GitHub conexões

1. Faça login no CodePipeline console.

2. Escolha uma das opções a seguir.

   • Opte por criar um pipeline. Siga as etapas em Criar um pipeline para concluir a primeira tela e escolha Próximo. Na página Fonte, em Provedor de origem, escolha GitHub (via GitHub aplicativo).

   • Opte por editar um pipeline existente. Escolha Editar e, em seguida, escolha Editar estágio. Escolha adicionar ou editar sua ação de origem. Na página Editar ação, em Nome da ação, insira um nome para a ação. Em Provedor de ações, escolha GitHub (via GitHub aplicativo).

3. Execute um destes procedimentos:

   • Em Conexão, se você ainda não tiver criado uma conexão com seu provedor, escolha Conectar GitHub a. Prossiga para a Etapa 2: Crie uma conexão com GitHub.

   • Em Conexão, se você já tiver criado uma conexão com seu provedor, escolha a conexão. Vá para a Etapa 3: Salvar a ação de origem da sua conexão.

Para criar uma conexão com GitHub

1. Nas configurações de GitHub conexão, o nome da conexão aparece em Nome da conexão. Escolha Conectar GitHub a. A página de solicitação de acesso será exibida.

2. Escolha Autorizar AWS conector para GitHub. A página de conexão é exibida e mostra o campo GitHub Aplicativos.

   

3. Em GitHub Aplicativos, escolha uma instalação de aplicativo ou escolha Instalar um novo aplicativo para criar um.

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

   nota

   Se você quiser criar um token de acesso de usuário, verifique se já instalou o AWS Connector for GitHub app e deixe o campo de instalação do aplicativo vazio. CodeConnections usará o token de acesso do usuário para a conexão.

4. Na GitHub página Install AWS Connector for, escolha a conta na qual você deseja instalar o aplicativo.

   nota

   Você só instala o aplicativo uma vez para cada GitHub conta. Se você instalou a aplicação 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. Na GitHub página Install AWS Connector for, deixe os padrões e escolha Instalar.

6. Na GitHub página Connect to, o ID de conexão da sua nova instalação aparece em GitHub Apps. Selecione Conectar.

Para salvar sua ação GitHub de origem

1. Em Repository name (Nome do repositório), escolha o nome do repositório de terceiros.

2. Em Gatilhos do Pipeline, você pode adicionar gatilhos se sua ação for uma ação. CodeConnections Para definir a configuração de gatilhos do pipeline e, se necessário, aplicar filtros, consulte mais detalhes em Adicione gatilho com tipos de eventos de push ou pull request de código.

3. 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 GitHub ação usando o método padrão, escolha CodePipeline default. A ação acessa os arquivos do GitHub repositório e armazena os artefatos em um arquivo ZIP no repositório 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 CodeBuild posteriores.

     Se você escolher essa opção, precisará atualizar as permissões para sua função de serviço CodeBuild do projeto, conforme mostrado emAdicione CodeBuild GitClone permissões para conexões com Bitbucket GitHub, GitHub Enterprise Server ou .com GitLab. Para assistir a um tutorial que mostre como usar a opção Clone completo, consulte Tutorial: use o clone completo com uma fonte de GitHub pipeline.

4. Escolha Próximo no assistente ou Salvar na página Editar ação.

Para criar uma conexão

1. Abra um terminal (Linux, macOS ou Unix) ou um prompt de comando (Windows). Use o AWS CLI para executar o create-connection comando, especificando --provider-type e --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, consulte Atualizar uma conexão pendente.

3. O pipeline assume como padrão a detecção de alterações ao enviar o código por push ao repositório de origem da conexão. Para definir a configuração do gatilho do pipeline para liberação manual ou para tags Git, execute um dos seguintes procedimentos:

   • Para definir a configuração do gatilho do pipeline para início somente por meio de liberação manual, adicione a seguinte linha à configuração:

     "DetectChanges": "false",

   • Para definir a configuração de gatilhos do pipeline e aplicar filtros, consulte mais detalhes em Adicione gatilho com tipos de eventos de push ou pull request de código. Por exemplo, o trecho a seguir é adicionado ao nível do pipeline na definição JSON do pipeline. Neste exemplo, release-v0 e release-v1 são as tags Git a serem incluídas, enquanto release-v2 são as tags Git a serem excluídas.

     "triggers": [
                 {
                     "providerType": "CodeStarSourceConnection",
                     "gitConfiguration": {
                         "sourceActionName": "Source",
                         "push": [
                             {
                                 "tags": {
                                     "includes": [
                                         "release-v0", "release-v1"
                                     ],
                                     "excludes": [
                                         "release-v2"
                                     ]
                                 }
                             }
                         ]
                     }
                 }
             ]