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á.
# Introdução
A maneira mais fácil de começar CodeCommit é seguir as etapas em[Começando com CodeCommit ](getting-started-cc.md). Se você é novo no Git and CodeCommit, você também deve considerar seguir as etapas em. [Começando com o Git e CodeCommit](getting-started.md) Isso ajuda você a se familiarizar com CodeCommit as noções básicas do uso do Git ao interagir com seus repositórios. CodeCommit
Você também pode acompanhar o tutorial em [Simple Pipeline Walkthrough com CodePipeline e CodeCommit](https://docs.aws.amazon.com/codepipeline/latest/userguide/getting-started-cc.html) aprender a usar seu CodeCommit repositório como parte de um pipeline de entrega contínua.
Os tutoriais nesta seção foram escritos supondo que você concluiu os [pré-requisitos e a configuração](setting-up.md), incluindo:
+ Atribuir permissões ao usuário do IAM.
+ Configuração do gerenciamento de credenciais para conexões HTTPS ou SSH na máquina local que está sendo usada para este tutorial.
+ Configurando o AWS CLI se você quiser usar a linha de comando ou o terminal para todas as operações, incluindo a criação do repositório.
**Topics**
+ [
# Começando com AWS CodeCommit
](getting-started-cc.md)
+ [
# Começando com o Git e AWS CodeCommit
](getting-started.md)
# Começando com AWS CodeCommit
Este tutorial mostra como usar alguns CodeCommit recursos principais. Primeiro, crie um repositório e confirme algumas alterações nele. Depois disso, procure os arquivos e visualize as alterações. Também é possível criar uma solicitação pull para que outras pessoas possam analisar e comentar as alterações em seu código.
Se você quiser migrar o código existente para CodeCommit, consulte[Migração para o AWS CodeCommit](how-to-migrate-repository.md).
Se você não está familiarizado com o Git, considere concluir [Começando com o Git e CodeCommit](getting-started.md) também. Depois de concluir esses tutoriais, você deve ter prática suficiente para começar a usar CodeCommit em seus próprios projetos e em ambientes de equipe.
O CodeCommit console inclui informações úteis em um painel dobrável que você pode abrir a partir do ícone de informações (![\[The information icon that opens and closes the help panel on a page.\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-info-icon.png)) ou de qualquer link de **informações** na página. Você pode fechar esse painel a qualquer momento.
![\[Visualização de orientações adicionais no console\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-guidance-open.png)
O CodeCommit console também fornece uma maneira de pesquisar rapidamente seus recursos, como repositórios, criar projetos, aplicativos de implantação e pipelines. Selecione **Go to resource (Acessar recurso)** ou pressione a tecla `/` e digite o nome do recurso. Qualquer correspondência aparecerá na lista. As pesquisas não diferenciam letras maiúsculas de minúsculas. Só é possível ver recursos para os quais você tem permissão de visualizar. Para obter mais informações, consulte [Visualizar recursos no console](auth-and-access-control-iam-identity-based-access-control.md#console-resources).
## Pré-requisitos
Antes de começar, conclua os [pré-requisitos e configuração](setting-up.md), incluindo:
+ Atribuir permissões ao usuário do IAM.
+ Configuração de gerenciamento de credenciais para conexões HTTPS ou SSH na máquina local que você usar para este tutorial.
+ Configurando o AWS CLI se você quiser usar a linha de comando ou o terminal para todas as operações, inclusive para criar o repositório.
**Topics**
+ [
## Pré-requisitos
](#getting-started-cc-prereqs)
+ [
## Etapa 1: criar um CodeCommit repositório
](#getting-started-cc-create-repo)
+ [
## Etapa 2: adicionar arquivos ao repositório
](#getting-started-cc-add)
+ [
## Etapa 3: navegar pelos conteúdos do seu repositório
](#getting-started-cc-browse)
+ [
## Etapa 4: criar e colaborar em uma solicitação pull
](#getting-started-cc-pullrequest)
+ [
## Etapa 5: limpar
](#getting-started-cc-clean-up)
+ [
## Etapa 6: próximas etapas
](#getting-started-cc-next)
## Etapa 1: criar um CodeCommit repositório
Você pode usar o CodeCommit console para criar um CodeCommit repositório. Se você já tem um repositório que deseja usar para este tutorial, ignore esta etapa.
**nota**
Dependendo do seu uso, você poderá ser cobrado pela criação ou acesso a um repositório. Para obter mais informações, consulte [Preços](https://aws.amazon.com/codecommit/pricing) na página de informações CodeCommit do produto.
**Para criar o CodeCommit repositório**
1. Abra o CodeCommit console em [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home).
1. Use o seletor de região para escolher Região da AWS onde você deseja criar o repositório. Para obter mais informações, consulte [Regiões e endpoints de conexão do Git](regions.md).
1. Na página **Repositories (Repositórios)**, selecione **Create repository (Criar repositório)**.
1. Na página **Create repository (Criar repositório)**, em **Repository name (Nome do repositório)**, insira um nome para o repositório (por exemplo **MyDemoRepo**).
**nota**
Os nomes de repositório diferenciam letras maiúsculas de minúsculas e não podem ter mais de 100 caracteres. Para saber mais, consulte [Limites](limits.md#limits-repository-names).
1. (Opcional) Em **Description (Descrição)**, insira uma descrição, (por exemplo, **My demonstration repository**). Isso pode ajudar você e outros usuários a identificar a finalidade do repositório.
1. (Opcional) Escolha **Adicionar tag** para adicionar uma ou mais tags de repositório (um rótulo de atributo personalizado que ajuda você a organizar e gerenciar seus AWS recursos) ao seu repositório. Para obter mais informações, consulte [Marcando repositórios em AWS CodeCommit](how-to-tag-repository.md).
1. (Opcional) Expanda **Configuração adicional** para especificar se você deseja usar a chave padrão Chave gerenciada pela AWS ou sua própria chave gerenciada pelo cliente para criptografar e descriptografar os dados nesse repositório. Se você optar por usar sua própria chave gerenciada pelo cliente, deverá garantir que ela esteja disponível no Região da AWS local em que você está criando o repositório e que a chave esteja ativa. Para obter mais informações, consulte [AWS Key Management Service e criptografia para AWS CodeCommit repositórios](encryption.md).
1. (Opcional) Selecione **Ativar Amazon CodeGuru Reviewer para Java e Python** se esse repositório contiver código Java ou Python e você quiser que o revisor analise esse código. CodeGuru CodeGuru O revisor usa vários modelos de aprendizado de máquina para encontrar defeitos no código e sugerir automaticamente melhorias e correções nas pull requests. Para obter mais informações, consulte o Guia do usuário do Amazon CodeGuru Reviewer.
1. Escolha **Criar**.
![\[Criação de um repositório no console\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-create-repository.png)
**nota**
Se você usar outro nome que não seja `MyDemoRepo` para o repositório, use-o nas etapas restantes deste tutorial.
Quando o repositório é aberto, você vê informações sobre como adicionar arquivos diretamente do CodeCommit console.
## Etapa 2: adicionar arquivos ao repositório
Você pode adicionar arquivos ao repositório da seguinte forma:
+ Criação de um arquivo no CodeCommit console. Se você criar o primeiro arquivo para um repositório no console, uma ramificação chamada *principal* será criada para você. Essa ramificação é a ramificação padrão do seu repositório.
+ Fazendo upload de um arquivo do seu computador local usando o CodeCommit console. Se você criar o primeiro arquivo para um repositório no console, uma ramificação chamada *principal* será criada para você. Essa ramificação é a ramificação padrão do seu repositório.
+ Usar um cliente Git para clonar o repositório em seu computador local e, em seguida, adicionar, confirmar e enviar arquivos para o repositório. CodeCommit Uma ramificação será criada para você como parte da primeira confirmação do Git, definida como a ramificação padrão para seu repositório. O nome da ramificação é a escolha padrão do seu cliente Git. Considere configurar seu cliente Git para usar *principal* como nome da ramificação inicial.
**nota**
Você pode criar ramificações e alterar a ramificação padrão de um repositório a qualquer momento. Para obter mais informações, consulte [Trabalhando com ramificações em AWS CodeCommit repositórios](branches.md).
A maneira mais simples de começar é abrir o CodeCommit console e adicionar um arquivo. Ao fazer isso, você também cria uma ramificação padrão para seu repositório chamada *principal*. Para obter instruções sobre como adicionar um arquivo e criar uma primeira confirmação em um repositório usando o. AWS CLI, consulte [Criar a primeira confirmação para um repositório usando o. AWS CLI](how-to-create-commit.md#create-first-commit)
**Como adicionar um arquivo a um repositório**
1. Na barra de navegação do repositório, escolha **Code (Código)**.
1. Escolha **Add file (Adicionar arquivo)** e escolha se deseja criar um arquivo ou fazer upload de um arquivo do seu computador. Este tutorial mostra como realizar as duas ações.
1. Para adicionar um arquivo, faça o seguinte:
1. Na lista suspensa de ramificações, escolha a ramificação onde deseja adicionar o arquivo. A ramificação padrão é selecionada automaticamente para você. No exemplo mostrado aqui, a ramificação padrão é nomeada*main*. Se você deseja adicionar o arquivo a outra ramificação, escolha uma ramificação diferente.
1. Em **File name (Nome do arquivo)**, insira um nome para o arquivo. No editor de código, insira o código do arquivo.
1. Em **Author name (Nome do autor)**, insira o nome a ser exibido para outros usuários do repositório.
1. Em **Email address (Endereço de e-mail)**, forneça um endereço de e-mail.
1. (Opcional) Em **Commit message (Mensagem de confirmação)**, insira uma mensagem breve. Embora seja opcional, recomendamos que você adicione uma mensagem de confirmação para ajudar os membros da equipe a entender porque o arquivo foi adicionado. Se você não inserir uma mensagem de confirmação, uma mensagem padrão será usada.
1. Escolha **Commit changes (Confirmar alterações)**.
Para fazer upload de um arquivo, faça o seguinte:
+ Se você estiver fazendo upload de um arquivo, escolha o arquivo desejado.
![\[Uma visão do upload de um arquivo no console CodeCommit\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-commit-first-file.png)
+ Em **Author name (Nome do autor)**, insira o nome a ser exibido para outros usuários do repositório.
+ Em **Email address (Endereço de e-mail)**, forneça um endereço de e-mail.
+ (Opcional) Em **Commit message (Mensagem de confirmação)**, insira uma mensagem breve. Embora seja opcional, recomendamos que você adicione uma mensagem de confirmação para ajudar os membros da equipe a entender porque o arquivo foi adicionado. Se você não inserir uma mensagem de confirmação, uma mensagem padrão será usada.
+ Escolha **Commit changes (Confirmar alterações)**.
Para obter mais informações, consulte [Trabalhar com arquivos em repositórios do AWS CodeCommit](files.md).
Para usar um cliente Git para clonar o repositório, instale o Git no seu computador local e, em seguida, clone o repositório. CodeCommit Adicione alguns arquivos ao repositório e envie-os para o repositório do CodeCommit por push. Para uma introdução detalhada, experimente o [Começando com o Git e CodeCommit](getting-started.md). Se você estiver familiarizado com o Git, mas não tiver certeza de como fazer isso com um CodeCommit repositório, você pode ver exemplos e instruções em[Criar uma confirmação](how-to-create-commit.md), [Etapa 2: criação de um repositório local](getting-started.md#getting-started-set-up-folders) ou. [Conexão a um repositório](how-to-connect.md)
Depois de adicionar alguns arquivos ao CodeCommit repositório, você pode visualizá-los no console.
## Etapa 3: navegar pelos conteúdos do seu repositório
Você pode usar o CodeCommit console para revisar os arquivos em um repositório ou ler rapidamente o conteúdo de um arquivo. Isso ajuda a determinar qual ramificação deve ter o check-out feito ou se você deseja criar uma cópia local de um repositório.
**Como navegar no repositório**
1. Em **Repositórios**, escolha MyDemoRepo.
1. A página exibe o conteúdo na ramificação padrão do repositório. Para visualizar outra ramificação ou visualizar o código em uma tag específica, escolha a ramificação ou tag que deseja visualizar na lista. Na captura de tela a seguir, a exibição é definida como a ramificação **principal**.
![\[Navegar pelo conteúdo de um repositório\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-code-browse.png)
1. Para visualizar os conteúdos de um arquivo no seu repositório, escolha o arquivo na lista. Para alterar a cor do código exibido, escolha o ícone de configurações.
![\[Visualizar o conteúdo de um arquivo\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-code-browse-file.png)
Para obter mais informações, consulte [Procurar arquivos em um repositório](how-to-browse.md).
1. Para navegar pelo histórico de confirmações do repositório, escolha **Commits (Confirmações)**. O console exibe o histórico de confirmações da ramificação padrão, em ordem cronológica inversa. Revise os detalhes de confirmações por autor, data e muito mais.
![\[A visualização do histórico de confirmações no console\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-code-history.png)
1. Para visualizar o histórico de confirmações por [ramificação](branches.md) ou [tag do Git](how-to-view-tag-details.md), escolha a ramificação ou tag que deseja visualizar na lista.
1. Para visualizar as diferenças entre uma confirmação e sua confirmação pai, escolha o ID de confirmação abreviado. Você pode escolher como as alterações são exibidas, incluindo mostrar ou ocultar alterações no espaço em branco e se você deseja visualizar alterações embutidas (exibição **Unified (Unificada)**) ou lado a lado (exibição **Split (Dividida)**).
**nota**
Suas preferências para visualizar código e outras configurações do console são salvas como cookies do navegador sempre que você as altera. Para obter mais informações, consulte [Trabalhar com preferências do usuário](user-preferences.md).
![\[Alterações exibidas na visualização Unificada, com as alterações de espaço em branco visíveis\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-commit-changes2c.png)
1. Para ver todos os comentários em uma confirmação, escolha a confirmação e, em seguida, role pelas alterações para visualizá-las em linha. Você também pode adicionar seus próprios comentários e responder aos comentários feitos por outros.
Para obter mais informações, consulte [Comentar sobre uma confirmação](how-to-commit-comment.md).
1. **Para ver as diferenças entre quaisquer dois especificadores de commits, incluindo tags, branches e commits, no painel de navegação IDs, escolha Commits e, em seguida, escolha **Comparar commits**.**
![\[Comparação de uma confirmação com a extremidade de uma ramificação na visualização dividida\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-compare-4.png)
Para obter mais informações, consulte [Navegar pelo histórico de confirmações de um repositório](how-to-view-commit-details.md#how-to-view-commit-details-console-history) e [Comparar confirmações](how-to-compare-commits.md).
1. Em **Commits (Confirmações)**, escolha a guia **Commit visualizer (Visualizador de confirmações)**.
![\[Uma visualização gráfica de um repositório no console\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-cv-complex1.png)
O gráfico de confirmações será exibido, com a linha de assunto de cada confirmação mostrada próxima ao seu respectivo ponto no gráfico. A exibição da linha de assunto é limitada a 80 caracteres.
1. Para ver mais detalhes sobre uma confirmação, escolha o ID abreviado da confirmação. Para renderizar o gráfico de uma confirmação específica, escolha este ponto no gráfico. Para obter mais informações, consulte [Visualizar um gráfico do histórico de confirmações de um repositório](how-to-view-commit-details.md#how-to-view-commit-details-console-visualizer).
## Etapa 4: criar e colaborar em uma solicitação pull
Ao trabalhar em um repositório com outros usuários, é possível colaborar no código e revisar alterações. É possível criar uma solicitação pull para que outros usuários possam revisar e comentar suas alterações de código em uma ramificação. Também é possível criar uma ou mais regras de aprovação da solicitação pull. Por exemplo, é possível criar uma regra de aprovação que exija que pelo menos dois outros usuários aprovem a solicitação pull para que possa ser mesclada. Depois que a solicitação pull for aprovada, você poderá mesclar essas alterações à ramificação de destino. Se você configurar notificações para seu repositório, os usuários do repositório poderão receber e-mails sobre eventos do repositório (por exemplo, para solicitações pull ou quando alguém fizer comentários sobre o código). Para obter mais informações, consulte [Configurando notificações para eventos em um repositório AWS CodeCommit](how-to-repository-email.md).
**Importante**
Antes de criar uma solicitação pull, você deve criar uma ramificação que contenha as alterações de código que deseja rever. Para obter mais informações, consulte [Criar uma ramificação](how-to-create-branch.md).
**Como criar e colaborar em uma solicitação pull**
1. No painel de navegação, escolha **Pull Requests (Solicitações pull)**.
1. Em **Pull request (Solicitação pull)**, escolha **Create pull request (Criar solicitação pull)**.
**dica**
Você também pode criar solicitações pull em **Branches (Ramificações)** e em **Code (Código)**.
Em **Create pull request**, em **Source**, escolha a ramificação que contém as alterações que deseja revisar. Em **Destination (Destino)**, escolha a ramificação na qual você deseja que o código seja revisado para ser mesclado quando a solicitação pull for fechada. Escolha **Compare**.
1. Reveja os detalhes da mesclagem e as alterações para confirmar que a solicitação pull contém as alterações e confirmações que você deseja analisar. Em caso positivo, em **Title (Título)**, insira um título para esta revisão. Este é o título que aparece na lista de solicitações pull para o repositório. Em **Description (Descrição)**, insira detalhes sobre essa revisão e sobre qualquer outra informação útil para os revisores. Escolha **Criar**.
![\[Criar uma solicitação pull\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-pull-request-create.png)
1. Sua solicitação pull aparece na lista de solicitações pull para o repositório. Você pode filtrar a exibição para mostrar apenas solicitações abertas, solicitações fechadas, solicitações que você criou e muito mais.
![\[Visualização de solicitações pull em um repositório\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-pull-request-view.png)
1. É possível adicionar uma regra de aprovação à solicitação pull a fim de garantir que determinadas condições sejam atendidas antes que ela seja mesclada. Para adicionar uma regra de aprovação à solicitação pull, escolha a solicitação pull na lista. Na guia **Approvals (Aprovações)**, escolha **Create approval rule (Criar regra de aprovação)**.
1. Em **Rule name (Nome da regra)**, dê à regra um nome descritivo. Por exemplo, se você deseja exigir que duas pessoas aprovem uma solicitação pull para que ela possa ser mesclada, é possível nomear a regra **Require two approvals before merge**. Em **Number of approvals needed (Número de aprovações necessárias)**, insira **2**, o número que você deseja. O padrão é um. Selecione **Enviar**. Para saber mais sobre regras de aprovação e membros do grupo de aprovações, consulte [Criar uma regra de aprovação de uma solicitação pull](how-to-create-pull-request-approval-rule.md).
![\[Criar uma regra de aprovação de uma solicitação pull\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-create-approval-rule.png)
1. Se você tiver configurado notificações para o seu repositório e optou por notificar os usuários sobre eventos de solicitação pull, os usuários receberão e-mails sobre sua nova solicitação pull. Os usuários podem visualizar as alterações e comentar em linhas específicas do código, em arquivos e na solicitação pull propriamente dita. Elas também podem responder aos comentários com texto e emojis. Se necessário, você pode inserir as alterações na ramificação da solicitação pull, o que atualiza a solicitação pull.
![\[Adicionar uma reação de emoji em um comentário em uma solicitação pull.\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-commenting-commenttab.png)
1. Se você estiver satisfeito com as alterações feitas na solicitação, escolha **Approve (Aprovar)**. É possível optar por aprovar uma solicitação pull mesmo que nenhuma regra de aprovação esteja configurada para ela. Isso fornece um registro claro de que você revisou a solicitação pull e sua aprovação das alterações. Também é possível optar por revogar sua aprovação se mudar de ideia.
![\[Visualizar aprovações em uma solicitação pull\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-pull-request-approvals.png)
**nota**
Não é possível aprovar uma solicitação pull se você a criou.
1. Quando todas as alterações de código forem analisadas e aceitas apropriadamente, na solicitação pull, siga um destes procedimentos:
+ Se você deseja fechar a solicitação pull sem mesclar ramificações, selecione **Close pull request (Fechar solicitação pull)**.
+ Se deseja mesclar as ramificações e fechar a solicitação pull, escolha **Merge (Mesclar)**. Será possível escolher entre as estratégias de mesclagem disponíveis para seu código, que dependem das diferenças entre as ramificações de origem e de destino, e a opção de excluir automaticamente a ramificação de origem depois que a mesclagem for concluída. Após ter feito suas escolhas, selecione **Merge pull request (Mesclar solicitação pull)** para concluir a mesclagem.
![\[Um pull request mostrando as estratégias de mesclagem disponíveis para a mesclagem no CodeCommit console.\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-merge-squash.png)
+ Se houver conflitos de mesclagem nas ramificações que não podem ser resolvidos automaticamente, você pode resolvê-los no CodeCommit console ou usar seu cliente Git local para mesclar as ramificações e, em seguida, enviar a mesclagem. Para obter mais informações, consulte [Resolver conflitos em uma solicitação pull em um repositório do AWS CodeCommit](how-to-resolve-conflict-pull-request.md).
**nota**
Você sempre pode mesclar as ramificações manualmente, incluindo ramificações de solicitação pull, usando o comando **git merge** no repositório local e enviando as alterações por push.
Para obter mais informações, consulte [Trabalhar com solicitações pull](pull-requests.md) e [Trabalhar com modelos de regra de aprovação](approval-rule-templates.md).
## Etapa 5: limpar
Se você não precisar mais do CodeCommit repositório, exclua o CodeCommit repositório e outros recursos usados neste exercício para não continuar sendo cobrado pelo espaço de armazenamento.
**Importante**
Esta ação não pode ser desfeita. Após excluir esse repositório, você não poderá mais cloná-lo para nenhum repositório local ou compartilhado. Também não será mais possível extrair dados do repositório ou enviar dados via push para ele, nem executar operações do Git, tanto de repositórios locais como compartilhados.
Se você configurou notificações para o seu repositório, a exclusão do repositório também exclui a regra CloudWatch Amazon Events criada para o repositório. Isso não exclui o tópico do Amazon SNS usado como destino para essa regra.
Se você tiver configurado acionadores para seu repositório, a exclusão do repositório não exclui os tópicos do Amazon SNS nem as funções do Lambda que foram configurados como destinos desses acionadores. Lembre-se de excluir esses recursos se não forem necessários. Para obter mais informações, consulte [Excluir gatilhos de um repositório](how-to-notify-delete.md).
**Para excluir o CodeCommit repositório**
1. Abra o CodeCommit console em [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home).
1. Em **Repositories (Repositórios)**, escolha o repositório que você deseja excluir. Se você tiver seguido a convenção de nomenclatura deste tópico, ele será chamado **MyDemoRepo**.
1. No painel de navegação, selecione **Configurações**.
1. Na página **Settings**, escolha **Delete repository** em **Delete repository**.
1. Digite **delete** e, em seguida, escolha **Delete (Excluir)**. O repositório será excluído permanentemente.
## Etapa 6: próximas etapas
Agora que você se familiarizou com alguns CodeCommit de seus recursos, considere fazer o seguinte:
+ Se você é iniciante no Git CodeCommit e/ou deseja revisar exemplos de uso do Git com CodeCommit, continue com o tutorial. [Começando com o Git e CodeCommit](getting-started.md)
+ Se você quiser trabalhar com outras pessoas em um CodeCommit repositório, consulte[Compartilhar um repositório](how-to-share-repository.md). (Para compartilhar seu repositório com usuários em outra conta da Amazon Web Services, consulte [Configurar o acesso entre contas a um AWS CodeCommit repositório usando funções](cross-account.md).)
+ Se você quiser migrar um repositório para CodeCommit, siga as etapas em. [Migrar para o CodeCommit](how-to-migrate-repository.md)
+ Se você quiser adicionar o repositório a um pipeline de entrega contínua, siga as etapas em [Passo-a-passo de pipeline simples](https://docs.aws.amazon.com/codepipeline/latest/userguide/getting-started-cc.html).
+ Para saber mais sobre produtos e serviços que se integram ao CodeCommit, incluindo exemplos da comunidade, consulte [Integrações de produtos e serviços](integrations.md).
# Começando com o Git e AWS CodeCommit
Se você é iniciante no Git CodeCommit, este tutorial ajuda você a aprender alguns comandos simples para começar. Se você já está familiarizado com o Git, pode pular este tutorial e ir para [Começando com CodeCommit ](getting-started-cc.md).
Neste tutorial, você cria um repositório que representa uma cópia local do CodeCommit repositório, que chamamos de repositório local.
Depois de criar o repositório local, você fará algumas alterações nele. Em seguida, você envia (envia) suas alterações para o CodeCommit repositório.
Você também simula um ambiente de equipe em que dois usuários confirmam as alterações de forma independente no repositório local e enviam essas alterações para o CodeCommit repositório. Em seguida, os usuários puxam as alterações do CodeCommit repositório para seu próprio repositório local para ver as alterações feitas pelo outro usuário.
Você também cria ramificações e tags e gerencia algumas permissões de acesso no CodeCommit repositório.
Depois de concluir este tutorial, você terá praticado o suficiente com os principais conceitos do Git e do CodeCommit para usá-los em seus próprios projetos.
Conclua os [pré-requisitos e a configuração](setting-up.md), incluindo:
+ Atribua permissões ao usuário do IAM.
+ Configure CodeCommit para se conectar a um repositório usando [HTTPS](setting-up-gc.md), SSH ou. [**git-remote-codecommit**](setting-up-git-remote-codecommit.md) Para obter mais informações sobre essas opções, consulte [Configuração do AWS CodeCommit](setting-up.md).
+ Configure o AWS CLI se quiser usar a linha de comando ou o terminal para todas as operações, incluindo a criação do repositório.
**Topics**
+ [
## Etapa 1: criar um CodeCommit repositório
](#getting-started-create-repo)
+ [
## Etapa 2: criação de um repositório local
](#getting-started-set-up-folders)
+ [
## Etapa 3: criar sua primeira confirmação
](#getting-started-create-commit)
+ [
## Etapa 4: enviar sua primeira confirmação via push
](#getting-started-init-repo)
+ [
## Etapa 5: compartilhar o CodeCommit repositório e enviar e receber outro commit
](#getting-started-pull-commits)
+ [
## Etapa 6: criar e compartilhar uma ramificação
](#getting-started-branching)
+ [
## Etapa 7: criar e compartilhar uma tag
](#getting-started-tags)
+ [
## Etapa 8: configurar permissões de acesso
](#getting-started-permissions)
+ [
## Etapa 9: limpar
](#getting-started-clean-up)
## Etapa 1: criar um CodeCommit repositório
Nesta etapa, você usa o CodeCommit console para criar o repositório.
Você pode pular essa etapa se já tiver um CodeCommit repositório que queira usar.
**nota**
Dependendo do seu uso, você poderá ser cobrado pela criação ou acesso a um repositório. Para obter mais informações, consulte [Preços](https://aws.amazon.com/codecommit/pricing) na página de informações CodeCommit do produto.
**Para criar o CodeCommit repositório**
1. Abra o CodeCommit console em [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home).
1. Use o seletor de região para escolher Região da AWS onde você deseja criar o repositório. Para obter mais informações, consulte [Regiões e endpoints de conexão do Git](regions.md).
1. Na página **Repositories (Repositórios)**, selecione **Create repository (Criar repositório)**.
1. Na página **Create repository (Criar repositório)**, em **Repository name (Nome do repositório)**, insira um nome para o repositório (por exemplo **MyDemoRepo**).
**nota**
Os nomes de repositório diferenciam letras maiúsculas de minúsculas e não podem ter mais de 100 caracteres. Para saber mais, consulte [Limites](limits.md#limits-repository-names).
1. (Opcional) Em **Description (Descrição)**, insira uma descrição, (por exemplo, **My demonstration repository**). Isso pode ajudar você e outros usuários a identificar a finalidade do repositório.
1. (Opcional) Escolha **Adicionar tag** para adicionar uma ou mais tags de repositório (um rótulo de atributo personalizado que ajuda você a organizar e gerenciar seus AWS recursos) ao seu repositório. Para obter mais informações, consulte [Marcando repositórios em AWS CodeCommit](how-to-tag-repository.md).
1. (Opcional) Expanda **Configuração adicional** para especificar se você deseja usar a chave padrão Chave gerenciada pela AWS ou sua própria chave gerenciada pelo cliente para criptografar e descriptografar os dados nesse repositório. Se você optar por usar sua própria chave gerenciada pelo cliente, deverá garantir que ela esteja disponível no Região da AWS local em que você está criando o repositório e que a chave esteja ativa. Para obter mais informações, consulte [AWS Key Management Service e criptografia para AWS CodeCommit repositórios](encryption.md).
1. (Opcional) Selecione **Ativar Amazon CodeGuru Reviewer para Java e Python** se esse repositório contiver código Java ou Python e você quiser que o revisor analise esse código. CodeGuru CodeGuru O revisor usa vários modelos de aprendizado de máquina para encontrar defeitos no código e sugerir automaticamente melhorias e correções nas pull requests. Para obter mais informações, consulte o Guia do usuário do Amazon CodeGuru Reviewer.
1. Escolha **Criar**.
**nota**
As etapas restantes deste tutorial são usadas `MyDemoRepo` para o nome do CodeCommit repositório. Se você escolher um nome diferente, certifique-se de usá-lo durante todo este tutorial.
Para obter mais informações sobre a criação de repositórios, incluindo como criar um repositório do terminal ou da linha de comando, consulte [Criar um repositório](how-to-create-repository.md).
## Etapa 2: criação de um repositório local
Nesta etapa, você configurará um repositório local em sua máquina local para se conectar ao seu repositório. Para fazer isso, será preciso selecionar um diretório em sua máquina local que represente o repositório local. Você usa o Git para clonar e inicializar uma cópia do seu CodeCommit repositório vazio dentro desse diretório. Em seguida, você especificará o nome de usuário GIT e endereço de e-mail usados para anotar suas confirmações.
1. Abra o CodeCommit console em [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home).
1. No seletor de região, escolha Região da AWS onde o repositório foi criado. Os repositórios são específicos para um Região da AWS. Para obter mais informações, consulte [Regiões e endpoints de conexão do Git](regions.md).
1. Escolha na lista o repositório ao qual deseja se conectar. Escolha **Clone URL (Clonar URL)** e escolha o protocolo que você deseja usar ao clonar ou se conectar ao repositório. Isso copia a URL do clone.
+ Copie a URL HTTPS se você estiver usando credenciais do Git com seu usuário do IAM ou o assistente de credenciais incluído na AWS CLI.
+ Copie o URL HTTPS (GRC) se estiver usando o comando **git-remote-codecommit** no computador local.
+ Copie o URL do SSH se você estiver usando um par de public/private chaves SSH com seu usuário do IAM.
**nota**
Se você ver uma página de **boas-vindas** em vez de uma lista de repositórios, não há repositórios associados à sua AWS conta no Região da AWS local em que você está conectado. Para criar um repositório, consulte [Crie um AWS CodeCommit repositório](how-to-create-repository.md) ou siga as etapas no tutorial [Começando com o Git e CodeCommit](#getting-started).
1. (Opcional) Recomendamos que você configure seu cliente Git local para usar **main** como nome da ramificação padrão do seu repositório. Esse é o nome usado para a ramificação padrão em todos os exemplos deste guia. Também é o mesmo nome de ramificação padrão CodeCommit usado se você fizer sua primeira confirmação no console. Execute o comando a seguir para configurar o nome da ramificação padrão globalmente para seu sistema:
```
git config --global init.defaultBranch main
```
Se você preferir usar um nome de ramificação padrão diferente para todos os seus repositórios, substitua **main** pelo nome de sua preferência. Este tutorial pressupõe que sua ramificação padrão tenha o nome de *principal*.
Se quiser usar nomes de ramificações padrão diferentes para repositórios diferentes, você pode definir esse atributo localmente (**--local**) em vez de globalmente (**--global**).
1. No terminal ou prompt de comando, clone o repositório com o comando **git clone** e forneça a URL do clone copiado na etapa 3. A URL do clone dependerá do protocolo e da configuração usados. Por exemplo, se você estiver usando HTTPS com credenciais do Git para clonar um repositório chamado *MyDemoRepo* na região Leste dos EUA (Ohio):
```
git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo
```
Se você estiver usando HTTPS com **git-remote-codecommit**:
```
git clone codecommit://MyDemoRepo my-demo-repo
```
Se estiver usando SSH:
```
git clone ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo
```
**nota**
Se você visualizar um erro ao tentar clonar um repositório, talvez não tenha concluído a configuração necessária no seu computador local. Para obter mais informações, consulte [Configuração do AWS CodeCommit](setting-up.md).
## Etapa 3: criar sua primeira confirmação
Nesta etapa, você criará sua primeira confirmação no repositório local. Para fazer isso, será preciso criar dois arquivos de exemplo no seu repositório local. O Git será usado para preparar e, em seguida, confirmar a alteração no seu repositório local.
1. Use um editor de texto para criar os dois seguintes arquivos de texto de exemplo no seu diretório. Nomeie os arquivos `cat.txt` e `dog.txt`:
```
cat.txt
-------
The domestic cat (Felis catus or Felis silvestris catus) is a small, usually furry, domesticated, and carnivorous mammal.
```
```
dog.txt
-------
The domestic dog (Canis lupus familiaris) is a canid that is known as man's best friend.
```
1. Execute **git config** para adicionar seu nome de usuário e endereço de e-mail representados por espaços reservados *your-user-name* e *your-email-address* ao seu repositório local. Isso facilita a identificação das confirmações realizadas:
```
git config --local user.name "your-user-name"
git config --local user.email your-email-address
```
1. Se você não definiu o nome da ramificação padrão globalmente ao criar o repositório local, execute o comando a seguir para definir o nome da ramificação padrão como **main**:
```
git config --local init.defaultBranch main
```
1. Execute **git add** para preparar a alteração:
```
git add cat.txt dog.txt
```
1. Execute **git commit** para confirmar a alteração:
```
git commit -m "Added cat.txt and dog.txt"
```
**dica**
Para ver os detalhes da confirmação que acabou de fazer, execute **git log**.
## Etapa 4: enviar sua primeira confirmação via push
Nesta etapa, você envia o commit do seu repositório local para o seu CodeCommit repositório.
Execute **git push** para enviar seu commit por meio do nome remoto padrão que o Git usa para seu CodeCommit repositório (`origin`), da ramificação padrão em seu repositório local (): `main`
```
git push -u origin main
```
**dica**
Depois de enviar os arquivos para o seu CodeCommit repositório, você pode usar o CodeCommit console para visualizar o conteúdo. Para obter mais informações, consulte [Procurar arquivos em um repositório](how-to-browse.md).
## Etapa 5: compartilhar o CodeCommit repositório e enviar e receber outro commit
Nesta etapa, você compartilha informações sobre o CodeCommit repositório com outro membro da equipe. O integrante da equipe usa essas informações para obter uma cópia local, fazer algumas alterações nela e, em seguida, enviar a cópia local modificada para o seu CodeCommit repositório. Em seguida, você puxa as alterações do CodeCommit repositório para o repositório local.
Neste tutorial, o outro usuário será simulado fazendo com que o Git crie um diretório separado daquele que você criou na [etapa 2](#getting-started-set-up-folders). (Normalmente, esse diretório está em uma máquina diferente.) Esse novo diretório é uma cópia do seu CodeCommit repositório. Algumas alterações feitas ao diretório existente ou a esse novo diretório são realizadas independentemente. A única maneira de identificar alterações nesses diretórios é extrair do CodeCommit repositório.
Mesmo que estejam na mesma máquina local, chamaremos o diretório existente de *repositório local* e o novo diretório de *repositório compartilhado*.
No novo diretório, você obtém uma cópia separada do CodeCommit repositório. Em seguida, você adiciona um novo arquivo de exemplo, confirma as alterações no repositório compartilhado e, em seguida, envia o commit do repositório compartilhado para o seu CodeCommit repositório.
Por fim, você extrairá as alterações do seu repositório para seu repositório local e, em seguida, navegará por ele para ver as alterações confirmadas pelo outro usuário.
1. Mude para o diretório `/tmp` ou `c:\temp`.
1. Execute **git clone** para fazer o pull de uma cópia do repositório para o repositório compartilhado:
Para HTTPS:
```
git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo shared-demo-repo
```
Para HTTPS com **git-remote-codecommit**:
```
git clone codecommit://MyDemoRepo shared-demo-repo
```
Para o SSH:
```
git clone ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo shared-demo-repo
```
**nota**
Quando um repositório é clonado usando SSH em sistemas operacionais Windows, talvez seja necessário adicionar o ID da chave SSH à cadeia de conexão da seguinte forma:
```
git clone ssh://Your-SSH-Key-ID@git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo
```
Para obter mais informações, consulte [Para conexões SSH no Windows](setting-up-ssh-windows.md).
Neste comando, `MyDemoRepo` está o nome do seu CodeCommit repositório. `shared-demo-repo`é o nome do diretório que o Git cria no `/tmp` diretório ou no `c:\temp` diretório. Depois que o Git criar o diretório, o Git extrairá uma cópia do seu repositório no diretório `shared-demo-repo`.
1. Mude para o diretório `shared-demo-repo`:
```
(For Linux, macOS, or Unix) cd /tmp/shared-demo-repo
(For Windows) cd c:\temp\shared-demo-repo
```
1. Execute **git config** para adicionar outro nome de usuário e endereço de e-mail representado por espaços reservados *other-user-name* e. *other-email-address* Isso facilita a identificação das confirmações realizadas pelo outro usuário:
```
git config --local user.name "other-user-name"
git config --local user.email other-email-address
```
1. Use um editor de texto para criar o seguinte arquivo de texto de exemplo no diretório `shared-demo-repo`. Nomeie o arquivo `horse.txt`:
```
horse.txt
-------
The horse (Equus ferus caballus) is one of two extant subspecies of Equus ferus.
```
1. Execute **git add** para preparar a alteração no repositório compartilhado:
```
git add horse.txt
```
1. Execute **git commit** para confirmar a alteração no repositório compartilhado:
```
git commit -m "Added horse.txt"
```
1. Execute **git push** para enviar seu commit inicial por meio do nome remoto padrão que o Git usa para seu CodeCommit repositório (`origin`), da ramificação padrão em seu repositório local (): `main`
```
git push -u origin main
```
1. Mude para seu repositório local e execute **git pull** para obter em seu repositório local o commit do repositório compartilhado feito no repositório. CodeCommit Em seguida, execute **git log** para ver a confirmação que foi iniciada a partir do repositório compartilhado.
## Etapa 6: criar e compartilhar uma ramificação
Nesta etapa, você cria uma ramificação em seu repositório local, faz algumas alterações e, em seguida, envia a ramificação para seu CodeCommit repositório. Em seguida, você puxa a ramificação do seu CodeCommit repositório para o repositório compartilhado.
Uma ramificação permite que você desenvolva independentemente uma versão diferente do conteúdo do repositório (por exemplo, para trabalhar em um novo recurso de software sem afetar o trabalho dos membros de sua equipe). Quando o recurso fica estável, você mescla a ramificação a outra mais estável do software.
Você usa o Git para criar a ramificação e, em seguida, apontá-la para a primeira confirmação que você fez. Você usa o Git para enviar a ramificação para o CodeCommit repositório. Em seguida, você alternará para o repositório compartilhado e usará o Git para extrair a nova ramificação para o repositório local compartilhado e explorar a ramificação.
1. Do repositório local, execute **git checkout**, especificando o nome da ramificação (por exemplo, `MyNewBranch`) e a ID da primeira confirmação que você fez no repositório local.
Se você não souber o ID da confirmação, execute **git log** para obtê-lo. Certifique-se de que a confirmação tem seu nome de usuário e endereço de e-mail, não o nome de usuário e endereço de e-mail do outro usuário. Isso é para simular que `main` é uma versão estável do CodeCommit repositório e a `MyNewBranch` ramificação é para algum recurso novo e relativamente instável:
```
git checkout -b MyNewBranch commit-ID
```
1. Execute **git push** para enviar a nova ramificação do repositório local para o CodeCommit repositório:
```
git push origin MyNewBranch
```
1. Agora, efetue o pull da ramificação para o repositório compartilhado e verifique os resultados:
1. Alterne para o diretório do repositório compartilhado (shared-demo-repo).
1. Faça o pull na nova ramificação (**git fetch origin**).
1. Confirme se o pull da ramificação foi efetuado (o **git branch --all** exibe uma lista de todas as ramificações do repositório).
1. Mude para a nova ramificação (**git checkout MyNewBranch**).
1. Confirme se você mudou para a ramificação `MyNewBranch`, executando **git status** ou **git branch**. O resultado mostra em qual ramificação você está. Neste caso, deve ser `MyNewBranch`.
1. Visualize a lista de confirmações na ramificação (**git log**).
Aqui está a lista de comandos Git para chamar:
```
git fetch origin
git branch --all
git checkout MyNewBranch
git branch or git status
git log
```
1. Alterne de volta para a ramificação `main` e visualize a lista de confirmações. Os comandos do Git devem ter essa aparência:
```
git checkout main
git log
```
1. Alterne para a ramificação `main` em seu repositório local. Você pode executar **git status** ou **git branch**. O resultado mostra em qual ramificação você está. Neste caso, deve ser `main`. Os comandos do Git devem ter essa aparência:
```
git checkout main
git branch or git status
```
## Etapa 7: criar e compartilhar uma tag
Nesta etapa, você cria duas tags em seu repositório local, associa as tags aos commits e, em seguida, envia as tags para o seu CodeCommit repositório. Em seguida, você puxa as alterações do CodeCommit repositório para o repositório compartilhado.
Uma tag é usada para dar um nome legível por humanos a uma confirmação (ou uma ramificação ou até mesmo outra tag). Você poderá fazer isso, por exemplo, se quiser marcar uma confirmação como `v2.1`. Uma confirmação, uma ramificação ou uma tag podem ter várias tags associadas a elas, mas uma tag individual pode ser associada a apenas uma confirmação, uma ramificação ou uma tag. Neste tutorial, você marcará uma confirmação como `release` e outra como `beta`.
Use o Git para criar as tags, apontando a tag `release` para a primeira confirmação que você fez e a tag `beta` para a confirmação feita pelo outro usuário. Em seguida, você usa o Git para enviar as tags para o CodeCommit repositório. Você, então, alternará para o repositório compartilhado e usará o Git para extrair as tags para o repositório local compartilhado e explorar as tags.
1. Do repositório local, execute **git tag**, especificando o nome da nova tag (`release`) e a ID da primeira confirmação que você fez no repositório local.
Se você não souber o ID da confirmação, execute **git log** para obtê-lo. Certifique-se de que a confirmação tem seu nome de usuário e endereço de e-mail, não o nome de usuário e endereço de e-mail do outro usuário. Isso é para simular que seu commit é uma versão estável do CodeCommit repositório:
```
git tag release commit-ID
```
Execute **git tag** novamente para marcar a confirmação do outro usuário com a tag `beta`. Isso é para simular que a confirmação é para algum recurso novo relativamente instável:
```
git tag beta commit-ID
```
1. Execute **git push --tags** para enviar as tags para o CodeCommit repositório.
1. Agora, efetue o pull das tags para o repositório compartilhado e verifique os resultados:
1. Alterne para o diretório do repositório compartilhado (shared-demo-repo).
1. Faça o pull nas novas tags (**git fetch origin**).
1. Confirme se foi efetuado o pull das tags (o comando **git tag** exibe uma lista das tags do repositório).
1. Exiba as informações sobre cada tag (**git log release** e **git log beta**).
Aqui está a lista de comandos Git para chamar:
```
git fetch origin
git tag
git log release
git log beta
```
1. Experimente isso também no repositório local:
```
git log release
git log beta
```
## Etapa 8: configurar permissões de acesso
Nesta etapa, você concede permissão ao usuário para sincronizar o repositório compartilhado com o CodeCommit repositório. Esta é uma etapa opcional. É recomendado para usuários interessados em aprender sobre como controlar o acesso aos CodeCommit repositórios quando os usuários usam credenciais do Git ou os pares de chaves SSH são usados com usuários do IAM para acessar os repositórios. CodeCommit
**nota**
Se você estiver usando acesso federado, credenciais temporárias ou um provedor de identidade da web, como o IAM Identity Center, configure usuários, acessos e permissões para seu provedor de identidade e, em seguida, use **git-remote-codecommit**. Para obter mais informações, consulte [Etapas de configuração para conexões HTTPS AWS CodeCommit com git-remote-codecommit](setting-up-git-remote-codecommit.md) e [Conectando-se a AWS CodeCommit repositórios com credenciais rotativas](temporary-access.md).
Para fazer isso, use o console do IAM para criar um usuário que, por padrão, não tem permissões para sincronizar o repositório compartilhado com o CodeCommit repositório. Você pode executar **git pull** para verificar isso. Se o novo usuário não tiver permissão para sincronizar, o comando não funcionará. Em seguida, você voltará ao console do IAM e aplicará uma política que permita ao usuário executar o **git pull**. Você pode executar o **git pull** novamente para verificar isso.
Esta etapa foi escrita supondo que você tenha permissões para criar usuários do IAM em sua conta da Amazon Web Services. Se você não tiver essas permissões, não poderá realizar os procedimentos desta etapa. Avance para [Etapa 9: limpar](#getting-started-clean-up) para limpar os recursos usados no tutorial.
1. Faça login no Console de gerenciamento da AWS e abra o console do IAM em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
Certifique-se de fazer login com o mesmo nome de usuário e senha utilizados em [Configurando ](setting-up.md).
1. No painel de navegação, escolha **Users** e depois **Create New Users**.
1. Na primeira caixa **Enter User Names (Inserir nomes de usuários)**, insira um nome de usuário de exemplo (por exemplo, **JaneDoe-CodeCommit**). Selecione a caixa **Generate an access key for each user (Gerar uma chave de acesso para cada usuário)** e selecione **Create (Criar)**.
1. Escolha **Show User Security Credentials**. Anote o access key ID e a chave de acesso secreta ou escolha **Download Credentials**.
1. Siga as instruções em [Para usuários de HTTPS usando credenciais do Git](setting-up-gc.md) para gerar e fornecer as credenciais do usuário do IAM.
Se você quiser usar SSH, siga as instruções em [SSH e Linux, macOS ou Unix: configure as chaves públicas e privadas para Git e CodeCommit](setting-up-ssh-unixes.md#setting-up-ssh-unixes-keys-unixes) ou [Etapa 3: configurar as chaves públicas e privadas para o Git e CodeCommit](setting-up-ssh-windows.md#setting-up-ssh-windows-keys-windows) para configurar o usuário com chaves públicas e privadas.
1. Executar **git pull**. O seguinte erro deve aparecer:
Para HTTPS:
`fatal: unable to access 'https://git-codecommit.us-east-2.amazonaws.com/v1/repos/repository-name/': The requested URL returned error: 403`.
Para o SSH:
`fatal: unable to access 'ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/repository-name/': The requested URL returned error: 403`.
O erro aparece porque o novo usuário não tem permissão para sincronizar o repositório compartilhado com o CodeCommit repositório.
1. Retorne ao console do IAM. No painel de navegação, escolha **Policies** e, em seguida, **Create Policy**. (Se aparecer um botão **Get Started**, selecione-o e, em seguida, **Create Policy**.)
1. Próximo a **Create Your Own Policy**, escolha **Select**.
1. Na caixa **Policy Name (Nome da política)**, insira um nome (por exemplo, **CodeCommitAccess-GettingStarted**).
1. Na caixa **Documento da política**, insira o seguinte para permitir que um usuário do IAM extraia de qualquer repositório associado ao usuário do IAM:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codecommit:GitPull"
],
"Resource": "*"
}
]
}
```
------
**dica**
Se quiser que o usuário do IAM possa enviar confirmações via push para qualquer repositório associado ao usuário do IAM, insira:
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codecommit:GitPull",
"codecommit:GitPush"
],
"Resource": "*"
}
]
}
```
Para obter informações sobre outras permissões de CodeCommit ações e recursos que você pode conceder aos usuários, consulte[Autenticação e controle de acesso para AWS CodeCommit](auth-and-access-control.md).
1. No painel de navegação, escolha **Users**.
1. Escolha o nome de usuário de exemplo (por exemplo, **JaneDoe-CodeCommit**) ao qual você deseja anexar a política.
1. Escolha a aba **Permissões**.
1. Em **Managed Policies**, escolha **Attach Policy**.
1. Selecione a política **CodeCommitAccess-GettingStarted** que você acabou de criar e escolha **Attach Policy (Anexar política)**.
1. Executar **git pull**. Dessa vez, o comando deve funcionar e deve aparecer uma mensagem `Already up-to-date`.
1. Se você estiver usando HTTPS, alterne para suas credenciais originais do Git ou, se estiver usando **git-remote-codecommit**, seu perfil habitual. Para obter mais informações, consulte as instruções em [Configuração para usuários de HTTPS usando credenciais do Git](setting-up-gc.md) ou [Etapas de configuração para conexões HTTPS AWS CodeCommit com git-remote-codecommit](setting-up-git-remote-codecommit.md).
Se você estiver usando SSH, alterne para suas chaves originais. Para acessar mais informações, consulte [SSH e Linux, macOS ou Unix: configure as chaves públicas e privadas para Git e CodeCommit](setting-up-ssh-unixes.md#setting-up-ssh-unixes-keys-unixes) ou [Etapa 3: configurar as chaves públicas e privadas para o Git e CodeCommit](setting-up-ssh-windows.md#setting-up-ssh-windows-keys-windows).
Você chegou ao fim deste tutorial.
## Etapa 9: limpar
Nesta etapa, você exclui o CodeCommit repositório usado neste tutorial, para não continuar sendo cobrado pelo espaço de armazenamento.
Você também remove o repositório local e o repositório compartilhado em sua máquina local porque eles não serão necessários depois que você excluir o CodeCommit repositório.
**Importante**
Depois de excluir esse repositório, você não poderá cloná-lo para nenhum repositório local ou compartilhado. Também não será possível extrair dados dele nem enviar via push dados para ele de nenhum repositório local ou compartilhado. Esta ação não pode ser desfeita.
### Para excluir o CodeCommit repositório (console)
1. Abra o CodeCommit console em [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home).
1. Na página do **Dashboard (Painel)**, escolha **MyDemoRepo** na lista de repositórios.
1. No painel de navegação, selecione **Configurações**.
1. Na página **Settings**, escolha **Delete repository** em **Delete repository**.
1. Na caixa ao lado de **Type the name of the repository to confirm deletion (Digite o nome do repositório para confirmar a exclusão)**, insira **MyDemoRepo** e escolha **Delete (Excluir)**.
### Para excluir o CodeCommit repositório ()AWS CLI
Execute o comando [delete-repository](how-to-delete-repository.md#how-to-delete-repository-cli):
```
aws codecommit delete-repository --repository-name MyDemoRepo
```
### Para excluir o repositório local e o repositório compartilhado
Para Linux, macOS ou Unix:
```
cd /tmp
rm -rf /tmp/my-demo-repo
rm -rf /tmp/shared-demo-repo
```
Para Windows:
```
cd c:\temp
rd /s /q c:\temp\my-demo-repo
rd /s /q c:\temp\shared-demo-repo
```