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 aoAWSrecursos da AWS.

nota

Esse recurso não está disponível na região Ásia-Pacífico (Hong Kong) ou Europa (Milão). Para usar outras ações de origem disponíveis nessa região, consulteIntegrações de ações de origem.

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:

  • É necessário criar 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 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 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 de propriedade da conta do GitHub usada para criar a conexão do.

Etapa 1: Crie ou edite seu pipeline

  1. Faça login no console 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).

    • Selecione Como 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 da ação do. DentroProvedor de ação, escolhaGitHub (versão 2).

  3. Execute um destes procedimentos:

    • UNDERConexão doSe você ainda não tiver criado uma conexão com seu provedor, escolhaConnect 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 optar por criar a conexão, oConnect ao GitHubA página será exibida.


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

Para criar uma conexão com o GitHub

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

    
                            Captura de tela do console mostrando a página de acesso à conta do GitHub.
  2. SelecioneAutorizarAWSConector para o 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 oAWSConector para aplicativo GitHub, escolhe-o e pule esta etapa.

  4. NoInstallAWSConector para o GitHubPágina, escolha a conta em que você deseja instalar o aplicativo.

    
                            Captura de tela do console mostrando a página de instalação do  Conector for GitHub.
    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 o GitHubPágina, deixe os padrões e escolhaInstall.

    
                            Captura de tela do console mostrando a segunda página de instalação do Conector para o GitHub.

  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,entrarO nome do repositório do. 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, escolhaPadrão 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 por 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 emAdicione permissões do GitClone do CodeBuild para conexões com o Bitbucket, GitHub ou GitHub Enterprise Server. Para obter um tutorial que mostra como usar oClone 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.