Conexão a um repositório 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"

Conexão a um repositório do AWS CodeCommit

Quando você se conecta a um repositório do CodeCommit pela primeira vez, geralmente clona o conteúdo para a sua máquina local. Você também pode adicionar arquivos para e editar arquivos em um repositório diretamente a partir do console CodeCommit. Ou se você já tem um repositório local, poderá adicionar um repositório do CodeCommit como remoto. Este tópico fornece instruções sobre como se conectar a um repositório do CodeCommit. Se você quiser migrar um repositório existente para o CodeCommit, consulte Migrar para o CodeCommit.

nota

Dependendo do uso, você poderá ser cobrado pela criação ou acesso a um repositório. Para obter mais informações, consulte Definição de preços na página de informações de produtos do CodeCommit.

Pré-requisitos para se conectar a um repositório do CodeCommit

Antes que você possa clonar um repositório do CodeCommit ou conectar um repositório local a um repositório do CodeCommit:

  • Você deve ter configurado o computador local com o software e as configurações necessárias para se conectar ao CodeCommit. Isso inclui instalar e configurar o Git. Para obter mais informações, consulte Configurando e Conceitos básicos do Git e AWS CodeCommit.

  • Você deve ter a URL clone do repositório do CodeCommit ao qual deseja se conectar. Para obter mais informações, consulte Visualizar detalhes de repositórios.

    Se você ainda não criou um repositório do CodeCommit, siga as instruções em Criar um repositório, copie a URL do clone do repositório do CodeCommit e retorne a esta página.

    Se você tem um repositório do CodeCommit, mas não sabe o nome dele, siga as instruções em Visualizar detalhes de repositórios.

  • Você deve ter um lugar na sua máquina local para armazenar uma cópia local do repositório do CodeCommit que você deseja se conectar. (Essa cópia local do repositório do CodeCommit é conhecida como repositório local.) Em seguida, alterne para os comandos do Git e execute-os a partir daquele local. Por exemplo, você pode usar /tmp (para Linux, macOS ou Unix) ou c:\temp (para Windows) se estiver fazendo um clone temporário para fins de teste. Este é o caminho de diretório usado nesses exemplos.

    nota

    Você pode usar o diretório que desejar. Se você estiver clonando um repositório para uso em longo período, considere criar o clone de um diretório em funcionamento e não de um usado para arquivos temporários. Se você estiver usando um outro diretório do /tmp ou c:\temp, certifique-se de substituí-lo pelo nosso diretório quando seguir essas instruções.

Conectar ao repositório do CodeCommit clonando o repositório

Se você ainda não possui um repositório local, siga as etapas neste procedimento para clonar o repositório do CodeCommit para sua máquina local.

  1. Conclua os pré-requisitos, incluindo Configurando .

    Importante

    Se você não tiver concluído a configuração, não poderá se conectar ou clonar o repositório.

  2. No diretório /tmp ou no c:\temp, use o Git para executar o comando clone. O exemplo a seguir mostra como clonar um repositório chamado MyDemoRepo na região Leste dos EUA (Ohio).

    Para HTTPS usando credenciais do Git ou o assistente de credencial incluído na AWS CLI:

    git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo

    Para HTTPS usando git-remote-codecommit, assumindo o perfil padrão e a Região da AWS configurados na AWS CLI:

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

    Para o SSH:

    git clone ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo

    Neste exemplo, git-codecommit.us-east-2.amazonaws.com é o ponto de conexão do Git para a região Leste dos EUA (Ohio) em que está o repositório, MyDemoRepo representa o nome do CodeCommit e my-demo-repo representa o nome do diretório que o Git cria no diretório /tmp ou c:\temp. Para obter mais informações sobre as Regiões da AWS compatíveis com o CodeCommit e as conexões do Git para essas Regiões da AWS, consulte Regiões e endpoints de conexão do Git.

    nota

    Ao usar SSH em sistemas operacionais Windows para clonar um repositório, talvez você precise adicionar o ID da chave SSH à string de conexão da seguinte forma:

    git clone ssh://Your-SSH-Key-ID@git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo

    Para obter mais informações, consulte Para conexões SSH no Windows e Solução de problemas.

    Depois que o Git criar o diretório, ele extrairá uma cópia do repositório do CodeCommit para o diretório recém-criado.

    Se o repositório do CodeCommit for novo ou estiver vazio, uma mensagem avisará que você está clonando um repositório vazio. Isso é esperado.

    nota

    Se você receber um erro avisando que o Git não consegue localizar o repositório do CodeCommit ou que você não tem permissão para se conectar a ele, verifique se você concluiu os pré-requisitos, incluindo a atribuição de permissões para o usuário do IAM e as configurações das suas credenciais de usuário do IAM para Git e CodeCommit na máquina local. Além disso, confirme se você especificou o nome correto do repositório.

Após conectar com sucesso o seu repositório local ao repositório do CodeCommit, você poderá começar a executar comandos do Git a partir do repositório local para criar confirmações, ramificações e tags, além de enviar via push e extrair junto ao repositório do CodeCommit.

Conectar um repositório local ao repositório do CodeCommit

Conclua as etapas a seguir se você já tiver um repositório local e quiser adicionar um repositório do CodeCommit como remoto. Se você já tem um repositório remoto e quer enviar suas confirmações via push para o CodeCommit e para esse repositório remoto, siga as etapas em Confirmações de push em dois repositórios.

  1. Conclua os pré-requisitos.

  2. A partir do prompt de comando ou terminal, alterne para o diretório do repositório local e execute o comando git remote add para adicionar o repositório do CodeCommit como repositório remoto do seu repositório local.

    Por exemplo, o comando a seguir adiciona o remoto apelidado de origin para https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo:

    Para HTTPS:

    git remote add origin https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo

    Para o SSH:

    git remote add origin ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo

    Esse comando não retorna nada.

  3. Para verificar se você adicionou o repositório do CodeCommit ao seu repositório local como remoto, execute o comando git remote -v, que deverá criar uma saída semelhante à seguinte:

    Para HTTPS:

    origin https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo (fetch) origin https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo (push)

    Para o SSH:

    origin ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo (fetch) origin ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo (push)

Após conectar com sucesso o seu repositório local ao repositório do CodeCommit, você poderá começar a executar comandos do Git a partir do repositório local para criar confirmações, ramificações e tags, além de enviar via push e extrair junto ao repositório do CodeCommit.