Etapas de configuração para HTTPS conexões AWS CodeCommit com git-remote-codecommit - AWS CodeCommit
Etapa 0: instalar os pré-requisitos para git-remote-codecommitEtapa 1: Configuração inicial para CodeCommitEtapa 2: instalar git-remote-codecommitEtapa 3: Conectar-se ao CodeCommit console e clonar o repositórioPróximas etapas

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

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

Etapas de configuração para HTTPS conexões AWS CodeCommit com git-remote-codecommit

Se você quiser se conectar CodeCommit usando uma conta raiz, acesso federado ou credenciais temporárias, você deve configurar o acesso usando. git-remote-codecommit Esse utilitário fornece um método simples para enviar e extrair código de CodeCommit repositórios estendendo o Git. É o método recomendado para oferecer suporte a conexões feitas com acesso federado, provedores de identidade e credenciais temporárias. Para atribuir permissões a identidades federadas, você cria um perfil e define permissões para a perfil. Quando uma identidade federada é autenticada, essa identidade é associada ao perfil e recebe as permissões definidas pelo mesmo. Para obter informações sobre funções para federação, consulte Criar uma função para um provedor de identidade terceirizado (federação) no Guia IAM do usuário. Se você usa o IAM Identity Center, configura um conjunto de permissões. Para controlar o que suas identidades podem acessar após a autenticação, o IAM Identity Center correlaciona o conjunto de permissões a uma função em. IAM Para obter informações sobre conjuntos de permissões, consulte Conjuntos de Permissões no Manual do Usuário do AWS IAM Identity Center .

Você também pode usar git-remote-codecommit com um IAM usuário. Ao contrário de outros métodos de HTTPS conexão, git-remote-codecommit não exige a configuração de credenciais do Git para o usuário.

nota

Alguns IDEs não suportam o URL formato de clone usado pelogit-remote-codecommit. Talvez você precise clonar manualmente os repositórios em seu computador local antes de poder trabalhar com eles da maneira que preferir. IDE Para obter mais informações, consulte Solução de problemas git-remote-codecommit e AWS CodeCommit.

Esses procedimentos são escritos com a suposição de que você tem uma conta da Amazon Web Services, criou pelo menos um repositório e usa um IAM usuário com uma política gerenciada ao se conectar aos CodeCommit repositórios. CodeCommit Para obter informações sobre como configurar o acesso para usuários federados e outros tipos de credenciais rotativas, consulte Conectando-se a AWS CodeCommit repositórios com credenciais rotativas.

Etapa 0: instalar os pré-requisitos para git-remote-codecommit

Para utilizar git-remote-codecommit, é necessário instalar alguns pré-requisitos no computador local. Isso inclui:

nota

Ao instalar o Python no Windows, não se esqueça de escolher a opção para adicionar o Python ao caminho.

git-remote-codecommit requer o pip versão 9.0.3 ou posterior. Para verificar sua versão do pip, abra um terminal ou a linha de comando e execute o seguinte comando:

pip --version

É possível executar os dois comandos a seguir para atualizar sua versão do pip para a versão mais recente:

curl -O https://bootstrap.pypa.io/get-pip.py
python3 get-pip.py --user

Para trabalhar com arquivos, commits e outras informações em CodeCommit repositórios, você deve instalar o Git na sua máquina local. 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.

nota

O Git é uma plataforma em constante evolução atualizada regularmente. Ocasionalmente, uma alteração de recurso pode afetar a forma como funciona com CodeCommit. Se você encontrar problemas com uma versão específica do Git and CodeCommit, revise as informações em. Solução de problemas

Etapa 1: Configuração inicial para CodeCommit

Siga estas etapas para criar um IAM usuário, configurá-lo com as políticas apropriadas, obter uma chave de acesso e uma chave secreta e instalar e configurar AWS CLI o.

Para criar e configurar um IAM usuário para acessar CodeCommit

  1. Crie uma conta da Amazon Web Services acessando http://aws.amazon.com e escolhendo Cadastrar-se.

  2. Crie um IAM usuário ou use um existente em sua conta da Amazon Web Services. Verifique se você tem uma ID de chave de acesso e uma chave de acesso secreta associada a esse IAM usuário. Para obter mais informações, consulte Criação de um IAM usuário em sua conta da Amazon Web Services.

    nota

    CodeCommit requer AWS Key Management Service. Se você estiver usando um IAM usuário existente, certifique-se de que não haja políticas anexadas ao usuário que neguem expressamente as AWS KMS ações exigidas pelo CodeCommit. Para obter mais informações, consulte AWS KMS e criptografia.

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

  4. No IAM console, no painel de navegação, escolha Usuários e, em seguida, escolha o IAM usuário que você deseja configurar para CodeCommit acesso.

  5. Na guia Permissions, escolha Add Permissions.

  6. Em Grant permissions, escolha Attach existing policies directly.

  7. Na lista de políticas, selecione AWSCodeCommitPowerUserou outra política gerenciada para CodeCommit acesso. Para obter mais informações, consulte AWS políticas gerenciadas para CodeCommit.

    Depois de selecionar a política que você deseja anexar, escolha Avançar: Revisão para revisar a lista de políticas a serem anexadas ao IAM usuário. Se a lista estiver correta, selecione Add permissions.

    Para obter mais informações sobre políticas CodeCommit gerenciadas e compartilhamento de acesso a repositórios com outros grupos e usuários, consulte Compartilhar um repositório e. Autenticação e controle de acesso para o AWS CodeCommit

Para instalar e configurar o AWS CLI

  1. Em sua máquina local, baixe e instale AWS CLI o. Esse é um pré-requisito para interagir com a linha CodeCommit de comando. Recomendamos instalar a AWS CLI versão 2. É a versão principal mais recente do AWS CLI e oferece suporte a todos os recursos mais recentes. É a única versão do AWS CLI que suporta o uso de uma conta raiz, acesso federado ou credenciais temporárias com. git-remote-codecommit

    Para obter mais informações, consulte Como configurar a interface de linha de AWS comando.

    nota

    CodeCommit funciona somente com AWS CLI as versões 1.7.38 e posteriores. Como prática recomendada, instale ou atualize AWS CLI para a versão mais recente disponível. Para determinar qual versão do AWS CLI você instalou, execute o aws --version comando.

    Para atualizar uma versão mais antiga do AWS CLI para a versão mais recente, consulte Instalando AWS Command Line Interface o.

  2. Execute esse comando para verificar se os CodeCommit comandos do AWS CLI estão instalados.

    aws codecommit help

    Esse comando retorna uma lista de CodeCommit comandos.

  3. Configure o AWS CLI com um perfil usando o configure comando, do seguinte modo:.

    aws configure

    Quando solicitado, especifique a chave de AWS acesso e a chave de acesso AWS secreta do IAM usuário com CodeCommit a qual usar. Além disso, certifique-se de especificar Região da AWS onde o repositório existe, comous-east-2. Quando solicitado pelo formato de saída padrão, especifique json. Por exemplo, se você estiver configurando um perfil para um IAM usuário:

    AWS Access Key ID [None]: Type your IAM user AWS access key ID here, and then press Enter
AWS Secret Access Key [None]: Type your IAM user AWS secret access key here, and then press Enter
Default region name [None]: Type a supported region for CodeCommit here, and then press Enter
Default output format [None]: Type json here, and then press Enter

    Para obter mais informações sobre como criar e configurar perfis para usar com o AWS CLI, consulte o seguinte:

    Para se conectar a um repositório ou recurso em outro Região da AWS, você deve reconfigurar o AWS CLI com o nome de região padrão. Os nomes de região padrão compatíveis CodeCommit incluem:

    • us-east-2

    • us-east-1

    • eu-west-1

    • us-west-2

    • ap-northeast-1

    • ap-southeast-1

    • ap-southeast-2

    • ap-southeast-3

    • me-central-1

    • eu-central-1

    • ap-northeast-2

    • sa-east-1

    • us-west-1

    • eu-west-2

    • ap-south-1

    • ap-south-1

    • ca-central-1

    • us-gov-west-1

    • us-gov-east-1

    • eu-north-1

    • ap-east-1

    • me-south-1

    • cn-north-1

    • cn-northwest-1

    • eu-south-1

    • ap-northeast-3

    • af-south-1

    • il-central-1

    Para obter mais informações sobre CodeCommit e Região da AWS, consulteRegiões e endpoints de conexão do Git. Para obter mais informações sobre IAM chaves de acesso e chaves secretas, consulte Como faço para obter credenciais? e gerenciamento de chaves de acesso para IAM usuários. Para obter mais informações sobre os perfis AWS CLI e, consulte Perfis nomeados.

Etapa 2: instalar git-remote-codecommit

Siga estas etapas para instalar o git-remote-codecommit.

Para instalar git-remote-codecommit

  1. No terminal ou na linha de comando, execute o seguinte comando:

    pip install git-remote-codecommit
    nota

    Dependendo do sistema operacional e da configuração, talvez seja necessário executar esse comando com permissões elevadas, como sudo, ou usar o parâmetro --user para instalar em um diretório que não exija privilégios especiais, como sua conta de usuário atual. Por exemplo, em um computador executando Linux, macOS ou Unix:

    sudo pip install git-remote-codecommit

    Em um computador executando o Windows:

    pip install --user git-remote-codecommit

  2. Monitore o processo de instalação até que você veja uma mensagem de êxito.

Etapa 3: Conectar-se ao CodeCommit console e clonar o repositório

Se um administrador já enviou o clone URL para você usar no CodeCommit repositório, você pode pular a conexão com git-remote-codecommit o console e clonar o repositório diretamente.

Para se conectar a um CodeCommit repositório

  1. Abra o CodeCommit console em https://console.aws.amazon.com/codesuite/codecommit/home.

  2. No seletor de região, escolha Região da AWS onde o repositório foi criado. Os repositórios são específicos para um Região da AWS. Para obter mais informações, consulte Regiões e endpoints de conexão do Git.

  3. Escolha na lista o repositório ao qual deseja se conectar. Escolha Clonar eURL, em seguida, escolha o protocolo que você deseja usar ao clonar ou conectar-se ao repositório. Isso copia o cloneURL.

    • Copie o HTTPS URL se você estiver usando as credenciais do Git com seu IAM usuário ou o auxiliar de credenciais incluído no. AWS CLI

    • Copie o HTTPS (GRC) URL se você estiver usando o git-remote-codecommit comando em seu computador local.

    • Copie o SSH URL se você estiver usando um par de chaves SSH pública/privada com seu IAM usuário.

    nota

    Se você ver uma página de boas-vindas em vez de uma lista de repositórios, não há repositórios associados à sua AWS conta no Região da AWS local em que você está conectado. Para criar um repositório, consulte Crie um AWS CodeCommit repositório ou siga as etapas no tutorial Conceitos básicos do Git e CodeCommit.

  4. No terminal ou no prompt de comando, clone o repositório com o comando git clone. Use o HTTPS git-remote-codecommit URL que você copiou e o nome do AWS CLI perfil, se você criou um perfil nomeado. Se você não especificar um perfil, o comando assumirá o perfil padrão. O repositório local é criado em um subdiretório do diretório onde o comando é executado. Por exemplo, para clonar um repositório chamado MyDemoRepo para um repositório local chamado my-demo-repo:

    git clone codecommit://MyDemoRepo my-demo-repo

    Para clonar o mesmo repositório usando um perfil chamado CodeCommitProfile: 

    git clone codecommit://CodeCommitProfile@MyDemoRepo my-demo-repo

    Para clonar um repositório em um repositório Região da AWS diferente daquele configurado em seu perfil, inclua o Região da AWS nome. Por exemplo:

    git clone codecommit::ap-northeast-1://MyDemoRepo my-demo-repo

Próximas etapas

Você concluiu os pré-requisitos. Siga as etapas Começando com CodeCommit para começar a usar CodeCommit.

Para saber como criar e enviar via push sua primeira confirmação, consulte Crie um commit em AWS CodeCommit. Se você é novo no Git, revise as informações em Como posso saber mais sobre o Git? e Conceitos básicos do Git e AWS CodeCommit.