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á.
# Integrando com CodeDeploy GitHub
CodeDeploy supports [GitHub](https://github.com/about), 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.
**Topics**
+ [Implantando CodeDeploy revisões de GitHub](#github-deployment-steps)
+ [GitHub comportamentos com CodeDeploy](#github-behaviors)
## 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 [Planejar uma revisão para o CodeDeploy](application-revisions-plan.md) e [Adicionar um arquivo de especificação do aplicativo a uma revisão do CodeDeploy](application-revisions-appspec-file.md).
1. Use uma GitHub conta para adicionar sua revisão a um GitHub repositório.
Para criar uma GitHub conta, consulte [Entrar GitHub](https://github.com/join). Para criar um GitHub repositório, consulte [Criar um repositório](https://help.github.com/articles/create-a-repo/).
1. 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, consulte[Crie uma implantação com CodeDeploy](deployments-create.md).
Para saber como chamar o **create-deployment** comando para implantar a partir de um GitHub repositório, consulte[Criar uma implantação de plataforma de computação de EC2/On-Premises (CLI)](deployments-create-cli.md).
Para saber como preparar instâncias para uso em CodeDeploy implantações, consulte[Trabalhando com instâncias para CodeDeploy](instances.md).
Para obter mais informações, consulte [Tutorial: Use CodeDeploy para implantar um aplicativo a partir de GitHub](tutorials-github.md).
## GitHub comportamentos com CodeDeploy
**Topics**
+ [GitHub autenticação com aplicativos em CodeDeploy](#behaviors-authentication)
+ [CodeDeploy interação com GitHub repositórios públicos e privados](#behaviors-interactions-private-and-public)
+ [CodeDeploy interação com repositórios gerenciados pela organização GitHub](#behaviors-interactions-organization-managed)
+ [Implemente automaticamente a partir CodePipeline de CodeDeploy](#behaviors-deploy-automatically)
### 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 Console de gerenciamento da AWS e abra o CodeDeploy console em [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy).
**nota**
Faça login com o mesmo usuário que você configurou em [Começando com CodeDeploy](getting-started-codedeploy.md).
1. No painel de navegação, expanda a opção **Implantar** e escolha **Aplicações**.
1. Escolha o aplicativo que você deseja vincular a uma GitHub conta diferente.
1. 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](deployment-groups-create.md). Um grupo de implantação é necessário para selecionar **Create deployment (Criar implantação)** na próxima etapa.
1. 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.
1. Em **Configurações de implantação**, para **Tipo de revisão**, escolha **Meu aplicativo está armazenado em GitHub**.
1. Execute um destes procedimentos:
+ Para criar uma conexão entre AWS CodeDeploy aplicativos e 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.
1. 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.
1. Escolha **Autorizar aplicativo**. GitHub dá CodeDeploy permissão para interagir GitHub em nome da GitHub conta conectada do aplicativo selecionado.
1. 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 ](https://github.com/dashboard)usando as credenciais da GitHub conta na qual você deseja revogar a permissão AWS CodeDeploy .
1. Abra a página GitHub [Aplicativos](https://github.com/settings/applications), localize **CodeDeploy**na 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 públicos ou privados 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 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 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](https://help.github.com/articles/requesting-organization-approval-for-your-authorized-applications/).
+ Se você ainda não autorizou o acesso à CodeDeploy sua conta, consulte [Solicitação de aprovação da organização para aplicativos de terceiros](https://help.github.com/articles/requesting-organization-approval-for-third-party-applications/).
+ 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](https://help.github.com/articles/disabling-third-party-application-restrictions-for-your-organization/).
Para obter mais informações, consulte [Sobre restrições de aplicativos de terceiros](https://help.github.com/articles/about-third-party-application-restrictions/).
### 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](https://aws.amazon.com/codepipeline/).