View a markdown version of this page

Configurando para AWS CodeCommit - AWS CodeCommit

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

Configurando para AWS CodeCommit

Você pode entrar no Console de gerenciamento da AWS e carregar, 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 do 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.

  • É 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 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ê.

Para obter informações sobre como usar CodeCommit a Amazon Virtual Private Cloud, consulteUtilizar 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 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 CodeCommit.

Configurar usando outros métodos

Você pode usar o protocolo SSH em vez de HTTPS para se conectar ao seu CodeCommit repositório. Com as conexões SSH, você cria arquivos de chave pública e privada em sua máquina local que são CodeCommit usados pelo Git 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 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 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 exigir um usuário do IAM, o que significa que você pode se conectar aos 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 auxiliar de credenciais incluído no AWS CLI permite que o Git use HTTPS e uma versão criptograficamente assinada de suas credenciais de usuário do IAM ou da função de instância do Amazon EC2 sempre que o Git precisar se autenticar para interagir com os 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.

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

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 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-codecommitexige que a AWS CLI versão 2 AWS ofereça suporte a SSO e conexões que exigem credenciais temporárias, como usuários federados.