Pré-requisitos Etapa 1: Configurar o grupo do IAM com as permissões de acesso necessárias Etapa 2: Criar um repositório no CodeCommit Etapa 3: Conectar o ambiente ao repositório remoto Etapa 4: Clonar o repositório remoto no ambiente Etapa 5: Adicionar arquivos ao repositório Etapa 6: Limpar

Tutorial do AWS CodeCommit para o AWS Cloud9

Você pode usar o tutorial do AWS CodeCommit para configurar um ambiente de desenvolvimento do AWS Cloud9 a fim de interagir com um repositório de código remoto no CodeCommit. O CodeCommit é um serviço de controle de código-fonte que pode ser usado para armazenar e gerenciar repositórios do Git com privacidade na Nuvem AWS. Para obter mais informações sobre o CodeCommit, consulte o Manual do usuário do AWS CodeCommit.

Seguindo este tutorial e criando este exemplo pode gerar cobranças em sua Conta da AWS. Isso inclui possíveis cobranças por serviços como o Amazon EC2 e CodeCommit. Para obter mais informações, consulte Definição de preço do Amazon EC2 e Definição de preço do AWS CodeCommit.

Pré-requisitos
Etapa 1: Configurar o grupo do IAM com as permissões de acesso necessárias
Etapa 2: criar um repositório no AWS CodeCommit
Etapa 3: Conectar o ambiente ao repositório remoto
Etapa 4: Clonar o repositório remoto no ambiente
Etapa 5: Adicionar arquivos ao repositório
Etapa 6: Limpar

Pré-requisitos

Antes de usar esse exemplo, verifique se suas configurações cumprem os requisitos a seguir.

É necessário ter um ambiente existente de desenvolvimento do AWS Cloud9 EC2 Este exemplo pressupõe que você já tem um ambiente do EC2 conectado a uma instância do Amazon EC2 que executa Amazon Linux ou Ubuntu Server. Caso tenha um tipo diferente de ambiente ou sistema operacional, poderá ser necessário adaptar as instruções desse exemplo para configurar ferramentas relacionadas. Para obter mais informações, consulte Criar um ambiente no AWS Cloud9.
Você tem o IDE do AWS Cloud9 para o ambiente existente já aberto. Ao abrir um ambiente o AWS Cloud9 abre o IDE para esse ambiente em um navegador da Web. Para obter mais informações, consulte Abrir um ambiente no AWS Cloud9.

Etapa 1: Configurar o grupo do IAM com as permissões de acesso necessárias

Suponha que suas credenciais da AWS estão associadas a um usuário administrador em sua Conta da AWS e você quer usar esse usuário para trabalhar com o CodeCommit. Avance para a Etapa 2: Criar um repositório no AWS CodeCommit.

Conclua essa etapa usando o AWS Management Console ou a interface da linha de comando da AWS (AWS CLI).

Configurar o grupo do IAM com as permissões de acesso necessárias usando o console

Faça login no AWS Management Console, se ainda não tiver feito.

Para esta etapa, recomendamos que faça login usando credenciais de um usuário administrador em sua Conta da AWS. Se isso não for possível, fale com o administrador de sua Conta da AWS.
Abra o console do IAM. Para fazer isso, na barra de navegação do console, selecione Serviços. Depois, selecione IAM.
Selecione Grupos.
Selecione o nome do grupo.
Na guia Permssões, em Políticas gerenciadas, selecione Anexar política.
Na lista de nomes de políticas, selecione uma das seguintes caixas:
- Selecione AWSCodeCommitPowerUser para acessar todas as funcionalidades do CodeCommit e recursos relacionados ao repositório. No entanto, isso não permite que você exclua repositórios do CodeCommit nem crie ou exclua recursos relacionados ao repositório em outros Serviços da AWS, como o Amazon CloudWatch Events.
- Selecione AWSCodeCommitFullAccess para obter controle total sobre os repositórios do CodeCommit e os recursos relacionados na Conta da AWS. Isso inclui a capacidade de excluir repositórios.
Se nenhum desses nomes de política for encontrado na lista, insira os nomes das políticas na caixa Filtrar para exibi-las.
Escolha Attach Policy.

Para ver a lista de permissões de acesso que essas políticas gerenciadas pela AWS fornecem a um grupo, consulte Políticas (predefinidas) gerenciadas pela AWS para o AWS CodeCommit no Guia do usuário do AWS CodeCommit.

Avance até a Etapa 2: Criar um repositório no AWS CodeCommit.

Configurar o grupo do IAM com as permissões de acesso necessárias usando a AWS CLI

Execute o comando attach-group-policy do IAM, especificando o nome do grupo e o nome do recurso da Amazon (ARN) da política gerenciada pela AWS que descreve as permissões de acesso necessárias. A sintaxe é a seguinte.


aws iam attach-group-policy --group-name MyGroup --policy-arn POLICY_ARN

No comando anterior, substitua MyGroup pelo nome do grupo. Substitua POLICY_ARN pelo ARN da política gerenciada pela AWS:

arn:aws:iam::aws:policy/AWSCodeCommitPowerUser para acessar todas as funcionalidades do CodeCommit e recursos relacionados ao repositório. No entanto, não permite que você exclua repositórios do CodeCommit nem crie ou exclua recursos relacionados ao repositório em outros Serviços da AWS, como o Amazon CloudWatch Events.
arn:aws:iam::aws:policy/AWSCodeCommitFullAccess para obter controle total sobre os repositórios do CodeCommit e os recursos relacionados na Conta da AWS. Isso inclui a capacidade de excluir repositórios.

Etapa 2: Criar um repositório no CodeCommit

Nesta etapa, você criará um repositório de código remoto no CodeCommit usando o console dele.

Se você já tiver um repositório do CodeCommit, avance até a Etapa 3: Conectar o ambiente ao repositório remoto.

Conclua essa etapa usando o AWS Management Console ou a interface da linha de comando da AWS (AWS CLI).

Crie um repositório no CodeCommit usando o console

Suponha que você está conectado ao AWS Management Console como um usuário administrador desde a etapa anterior e não quer usar o usuário administrador para criar o repositório. Saia do AWS Management Console.
Abra o console do CodeCommit em https://console.aws.amazon.com/codecommit.
Na barra de navegação do console, use o seletor de região para selecionar a Região da AWS onde deseja criar o repositório. Por exemplo, US East (Ohio) [Leste dos EUA (Ohio)].
Se uma página de boas-vindas for exibida, escolha Get started. Caso contrário, selecione Criar repositório.
Na página Criar repositório, em Nome do repositório, insira um nome para o novo repositório (por exemplo, MyDemoCloud9Repo). Se escolher um nome diferente, substitua-o ao longo desse exemplo.
(Opcional) Em Descrição, insira algo sobre o repositório. Por exemplo, insira: This is a demonstration repository for the AWS Cloud9 sample.
Escolha Criar repositório. Um painel Conectar ao repositório é exibido. Selecione Fechar, uma vez que se conectará ao repositório de forma diferente mais adiante nesse tópico.

Avance até a Etapa 3: Conectar o ambiente ao repositório remoto.

Crie um repositório no CodeCommit usando a AWS CLI

Execute o comando AWS CodeCommit create-repository. Especifique o nome do repositório, uma descrição opcional e a Região da AWS onde o repositório será criado.


aws codecommit create-repository --repository-name MyDemoCloud9Repo --repository-description "This is a demonstration repository for the AWS Cloud9 sample." --region us-east-2

No comando anterior, substitua us-east-2 pelo ID da Região da AWS onde o repositório será criado. Para ver uma lista das regiões compatíveis, consulte AWS CodeCommit no Referência geral da Amazon Web Services.

Se decidiu usar um nome de repositório diferente, substitua-o ao longo desse exemplo.

Etapa 3: Conectar o ambiente ao repositório remoto

Nesta etapa, use o IDE do AWS Cloud9 para se conectar ao repositório do CodeCommit criado ou identificado na etapa anterior.

nota

Se preferir trabalhar com o Git por meio de uma interface visual, você poderá clonar o repositório remoto. Depois, você poderá adicionar arquivos usando o recurso Painel do Git que está disponível no IDE.

Conclua um dos conjuntos de procedimentos a seguir de acordo com o tipo do ambiente de desenvolvimento do AWS Cloud9.

Tipo de ambiente Siga esses procedimentos

Tipo de ambiente	Siga esses procedimentos
Ambiente EC2	Na sessão de terminal no IDE, execute os dois comandos a seguir: `git config --global credential.helper '!aws codecommit credential-helper $@' git config --global credential.UseHttpPath true` Para obter mais informações, consulte Etapa 2: Configurar o auxiliar de credenciais da AWS CLI no ambiente de desenvolvimento EC2 do AWS Cloud9 em Integrar o AWS Cloud9 ao AWS CodeCommit no Manual do usuário do AWS CodeCommit. Avance até a Etapa 4: Clonar o repositório remoto para o ambiente deste tópico.
Ambiente do SSH	Se o Git ainda não estiver instalado no ambiente, use uma sessão de terminal no IDE para instalá-lo. Para obter mais informações, consulte Etapa 2: Instalar o Git em Etapas de configuração para conexões SSH aos repositórios do AWS CodeCommit no Linux, macOS ou Unix no Guia do usuário do AWS CodeCommit. Conclua a Etapa 3: Configurar as credenciais no Linux, macOS ou Unix em Etapas de configuração para conexões SSH aos repositórios do AWS CodeCommit no Linux, macOS ou Unix no Manual do usuário do AWS CodeCommit. Ao ser instruído para fazer login no AWS Management Console e abrir o console do IAM, recomendamos que você faça login usando as credenciais de um usuário administrador na sua Conta da AWS. Se isso não for possível, fale com o administrador de sua Conta da AWS. Avance até a Etapa 4: Clonar o repositório remoto para o ambiente deste tópico.

Ambiente EC2

Na sessão de terminal no IDE, execute os dois comandos a seguir:
```
git config --global credential.helper '!aws codecommit credential-helper $@'
git config --global credential.UseHttpPath true
```
Para obter mais informações, consulte Etapa 2: Configurar o auxiliar de credenciais da AWS CLI no ambiente de desenvolvimento EC2 do AWS Cloud9 em Integrar o AWS Cloud9 ao AWS CodeCommit no Manual do usuário do AWS CodeCommit.
Avance até a Etapa 4: Clonar o repositório remoto para o ambiente deste tópico.

Ambiente do SSH

Se o Git ainda não estiver instalado no ambiente, use uma sessão de terminal no IDE para instalá-lo. Para obter mais informações, consulte Etapa 2: Instalar o Git em Etapas de configuração para conexões SSH aos repositórios do AWS CodeCommit no Linux, macOS ou Unix no Guia do usuário do AWS CodeCommit.
Conclua a Etapa 3: Configurar as credenciais no Linux, macOS ou Unix em Etapas de configuração para conexões SSH aos repositórios do AWS CodeCommit no Linux, macOS ou Unix no Manual do usuário do AWS CodeCommit.

Ao ser instruído para fazer login no AWS Management Console e abrir o console do IAM, recomendamos que você faça login usando as credenciais de um usuário administrador na sua Conta da AWS. Se isso não for possível, fale com o administrador de sua Conta da AWS.
Avance até a Etapa 4: Clonar o repositório remoto para o ambiente deste tópico.

Etapa 4: Clonar o repositório remoto no ambiente

Nesta etapa, você usará o IDE do AWS Cloud9 para clonar o repositório remoto no CodeCommit no ambiente.

Para clonar o repositório, execute o comando git clone. Substitua CLONE_URL pelo URL do clone do repositório.


git clone CLONE_URL

Para um ambiente EC2, forneça um URL de clonagem HTTPS que comece com https://. Para um ambiente SSH, forneça um URL de clonagem SSH que comece com ssh://.

Para obter o URL de clonagem completo do repositório, consulte Usar o console do AWS CodeCommit para exibir os detalhes do repositório no Manual do usuário do AWS CodeCommit.

Se seu repositório não tiver nenhum arquivo, uma mensagem de aviso será exibida, como: “You appear to have cloned an empty repository. This is expected.” (Parece que você clonou um repositório vazio. Isso é esperado.). Você cuidará disso mais tarde.

Etapa 5: Adicionar arquivos ao repositório

Nesta etapa, você criará três arquivos simples no repositório clonado no ambiente do AWS Cloud9. Depois, adicione os arquivos à área de preparação do Git no repositório clonado. Por fim, confirme os arquivos preparados e envie a confirmação para o repositório remoto no CodeCommit.

Se o repositório clonado já contém arquivos, pule o restante desse exemplo.

Para adicionar arquivos ao repositório

Criar um novo arquivo. Na barra de menus, selecione Arquivo, Novo arquivo.
Insira o conteúdo a seguir no arquivo, depois selecione Arquivo e Salvar para salvar o arquivo como bird.txt no diretório MyDemoCloud9Repo no ambiente do AWS Cloud9.
```
bird.txt
--------
Birds are a group of endothermic vertebrates, characterized by feathers,
toothless beaked jaws, the laying of hard-shelled eggs, a high metabolic
rate, a four-chambered heart, and a lightweight but strong skeleton.
```
nota
Para confirmar que está salvando o arquivo no diretório correto, na caixa de diálogo Salvar como, selecione a pasta MyDemoCloud9Repo. Depois, certifique-se de que Pasta exiba /MyDemoCloud9Repo.

Crie mais dois arquivos, chamados insect.txt e reptile.txt, com o conteúdo a seguir. Salve os arquivos no mesmo diretório MyDemoCloud9Repo.


insect.txt
----------
Insects are a class of invertebrates within the arthropod phylum that
have a chitinous exoskeleton, a three-part body (head, thorax, and abdomen),
three pairs of jointed legs, compound eyes, and one pair of antennae.


reptile.txt
-----------
Reptiles are tetrapod (four-limbed vertebrate) animals in the class
Reptilia, comprising today's turtles, crocodilians, snakes,
amphisbaenians, lizards, tuatara, and their extinct relatives.

No terminal, execute o comando cd para alternar para o diretório MyDemoCloud9Repo.
```
cd MyDemoCloud9Repo
```
Confirme se os arquivos foram salvos com sucesso no diretório MyDemoCloud9Repo executando o comando git status. Todos os três arquivos serão listados como arquivos não rastreados.
```
Untracked files:
  (use "git add <file>..." to include in what will be committed)

        bird.txt
        insect.txt
        reptile.txt
```
Adicione os arquivos à área de preparação do Git executando o comando git add.
```
git add --all
```
Confirme se os arquivos foram adicionados com sucesso à área de preparação do Git executando o comando git status novamente. Todos os três arquivos agora estão listados como alterações na confirmação.
```
Changes to be committed:
  (use "git rm --cached <file>..." to unstage)

        new file:   bird.txt
        new file:   insect.txt
        new file:   reptile.txt
```
Confirme os arquivos preparados executando o comando git commit.
```
git commit -m "Added information about birds, insects, and reptiles."
```
Envie a confirmação para o repositório remoto no CodeCommit executando o comando git push.
```
git push -u origin master
```
Confirme se os arquivos foram enviado com êxito. Abra o console do CodeCommit, se ainda não estiver aberto, em https://console.aws.amazon.com/codecommit.
Na barra de navegação superior, perto da borda direita, selecione a Região da AWS onde o repositório foi criado; por exemplo, US East (Ohio) [Leste dos EUA (Ohio)].
Na página do Dashboard (Painel), selecione MyDemoCloud9Repo. Os três arquivos são exibidos.

Para continuar a testar o repositório do CodeCommit, consulte Browse the Contents of Your Repository (Navegar pelo conteúdo do repositório) no Manual do usuário do AWS CodeCommit.

Se for iniciante no Git e não quiser bagunçar seu repositório do CodeCommit, faça um teste com um exemplo de repositório Git no site Try Git.

Etapa 6: Limpar

Para evitar cobranças contínuas na Conta da AWS, ao terminar de usar esse exemplo, exclua o repositório do CodeCommit. Para obter instruções, consulte Delete an AWS CodeCommit Repository no Guia do usuário do AWS CodeCommit.

Exclua também o ambiente. Para obter instruções, consulte Exclusão de um ambiente.

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

AWS CLI e tutorial aws-shell

Tutorial do Amazon DynamoDB