

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á.

# Configuração de conexões a partir de ferramentas de desenvolvimento usando credenciais do Git
<a name="setting-up-ide"></a>

Depois configurar as credenciais do Git para o AWS CodeCommit no console do IAM, você poderá usá-las com qualquer ferramenta de desenvolvimento compatível com credenciais do Git. Por exemplo, você pode configurar o acesso ao repositório do CodeCommit no AWS Cloud9, Visual Studio, Xcode, IntelliJ ou em qualquer ambiente de desenvolvimento integrado (IDE) que inclua as credenciais do Git. Depois de configurar o acesso, você poderá editar seu código, confirmar suas alterações e enviar diretamente do IDE ou de outra ferramenta de desenvolvimento. 

**nota**  
Se você acessar repositórios do CodeCommit usando acesso federado, credenciais temporárias ou um provedor de identidade web, não poderá usar credenciais do Git. Recomendamos configurar seu computador local usando o comando `git-remote-codecommit`. No entanto, nem todos os IDEs são totalmente compatíveis com assistentes remotos do Git, como **git-remote-codecommit**. Se você tiver problemas, consulte [Solução de problemas git-remote-codecommit e AWS CodeCommit](troubleshooting-grc.md).

**Topics**
+ [Integre AWS Cloud9 com AWS CodeCommit](setting-up-ide-c9.md)
+ [Integre o Visual Studio com o AWS CodeCommit](setting-up-ide-vs.md)

Quando o IDE ou a ferramenta de desenvolvimento solicitar que você informe o nome de usuário e senha usados para conexão com o repositório do CodeCommit, forneça as credenciais do Git para **Nome de usuário** e a **Senha** que você criou no IAM. 

Para obter mais informações sobre Regiões da AWS e endpoints do CodeCommit, consulte [Regiões e endpoints de conexão do Git](regions.md).

Você também pode ver um prompt do seu sistema operacional para armazenar seu nome de usuário e senha. Por exemplo, no Windows, você forneceria suas credenciais do Git da seguinte maneira:

![\[Um prompt de segurança no Windows\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-ide-vs2.png)


Para obter informações sobre como configurar credenciais do Git para determinado programa de software ou ferramenta de desenvolvimento, consulte a documentação do produto. 

O seguinte não é uma lista abrangente de IDEs. Os links são fornecidos exclusivamente para ajudá-lo a saber mais sobre essas ferramentas. A AWS não se responsabiliza pelo conteúdo de nenhum desses tópicos. 
+ [AWS Cloud9](setting-up-ide-c9.md)  
![\[Clonar um repositório em AWS Cloud9.\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-ide-c9-clone.png)
+ [Visual Studio](https://www.visualstudio.com/en-us/docs/git/tutorial/creatingrepo#clone-an-existing-git-repo)

  Como alternativa, instale o AWS Toolkit for Visual Studio. Para obter mais informações, consulte [Integre o Visual Studio com o AWS CodeCommit](setting-up-ide-vs.md).  
![\[Clonagem de um repositório no Visual Studio.\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-ide-vs1.png)
+ [XCode](https://developer.apple.com/library/content/documentation/IDEs/Conceptual/xcode_guide-continuous_integration/PublishYourCodetoaSourceRepository.html)

# Integre AWS Cloud9 com AWS CodeCommit
<a name="setting-up-ide-c9"></a>

Você pode usar AWS Cloud9 para fazer alterações no código em um CodeCommit repositório. AWS Cloud9 contém uma coleção de ferramentas que você pode usar para escrever código e criar, executar, testar, depurar e lançar software. Você pode clonar repositórios existentes, criar repositórios, confirmar e enviar alterações de código para um repositório e muito mais, tudo a partir do seu AWS Cloud9 ambiente de desenvolvimento EC2. O ambiente de desenvolvimento do AWS Cloud9 EC2 geralmente é pré-configurado com a AWS CLI, uma função do Amazon EC2 e o Git. Portanto, na maioria dos casos, você pode executar alguns comandos simples e começar a interagir com seu repositório.

Para usar AWS Cloud9 com CodeCommit, você precisa do seguinte:
+ Um ambiente de desenvolvimento AWS Cloud9 EC2 executado no Amazon Linux.
+ O AWS Cloud9 IDE é aberto em um navegador da web.
+ Um usuário do IAM com uma das políticas CodeCommit gerenciadas e uma das políticas AWS Cloud9 gerenciadas aplicadas a ela.

  Para obter mais informações, consulte [AWS políticas gerenciadas para CodeCommit](security-iam-awsmanpol.md) e [Compreender os conceitos e suas credenciais de segurança](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html).
**nota**  
Este tópico descreve a configuração da integração com CodeCommit e AWS Cloud9 com o acesso geral da Internet. Você pode configurar o acesso a CodeCommit e AWS Cloud9 em um ambiente isolado, mas isso requer etapas adicionais. Para obter mais informações, consulte:  
[Usando AWS CodeCommit com interface VPC endpoints](codecommit-and-interface-VPC.md)
[Acessando instâncias sem entrada do Amazon EC2 com AWS Systems Manager](https://docs.aws.amazon.com/cloud9/latest/user-guide/ec2-ssm.html)
[Como trabalhar com ambientes compartilhados](https://docs.aws.amazon.com/cloud9/latest/user-guide/share-environment.html)
[Compartilhar sua VPC com outras contas](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-sharing.html)
[Publicação no blog: Isolando o acesso à rede em seus ambientes AWS Cloud9](https://aws.amazon.com/blogs/security/isolating-network-access-to-your-aws-cloud9-environments/)

**Topics**
+ [Etapa 1: criar um ambiente AWS Cloud9 de desenvolvimento](#setting-up-ide-c9-connect)
+ [Etapa 2: Configurar o auxiliar de AWS CLI credenciais em seu ambiente de desenvolvimento AWS Cloud9 EC2](#setting-up-ide-c9-credentials)
+ [Etapa 3: clonar um CodeCommit repositório em seu ambiente de desenvolvimento AWS Cloud9 EC2](#setting-up-ide-c9-checkout)
+ [Próximas etapas](#setting-up-ide-c9-next)

## Etapa 1: criar um ambiente AWS Cloud9 de desenvolvimento
<a name="setting-up-ide-c9-connect"></a>

AWS Cloud9 hospeda seu ambiente de desenvolvimento em uma instância do Amazon EC2. Essa é a maneira mais fácil de integrar, pois você pode usar as credenciais temporárias AWS gerenciadas da instância para se conectar ao seu CodeCommit repositório. Para usar seu próprio servidor, consulte o [Guia do usuário do AWS Cloud9](https://docs.aws.amazon.com/cloud9/latest/user-guide/). 

**Para criar um AWS Cloud9 ambiente**

1. Faça login AWS como o usuário do IAM que você configurou e abra o AWS Cloud9 console.

1. No AWS Cloud9 console, escolha **Criar ambiente**.

1. Em **Step 1: Name environment (Etapa 1: nomear ambiente)**, insira um nome e uma descrição opcional para o ambiente e selecione **Next step (Próxima etapa)**.

1. Em **Step 2: Configure Settings**, configure seu ambiente da seguinte maneira:
   + Em **Environment type**, escolha **Create a new instance for environment (EC2)**.
   + Em **Instance type**, escolha o tipo de instância adequado para o seu ambiente de desenvolvimento. Por exemplo, se você está apenas explorar o serviço, pode escolher o padrão de t2.micro. Se você pretende usar este ambiente para trabalho de desenvolvimento, escolha um tipo de instância maior.
   + Aceite as outras configurações padrão, a menos que você tenha motivos para escolher o contrário (por exemplo, sua organização usa uma VPC específica ou sua conta da Amazon Web Services não tem nenhuma VPCs configurada) e, em seguida, escolha **Próxima** etapa.

1. Em **Step 3: Review**, analise suas configurações. Escolha **Previous step** se quiser fazer qualquer alteração. Se não, escolha **Create environment**.

   A criação de um ambiente e a conexão a ele pela primeira vez leva vários minutos. Se parecer levar um tempo muito longo, consulte [Solução de problemas](https://docs.aws.amazon.com/cloud9/latest/user-guide/troubleshooting.html) no *Guia do usuário do AWS Cloud9 *.

1. Após a conexão com o ambiente, verifique se o Git já está instalado e se é uma versão compatível, executando o comando **git --version** na janela do terminal.

   Se o Git não estiver instalado, ou se não for uma versão compatível, instale uma versão compatível. 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). 
**dica**  
Dependendo do sistema operacional do ambiente, você pode usar o comando **yum** com a opção **sudo** para instalar atualizações, incluindo o Git. Por exemplo, uma sequência de comandos administrativos poderá se parecer com os seguintes três comandos:  

   ```
   sudo yum -y update
   sudo yum -y install git
   git --version
   ```

    

1. Configure um nome de usuário e e-mail a ser associado a suas confirmações do Git executando o comando **git config**. Por exemplo:

   ```
       git config --global user.name "Mary Major"
       git config --global user.email mary.major@example.com
   ```

## Etapa 2: Configurar o auxiliar de AWS CLI credenciais em seu ambiente de desenvolvimento AWS Cloud9 EC2
<a name="setting-up-ide-c9-credentials"></a>

Depois de criar um AWS Cloud9 ambiente, você pode configurar o auxiliar de AWS CLI credenciais para gerenciar as credenciais das conexões ao seu repositório. CodeCommit O ambiente de AWS Cloud9 desenvolvimento vem com credenciais temporárias AWS gerenciadas associadas ao seu usuário do IAM. Você usa essas credenciais com o auxiliar de AWS CLI credenciais.

1. Abra a janela do terminal e execute o seguinte comando para verificar se a AWS CLI está instalada:

   ```
   aws --version
   ```

   Se for bem-sucedido, este comando retornará a versão da AWS CLI instalada no momento. 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. No terminal, execute os seguintes comandos para configurar o auxiliar de AWS CLI credenciais para conexões HTTPS:

   ```
   git config --global credential.helper '!aws codecommit credential-helper $@'
   git config --global credential.UseHttpPath true
   ```
**dica**  
O assistente de credenciais usa o perfil de instância padrão do Amazon EC2 para o ambiente de desenvolvimento. Se você pretende usar o ambiente de desenvolvimento para se conectar a repositórios que não estão hospedados CodeCommit, configure conexões SSH com esses repositórios ou configure um `.gitconfig` arquivo local para usar um sistema alternativo de gerenciamento de credenciais ao se conectar a esses outros repositórios. Para obter mais informações, consulte [Ferramentas do GiT – armazenamento de credenciais](https://git-scm.com/book/en/v2/Git-Tools-Credential-Storage) no site do Git.

## Etapa 3: clonar um CodeCommit repositório em seu ambiente de desenvolvimento AWS Cloud9 EC2
<a name="setting-up-ide-c9-checkout"></a>

Depois de configurar o auxiliar de AWS CLI credenciais, você pode clonar seu CodeCommit repositório nele. Em seguida, pode começar a trabalhar com o código.

1. No terminal, execute o comando **git clone** especificando a URL do clone HTTPS do repositório que você deseja clonar. Por exemplo, se você quiser clonar um repositório chamado MyDemoRepo na região Leste dos EUA (Ohio), insira:

   ```
   git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo
   ```
**dica**  
Você pode encontrar o URL do clone do seu repositório no CodeCommit console escolhendo **Clone** URL.

1. Quando a clonagem for concluída, na navegação lateral, expanda a pasta do seu repositório e selecione o arquivo que deseja abrir para edição. Como alternativa, selecione **File (Arquivo)** e selecione **New file (Novo arquivo)** para criar um arquivo.

1. Quando você finalizar a edição ou a criação de arquivos, na janela do terminal, altere os diretórios para o repositório clonado e, em seguida, confirme e faça push de suas alterações. Por exemplo, se você adicionou um novo arquivo chamado*MyFile.py*:

   ```
   cd MyDemoRepo
   git commit -a MyFile.py
   git commit -m "Added a new file with some code improvements"
   git push
   ```

## Próximas etapas
<a name="setting-up-ide-c9-next"></a>

Para obter mais informações, consulte o [Guia AWS Cloud9 do usuário](https://docs.aws.amazon.com/cloud9/latest/user-guide/welcome.html) e a [CodeCommit amostra de AWS Cloud9](https://docs.aws.amazon.com/cloud9/latest/user-guide/sample-codecommit.html). Para obter mais informações sobre como usar o Git com CodeCommit, consulte. [Começando com o Git e AWS CodeCommit](getting-started.md)

# Integre o Visual Studio com o AWS CodeCommit
<a name="setting-up-ide-vs"></a>

Você pode usar o Visual Studio para fazer alterações de código em um repositório do CodeCommit. O AWS Toolkit for Visual Studio agora inclui atributos que tornam o trabalho no CodeCommit mais fácil e prático ao usar Visual Studio. A integração do Toolkit do Visual Studio foi desenvolvida para funcionar com credenciais do Git e usuário do IAM. Você pode clonar repositórios existentes, criar repositórios, confirmar e enviar alterações de código via push para um repositório e muito mais. 

**Importante**  
O Toolkit for Visual Studio está disponível para instalação apenas em sistemas operacionais Windows. Se você estiver procurando informações sobre como trabalhar com o Visual Studio Code, consulte [AWS Toolkit for Visual Studio Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/welcome.html). 

Se você usou já usou o Toolkit for Visual Studio, provavelmente já está familiarizado com a configuração de perfis de credenciais da AWS que contêm uma chave de acesso e uma chave secreta. Os perfis de credenciais são usados no Toolkit for Visual Studio para habilitar chamadas às APIs de serviço da AWS (por exemplo, para que o Amazon S3 liste buckets ou para que o CodeCommit liste repositórios). Para extrair e enviar via push códigos a um repositório do CodeCommit, você também precisa de credenciais do Git. Se você não tiver credenciais do Git, o Toolkit for Visual Studio poderá gerar e aplicar essas credenciais para você. Isso pode poupar muito tempo.

Para usar o Visual Studio com o CodeCommit, você precisa do seguinte:
+ Um usuário do IAM com um conjunto válido de credenciais (uma chave de acesso e uma chave secreta) configuradas para isso. Esse usuário do IAM também deve ter:

  Uma das políticas gerenciadas do CodeCommit e a política gerenciada do IAMSelfManageServiceSpecificCredentials aplicadas a ele.

  OU

  Se o usuário do IAM já tiver credenciais do Git configuradas, uma das políticas gerenciadas do CodeCommit ou permissões equivalentes.

   Para obter mais informações, consulte [AWS políticas gerenciadas para CodeCommit](security-iam-awsmanpol.md) e [Compreender os conceitos e suas credenciais de segurança](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html).
+ O AWS Toolkit for Visual Studio instalado no computador no qual você instalou o Visual Studio. Para obter mais informações, consulte [Configurar o AWS Toolkit for Visual Studio](https://docs.aws.amazon.com/AWSToolkitVS/latest/UserGuide/getting-set-up.html).

Para obter mais informações sobre como usar o AWS Toolkit for Visual Studio com o CodeCommit, consulte [Usar o AWS CodeCommit com o Visual Studio Team Explorer](https://docs.aws.amazon.com/toolkit-for-visual-studio/latest/user-guide/using-aws-codecommit-with-team-explorer.html) no *Guia do Usuário do Toolkit for Visual Studio*.