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 do HTTPS Git para. AWS CodeCommit Esse método HTTPS de autenticação:

• 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 VPC endpoints de interface.

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 IAM console 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 HTTPS conexões 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 sua e outras ferramentas IDE de desenvolvimento e CodeCommit repositórios usando as credenciais do Git. IDEsque 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 SSH protocolo em vez de se conectar HTTPS ao seu CodeCommit repositório. Com SSH as conexões, você cria arquivos de chave pública e privada em sua máquina local que o Git CodeCommit usa para SSH autenticação. Você associa a chave pública ao seu IAM usuário. e a chave privada é armazenada na sua máquina local. Como SSH requer a criação e o gerenciamento manuais de arquivos de chave pública e privada, talvez você ache as credenciais do Git mais simples e fáceis de usar. CodeCommit

Diferentemente das credenciais do Git, a configuração da SSH conexão varia, dependendo do sistema operacional em seu computador local.

• Para usuários de SSH que não usam a AWS CLI: siga estas instruções abreviadas se você já tiver um par de chaves público-privado e estiver SSH familiarizado com as conexões 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 IAM usuários ou credenciais do Git para IAM usuários, 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 IAM usuário, 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 URL formato de clone usado pelogit-remote-codecommit. Talvez você precise clonar manualmente os repositórios no seu computador local antes de poder trabalhar com eles no seu. IDE

• Siga as instruções em Etapas de configuração para HTTPS conexões 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 uma versão assinada criptograficamente de suas IAM credenciais de usuário ou 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 assistente de credenciais da 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 assistente de credenciais da AWS CLI: 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 sobre como configurar o acesso entre contas em uma conta da Amazon Web Services para usuários em um IAM grupo 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 melhor prática, recomendamos que você use as versões mais recentes do Git e de outros softwares.

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

Componente	Version (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 com a atualização HTTPS 7.41.0 do curl. Para ter 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 suporte AWS SSO e conexões que exigem credenciais temporárias, como usuários federados.