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 SSH com AWS CodeCommit repositórios no Windows Antes de se conectar AWS CodeCommit pela primeira vez, você deve concluir algumas etapas iniciais de configuração. Depois de configurar o computador e o AWS perfil, você pode se conectar a um CodeCommit repositório e clonar esse repositório no seu computador (também conhecido como criar 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-ssh-windows-account) + [Etapa 2: Instalar o Git](#setting-up-ssh-windows-install-git) + [Etapa 3: configurar as chaves públicas e privadas para o Git e CodeCommit](#setting-up-ssh-windows-keys-windows) + [Etapa 4: Conectar-se ao CodeCommit console e clonar o repositório](#setting-up-ssh-windows-connect-console) + [Próximas etapas](#setting-up-ssh-windows-next-step) ## Etapa 1: Configuração inicial para CodeCommit Siga estas etapas para configurar uma conta da Amazon Web Services, criar um usuário do IAM e configurar o acesso CodeCommit a. **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) **nota** Se você quiser usar AWS CLI comandos com CodeCommit, instale AWS CLI o. Para obter mais informações, consulte [Referência da linha de comando](cmd-ref.md). ## 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 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) Se a versão do Git que você instalou não incluir um emulador de Bash, como o Git Bash, instale um. Use esse emulador em vez da linha de comando do Windows ao configurar conexões SSH. ## Etapa 3: configurar as chaves públicas e privadas para o Git e CodeCommit **Para configurar as chaves públicas e privadas para o Git e CodeCommit no Windows** 1. Abra o emulador de Bash. **nota** Talvez seja necessário executar o emulador com permissões administrativas. No emulador, execute o comando **ssh-keygen** e siga as instruções para salvar o arquivo no diretório .ssh do seu perfil. Por exemplo: ``` $ ssh-keygen Generating public/private rsa key pair. Enter file in which to save the key (/drive/Users/user-name/.ssh/id_rsa): Type a file name here, for example /c/Users/user-name/.ssh/codecommit_rsa Enter passphrase (empty for no passphrase): Enter same passphrase again: Your identification has been saved in drive/Users/user-name/.ssh/codecommit_rsa. Your public key has been saved in drive/Users/user-name/.ssh/codecommit_rsa.pub. The key fingerprint is: 45:63:d5:99:0e:99:73:50:5e:d4:b3:2d:86:4a:2c:14 user-name@client-name The key's randomart image is: +--[ RSA 2048]----+ | E.+.o*.++| | .o .=.=o.| | . .. *. +| | ..o . +..| | So . . . | | . | | | | | | | +-----------------+ ``` Isso gera: + O *codecommit\$1rsa* arquivo, que é o arquivo de chave privada. + O *codecommit\$1rsa* arquivo.pub, que é o arquivo de chave pública. **dica** Por padrão, o **ssh-keygen** gera uma chave de 2048 bits. Você pode usar os parâmetros -t e -b para especificar o tipo e o comprimento da chave. Se você quiser uma chave de 4096 bits no formato rsa, especifique isso executando o comando com os seguintes parâmetros: ``` ssh-keygen -t rsa -b 4096 ``` Para obter mais informações sobre os formatos e comprimentos necessários para as chaves SSH, consulte Como [usar o IAM com](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_ssh-keys.html#ssh-keys-code-commit). CodeCommit 1. Execute os comandos a seguir para exibir o valor do arquivo de chave pública (*codecommit\$1rsa*.pub): ``` cd .ssh notepad codecommit_rsa.pub ``` Copie o conteúdo do arquivo e, em seguida, feche o Bloco de Notas sem salvar. O conteúdo do arquivo é semelhante ao seguinte: ``` ssh-rsa EXAMPLE-AfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMCVVMxCzAJB gNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb2 5zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhc NMTEwNDI1MjA0NTIxWhcNMTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAw DgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDAS=EXAMPLE user-name@computer-name ``` 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/). **nota** Você pode visualizar e gerenciar diretamente suas CodeCommit credenciais em **Minhas Credenciais de Segurança**. Para obter mais informações, consulte [Visualizar e gerenciar suas credenciais](setting-up.md#setting-up-view-credentials). 1. No painel de navegação do console do IAM, selecione **Usuários** e, na lista de usuários, escolha o seu usuário do IAM. 1. Na página de detalhes do usuário, selecione a guia **Security Credentials** e, em seguida, **Upload SSH public key**. 1. Cole os conteúdos da chave SSH pública no campo e selecione **Upload SSH public key**. 1. Copie ou salve as informações no **ID da chave SSH** (por exemplo,*APKAEIBAERJR2EXAMPLE*). ![\[O ID da chave SSH no console do IAM\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-ssh-key-id-iam.png) **nota** Se você tiver mais de uma chave SSH IDs carregada, as chaves serão listadas alfabeticamente por ID da chave, não pela data de upload. Verifique se você copiou o ID da chave que está associado à data de upload correta. 1. No emulador de Bash, execute os seguintes comandos para criar um arquivo de configuração no diretório \$1/.ssh ou edite-o, caso já exista um: ``` notepad ~/.ssh/config ``` 1. Adicione as seguintes linhas ao arquivo, em que o valor para *User* é o ID da chave SSH que você copiou anteriormente e o valor para *IdentityFile* é o caminho e o nome do arquivo de chave privada: ``` Host git-codecommit.*.amazonaws.com User APKAEIBAERJR2EXAMPLE IdentityFile ~/.ssh/codecommit_rsa ``` **nota** Se você deu ao seu arquivo de chave privada um nome diferente de*codecommit\$1rsa*, não se esqueça de usá-lo aqui. Você pode configurar o acesso SSH aos repositórios em várias contas da Amazon Web Services. Para obter mais informações, consulte [Solução de problemas de conexões SSH com AWS CodeCommit](troubleshooting-ssh.md). Salve o arquivo como config (não config.txt) e feche o Bloco de Notas. **Importante** O nome do arquivo deve ser `config` sem extensão de arquivo. Caso contrário, as conexões SSH falharão. 1. Execute o seguinte comando para testar a sua configuração de SSH: ``` ssh git-codecommit.us-east-2.amazonaws.com ``` Você será solicitado a confirmar a conexão porque `git-codecommit.us-east-2.amazonaws.com` ainda não está incluído em seu arquivo de hosts conhecidos. A impressão digital CodeCommit do servidor é exibida como parte da verificação (`a9:6d:03:ed:08:42:21:be:06:e1:e0:2a:d1:75:31:5e`para MD5 ou `3lBlW2g5xn/NA2Ck6dyeJIrQOWvn7n8UEs56fG6ZIzQ` para SHA256). **nota** CodeCommit as impressões digitais do servidor são exclusivas para cada Região da AWS um. Para ver as impressões digitais do servidor de um Região da AWS, consulte[Impressões digitais do servidor para CodeCommit](regions.md#regions-fingerprints). Após confirmar a conexão, aparecerão a confirmação de que você adicionou o servidor ao seu arquivo hosts conhecido e uma mensagem de conexão bem-sucedida. Se você não ver uma mensagem de sucesso, verifique se você salvou o `config` arquivo no diretório \$1/.ssh do usuário do IAM ao qual você configurou para acesso CodeCommit, se o `config` arquivo não tem extensão de arquivo (por exemplo, ele não deve ser chamado de config.txt) e se você especificou o arquivo de chave privada correto (*codecommit\$1rsa*e não .pub). *codecommit\$1rsa* Para solucionar problemas, execute o comando `ssh` com o parâmetro `-v`. Por exemplo: ``` ssh -v git-codecommit.us-east-2.amazonaws.com ``` Para obter informações para ajudar a solucionar problemas de conexão, consulte [Solução de problemas de conexões SSH com AWS CodeCommit](troubleshooting-ssh.md). ## Etapa 4: Conectar-se ao CodeCommit console e clonar o repositório Se um administrador já enviou para você o nome e os detalhes de conexão do repositório do CodeCommit, ignore esta etapa e clone 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 emulador Bash, execute o comando **git clone** com o URL SSH copiado para clonar o repositório. Esse comando cria o repositório local 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 ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo ``` Como alternativa, abra um prompt de comando e, usando a URL e o ID de chave SSH da chave pública que você fez upload no IAM, execute o comando **git clone**. 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 ssh://Your-SSH-Key-ID@git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo ``` Para obter mais informações, consulte [Conecte-se ao CodeCommit repositório clonando o repositório](how-to-connect.md#how-to-connect-http) e [Criar uma confirmação](how-to-create-commit.md). ## 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.