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á.
# Etapas de configuração para conexões HTTPS AWS CodeCommit com git-remote-codecommit
Se você quiser se conectar CodeCommit usando uma conta raiz, acesso federado ou credenciais temporárias, você deve configurar o acesso usando. **git-remote-codecommit** Esse utilitário fornece um método simples para enviar e extrair código de CodeCommit repositórios estendendo o Git. É o método recomendado para oferecer suporte a conexões feitas com acesso federado, provedores de identidade e credenciais temporárias. Para atribuir permissões a identidades federadas, você cria um perfil e define permissões para a perfil. Quando uma identidade federada é autenticada, essa identidade é associada ao perfil e recebe as permissões definidas por ele. Para ter mais informações sobre perfis para federação, consulte [Criar um perfil para um provedor de identidade de terceiros (federação)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-idp.html) no *Guia do usuário do IAM*. Se usar o Centro de Identidade do IAM, configure um conjunto de permissões. Para controlar o que suas identidades podem acessar após a autenticação, o Centro de Identidade do IAM correlaciona o conjunto de permissões a um perfil no IAM. Para obter informações sobre conjuntos de permissões, consulte [Conjuntos de Permissões](https://docs.aws.amazon.com/singlesignon/latest/userguide/permissionsetsconcept.html) no *Guia do Usuário do Centro de Identidade do AWS IAM *.
Você também pode usar **git-remote-codecommit** com um usuário do IAM. Ao contrário de outros métodos de conexão HTTPS, **git-remote-codecommit** não requer a configuração de credenciais do Git para o usuário.
**nota**
Alguns IDEs não suportam o formato de URL de clone usado pelo`git-remote-codecommit`. Talvez seja necessário clonar manualmente repositórios para o computador local para poder trabalhar com eles no IDE de preferência. Para obter mais informações, consulte [Solução de problemas git-remote-codecommit e AWS CodeCommit](troubleshooting-grc.md).
Esses procedimentos são escritos com a suposição de que você tem uma conta da Amazon Web Services, criou pelo menos um repositório e usa um usuário do IAM com uma política gerenciada ao se conectar aos CodeCommit repositórios. CodeCommit Para obter informações sobre como configurar o acesso para usuários federados e outros tipos de credenciais rotativas, consulte [Conectando-se a AWS CodeCommit repositórios com credenciais rotativas](temporary-access.md).
**Topics**
+ [Etapa 0: instalar os pré-requisitos para git-remote-codecommit](#setting-up-git-remote-codecommit-prereq)
+ [Etapa 1: Configuração inicial para CodeCommit](#setting-up-git-remote-codecommit-account)
+ [Etapa 2: instalar git-remote-codecommit](#setting-up-git-remote-codecommit-install)
+ [Etapa 3: Conectar-se ao CodeCommit console e clonar o repositório](#setting-up-git-remote-codecommit-connect-console)
+ [Próximas etapas](#setting-up-git-remote-codecommit-next-step)
## Etapa 0: instalar os pré-requisitos para git-remote-codecommit
Para utilizar **git-remote-codecommit**, é necessário instalar alguns pré-requisitos no computador local. Isso inclui:
+ Uma versão compatível do Python. Para obter mais informações sobre as versões compatíveis do Python, consulte. [git-remote-codecommit](https://pypi.org/project/git-remote-codecommit/)
Para obter mais informações sobre como configurar e usar git-remote-codecommit, consulte[Etapas de configuração para conexões HTTPS AWS CodeCommit com git-remote-codecommit](#setting-up-git-remote-codecommit).
+ Git
**nota**
Ao instalar o Python no Windows, não se esqueça de escolher a opção para adicionar o Python ao caminho.
**git-remote-codecommit** requer o pip versão 9.0.3 ou posterior. Para verificar sua versão do pip, abra um terminal ou a linha de comando e execute o seguinte comando:
```
pip --version
```
É possível executar os dois comandos a seguir para atualizar sua versão do pip para a versão mais recente:
```
curl -O https://bootstrap.pypa.io/get-pip.py
python3 get-pip.py --user
```
Para trabalhar com arquivos, commits e outras informações em CodeCommit repositórios, você deve instalar o Git na sua máquina local. CodeCommit suporta as versões 1.7.9 e posteriores do Git. A versão 2.28 do Git é compatível com a configuração do nome de ramificações para as confirmações iniciais. Recomendamos o uso de uma versão recente do Git.
Para instalar o Git, recomendamos sites como o [Git Downloads](http://git-scm.com/downloads).
**nota**
O Git é uma plataforma em constante evolução atualizada regularmente. Ocasionalmente, uma alteração de recurso pode afetar a forma como funciona com CodeCommit. Se você encontrar problemas com uma versão específica do Git and CodeCommit, revise as informações em. [Solução de problemas](troubleshooting.md)
## Etapa 1: Configuração inicial para CodeCommit
Siga estas etapas para criar um usuário do IAM, configurá-lo com as políticas apropriadas, obter uma chave de acesso e uma chave secreta e instalar e configurar a AWS CLI.
**Para criar e configurar um usuário do IAM para acessar CodeCommit**
1. Crie uma conta da Amazon Web Services acessando [http://aws.amazon.com](https://aws.amazon.com/) e escolhendo **Cadastrar-se**.
1. Crie um usuário do IAM ou use um existente na sua conta da Amazon Web Services. Confirme se você tem um ID de chave de acesso e uma chave de acesso secreta associados ao usuário do IAM. Para obter mais informações, consulte [Criar um usuário do IAM na conta da Amazon Web Services](https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_SettingUpUser.html).
**nota**
CodeCommit requer AWS Key Management Service. Se você estiver usando um usuário do IAM existente, verifique se não há políticas anexadas ao usuário que neguem expressamente as AWS KMS ações exigidas pelo CodeCommit. Para obter mais informações, consulte [AWS KMS e criptografia](encryption.md).
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/).
1. No console do IAM, no painel de navegação, escolha **Usuários** e, em seguida, escolha o usuário do IAM que você deseja configurar para CodeCommit acesso.
1. Na guia **Permissions**, escolha **Add Permissions**.
1. Em **Grant permissions**, escolha **Attach existing policies directly**.
1. Na lista de políticas, selecione **AWSCodeCommitPowerUser**ou outra política gerenciada para CodeCommit acesso. Para obter mais informações, consulte [AWS políticas gerenciadas para CodeCommit](security-iam-awsmanpol.md).
Depois de selecionar a política que deseja anexar, escolha **Próximo: Revisar** para revisar a lista de políticas a serem anexadas ao usuário do IAM. Se a lista estiver correta, selecione **Add permissions**.
Para obter mais informações sobre políticas CodeCommit gerenciadas e compartilhamento de acesso a repositórios com outros grupos e usuários, consulte [Compartilhar um repositório](how-to-share-repository.md) e. [Autenticação e controle de acesso para AWS CodeCommit](auth-and-access-control.md)
**Para instalar e configurar o AWS CLI**
1. Em sua máquina local, baixe e instale AWS CLI o. Esse é um pré-requisito para interagir com a linha CodeCommit de comando. Recomendamos instalar a AWS CLI versão 2. É a versão principal mais recente do AWS CLI e oferece suporte a todos os recursos mais recentes. É a única versão do AWS CLI que suporta o uso de uma conta raiz, acesso federado ou credenciais temporárias com. **git-remote-codecommit**
Para obter mais informações, consulte [Como configurar a interface de linha de AWS comando](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-set-up.html).
**nota**
CodeCommit funciona somente com AWS CLI as versões 1.7.38 e posteriores. Como prática recomendada, instale ou atualize AWS CLI para a versão mais recente disponível. Para determinar qual versão do AWS CLI você instalou, execute o **aws --version** comando.
Para atualizar uma versão mais antiga do AWS CLI para a versão mais recente, consulte [Instalando AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) o.
1. Execute esse comando para verificar se os CodeCommit comandos do AWS CLI estão instalados.
```
aws codecommit help
```
Esse comando retorna uma lista de CodeCommit comandos.
1. Configure o AWS CLI com um perfil usando o **configure** comando, do seguinte modo:.
```
aws configure
```
Quando solicitado, especifique a chave de AWS acesso e a chave de acesso AWS secreta do usuário do IAM com CodeCommit a qual usar. Além disso, certifique-se de especificar Região da AWS onde o repositório existe, como`us-east-2`. Quando solicitado pelo formato de saída padrão, especifique `json`. Por exemplo, se você estiver configurando um perfil para um usuário do IAM:
```
AWS Access Key ID [None]: Type your IAM user AWS access key ID here, and then press Enter
AWS Secret Access Key [None]: Type your IAM user AWS secret access key here, and then press Enter
Default region name [None]: Type a supported region for CodeCommit here, and then press Enter
Default output format [None]: Type json here, and then press Enter
```
Para obter mais informações sobre como criar e configurar perfis para usar com o AWS CLI, consulte o seguinte:
+ [Perfis nomeados](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)
+ [Usando uma função do IAM no AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-role.html)
+ [Comando set](https://docs.aws.amazon.com/cli/latest/reference/set.html)
+ [Conectando-se a AWS CodeCommit repositórios com credenciais rotativas](temporary-access.md)
Para se conectar a um repositório ou recurso em outro Região da AWS, você deve reconfigurar o AWS CLI com o nome de região padrão. Os nomes de região padrão compatíveis CodeCommit incluem:
+ us-east-2
+ us-east-1
+ eu-west-1
+ us-west-2
+ ap-northeast-1
+ ap-southeast-1
+ ap-southeast-2
+ ap-southeast-3
+ me-central-1
+ eu-central-1
+ ap-northeast-2
+ sa-east-1
+ us-west-1
+ eu-west-2
+ ap-south-1
+ ap-south-1
+ ca-central-1
+ us-gov-west-1
+ us-gov-east-1
+ eu-north-1
+ ap-east-1
+ me-south-1
+ cn-north-1
+ cn-northwest-1
+ eu-south-1
+ ap-northeast-3
+ af-south-1
+ il-central-1
Para obter mais informações sobre CodeCommit e Região da AWS, consulte[Regiões e endpoints de conexão do Git](regions.md). Para obter mais informações sobre o IAM, chaves de acesso e chaves secretas, consulte [Como consigo credenciais?](https://docs.aws.amazon.com/IAM/latest/UserGuide/IAM_Introduction.html#IAM_SecurityCredentials) e [Gerenciar chaves de acesso para usuário do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/ManagingCredentials.html). Para obter mais informações sobre os perfis AWS CLI e, consulte [Perfis nomeados](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html).
## Etapa 2: instalar git-remote-codecommit
Siga estas etapas para instalar o **git-remote-codecommit**.
**Para instalar git-remote-codecommit**
1. No terminal ou na linha de comando, execute o seguinte comando:
```
pip install git-remote-codecommit
```
**nota**
Dependendo do sistema operacional e da configuração, talvez seja necessário executar esse comando com permissões elevadas, como sudo, ou usar o parâmetro --user para instalar em um diretório que não exija privilégios especiais, como sua conta de usuário atual. Por exemplo, em um computador executando Linux, macOS ou Unix:
```
sudo pip install git-remote-codecommit
```
Em um computador executando o Windows:
```
pip install --user git-remote-codecommit
```
1. Monitore o processo de instalação até que você veja uma mensagem de êxito.
## Etapa 3: Conectar-se ao CodeCommit console e clonar o repositório
Se um administrador já enviou a URL do clone para usar no CodeCommit repositório, você pode pular a conexão com **git-remote-codecommit** o console e clonar o repositório diretamente.
**Para se conectar a um 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. 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.md).
1. No terminal ou no prompt de comando, clone o repositório com o comando **git clone**. Use o git-remote-codecommit URL HTTPS que você copiou e o nome do AWS CLI perfil, se você criou um perfil nomeado. Se você não especificar um perfil, o comando assumirá o perfil padrão. O repositório local é criado em um subdiretório do diretório onde o comando é executado. Por exemplo, para clonar um repositório chamado *MyDemoRepo* para um repositório local chamado *my-demo-repo*:
```
git clone codecommit://MyDemoRepo my-demo-repo
```
Para clonar o mesmo repositório usando um perfil chamado: *CodeCommitProfile*
```
git clone codecommit://CodeCommitProfile@MyDemoRepo my-demo-repo
```
Para clonar um repositório em um repositório Região da AWS diferente daquele configurado em seu perfil, inclua o Região da AWS nome. Por exemplo:
```
git clone codecommit::ap-northeast-1://MyDemoRepo my-demo-repo
```
## Próximas etapas
Você concluiu os pré-requisitos. Siga as etapas [Começando com CodeCommit ](getting-started-cc.md) para começar a usar CodeCommit.
Para saber como criar e enviar via push sua primeira confirmação, consulte [Crie um commit em AWS CodeCommit](how-to-create-commit.md). Se você é novo no Git, revise as informações em [Como posso saber mais sobre o Git?](welcome.md#welcome-get-started-with-git) e [Começando com o Git e AWS CodeCommit](getting-started.md).