Configuração do AWS CodeCommit - AWS CodeCommit

O AWS CodeCommit não está mais disponível para novos clientes. Os clientes atuais do AWS CodeCommit podem continuar usando o serviço normalmente. Saiba mais"

Configuração do AWS CodeCommit

Você pode fazer login no Console de gerenciamento da AWS e fazer upload, adicionar ou editar um arquivo em um repositório diretamente no console do AWS CodeCommit. 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 o CodeCommit é configurar as credenciais do Git HTTPS para o 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 compatíveis com o CodeCommit.

  • É compatível com ambientes de desenvolvimento integrados (IDEs) e outras ferramentas de desenvolvimento com suporte para 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 repositórios do CodeCommit usando acesso federado, credenciais temporárias ou um provedor de identidade da Web, não poderá usar 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ê.

Para obter informações sobre o uso do CodeCommit e da Amazon Virtual Private Cloud, consulte Usar o AWS CodeCommit com endpoints da VPC de interface.

Visualizar e gerenciar suas credenciais

Você pode visualizar e gerenciar suas credenciais do CodeCommit no console da AWS em 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 Console de gerenciamento da AWS 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 tem suporte da maioria das IDEs e das ferramentas de desenvolvimento. É o método de conexão mais simples e fácil de usar com o CodeCommit.

Configurar usando outros métodos

Você pode usar o protocolo SSH em vez de HTTPS para se conectar ao repositório do CodeCommit. Com conexões SSH, você cria arquivos de chave pública e privada em sua máquina local que o Git e o CodeCommit usam para a 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, talvez você ache as credenciais do Git 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 a 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 essas instruções para obter orientações passo a passo sobre como criar um par de chaves pública e privada e configurar conexões em sistemas operacionais Linux, macOS ou Unix.

  • Para conexões SSH no Windows: siga estas instruções para obter orientação passo a passo sobre a criação de um par de chaves pública e privada e a configuração de conexões em sistemas operacionais Windows.

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

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

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

Com os dois métodos, você pode acessar repositórios do CodeCommit sem a necessidade de um usuário do IAM, ou seja, se conectar a repositórios usando acesso federado e credenciais temporárias. O utilitário git-remote-codecommit é 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 os IDEs oferecem suporte ao formato de URL de clone usado pelo git-remote-codecommit. Talvez seja necessário clonar manualmente repositórios no computador local para poder trabalhar com eles no IDE.

O assistente de credenciais incluído na AWS CLI permite que o Git use HTTPS e uma versão assinada com criptografia de suas credenciais de usuário do IAM ou um perfil de instância do Amazon EC2 sempre que ele precisar da autenticação da AWS para interagir com os repositórios do 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 no CodeCommit.

Se você estiver se conectando a um repositório do CodeCommit hospedado em outra conta da Amazon Web Services, poderá configurar o acesso e definir conexões usando perfis, políticas e o assistente de credenciais incluído na AWS CLI.

Compatibilidade para CodeCommit, Git e outros componentes

Ao trabalhar com o CodeCommit, use 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 sobre compatibilidade de versões do AWS CodeCommit
Componente Versão
Git O CodeCommit é compatível com o Git versões 1.7.9 e posteriores. 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 O 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 (somente git-remote-codecommit) Recomendamos uma versão recente da AWS CLI versão 2 para todos os usuários do CodeCommit. O git-remote-codecommit requer a AWS CLI versão 2 para ser compatível com o AWS SSO e conexões que exigem credenciais temporárias, como usuários federados.