Configurando para AWS CodeCommit

Você pode entrar no AWS Management Console e fazer upload, adicionar ou editar um arquivo em um repositório diretamente do AWS CodeCommit console. Esta é uma maneira rápida de fazer uma alteração. No entanto, se você quiser trabalhar com vários arquivos, arquivos em ramificações, e assim por diante, considere configurar o computador local para trabalhar com repositórios. A maneira mais fácil de configurar CodeCommit é configurar as credenciais HTTPS Git para. AWS CodeCommit Esse método de autenticação HTTPS:

• Usa um nome de usuário e uma senha estáticos.

• Funciona com todos os sistemas operacionais suportados pelo CodeCommit.

• Também é compatível com ambientes de desenvolvimento integrados (IDEs) e outras ferramentas de desenvolvimento que oferecem suporte às credenciais do Git.

Você pode usar outros métodos, se não quiser ou não puder usar credenciais do Git por motivos operacionais. Por exemplo, se você acessar CodeCommit repositórios usando acesso federado, credenciais temporárias ou um provedor de identidade da web, não poderá usar as credenciais do Git. Recomendamos configurar seu computador local usando o comando git-remote-codecommit. Revise essas opções cuidadosamente, a fim de decidir qual método alternativo funciona melhor para você.

• Configurar usando credenciais do Git

• Configurar usando outros métodos

• Compatibilidade para CodeCommit, Git e outros componentes

Para obter informações sobre o uso CodeCommit da Amazon Virtual Private Cloud, consulteUsando AWS CodeCommit com interface VPC endpoints.

Visualizar e gerenciar suas credenciais

Você pode visualizar e gerenciar suas CodeCommit credenciais no AWS console por meio de Minhas Credenciais de Segurança.

nota

Essa opção não está disponível para usuários que usam acesso federado, credenciais temporárias ou um provedor de identidade da Web.

1. Faça login no AWS Management Console e abra o console do IAM em https://console.aws.amazon.com/iam/.

2. Na barra de navegação no canto superior direito, escolha seu nome de usuário e selecione Credenciais de segurança.

3. Selecione a guia Credenciais do AWS CodeCommit .

Configurar usando credenciais do Git

Com conexões HTTPS e credenciais do Git, você gera um nome de usuário e senha estáticos no IAM. Essas credenciais são usadas com o Git e qualquer outra ferramenta de terceiros com suporte para a autenticação usando o nome de usuário e a senha do Git. Esse método é suportado pela maioria das IDEs ferramentas de desenvolvimento. É o método de conexão mais simples e fácil de usar CodeCommit.

• Para usuários de HTTPS usando credenciais do Git: siga estas instruções para configurar conexões entre o computador local e os CodeCommit repositórios usando as credenciais do Git.

• Para conexões a partir de ferramentas de desenvolvimento: siga estas diretrizes para configurar conexões entre seu IDE ou outras ferramentas e CodeCommit repositórios de desenvolvimento usando as credenciais do Git. IDEs que oferecem suporte às credenciais do Git incluem (mas não estão limitados a) Visual Studio, Xcode e IntelliJ.

Configurar usando outros métodos

Você pode usar o protocolo SSH em vez de HTTPS para se conectar ao seu CodeCommit repositório. Com conexões SSH, você cria arquivos de chave pública e privada em sua máquina local que o Git CodeCommit usa para autenticação SSH. A chave pública deve ser associada ao seu usuário do IAM. e a chave privada é armazenada na sua máquina local. Como o SSH requer a criação e o gerenciamento manuais de arquivos de chave pública e privada, as credenciais do Git talvez sejam mais simples e fáceis de usar com o CodeCommit.

Diferente das credenciais do Git, a configuração da conexão SSH varia de acordo com o sistema operacional de seu computador local.

• Para usuários de SSH que não usam o AWS CLI: siga estas instruções resumidas se você já tiver um par de chaves pública e privada e estiver familiarizado com conexões SSH em seu computador local.

• Para conexões SSH no Linux, macOS ou Unix: siga estas instruções para ver um step-by-step passo a passo sobre como criar um par de chaves público-privadas e configurar conexões nos sistemas operacionais Linux, macOS ou Unix.

• Para conexões SSH no Windows: siga estas instruções para ver um step-by-step passo a passo sobre como criar um par de chaves público-privado e configurar conexões nos sistemas operacionais Windows.

Se você estiver se conectando CodeCommit e AWS usando acesso federado, um provedor de identidade ou credenciais temporárias, ou se não quiser configurar usuários do IAM ou credenciais do Git para usuários do IAM, você pode configurar conexões com CodeCommit repositórios de duas maneiras:

• Instale e use git-remote-codecommit (recomendado).

• Instale e use o assistente de credenciais incluído na AWS CLI.

Ambos os métodos oferecem suporte ao acesso a CodeCommit repositórios sem a necessidade de um usuário do IAM, o que significa que você pode se conectar aos repositórios usando acesso federado e credenciais temporárias. O git-remote-codecommit utilitário é a abordagem recomendada. Ele estende o Git e é compatível com uma variedade de versões do Git e assistentes de credenciais. No entanto, nem todos IDEs oferecem suporte ao formato de URL de clone usado pelogit-remote-codecommit. Talvez seja necessário clonar manualmente repositórios no computador local para poder trabalhar com eles no IDE.

• Siga as instruções em Etapas de configuração para conexões HTTPS com AWS CodeCommit repositórios git-remote-codecommit para instalar e configurar git-remote-codecommit no Windows, Linux, macOS ou Unix.

O auxiliar de credenciais incluído no permite que o AWS CLI Git use HTTPS e uma versão assinada criptograficamente de suas credenciais de usuário do IAM ou da EC2 função de instância da Amazon sempre que o Git precisar se autenticar para interagir com repositórios. AWS CodeCommit Alguns sistemas operacionais e versões do Git têm seus próprios assistentes de credenciais, que entram em conflito com o assistente de credenciais incluído na AWS CLI. Eles podem causar problemas de conectividade para CodeCommit.

• Para conexões HTTPS no Linux, macOS ou Unix com o auxiliar de credenciais AWS CLI : siga estas instruções para ver um step-by-step passo a passo sobre como instalar e configurar o auxiliar de credenciais em sistemas Linux, macOS ou Unix.

• Para conexões HTTPS no Windows com o auxiliar de AWS CLI credenciais: Siga estas instruções para obter um step-by-step passo a passo sobre como instalar e configurar o auxiliar de credenciais em sistemas Windows.

Se você estiver se conectando a um CodeCommit repositório hospedado em outra conta da Amazon Web Services, você pode configurar o acesso e configurar conexões usando funções, políticas e o auxiliar de credenciais incluído no. AWS CLI

• Configurar o acesso entre contas a um AWS CodeCommit repositório usando funções: Siga estas instruções para ver um step-by-step passo a passo da configuração do acesso entre contas em uma conta da Amazon Web Services para usuários em um grupo do IAM em outra conta da Amazon Web Services.

Compatibilidade para CodeCommit, Git e outros componentes

Quando você trabalha com CodeCommit, você usa o Git. Outros programas também podem ser usados. A tabela a seguir fornece as orientações mais recente sobre compatibilidade de versão. Como prática recomendada, use as versões mais recentes do Git e de outros softwares.

Informações de compatibilidade de versão para AWS CodeCommit

Componente	Versão
Git	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.
Curl	CodeCommit requer o curl 7.33 e versões posteriores. No entanto, há um problema conhecido entre HTTPS e a atualização 7.41.0 do curl. Para obter mais informações, consulte Solução de problemas.
Python (somente git-remote-codecommit)	git-remote-codecommit requer a versão 3 e posterior.
Pip (somente git-remote-codecommit)	git-remote-codecommit requer a versão 9.0.3 e posterior.
AWS CLI (git-remote-codecommitsomente)	Recomendamos uma versão recente da AWS CLI versão 2 para todos os CodeCommit usuários. git-remote-codecommitrequer a AWS CLI versão 2 para oferecer suporte a AWS SSO e conexões que exigem credenciais temporárias, como usuários federados.