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 com AWS CodeCommit repositórios no Windows com o auxiliar de AWS CLI credenciais
Antes de se conectar AWS CodeCommit pela primeira vez, você deve concluir as etapas iniciais de configuração. Para a maioria dos usuários, isso pode ser feito mais facilmente seguindo as etapas em [Para usuários de HTTPS usando credenciais do Git](setting-up-gc.md). No entanto, se você quiser se conectar CodeCommit usando uma conta raiz, acesso federado ou credenciais temporárias, você pode usar o auxiliar de credenciais incluído no. AWS CLI
**nota**
Embora o auxiliar de credenciais seja um método compatível para se conectar CodeCommit usando acesso federado, um provedor de identidade ou credenciais temporárias, o método recomendado é instalar e usar o utilitário. **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).
Este tópico explica as etapas para instalar o AWS CLI, configurar seu computador e AWS perfil, conectar-se a um CodeCommit repositório e clonar esse repositório em seu computador, também conhecido como criação de um repositório local. Se não estiver familiarizado com o Git, revise as informações em [Como posso saber mais sobre o Git?](welcome.md#welcome-get-started-with-git).
**Topics**
+ [
## Etapa 1: Configuração inicial para CodeCommit
](#setting-up-https-windows-account)
+ [
## Etapa 2: Instalar o Git
](#setting-up-https-windows-install-git)
+ [
## Etapa 3: Configurar o assistente de credenciais
](#setting-up-https-windows-credential-helper)
+ [
## Etapa 4: Conectar-se ao CodeCommit console e clonar o repositório
](#setting-up-https-windows-connect-console)
+ [
## Próximas etapas
](#setting-up-https-windows-next-step)
## Etapa 1: Configuração inicial para CodeCommit
Siga estas etapas para configurar uma conta da Amazon Web Services, criar e configurar um usuário do IAM e instalar a AWS CLI. AWS CLI Isso inclui um auxiliar de credencial que você configura para conexões HTTPS com seus CodeCommit repositórios.
**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, certifique-se de que não haja 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, não se esqueça 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 o Git
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 [Git for Windows](https://gitforwindows.org/). Se você usar esse link para instalar o Git, poderá aceitar todas as configurações padrão da instalação, exceto as seguintes:
+ Quando solicitado durante a etapa **Ajustar o seu ambiente PATH**, escolha a opção de usar o Git na linha de comando.
+ (Opcional) Se você pretende usar HTTPS com o auxiliar de credenciais incluído no, em AWS CLI vez de configurar as credenciais CodeCommit do Git, na página **Configurando opções extras, verifique se a opção Habilitar o** **Git** Credential Manager está desmarcada. O Gerenciador de Credenciais do Git só é compatível CodeCommit se os usuários do IAM configurarem as credenciais do Git. Para obter mais informações, consulte [Para usuários de HTTPS usando credenciais do Git](setting-up-gc.md) e [Git para Windows: eu instalei o Git para Windows, mas o acesso ao meu repositório é negado (403)](troubleshooting-ch.md#troubleshooting-windowshttps).
**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 3: Configurar o assistente de credenciais
AWS CLI Isso inclui um auxiliar de credencial do Git com o qual você pode usar. CodeCommit O auxiliar de credenciais do Git requer um perfil de AWS credencial, que armazena uma cópia do ID da chave de acesso e da chave de AWS acesso AWS secreta de um usuário do IAM (junto com um Região da AWS nome padrão e formato de saída padrão). O auxiliar de credenciais do Git usa essas informações para se autenticar automaticamente, CodeCommit então você não precisa inserir essas informações toda vez que usar o Git para interagir com. CodeCommit
1. Abra um prompt de comando e use o Git para executar**git config**, especificando o uso do auxiliar de credenciais do Git com o perfil de credencial, o que permite que o auxiliar de AWS credenciais do Git envie o caminho para os repositórios:
```
git config --global credential.helper "!aws codecommit credential-helper $@"
git config --global credential.UseHttpPath true
```
O assistente de credenciais do Git grava o seguinte no arquivo .gitconfig:
```
[credential]
helper = !aws codecommit credential-helper $@
UseHttpPath = true
```
**Importante**
Se você estiver usando um emulador de Bash em vez da linha de comando do Windows, deve usar aspas simples em vez de aspas duplas.
O auxiliar de credencial usa o AWS perfil padrão ou a função de instância do Amazon EC2. Se você criou um perfil de AWS credencial para usar, como*CodeCommitProfile*, você pode modificar o comando da seguinte forma para usá-lo em vez disso:
```
git config --global credential.helper "!aws codecommit credential-helper --profile CodeCommitProfile $@"
```
Isso grava o seguinte no arquivo .gitconfig:
```
[credential]
helper = !aws codecommit credential-helper --profile=CodeCommitProfile $@
UseHttpPath = true
```
Se o nome do seu perfil tiver espaços, será necessário editar o arquivo .gitconfig depois de executar esse comando para inseri-lo em aspas simples ('). Caso contrário, o assistente de credenciais não funcionará.
Se a instalação do Git para Windows incluir o utilitário Git Credential Manager, você verá erros 403 ou solicitações para fornecer credenciais no utilitário Credential Manager após as primeiras tentativas de conexão. A maneira mais confiável de resolver esse problema é desinstalar e reinstalar o Git para Windows sem a opção do utilitário Git Credential Manager, pois ele não é compatível com o CodeCommit. Se você quiser manter o utilitário Git Credential Manager, você deve executar etapas adicionais de configuração para usá-lo também CodeCommit, incluindo a modificação manual do arquivo.gitconfig para especificar o uso do auxiliar de credenciais ao se conectar a. AWS CodeCommit CodeCommit Exclua todas as credenciais armazenadas do utilitário Credential Manager (o utilitário pode ser encontrado no Painel de Controle). Depois de remover todas as credenciais armazenadas, adicione o seguinte ao seu arquivo .gitconfig, salve-o e tente se conectar novamente a partir de uma nova janela do prompt de comando:
```
[credential "https://git-codecommit.us-east-2.amazonaws.com"]
helper = !aws codecommit credential-helper $@
UseHttpPath = true
[credential "https://git-codecommit.us-east-1.amazonaws.com"]
helper = !aws codecommit credential-helper $@
UseHttpPath = true
```
Além disso, talvez seja necessário redefinir as configurações de **git config** especificando **--system** em vez de **--global** ou **--local** para que todas as conexões funcionem como esperado.
Se você quiser usar diferentes usuários do IAM na mesma máquina local CodeCommit, especifique ** git config --local** em vez de **git config --global** e execute a configuração para cada perfil de AWS credencial.
1. Execute **git config --global --edit** para verificar se os valores anteriores foram gravados no arquivo .gitconfig para seu perfil de usuário (por padrão, `%HOME%\.gitconfig` ou `drive:\Users\UserName\.gitconfig`). Se houver êxito, você verá os valores anterior (além de valores que já possam existir no arquivo de configuração global do Git). Para sair, normalmente, você digita **:q** e pressiona Enter.
## Etapa 4: Conectar-se ao CodeCommit console e clonar o repositório
Se um administrador já tiver enviado a você o nome e os detalhes da conexão do CodeCommit repositório, você pode pular essa etapa 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. Abra um prompt de comando e execute o comando **git clone** com a URL HTTPS que você copiou. O repositório local é criado em um subdiretório do diretório onde o comando é executado. Por exemplo, para clonar um repositório com o nome *MyDemoRepo* de um repositório local nomeado *my-demo-repo* na região Leste dos EUA (Ohio):
```
git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo
```
Em algumas versões do Windows, poderá ser exibida uma mensagem pop-up solicitando seu nome de usuário e sua senha. Esse é o sistema de gerenciamento de credenciais interno do Windows, mas ele não é compatível com o assistente de credenciais do AWS CodeCommit. Escolha **Cancelar**.
## 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.