Integrando com CodeDeploy GitHub

CodeDeploy supports GitHub, um serviço de hospedagem e compartilhamento de código baseado na web. CodeDeploy pode implantar revisões de aplicativos armazenadas em GitHub repositórios ou buckets do Amazon S3 em instâncias. CodeDeploy suporta GitHub somente implantações EC2/locais.

Implantando CodeDeploy revisões de GitHub

Para implantar uma revisão do aplicativo de um GitHub repositório para instâncias:

1. Crie uma revisão que seja compatível com CodeDeploy o tipo de instância do Amazon EC2 na qual você implantará.

   Para criar uma revisão compatível, siga as instruções em Planeje uma revisão para CodeDeploy e Adicionar um arquivo de especificação do aplicativo a uma revisão do CodeDeploy.

2. Use uma GitHub conta para adicionar sua revisão a um GitHub repositório.

   Para criar uma GitHub conta, consulte Entrar GitHub. Para criar um GitHub repositório, consulte Criar um repositório.

3. Use a página Criar implantação no CodeDeploy console ou o AWS CLI create-deployment comando para implantar sua revisão do seu GitHub repositório para instâncias de destino configuradas para uso em CodeDeploy implantações.

   Se quiser chamar o create-deployment comando, você deve primeiro usar a página Criar implantação do console para dar CodeDeploy permissão para interagir GitHub em nome de sua GitHub conta preferida para o aplicativo especificado. Você só precisa fazer isso uma vez por aplicativo.

   Para saber como usar a página Criar implantação para implantar a partir de um GitHub repositório, consulteCrie uma implantação com CodeDeploy.

   Para saber como chamar o create-deployment comando para implantar a partir de um GitHub repositório, consulteCriar uma implantação de plataforma de computação de EC2/On-Premises (CLI).

   Para saber como preparar instâncias para uso em CodeDeploy implantações, consulteTrabalhando com instâncias para CodeDeploy.

Para ter mais informações, consulte Tutorial: Use CodeDeploy para implantar um aplicativo a partir de GitHub.

GitHub comportamentos com CodeDeploy

Tópicos

• GitHub autenticação com aplicativos em CodeDeploy
• CodeDeploy interação com GitHub repositórios públicos e privados
• CodeDeploy interação com repositórios gerenciados pela organização GitHub
• Implemente automaticamente a partir CodePipeline de CodeDeploy

GitHub autenticação com aplicativos em CodeDeploy

Depois de dar CodeDeploy permissão para interagir com GitHub, a associação entre essa GitHub conta e o aplicativo é armazenada em CodeDeploy. Você pode vincular o aplicativo a uma GitHub conta diferente. Você também pode revogar a permissão CodeDeploy para interagir com GitHub.

Para vincular uma GitHub conta a um aplicativo no CodeDeploy

1. Faça login no AWS Management Console e abra o CodeDeploy console em https://console.aws.amazon.com/codedeploy.

   nota

   Faça login com o mesmo usuário que você configurou em Começando com CodeDeploy.

2. No painel de navegação, expanda a opção Implantar e escolha Aplicações.

3. Escolha o aplicativo que você deseja vincular a uma GitHub conta diferente.

4. Se o aplicativo não tiver um grupo de implantação, selecione Criar grupo de implantação para criar um. Para ter mais informações, consulte Crie um grupo de implantação com CodeDeploy. Um grupo de implantação é necessário para selecionar Create deployment (Criar implantação) na próxima etapa.

5. Em Deployments (Implantações), selecione Create deployment (Criar implantação).

   nota

   Não é necessário criar uma nova implantação. Atualmente, essa é a única maneira de vincular uma GitHub conta diferente a um aplicativo.

6. Em Configurações de implantação, para Tipo de revisão, escolha Meu aplicativo está armazenado em GitHub.

7. Execute um destes procedimentos:

   • Para criar uma conexão de AWS CodeDeploy aplicativos com uma GitHub conta, saia GitHub em uma guia separada do navegador da web. Em nome do GitHub token, digite um nome para identificar essa conexão e escolha Conectar GitHub a. A página da web solicita que você autorize CodeDeploy a interação com seu GitHub aplicativo. Continue na etapa 10.

   • Para usar uma conexão que você já criou, em nome do GitHub token, selecione seu nome e escolha Conectar GitHub a. Continue na etapa 8.

   • Para criar uma conexão com uma GitHub conta diferente, saia GitHub em uma guia separada do navegador. Em Nome do GitHub token, digite um nome para identificar a conexão e escolha Conectar GitHub a. A página da web solicita que você autorize CodeDeploy a interação com seu GitHub aplicativo. Continue na etapa 10.

8. Se você ainda não estiver conectado GitHub, siga as instruções na página de login para fazer login com a GitHub conta à qual você deseja vincular o aplicativo.

9. Escolha Autorizar aplicativo. GitHub dá CodeDeploy permissão para interagir GitHub em nome da GitHub conta conectada do aplicativo selecionado.

10. Se não quiser criar uma implantação, escolha Cancelar.

Para revogar a permissão CodeDeploy para interagir com GitHub

1. Faça login GitHub usando as credenciais da GitHub conta na qual você deseja revogar a permissão AWS CodeDeploy .

2. Abra a página GitHub Aplicativos, localize CodeDeployna lista de aplicativos autorizados e siga o GitHub procedimento para revogar a autorização de um aplicativo.

CodeDeploy interação com GitHub repositórios públicos e privados

CodeDeploy suporta a implantação de aplicativos de GitHub repositórios públicos e privados. Quando você der CodeDeploy permissão para acessar GitHub em seu nome, CodeDeploy terá acesso de leitura e gravação a todos os GitHub repositórios privados aos quais sua GitHub conta tem acesso. No entanto, CodeDeploy só lê dos GitHub repositórios. Ele não gravará em nenhum dos seus GitHub repositórios privados.

CodeDeploy interação com repositórios gerenciados pela organização GitHub

Por padrão, GitHub os repositórios gerenciados por uma organização (em oposição aos repositórios privados ou públicos da sua conta) não concedem acesso a aplicativos de terceiros, inclusive. CodeDeploy Sua implantação falhará se as restrições de aplicativos de terceiros de uma organização estiverem habilitadas GitHub e você tentar implantar o código de seu GitHub repositório. Há duas maneiras de resolver esse problema.

• Como integrante da organização, você pode pedir ao proprietário da organização que aprove o acesso a. CodeDeploy As etapas para solicitar esse acesso dependem de você já ter autorizado CodeDeploy sua conta individual:

  • Se você autorizou o acesso à CodeDeploy sua conta, consulte Solicitando a aprovação da organização para suas inscrições autorizadas.

  • Se você ainda não autorizou o acesso à CodeDeploy sua conta, consulte Solicitação de aprovação da organização para aplicativos de terceiros.

• O proprietário da organização pode desabilitar todas as restrições de aplicativos de terceiros para a organização. Para obter informações, consulte Desabilitando restrições de aplicativos de terceiros para sua organização.

Para obter mais informações, consulte Sobre restrições de aplicativos de terceiros.

Implemente automaticamente a partir CodePipeline de CodeDeploy

Você pode acionar uma implantação a partir de um CodePipeline sempre que o código-fonte for alterado. Para obter mais informações, consulte CodePipeline.