AWS Cloud9 não está mais disponível para novos clientes. Os clientes atuais do AWS Cloud9 podem continuar usando o serviço normalmente. [Saiba mais](https://aws.amazon.com/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/) 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á. # AWS CodeCommit tutorial 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 no CodeCommit. 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 CodeCommit, consulte o [Guia AWS CodeCommit do usuário](https://docs.aws.amazon.com/codecommit/latest/userguide/). Seguir este tutorial e criar essa 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](https://aws.amazon.com/ec2/pricing/) e [Definição de preço do AWS CodeCommit](https://aws.amazon.com/codecommit/pricing/). + [Pré-requisitos](#sample-codecommit-prereqs) + [Etapa 1: Configurar o grupo do IAM com as permissões de acesso necessárias](#sample-codecommit-permissions) + [Etapa 2: criar um repositório no AWS CodeCommit](#sample-codecommit-create-repo) + [Etapa 3: Conectar o ambiente ao repositório remoto](#sample-codecommit-connect-repo) + [Etapa 4: Clonar o repositório remoto no ambiente](#sample-codecommit-clone-repo) + [Etapa 5: Adicionar arquivos ao repositório](#sample-codecommit-add-files) + [Etapa 6: Limpar](#sample-codecommit-clean-up) ## Pré-requisitos Antes de usar esse exemplo, verifique se suas configurações cumprem os requisitos a seguir. + **Você deve ter um ambiente de desenvolvimento AWS Cloud9 EC2 existente.** 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 [Criando um ambiente em AWS Cloud9](create-environment.md). + **Você tem o AWS Cloud9 IDE para o ambiente existente já aberto.** Quando você abre um ambiente, AWS Cloud9 abre o IDE desse ambiente em seu navegador da web. Para obter mais informações, consulte [Abrindo um ambiente em AWS Cloud9](open-environment.md). ## 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](#sample-codecommit-create-repo) no. AWS CodeCommit Conclua essa etapa usando o [Console de gerenciamento da AWS](#sample-codecommit-permissions-console) ou a [interface da linha de comando da AWS (AWS CLI)](#sample-codecommit-permissions-cli). ### Configurar o grupo do IAM com as permissões de acesso necessárias usando o console 1. Faça login no Console de gerenciamento da AWS, se você ainda não estiver conectado. 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 . 1. Abra o console do IAM. Para fazer isso, na barra de navegação do console, selecione **Serviços**. Depois, selecione **IAM**. 1. Selecione **Grupos**. 1. Selecione o nome do grupo. 1. Na guia **Permssões**, em **Políticas gerenciadas**, selecione **Anexar política**. 1. Na lista de nomes de políticas, selecione uma das seguintes caixas: + Selecione **AWSCodeCommitPowerUser**para 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 outros, Serviços da AWS como o Amazon Events. CloudWatch + Selecione **AWSCodeCommitFullAccess**para ter controle total sobre CodeCommit repositórios e recursos relacionados no 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. 1. 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](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control-iam-identity-based-access-control.html#managed-policies) no *Guia do AWS CodeCommit usuário*. Vá para a [Etapa 2: Criar um repositório](#sample-codecommit-create-repo) no. AWS CodeCommit ### Configure seu grupo do IAM com as permissões de acesso necessárias usando o AWS CLI Execute o `attach-group-policy` comando IAM, especificando o nome do grupo e o Amazon Resource Name (ARN) da política gerenciada que descreve AWS 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. `POLICY_ARN`Substitua pelo ARN da política AWS gerenciada: + `arn:aws:iam::aws:policy/AWSCodeCommitPowerUser`para ter acesso a 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 outros, Serviços da AWS como o Amazon Events. CloudWatch + `arn:aws:iam::aws:policy/AWSCodeCommitFullAccess`para controle total sobre CodeCommit repositórios e recursos relacionados no Conta da AWS. Isso inclui a capacidade de excluir repositórios. 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](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control-iam-identity-based-access-control.html#managed-policies) no *Guia do AWS CodeCommit usuário*. ## Etapa 2: criar um repositório no CodeCommit Nesta etapa, você cria um repositório de código remoto CodeCommit usando o CodeCommit console. Se você já tiver um CodeCommit repositório, vá para a [Etapa 3: Conecte seu ambiente ao repositório remoto](#sample-codecommit-connect-repo). Conclua essa etapa usando o [Console de gerenciamento da AWS](#sample-codecommit-create-repo-console) ou a [interface da linha de comando da AWS (AWS CLI)](#sample-codecommit-create-repo-cli). ### Crie um repositório CodeCommit usando o console 1. Suponha que você esteja conectado ao Console de gerenciamento da AWS como usuário administrador da etapa anterior e não queira usar o usuário administrador para criar o repositório. Em seguida, saia do Console de gerenciamento da AWS. 1. Abra o CodeCommit console, em [https://console.aws.amazon.com/codecommit](https://console.aws.amazon.com/codecommit). 1. 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)]. 1. Se uma página de boas-vindas for exibida, escolha **Get started**. Caso contrário, selecione **Criar repositório**. 1. 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. 1. (Opcional) Em **Descrição**, insira algo sobre o repositório. Por exemplo, insira: `This is a demonstration repository for the AWS Cloud9 sample.` 1. 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](#sample-codecommit-connect-repo). ### 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 o local Região da AWS para criar o repositório. ``` 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](https://docs.aws.amazon.com/general/latest/gr/rande.html#codecommit_region) 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, 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](source-control-gitpanel.md) 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** | | --- | --- | | Ambiente EC2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/cloud9/latest/user-guide/sample-codecommit.html) | | Ambiente do SSH | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/cloud9/latest/user-guide/sample-codecommit.html) | ## 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 completo do clone do repositório, consulte [Usar o AWS CodeCommit console para visualizar os detalhes do repositório no Guia](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-view-repository-details.html#how-to-view-repository-details-console) do AWS CodeCommit usuário.* 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, você confirma os arquivos preparados e envia o commit para o seu repositório remoto em. CodeCommit Se o repositório clonado já contém arquivos, pule o restante desse exemplo. **Para adicionar arquivos ao repositório** 1. Criar um novo arquivo. Na barra de menus, selecione **Arquivo**, **Novo arquivo**. 1. Insira o conteúdo a seguir no arquivo e escolha **Arquivo**, **Salvar** para salvar o arquivo como `bird.txt` no `MyDemoCloud9Repo` diretório do seu AWS Cloud9 ambiente. ``` 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`. 1. 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. ``` 1. No terminal, execute o comando **`cd`** para alternar para o diretório `MyDemoCloud9Repo`. ``` cd MyDemoCloud9Repo ``` 1. 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 ..." to include in what will be committed) bird.txt insect.txt reptile.txt ``` 1. Adicione os arquivos à área de preparação do Git executando o comando **`git add`**. ``` git add --all ``` 1. 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 ..." to unstage) new file: bird.txt new file: insect.txt new file: reptile.txt ``` 1. Confirme os arquivos preparados executando o comando **`git commit`**. ``` git commit -m "Added information about birds, insects, and reptiles." ``` 1. Envie o commit para seu repositório remoto CodeCommit executando o **`git push`**comando. ``` git push -u origin master ``` 1. Confirme se os arquivos foram enviado com êxito. Abra o CodeCommit console, se ele ainda não estiver aberto, em [https://console.aws.amazon.com/codecommit](https://console.aws.amazon.com/codecommit). 1. Na barra de navegação superior, perto da borda direita, escolha Região da AWS onde você criou o repositório (por exemplo, **Leste dos EUA (Ohio))**. 1. Na página **Painel**, escolha **MyDemoCloud9Repo**. Os três arquivos são exibidos. *Para continuar experimentando com seu CodeCommit repositório, consulte [Navegar pelo conteúdo do seu repositório no Guia](https://docs.aws.amazon.com/codecommit/latest/userguide/getting-started-cc.html#getting-started-cc-browse) 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 Git site Try. Git](https://try.github.io/) ## Etapa 6: limpar Para evitar cobranças contínuas Conta da AWS depois de terminar de usar essa amostra, exclua o CodeCommit repositório. Para obter instruções, consulte [Excluir um AWS CodeCommit repositório](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-delete-repository.html) no *Guia do AWS CodeCommit usuário*. Exclua também o ambiente. Para obter instruções, consulte [Exclusão de um ambiente](delete-environment.md).