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

AWS CodeCommittutorial para AWS Cloud9

Você pode usar o AWS CodeCommit tutorial para configurar um ambiente de AWS Cloud9 desenvolvimento para interagir com um repositório de código remoto noCodeCommit. CodeCommité um serviço de controle de código-fonte que você pode usar para armazenar e gerenciar Git repositórios de forma privada no. Nuvem AWS Para obter mais informações sobre o CodeCommit, consulte o Guia do usuário do AWS CodeCommit.

Seguir este tutorial e criar esta amostra pode resultar em cobranças para vocêConta da AWS. Isso inclui possíveis cobranças por serviços como 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 AWS credenciais estejam associadas a um usuário administrador em seu Conta da AWS e você queira usar esse usuário para trabalhar com. CodeCommit Em seguida, vá para a Etapa 2: Criar um repositório em. 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 Services (Serviços). Depois, selecione IAM.
Selecione Groups (Grupos).
Selecione o nome do grupo.
Na guia Permissions (Permissões), em Managed Policies (Políticas gerenciadas), selecione Attach Policy (Anexar política).
Na lista de nomes de políticas, selecione uma das seguintes caixas:
- Selecione AWSCodeCommitPowerUserpara acessar todas as funcionalidades CodeCommit e recursos relacionados ao repositório. No entanto, isso não permite que você exclua CodeCommit repositórios nem crie ou exclua recursos relacionados ao repositório em outrosServiços da AWS, como o Amazon Events. CloudWatch
- Selecione AWSCodeCommitFullAccesspara ter controle total sobre CodeCommit repositórios e recursos relacionados noConta 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 Filter (Filtrar) para exibi-las.
Escolha Attach Policy.

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

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/AWSCodeCommitPowerUserpara acessar todas as funcionalidades CodeCommit e recursos relacionados ao repositório. No entanto, ele não permite que você exclua CodeCommit repositórios nem crie ou exclua recursos relacionados ao repositório em outrosServiços da AWS, como o Amazon Events. CloudWatch
arn:aws:iam::aws:policy/AWSCodeCommitFullAccesspara controle total sobre CodeCommit repositórios e recursos relacionados noConta da AWS. Isso inclui a capacidade de excluir repositórios.

Etapa 2: criar um repositório no CodeCommit

Nesta etapa, crie um repositório de código remoto no CodeCommit usando o console do CodeCommit.

Se você já possuir 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 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 Create repository (Criar repositório).
Na página Create repository (Criar repositório), em Repository name (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 Description (Descrição), insira algo sobre o repositório. Por exemplo, insira: This is a demonstration repository for the AWS Cloud9 sample.
Escolha Create repository (Criar repositório). Um painel Connect to your repository (Conectar ao repositório) é exibido. Selecione Close (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 CodeCommit usando o 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 obter uma lista das regiões suportadas, consulte AWS CodeCommitno 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, você usa o AWS Cloud9 IDE para se conectar ao CodeCommit repositório que você criou ou identificou 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ê usa o AWS Cloud9 IDE para clonar o repositório remoto CodeCommit em seu 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 último, você confirma os arquivos estáticos e envia o commit para o seu repositório remoto. 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 File (Arquivo), New File (Novo arquivo).
Insira o conteúdo a seguir no arquivo, depois selecione File (Arquivo) e Save (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 Save As (Salvar como), selecione a pasta MyDemoCloud9Repo. Depois, certifique-se de que Folder (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 o commit para seu repositório remoto CodeCommit executando o git pushcomando.
```
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 Painel, escolha MyDemoCloud9Repo. Os três arquivos são exibidos.

Para continuar experimentando seu CodeCommit repositório, consulte Navegar pelo conteúdo do seu repositório no Guia do AWS CodeCommit usuário.

Se você é novato Git e não quer bagunçar seu CodeCommit repositório, experimente um repositório de amostra no site do Git Try. Git

Etapa 6: Limpar

Para evitar cobranças contínuas Conta da AWS após terminar de usar esse exemplo, exclua o CodeCommit repositório. Para obter instruções, consulte Excluir um AWS CodeCommit repositório no Guia do AWS CodeCommit usuário.

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 CLIe AWS CloudShell tutorial

Tutorial do Amazon DynamoDB