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á.
Integrar o CodeDeploy com o GitHub
O CodeDeploy oferece suporte para o GitHub
Implantação de revisões do CodeDeploy pelo GitHub
Para implantar uma revisão de aplicativo de um repositório GitHub em instâncias:
-
Crie uma revisão compatível com o CodeDeploy e o tipo de instância do Amazon EC2 no qual você fará a implantação.
Para criar uma revisão compatível, siga as instruções em Planejar uma revisão para o CodeDeploy e Adicionar um arquivo de especificações de aplicativo a uma revisão para o CodeDeploy.
-
Use uma conta do GitHub para adicionar sua revisão a um repositório GitHub.
Para criar uma conta do GitHub, consulte Participar do GitHub
. Para criar um repositório GitHub, consulte Criar um repositório . -
Use a página Criar implantação no console do CodeDeploy ou o comando create-deployment do AWS CLI para implantar sua revisão com seu repositório do GitHub em instâncias de destino configuradas para uso em implantações do CodeDeploy.
Se você deseja chamar o comando create-deployment, primeiro é necessário usar a página Criar implantação do console para dar ao CodeDeploy permissão para interagir com o GitHub em nome da sua conta do GitHub preferencial 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 repositório do GitHub, consulte Crie uma implantação com CodeDeploy.
Para saber como chamar o comando create-deployment para implantar a partir de um repositório do GitHub, consulte Crie uma implantação EC2 /On-Premises Compute Platform (CLI).
Para saber como preparar instâncias para uso em implantações do CodeDeploy, consulte Como trabalhar com instâncias para o CodeDeploy.
Para obter mais informações, consulte Tutorial: usar o CodeDeploy para implantar um aplicativo do GitHub.
Comportamentos do GitHub com o CodeDeploy
Tópicos
Autenticação do GitHub com aplicativos no CodeDeploy
Depois de dar permissão ao CodeDeploy para interagir com o GitHub, a associação entre essa conta do GitHub e o aplicativo é armazenada no CodeDeploy. É possível vincular o aplicativo a uma conta do GitHub diferente. Você também pode revogar a permissão para o CodeDeploy interagir com o GitHub.
Para vincular uma conta do GitHub a um aplicativo no CodeDeploy
Faça login no Console de gerenciamento da AWS e abra o console do CodeDeploy em https://console.aws.amazon.com/codedeploy
. nota
Faça login com o mesmo usuário que você configurou em Começando com CodeDeploy.
No painel de navegação, expanda a opção Implantar e escolha Aplicativos.
-
Escolha o aplicativo que deseja vincular a uma conta do GitHub diferente.
-
Se o aplicativo não tiver um grupo de implantação, selecione Criar grupo de implantação para criar um. Para obter 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.
-
Em Deployments (Implantações), selecione Create deployment (Criar implantação).
nota
Não é necessário criar uma nova implantação. Atualmente, esta é a única maneira de vincular uma conta do GitHub diferente a um aplicativo.
-
Em Deployment settings (Configurações de implantação), para Revision type (Tipo de revisão), selecione My application is stored in GitHub (Meu aplicativo está armazenado no GitHub).
-
Execute um destes procedimentos:
-
Para criar uma conexão para aplicativos do AWS CodeDeploy com uma conta do GitHub, saia do GitHub em uma guia separada do navegador da web. Em GitHub token name (Nome do token do GitHub), digite um nome para identificar essa conexão e, em seguida, selecione Connect to GitHub (Conectar-se ao GitHub). A página da web solicita que você autorize o CodeDeploy a interagir com o GitHub de seu aplicativo. Continue na etapa 10.
-
Para usar uma conexão já criada, em GitHub token name (Nome do token do GitHub), selecione seu nome e, em seguida, selecione Connect to GitHub (Conectar-se ao GitHub). Continue na etapa 8.
-
Para criar uma conexão com uma conta do GitHub diferente, saia do GitHub em uma guia separada do navegador. Em GitHub token name (Nome do token do GitHub), digite um nome para identificar a conexão e, em seguida, selecione Connect to GitHub (Conectar-se ao GitHub). A página da web solicita que você autorize o CodeDeploy a interagir com o GitHub de seu aplicativo. Continue na etapa 10.
-
-
Se você ainda não entrou no GitHub, siga as instruções na página Fazer login para fazer login com a conta do GitHub à qual deseja vincular o aplicativo.
-
Escolha Autorizar aplicativo. O GitHub dá ao CodeDeploy permissão para interagir com o GitHub em nome da conta do GitHub conectada para o aplicativo selecionado.
-
Se não quiser criar uma implantação, escolha Cancelar.
Para revogar a permissão para o CodeDeploy interagir com o GitHub
-
Entre no GitHub
usando as credenciais da conta do GitHub na qual deseja revogar a permissão do AWS CodeDeploy. -
Abra a página Aplicativos
do GitHub, localize CodeDeploy na lista de aplicativos autorizados e, em seguida, siga o procedimento do GitHub para revogar a autorização para um aplicativo.
Interação do CodeDeploy com repositórios GitHub particulares e públicos
O CodeDeploy dá suporte à implantação de aplicativos de repositórios GitHub particulares e públicos. Ao dar permissão ao CodeDeploy para acessar o GitHub em seu nome, o CodeDeploy tem acesso de leitura e gravação a todos os repositórios GitHub particulares aos quais a sua conta do GitHub tem acesso. No entanto, o CodeDeploy somente faz leituras dos repositórios GitHub. Ele não gravará em nenhum dos seus repositórios GitHub particulares.
Interação do CodeDeploy com repositórios GitHub gerenciados pela organização
Por padrão, os repositórios GitHub gerenciados por uma organização (ao contrário de repositórios particulares ou públicos da sua conta) não concedem acesso a aplicativos de terceiros, incluindo o CodeDeploy. Sua implantação falhará se as restrições de aplicativos de terceiros de uma organização estiverem habilitadas no GitHub e você tentar implantar o código do seu repositório GitHub. Há duas maneiras de resolver esse problema.
-
Como membro da organização, você pode solicitar ao proprietário da organização que aprove o acesso ao CodeDeploy. As etapas para solicitar esse acesso dependem de você já ter autorizado o CodeDeploy para sua conta individual:
-
Se você tiver autorizado o acesso ao CodeDeploy na sua conta, consulte Solicitação de aprovação da organização para seus aplicativos autorizados
. -
Se ainda não tiver autorizado o acesso ao CodeDeploy na 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
Implantar automaticamente a partir do CodePipeline com o CodeDeploy
É possível disparar uma implantação de um CodePipeline sempre que o código-fonte é alterado. Para obter mais informações, consulte CodePipeline