Conexões GitHub - AWS CodePipeline

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Conexões GitHub

Você usa conexões para autorizar e estabelecer configurações que associam seu provedor terceirizado ao seuAWSrecursos da AWS.

nota

Esse recurso não está disponível nas regiões Ásia-Pacífico (Hong Kong) e Europa (Milão) Para fazer referência a outras ações disponíveis, consulteIntegrações de produtos e serviços ao CodePipeline.

Para adicionar uma ação de origem ao repositório do GitHub ou do GitHub Enterprise Cloud no CodePipeline, você pode optar por:

nota

Você também pode criar uma conexão usando o console do Developer Tools emConfigurações. ConsulteCriar uma conexão.

Antes de começar:

  • Você deve ter criado uma conta com o GitHub.

  • Você já deve ter criado um repositório de código do GitHub.

  • Se sua função de serviço do CodePipeline foi criada antes de 18 de dezembro de 2019, pode ser necessário atualizar suas permissões para usarcodestar-connections:UseConnectionPara conexões do AWS CodeStar. Para obter instruções, consulte Adicionar permissões à função de serviço do CodePipeline.

Criar uma conexão com o GitHub (console)

Use estas etapas para usar o console do CodePipeline para adicionar uma ação de conexões ao repositório do GitHub ou do GitHub Enterprise Cloud.

nota

As conexões do GitHub fornecem acesso somente a repositórios pertencentes à conta do GitHub usada para criar a conexão.

Etapa 1: Crie ou edite seu pipeline

  1. Faça login no console do CodePipeline.

  2. Escolha uma das seguintes opções.

    • Escolha criar um pipeline. Siga as etapas emCriar um pipelinepara completar a primeira tela e escolherPróximo. NoOrigempágina, emProvedor de origem, escolhaGitHub (Versão 2).

    • Escolha editar um pipeline existente. SelecioneEditee, depois, escolhaEdit stage. Escolha adicionar ou editar sua ação de origem. NoEditar açãopágina, emAction name (Nome da ação), insira o nome de sua ação. DentroProvedor de ação, escolhaGitHub (Versão 2).

  3. Execute um destes procedimentos:

    • UNDERConexão do, se você ainda não tiver criado uma conexão com seu provedor, selecioneConnect ao GitHub. Prossiga para a Etapa 2: Crie uma conexão com o GitHub.

    • UNDERConexão do, se você já criou uma conexão com seu provedor, escolha a conexão. Prossiga para a Etapa 3: Salve a ação de origem para sua conexão.

Etapa 2: Criar uma conexão com o GitHub

Depois de escolher criar a conexão, oConnect ao GitHubA página é exibida.


                    Captura de tela do console mostrando a página inicial de conexão do GitHub.

Para criar uma conexão com o GitHub

  1. UNDERConfigurações de conexão do GitHub, seu nome de conexão aparece noConnection name (Nome da conexão). Escolha Conectar-se ao GitHub. A página de solicitação de acesso será exibida.

  2. SelecioneAutorizarAWSConector para GitHub. A página de conexão exibe e mostra o campo GitHub Apps (Aplicações do GitHub)

    
                            Captura de tela do console mostrando a página inicial de conexão do GitHub com o campo GitHub Apps (Aplicações do GitHub).
  3. Em GitHub apps (Aplicações do GitHub), escolha uma instalação de aplicação ou Install a new app (Instalar uma nova aplicação) para criar uma.

    nota

    Você instala uma aplicação para todas as suas conexões com um provedor específico. Se você já instalou aAWSConector para aplicativo GitHub, escolha-o e pule esta etapa.

  4. NoInstallAWSConector para GitHub, selecione a conta do na qual deseja instalar o aplicativo.

    nota

    A aplicação é instalada apenas uma vez para cada conta do GitHub. Se você instalou a aplicaçaõ anteriormente, poderá escolher Configure (Configurar) para prosseguir para uma página de modificação para a instalação da aplicação ou usar o botão Back (Voltar) para retornar ao console.

  5. NoInstallAWSConector para GitHubPágina, mantenha os padrões e escolhaInstall.

  6. Na página Connect to GitHub (Conexão ao GitHub) o ID de conexão da sua nova instalação é exibido em GitHub Apps (Aplicações do GitHub). Selecione Conectar.

Etapa 3: Salve sua ação de origem do GitHub

Use estas etapas noEditar açãopara salvar sua ação de origem com as informações de conexão.

Para salvar sua ação de origem do GitHub

  1. DentroRepositório, insira o nome do seu repositório. Em Branch name (Nome da ramificação), escolha a ramificação onde deseja que o pipeline detecte alterações de origem.

    nota

    DentroRepositório, tipoowner-name/repository-namecomo mostrado neste exemplo:

    my-account/my-repository
  2. Em Output artifact format (Formato de artefato de saída), você deve escolher o formato para seus artefatos.

    • Para armazenar artefatos de saída da ação do GitHub usando o método padrão, selecionePadrão do CodePipeline. A ação acessa os arquivos do repositório do GitHub e armazena os artefatos em um arquivo ZIP no armazenamento de artefatos do pipeline.

    • Para armazenar um arquivo JSON que contém uma referência de URL ao repositório para que as ações downstream possam executar comandos Git diretamente, escolha Full clone (Clone completo). Essa opção só pode ser usada pelas ações downstream do CodeBuild.

      Se você escolher essa opção, precisará atualizar as permissões para a função de serviço do projeto CodeBuild, conforme mostrado emAdicionar CodeBuild Permissões do GitClone para conexões com Bitbucket, GitHub ou GitHub Servidor corporativo. Para obter um tutorial que mostra como usar aClone completoopção, consulteTutorial: Usar clone completo com uma fonte de pipeline do GitHub.

  3. SelecionePróximono assistente ouSalvarnoEditar ação.

Criar uma conexão com o GitHub (CLI)

É possível usar a AWS Command Line Interface (AWS CLI) para criar uma conexão.

Para fazer isso, use o comando create-connection.

Importante

Uma conexão criada por meio da AWS CLI ou do AWS CloudFormation permanece no status PENDING por padrão. Depois de criar uma conexão com a CLI ou o AWS CloudFormation, use o console para editar a conexão e tornar seu status AVAILABLE.

Como criar uma conexão

  1. Abra um terminal (Linux, macOS ou Unix) ou um prompt de comando (Windows). Use a AWS CLI para executar o comando create-connection, especificando o --provider-type e o --connection-name para sua conexão. Neste exemplo, o nome do provedor de terceiros é GitHub e o nome da conexão especificada é MyConnection.

    aws codestar-connections create-connection --provider-type GitHub --connection-name MyConnection

    Se tiver êxito, esse comando gerará as informações do ARN de conexão semelhantes às seguintes.

    { "ConnectionArn": "arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f" }
  2. Use o console para concluir a conexão. Para obter mais informações, consulteAtualizar uma conexão pendente.