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á.
# Tutorial: Use CodeDeploy para implantar um aplicativo a partir de GitHub
Neste tutorial, você usa CodeDeploy para implantar uma amostra de revisão do GitHub aplicativo em uma única instância do Amazon EC2 executando o Amazon Linux, uma única instância do Red Hat Enterprise Linux (RHEL) ou uma única instância do Windows Server. Para obter informações sobre GitHub integração com CodeDeploy, consulte[Integrando com CodeDeploy GitHub](integrations-partners-github.md).
**nota**
Você também pode usar CodeDeploy para implantar uma revisão do aplicativo GitHub em uma instância do Ubuntu Server. Você pode usar a revisão de amostra descrita [Etapa 2: criar uma revisão de aplicativo de amostra](tutorials-on-premises-instance-2-create-sample-revision.md) em[Tutorial: Implantar um aplicativo em uma instância local com CodeDeploy (Windows Server, Ubuntu Server ou Red Hat Enterprise Linux)](tutorials-on-premises-instance.md), ou você pode criar uma revisão compatível com uma instância do Ubuntu Server CodeDeploy e. Para criar sua própria revisão, consulte [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).
**Topics**
+ [Pré-requisitos](tutorials-github-prerequisites.md)
+ [Etapa 1: configurar uma GitHub conta](tutorials-github-create-github-account.md)
+ [Etapa 2: criar um GitHub repositório](tutorials-github-create-github-repository.md)
+ [Etapa 3: Carregar um aplicativo de amostra no seu GitHub repositório](tutorials-github-upload-sample-revision.md)
+ [Etapa 4: provisionar uma instância](tutorials-github-provision-instance.md)
+ [Etapa 5: criar um aplicativo e um grupo de implantação](tutorials-github-create-application.md)
+ [Etapa 6: implantar o aplicativo na instância](tutorials-github-deploy-application.md)
+ [Etapa 7: monitorar e verificar a implantação](tutorials-github-verify.md)
+ [Etapa 8: Limpeza](tutorials-github-clean-up.md)
# Pré-requisitos
Antes de começar este tutorial, faça o seguinte:
+ Instale o Git na sua máquina local. Para instalar o Git, consulte [Downloads do Git](http://git-scm.com/downloads).
+ Conclua as etapas em [Começando com CodeDeploy](getting-started-codedeploy.md), incluindo a instalação e a configuração da AWS CLI. Isso é especialmente importante se você quiser usar o AWS CLI para implantar uma revisão na instância. GitHub
# Etapa 1: configurar uma GitHub conta
Você precisará de uma GitHub conta para criar um GitHub repositório onde a revisão será armazenada. Se você já tem uma GitHub conta, vá para[Etapa 2: criar um GitHub repositório](tutorials-github-create-github-repository.md).
1. Vá para [https://github.com/join](https://github.com).
1. Digite um nome de usuário, seu endereço de e-mail e uma senha.
1. Escolha **Inscrever-se GitHub** em e siga as instruções.
# Etapa 2: criar um GitHub repositório
Você precisará de um GitHub repositório para armazenar a revisão.
Se você já tem um GitHub repositório, não se esqueça de substituir seu nome por **CodeDeployGitHubDemo** todo este tutorial e, em seguida, vá para. [Etapa 3: Carregar um aplicativo de amostra no seu GitHub repositório](tutorials-github-upload-sample-revision.md)
1. Na [página GitHub inicial](https://github.com/dashboard), faça o seguinte:
+ Em **Seus repositórios**, escolha **Novo repositório**.
+ Na barra de navegação, escolha **Criar novo** (**\$1**) e, em seguida, escolha **Novo repositório**.
1. Na página **Create a new repository**, faça o seguinte:
+ Na caixa de texto **Repository name (Nome do repositório)**, digite **CodeDeployGitHubDemo**.
+ Selecione **Public**.
**nota**
Selecionar a opção **Público** padrão significa que qualquer pessoa pode ver esse repositório. Você pode selecionar a opção **Private (Privado)** para limitar quem pode ver e confirmar no repositório.
+ Desmarque a caixa de seleção **Inicializar este repositório com um LEIA-ME**. Você criará um arquivo `README.md` manualmente na próxima etapa.
+ Escolha **Criar repositório**.
1. Siga as instruções para o seu tipo de máquina local de modo a usar a linha de comando para criar o repositório.
**nota**
Se você ativou a autenticação de dois fatores GitHub, certifique-se de inserir seu token de acesso pessoal em vez de sua senha de GitHub login, caso seja solicitada uma senha. Para obter informações, consulte [Como fornecer seu código de autenticação de dois fatores](https://help.github.com/articles/providing-your-2fa-authentication-code/).
**Em máquinas Linux, macOS ou Unix locais:**
1. No terminal, execute os seguintes comandos, um por vez, onde *user-name* está seu nome de GitHub usuário:
```
mkdir /tmp/CodeDeployGitHubDemo
```
```
cd /tmp/CodeDeployGitHubDemo
```
```
touch README.md
```
```
git init
```
```
git add README.md
```
```
git commit -m "My first commit"
```
```
git remote add origin https://github.com/user-name/CodeDeployGitHubDemo.git
```
```
git push -u origin master
```
1. Deixe o terminal aberto na localização `/tmp/CodeDeployGitHubDemo`.
**Em máquinas locais do Windows:**
1. Em um prompt de comando em execução como administrador, execute os seguintes comandos, um por vez:
```
mkdir c:\temp\CodeDeployGitHubDemo
```
```
cd c:\temp\CodeDeployGitHubDemo
```
```
notepad README.md
```
1. No bloco de notas, salve o arquivo `README.md`. Feche o Bloco de notas. Execute os seguintes comandos, um por vez, onde *user-name* está seu nome de GitHub usuário:
```
git init
```
```
git add README.md
```
```
git commit -m "My first commit"
```
```
git remote add origin https://github.com/user-name/CodeDeployGitHubDemo.git
```
```
git push -u origin master
```
1. Deixe a solicitação de comando aberta na localização `c:\temp\CodeDeployGitHubDemo`.
# Etapa 3: Carregar um aplicativo de amostra no seu GitHub repositório
Nesta etapa, você copiará uma revisão de amostra de um bucket público do Amazon S3 para o seu GitHub repositório. (Para simplificar, as revisões de amostra fornecidas para este tutorial são páginas da Web exclusivas.)
**nota**
Se você usar uma das suas revisões em vez da nossa revisão de amostra, sua revisão deverá:
Seguir as diretrizes 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).
Trabalhar com o tipo de instância correspondente.
Esteja acessível a partir do seu GitHub painel.
Se a sua revisão atender a esses requisitos, avance para [Etapa 5: criar um aplicativo e um grupo de implantação](tutorials-github-create-application.md).
Se você estiver implantando em uma instância do Ubuntu Server, precisará enviar para o seu GitHub repositório uma revisão compatível com uma instância do Ubuntu Server e. CodeDeploy Para obter mais informações, consulte [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).
**Topics**
+ [Envie uma amostra de revisão com uma máquina Linux, macOS ou Unix local](#tutorials-github-upload-sample-revision-unixes)
+ [Enviar uma revisão de amostra de uma máquina Windows local](#tutorials-github-upload-sample-revision-windows)
## Envie uma amostra de revisão com uma máquina Linux, macOS ou Unix local
Com seu terminal ainda aberto, por exemplo, na localização `/tmp/CodeDeployGitHubDemo`, execute os seguintes comandos, um de cada vez:
**nota**
Se você planeja implantar em uma instância do Windows Server, substitua `SampleApp_Windows.zip` por `SampleApp_Linux.zip` nos comandos.
```
(Amazon S3 copy command)
```
```
unzip SampleApp_Linux.zip
```
```
rm SampleApp_Linux.zip
```
```
git add .
```
```
git commit -m "Added sample app"
```
```
git push
```
Onde *(Amazon S3 copy command)* está uma das seguintes opções:
+ `aws s3 cp s3://aws-codedeploy-us-east-2/samples/latest/SampleApp_Linux.zip . --region us-east-2` para a região Leste dos EUA (Ohio)
+ `aws s3 cp s3://aws-codedeploy-us-east-1/samples/latest/SampleApp_Linux.zip . --region us-east-1` para a região Leste dos EUA (Norte da Virgínia)
+ `aws s3 cp s3://aws-codedeploy-us-west-1/samples/latest/SampleApp_Linux.zip . --region us-west-1` para a região Oeste dos EUA (Norte da Califórnia)
+ `aws s3 cp s3://aws-codedeploy-us-west-2/samples/latest/SampleApp_Linux.zip . --region us-west-2` para a região Oeste dos EUA (Oregon)
+ `aws s3 cp s3://aws-codedeploy-ca-central-1/samples/latest/SampleApp_Linux.zip . --region ca-central-1` para a região do Canadá (Central)
+ `aws s3 cp s3://aws-codedeploy-eu-west-1/samples/latest/SampleApp_Linux.zip . --region eu-west-1` para a região da Europa (Irlanda)
+ `aws s3 cp s3://aws-codedeploy-eu-west-2/samples/latest/SampleApp_Linux.zip . --region eu-west-2` para a região da Europa (Londres)
+ `aws s3 cp s3://aws-codedeploy-eu-west-3/samples/latest/SampleApp_Linux.zip . --region eu-west-3` para a região da Europa (Paris)
+ `aws s3 cp s3://aws-codedeploy-eu-central-1/samples/latest/SampleApp_Linux.zip . --region eu-central-1` para a região da Europa (Frankfurt)
+ `aws s3 cp s3://aws-codedeploy-il-central-1/samples/latest/SampleApp_Linux.zip . --region il-central-1` para a região de Israel (Tel Aviv)
+ `aws s3 cp s3://aws-codedeploy-ap-east-1/samples/latest/SampleApp_Linux.zip . --region ap-east-1` para a região Ásia-Pacífico (Hong Kong)
+ `aws s3 cp s3://aws-codedeploy-ap-northeast-1/samples/latest/SampleApp_Linux.zip . --region ap-northeast-1` para a região Ásia-Pacífico (Tóquio)
+ `aws s3 cp s3://aws-codedeploy-ap-northeast-2/samples/latest/SampleApp_Linux.zip . --region ap-northeast-2` para a região Ásia-Pacífico (Seul)
+ `aws s3 cp s3://aws-codedeploy-ap-southeast-1/samples/latest/SampleApp_Linux.zip . --region ap-southeast-1` para a região Ásia-Pacífico (Singapura)
+ `aws s3 cp s3://aws-codedeploy-ap-southeast-2/samples/latest/SampleApp_Linux.zip . --region ap-southeast-2` para a região Ásia-Pacífico (Sydney)
+ `aws s3 cp s3://aws-codedeploy-ap-southeast-4/samples/latest/SampleApp_Linux.zip . --region ap-southeast-4` para a região Ásia-Pacífico (Melbourne)
+ `aws s3 cp s3://aws-codedeploy-ap-south-1/samples/latest/SampleApp_Linux.zip . --region ap-south-1` para a região Ásia-Pacífico (Mumbai)
+ `aws s3 cp s3://aws-codedeploy-sa-east-1/samples/latest/SampleApp_Linux.zip . --region sa-east-1` para a região da América do Sul (São Paulo)
## Enviar uma revisão de amostra de uma máquina Windows local
Com sua solicitação de comando ainda aberta, por exemplo, na localização `c:\temp\CodeDeployGitHubDemo`, execute os seguintes comandos, um de cada vez:
**nota**
Se você planeja implantar em uma instância do Amazon Linux ou RHEL, substitua `SampleApp_Linux.zip` por `SampleApp_Windows.zip` nos comandos.
```
(Amazon S3 copy command)
```
Descompacte o conteúdo do arquivo ZIP `the` diretamente no diretório local (por exemplo `c:\temp\CodeDeployGitHubDemo`), e não em um novo subdiretório.
```
git add .
```
```
git commit -m "Added sample app"
```
```
git push
```
Onde *(Amazon S3 copy command)* está uma das seguintes opções:
+ `aws s3 cp s3://aws-codedeploy-us-east-2/samples/latest/SampleApp_Windows.zip . --region us-east-2` para a região Leste dos EUA (Ohio)
+ `aws s3 cp s3://aws-codedeploy-us-east-1/samples/latest/SampleApp_Windows.zip . --region us-east-1` para a região Leste dos EUA (Norte da Virgínia)
+ `aws s3 cp s3://aws-codedeploy-us-west-1/samples/latest/SampleApp_Windows.zip . --region us-west-1` para a região Oeste dos EUA (Norte da Califórnia)
+ `aws s3 cp s3://aws-codedeploy-us-west-2/samples/latest/SampleApp_Windows.zip . --region us-west-2` para a região Oeste dos EUA (Oregon)
+ `aws s3 cp s3://aws-codedeploy-ca-central-1/samples/latest/SampleApp_Windows.zip . --region ca-central-1` para a região do Canadá (Central)
+ `aws s3 cp s3://aws-codedeploy-eu-west-1/samples/latest/SampleApp_Windows.zip . --region eu-west-1` para a região da Europa (Irlanda)
+ `aws s3 cp s3://aws-codedeploy-eu-west-2/samples/latest/SampleApp_Windows.zip . --region eu-west-2` para a região da Europa (Londres)
+ `aws s3 cp s3://aws-codedeploy-eu-west-3/samples/latest/SampleApp_Windows.zip . --region eu-west-3` para a região da Europa (Paris)
+ `aws s3 cp s3://aws-codedeploy-eu-central-1/samples/latest/SampleApp_Windows.zip . --region eu-central-1` para a região da Europa (Frankfurt)
+ `aws s3 cp s3://aws-codedeploy-il-central-1/samples/latest/SampleApp_Windows.zip . --region il-central-1` para a região de Israel (Tel Aviv)
+ `aws s3 cp s3://aws-codedeploy-ap-east-1/samples/latest/SampleApp_Windows.zip . --region ap-east-1` para a região Ásia-Pacífico (Hong Kong)
+ `aws s3 cp s3://aws-codedeploy-ap-northeast-1/samples/latest/SampleApp_Windows.zip . --region ap-northeast-1` para a região Ásia-Pacífico (Tóquio)
+ `aws s3 cp s3://aws-codedeploy-ap-northeast-2/samples/latest/SampleApp_Windows.zip . --region ap-northeast-2` para a região Ásia-Pacífico (Seul)
+ `aws s3 cp s3://aws-codedeploy-ap-southeast-1/samples/latest/SampleApp_Windows.zip . --region ap-southeast-1` para a região Ásia-Pacífico (Singapura)
+ `aws s3 cp s3://aws-codedeploy-ap-southeast-2/samples/latest/SampleApp_Windows.zip . --region ap-southeast-2` para a região Ásia-Pacífico (Sydney)
+ `aws s3 cp s3://aws-codedeploy-ap-southeast-4/samples/latest/SampleApp_Windows.zip . --region ap-southeast-4` para a região Ásia-Pacífico (Melbourne)
+ `aws s3 cp s3://aws-codedeploy-ap-south-1/samples/latest/SampleApp_Windows.zip . --region ap-south-1` para a região Ásia-Pacífico (Mumbai)
+ `aws s3 cp s3://aws-codedeploy-sa-east-1/samples/latest/SampleApp_Windows.zip . --region sa-east-1` para a região da América do Sul (São Paulo)
Para enviar sua própria revisão a uma instância do Ubuntu Server, copie-a no seu repositório local e depois chame o seguinte:
```
git add .
git commit -m "Added Ubuntu app"
git push
```
# Etapa 4: provisionar uma instância
Nesta etapa, você criará ou configurará a instância na qual implantará o aplicativo de amostra. Você pode implantar em uma instância do Amazon EC2 ou em uma instância local que esteja executando um dos sistemas operacionais suportados pelo. CodeDeploy Para obter mais informações, consulte [Sistemas operacionais suportados pelo CodeDeploy agente](codedeploy-agent.md#codedeploy-agent-supported-operating-systems). (Se você já tiver uma instância configurada para uso em CodeDeploy implantações, vá para a próxima etapa.)
**Como provisionar uma instância**
1. Siga as instruções em [Iniciar uma instância do Amazon EC2 (console)](instances-ec2-create.md#instances-ec2-create-console) para provisionar uma instância.
1. Ao iniciar a instância, lembre-se de especificar uma tag na página **Adicionar tags**. Para obter detalhes sobre como especificar a tag, consulte [Iniciar uma instância do Amazon EC2 (console)](instances-ec2-create.md#instances-ec2-create-console).
**Para verificar se o CodeDeploy agente está sendo executado na instância**
+ Siga as instruções em [Verifique se o CodeDeploy agente está em execução](codedeploy-agent-operations-verify.md) para verificar se o agente está em execução.
Depois de provisionar a instância com sucesso e verificar se o CodeDeploy agente está em execução, vá para a próxima etapa.
# Etapa 5: criar um aplicativo e um grupo de implantação
Nesta etapa, você usará o CodeDeploy console ou o AWS CLI para criar um aplicativo e um grupo de implantação para implantar a revisão de amostra do seu GitHub repositório.
## Criar um aplicativo e um grupo de implantação (console)
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 **Aplicativos**.
1. Escolha **Create application (Criar aplicativo)** e selecione **Custom application (Aplicativo personalizado)**.
1. Em **Nome do aplicativo**, insira **CodeDeployGitHubDemo-App**.
1. Em **Plataforma de computação**, selecione **EC2/On-Premises**.
1. Escolha **Criar aplicativo**.
1. Na guia **Grupos de implantação**, selecione **Criar um grupo de implantação**.
1. Em **Nome do grupo de implantação**, insira **CodeDeployGitHubDemo-DepGrp**.
1. Em **Função de serviço**, escolha o nome da sua função de CodeDeploy serviço que você criou em [Criar uma função de serviço para CodeDeploy](getting-started-create-service-role.md).
1. Em **Tipo de implantação**, selecione **No local**.
1. Em **Configuração do ambiente**, dependendo do tipo de instância que você estiver usando, selecione **Instâncias do Amazon EC2** ou **Instâncias on-premises**. Em **Key (Chave)** e **Value (Valor)**, digite a chave de tag da instância e o valor que foi aplicado à instância como parte de [Etapa 4: provisionar uma instância](tutorials-github-provision-instance.md).
1. Em **Configuração de implantação**, escolha **CodeDeployDefault. AllatOnce**.
1. Em **Balanceador de carga**, desmarque **Habilitar balanceamento de carga**.
1. Expanda **Advanced**.
1. Em **Alarms (Alarmes)**, selecione **Ignore alarm configuration (Ignorar configuração de alarme)**.
1. Selecione **Create deployment group (Criar grupo de implantação)** e continue na próxima etapa.
## Criar um aplicativo e um grupo de implantação (CLI)
1. Chame o comando **create-application** para criar um aplicativo no CodeDeploy chamado `CodeDeployGitHubDemo-App`:
```
aws deploy create-application --application-name CodeDeployGitHubDemo-App
```
1. Chame o comando **create-deployment-group** para criar um grupo de implantação chamado `CodeDeployGitHubDemo-DepGrp`:
+ Se você estiver implantando em uma instância do Amazon EC2*ec2-tag-key*, é a chave de tag da instância do Amazon EC2 que foi aplicada à sua instância do Amazon EC2 como parte do. [Etapa 4: provisionar uma instância](tutorials-github-provision-instance.md)
+ Se você estiver implantando em uma instância do Amazon EC2*ec2-tag-value*, é o valor da tag da instância do Amazon EC2 que foi aplicado à sua instância do Amazon EC2 como parte de. [Etapa 4: provisionar uma instância](tutorials-github-provision-instance.md)
+ Se você estiver implantando em uma instância local, *on-premises-tag-key* é a chave de tag da instância local que foi aplicada à sua instância local como parte de. [Etapa 4: provisionar uma instância](tutorials-github-provision-instance.md)
+ Se você estiver implantando em uma instância local, *on-premises-tag-value* é o valor da tag da instância local que foi aplicado à sua instância local como parte de. [Etapa 4: provisionar uma instância](tutorials-github-provision-instance.md)
+ *service-role-arn*é o ARN da função de serviço para a função de serviço que você criou em [Criar uma função de serviço](getting-started-create-service-role.md) para. CodeDeploy (Siga as instruções em [Obter o ARN do perfil de serviço (CLI)](getting-started-create-service-role.md#getting-started-get-service-role-cli) para localizar o ARN da função de serviço.)
```
aws deploy create-deployment-group --application-name CodeDeployGitHubDemo-App --ec2-tag-filters Key=ec2-tag-key,Type=KEY_AND_VALUE,Value=ec2-tag-value --on-premises-tag-filters Key=on-premises-tag-key,Type=KEY_AND_VALUE,Value=on-premises-tag-value --deployment-group-name CodeDeployGitHubDemo-DepGrp --service-role-arn service-role-arn
```
**nota**
O [create-deployment-group](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment-group.html)comando fornece suporte para a criação de acionadores que resultam no envio de notificações do Amazon SNS aos assinantes do tópico sobre eventos específicos em implantações e instâncias. O comando também oferece suporte a opções para reverter automaticamente as implantações e configurar alarmes para interromper as implantações quando os limites de monitoramento nos alarmes da CloudWatch Amazon forem atingidos. Os comandos para essas ações não estão incluídos neste tutorial.
# Etapa 6: implantar o aplicativo na instância
Nesta etapa, você usa o CodeDeploy console ou o AWS CLI para implantar a revisão de amostra do seu GitHub repositório na sua instância.
## Para implantar a revisão (console)
1. Na página **Deployment group details (Detalhes do grupo de implantação)**, selecione **Create deployment (Criar implantação)**.
1. Em **Deployment group (Grupo de implantação)**, selecione **`CodeDeployGitHubDemo-DepGrp`**.
1. Em **Tipo de revisão**, escolha **GitHub**.
1. Em **Connect to GitHub**, faça o seguinte:
+ Para criar uma conexão entre CodeDeploy aplicativos e uma GitHub conta, saia GitHub em uma guia separada do navegador da Web. Em **GitHub Conta**, insira 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 o aplicativo GitHub chamado. `CodeDeployGitHubDemo-App` Continue na etapa 5.
+ Para usar uma conexão que você já criou, na **GitHubconta**, selecione seu nome e escolha **Conectar GitHub** a. Continue na etapa 7.
+ Para criar uma conexão com uma GitHub conta diferente, saia GitHub em uma guia separada do navegador. Escolha **Conectar a uma GitHub conta diferente** e, em seguida, escolha **Conectar GitHub** a. Continue na etapa 5.
1. Siga as instruções na página de **login** para fazer login com sua GitHub conta.
1. Na página para **Autorizar aplicativo**, escolha **Autorizar aplicativo**.
1. Na página CodeDeploy **Criar implantação**, em **Nome do repositório**, insira o nome de GitHub usuário que você usou para entrar, seguido por uma barra (`/`), seguida pelo nome do repositório em que você enviou a revisão do aplicativo (por exemplo,). ***my-github-user-name*/CodeDeployGitHubDemo**
Caso não tenha certeza do valor que deve ser digitado ou se quiser especificar um repositório diferente:
1. Em uma guia separada do navegador, acesse seu [GitHub painel](https://github.com/dashboard).
1. Em **Seus repositórios**, passe o ponteiro do mouse sobre o nome do repositório de destino. Uma dica de ferramenta aparece, exibindo o nome GitHub do usuário ou da organização, seguido por uma barra (`/`), seguida pelo nome do repositório. Digite esse valor em **Repository name (Nome do repositório)**.
**nota**
Se o nome do repositório de destino não for exibido em **Seus repositórios**, use a GitHub caixa **Pesquisar** para encontrar o repositório de destino e o nome GitHub do usuário ou da organização.
1. Na caixa **ID da confirmação**, insira a ID da confirmação associada ao envio da revisão do seu aplicativo para GitHub.
Caso não tenha certeza do valor que deve ser digitado:
1. Em uma guia separada do navegador, acesse seu [GitHub painel](https://github.com/dashboard).
1. Em **Your repositories (Seus repositórios)**, selecione **CodeDeployGitHubDemo**.
1. Na lista de confirmações, localize e copie a ID da confirmação associada ao envio da revisão do seu aplicativo para GitHub. Em geral, esse ID tem 40 caracteres de comprimento e é formado por letras e números. (Não use a versão mais curta do ID de confirmação, que é normalmente os 10 primeiros caracteres da versão mais longa.)
1. Cole o ID de confirmação na caixa **ID de confirmação**.
1. Escolha **Implantar** e continue até a próxima etapa.
## Para implantar a revisão (CLI)
Antes de chamar qualquer AWS CLI comando que interaja com GitHub (como o **create-deployment** comando, que você chamará em seguida), você deve dar CodeDeploy permissão para usar sua conta de GitHub usuário GitHub para interagir com o `CodeDeployGitHubDemo-App` aplicativo. Atualmente, você deve usar o console do CodeDeploy para fazer isso.
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. Selecione **CodeDeployGitHubDemo-App**.
1. Na guia **Implantações**, selecione **Criar implantação**.
**nota**
Você não criará uma nova implantação. Atualmente, essa é a única maneira de dar CodeDeploy permissão para interagir GitHub em nome de sua conta de GitHub usuário.
1. Em **Grupo de implantação**, escolha **CodeDeployGitHubDemo- DepGrp**.
1. Em **Tipo de revisão**, escolha **GitHub**.
1. Em **Connect to GitHub**, faça o seguinte:
+ Para criar uma conexão entre CodeDeploy aplicativos e uma GitHub conta, saia GitHub em uma guia separada do navegador da Web. Em **GitHub Conta**, 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 GitHub o aplicativo chamado. `CodeDeployGitHubDemo-App` Continue na etapa 8.
+ Para usar uma conexão que você já criou, na **GitHubconta**, selecione seu nome e escolha **Conectar GitHub** a. Continue na etapa 10.
+ Para criar uma conexão com uma GitHub conta diferente, saia GitHub em uma guia separada do navegador. Escolha **Conectar a uma GitHub conta diferente** e, em seguida, escolha **Conectar GitHub** a. Continue na etapa 8.
1. Siga as instruções na página de **login** para fazer login com seu nome de GitHub usuário ou e-mail e senha.
1. Na página para **Autorizar aplicativo**, escolha **Autorizar aplicativo**.
1. Na página CodeDeploy **Criar implantação**, escolha **Cancelar**.
1. Chame o **create-deployment** comando para implantar a revisão do seu GitHub repositório na instância, onde:
+ *repository*é o nome GitHub da sua conta, seguido por uma barra (`/`), seguida pelo nome do seu repositório (`CodeDeployGitHubDemo`), por exemplo,. `MyGitHubUserName/CodeDeployGitHubDemo`
Caso não tenha certeza do valor que deve ser usado ou se quiser especificar um repositório diferente:
1. Em uma guia separada do navegador, acesse seu [GitHub painel](https://github.com/dashboard).
1. Em **Seus repositórios**, passe o ponteiro do mouse sobre o nome do repositório de destino. Uma dica de ferramenta aparece, exibindo o nome GitHub do usuário ou da organização, seguido por uma barra (`/`), seguida pelo nome do repositório. Este é o valor a ser usado.
**nota**
Se o nome do repositório de destino não aparecer em **Seus repositórios**, use a GitHub caixa **Pesquisar** para encontrar o repositório de destino e o nome de GitHub usuário ou organização correspondente.
+ *commit-id*é o commit associado à versão da revisão do aplicativo que você enviou para o seu repositório (por exemplo,`f835159a...528eb76f`).
Caso não tenha certeza do valor que deve ser usado:
1. Em uma guia separada do navegador, acesse seu [GitHub painel](https://github.com/dashboard).
1. Em **Your repositories (Seus repositórios)**, selecione **CodeDeployGitHubDemo**.
1. Na lista de confirmações, encontre a ID da confirmação associada ao envio da revisão do seu aplicativo para GitHub. Em geral, esse ID tem 40 caracteres de comprimento e é formado por letras e números. (Não use a versão mais curta do ID de confirmação, que é normalmente os 10 primeiros caracteres da versão mais longa.) Use esse valor.
Se você estiver trabalhando em uma máquina Linux, macOS ou Unix local:
```
aws deploy create-deployment \
--application-name CodeDeployGitHubDemo-App \
--deployment-config-name CodeDeployDefault.OneAtATime \
--deployment-group-name CodeDeployGitHubDemo-DepGrp \
--description "My GitHub deployment demo" \
--github-location repository=repository,commitId=commit-id
```
Se estiver trabalhando em uma máquina Windows local:
```
aws deploy create-deployment --application-name CodeDeployGitHubDemo-App --deployment-config-name CodeDeployDefault.OneAtATime --deployment-group-name CodeDeployGitHubDemo-DepGrp --description "My GitHub deployment demo" --github-location repository=repository,commitId=commit-id
```
# Etapa 7: monitorar e verificar a implantação
Nesta etapa, você usará o CodeDeploy console ou o AWS CLI para verificar o sucesso da implantação. Você usará seu navegador da Web para visualizar a página da Web que foi implantada na instância que você criou ou configurou.
**nota**
Se estiver implantando em uma instância do Ubuntu Server, use sua própria estratégia de teste para determinar se a revisão implantada funciona conforme esperado na instância e depois continue na próxima etapa.
**Para monitorar e verificar a implantação (console)**
1. No painel de navegação, expanda a opção **Implantar** e escolha **Implantações**.
1. **Na lista de implantações, procure a linha com um valor de **aplicativo** de **CodeDeployGitHubDemo-App** e um valor de **grupo de implantação** de CodeDeployGitHubDemo -. DepGrp** Se **Bem-sucedido** ou **Falha** não aparecer na coluna **Status**, clique no botão **Atualizar** periodicamente.
1. Se **Falha** aparecer na coluna **Status**, siga as instruções em [Exibir detalhes da instância (console)](instances-view-details.md#instances-view-details-console) para solucionar problemas com a implantação.
1. Se **Bem-sucedido** aparecer na coluna **Status**, você poderá verificar a implantação no seu navegador da Web. Nossa revisão de amostra implanta uma única página da Web na instância. Se estiver implantando em uma instância do Amazon EC2, no seu navegador da Web, acesse `http://public-dns` para a instância (por exemplo, `http://ec2-01-234-567-890.compute-1.amazonaws.com`).
1. Se conseguir ver a página da Web, parabéns\$1 Agora que você usou com sucesso AWS CodeDeploy para implantar uma revisão do GitHub, você pode pular para[Etapa 8: Limpeza](tutorials-github-clean-up.md).
**Para monitorar e verificar a implantação (CLI)**
1. Chame o comando **list-deployments** para obter o ID de implantação do aplicativo chamado `CodeDeployGitHubDemo-App` e o grupo de implantação chamado `CodeDeployGitHubDemo-DepGrp`:
```
aws deploy list-deployments --application-name CodeDeployGitHubDemo-App --deployment-group-name CodeDeployGitHubDemo-DepGrp --query "deployments" --output text
```
1. Chame o comando **get-deployment**, fornecendo o ID de implantação na saída do comando **list-deployments**:
```
aws deploy get-deployment --deployment-id deployment-id --query "deploymentInfo.[status, creator]" --output text
```
1. Se **Falha** for retornado, siga as instruções em [Exibir detalhes da instância (console)](instances-view-details.md#instances-view-details-console) para solucionar a implantação.
1. Se **Bem-sucedido** for retornado, você poderá tentar verificar a implantação no seu navegador da Web. Nossa revisão de amostra é uma única página da Web implantada na instância. Se você estiver implantando em uma instância do Amazon EC2, poderá visualizar essa página no seu navegador da Web acessando `http://public-dns` para a instância do Amazon EC2 (por exemplo, `http://ec2-01-234-567-890.compute-1.amazonaws.com`).
1. Se conseguir ver a página da Web, parabéns\$1 Você usou com sucesso AWS CodeDeploy para implantar a partir do seu GitHub repositório.
# Etapa 8: Limpeza
Para evitar cobranças adicionais pelos recursos usados durante esse tutorial, você deve encerrar a instância do Amazon EC2 e seus recursos associados. Opcionalmente, você pode excluir os registros de componentes de implantação do CodeDeploy associados a esse tutorial. Se você estava usando um GitHub repositório apenas para este tutorial, você também pode excluí-lo agora.
## Para excluir uma CloudFormation pilha (se você usou o CloudFormation modelo para criar uma instância do Amazon EC2)
1. Faça login no Console de gerenciamento da AWS e abra o CloudFormation console em [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/).
1. Na coluna **Stacks (Pilhas)** escolha a pilha que começa com `CodeDeploySampleStack`.
1. Escolha **Excluir**.
1. Quando solicitado, escolha **Excluir pilha**. A instância do Amazon EC2 e o perfil de serviço e o perfil de instância do IAM associados são excluídos.
## Para cancelar o registro manualmente e limpar uma instância local (caso você tenha provisionado uma instância local)
1. Use o AWS CLI para chamar o comando [de cancelamento de registro](https://docs.aws.amazon.com/cli/latest/reference/deploy/deregister.html) na instância local representada aqui por *your-instance-name* e na região associada por: *your-region*
```
aws deploy deregister --instance-name your-instance-name --no-delete-iam-user --region your-region
```
1. Na instância on-premises, chame o comando [desinstalar](https://docs.aws.amazon.com/cli/latest/reference/deploy/uninstall.html):
```
aws deploy uninstall
```
## Para encerrar manualmente uma instância do Amazon EC2 (caso você tenha iniciado manualmente uma instância do Amazon EC2)
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon EC2 em. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)
1. No painel de navegação, em **Instâncias**, escolha **Instâncias**.
1. Marque a caixa ao lado da instância do Amazon EC2 que você deseja encerrar. No menu **Ações**, selecione **Estado da instância** e escolha **Encerrar**.
1. Quando solicitado, escolha **Sim, Encerrar**.
## Para excluir os registros do componente de CodeDeploy implantação
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. Selecione **CodeDeployGitHubDemo-App**.
1. Selecione **Excluir aplicativo**.
1. Quando solicitado, digite **Delete** e escolha **Excluir**.
## Para excluir seu GitHub repositório
[Consulte [Excluindo um repositório na GitHub ajuda](https://help.github.com/articles/deleting-a-repository/).](https://help.github.com)