Conceitos básicos do Git e AWS CodeCommit

Para criar o repositório do CodeCommit

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

2. Use o seletor de região para escolher a Região da AWS onde você deseja criar o repositório. Para obter mais informações, consulte Regiões e endpoints de conexão do Git.

3. Na página Repositories (Repositórios), selecione Create repository (Criar repositório).

4. Na página Create repository (Criar repositório), em Repository name (Nome do repositório), insira um nome para o repositório (por exemplo MyDemoRepo).

   nota

   Os nomes de repositório diferenciam letras maiúsculas de minúsculas e não podem ter mais de 100 caracteres. Para obter mais informações, consulte Limites.

5. (Opcional) Em Description (Descrição), insira uma descrição, (por exemplo, My demonstration repository). Isso pode ajudar você e outros usuários a identificar a finalidade do repositório.

6. (Opcional) Selecione Add tag (Adicionar tag) para adicionar uma ou mais tags de repositório (um rótulo de atributo personalizado que ajuda a organizar e gerenciar seus recursos da AWS) ao repositório. Para obter mais informações, consulte Marcando repositórios em AWS CodeCommit.

7. (Opcional) Expanda Configuração adicional para especificar se você deseja usar a Chave gerenciada pela AWS padrão ou sua própria chave gerenciada pelo cliente para criptografar e descriptografar os dados nesse repositório. Se você optar por usar sua própria chave gerenciada pelo cliente, deverá garantir que ela esteja disponível na Região da AWS em que você está criando o repositório e que a chave esteja ativa. Para obter mais informações, consulte AWS Key Management Service e criptografia para repositórios do AWS CodeCommit.

8. (Opcional) Selecione Habilitar Amazon CodeGuru Reviewer para Java e Python se esse repositório contiver código Java ou Python e você quiser que o CodeGuru Reviewer analise esse código. O CodeGuru Reviewer usa vários modelos de machine learning para encontrar defeitos no código e sugerir automaticamente melhorias e correções nas solicitações pull. Para obter mais informações, consulte o Guia do usuário do Amazon CodeGuru Reviewer.

9. Escolha Create (Criar).

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

2. No seletor de região, escolha a Região da AWS onde o repositório foi criado. Os repositórios são específicos de uma 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 Clone URL (Clonar URL) e escolha o protocolo que você deseja usar ao clonar ou se conectar ao repositório. Isso copia a URL do clone.

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

   • Copie o URL HTTPS (GRC) se estiver usando o comando git-remote-codecommit no computador local.

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

   nota

   Se você visualizar uma página Boas-vindas em vez de uma lista de repositórios, não há repositórios associados à sua conta da AWS na Região da AWS onde 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. (Opcional) Recomendamos que você configure seu cliente Git local para usar main como nome da ramificação padrão do seu repositório. Esse é o nome usado para a ramificação padrão em todos os exemplos deste guia. Também é o mesmo nome de ramificação padrão que o CodeCommit usa se você fizer sua primeira confirmação no console. Execute o comando a seguir para configurar o nome da ramificação padrão globalmente para seu sistema:

   git config --global init.defaultBranch main

   Se você preferir usar um nome de ramificação padrão diferente para todos os seus repositórios, substitua main pelo nome de sua preferência. Este tutorial pressupõe que sua ramificação padrão tenha o nome de principal.

   Se quiser usar nomes de ramificações padrão diferentes para repositórios diferentes, você pode definir esse atributo localmente (--local) em vez de globalmente (--global).

5. No terminal ou prompt de comando, clone o repositório com o comando git clone e forneça a URL do clone copiado na etapa 3. A URL do clone dependerá do protocolo e da configuração usados. Por exemplo, se você estiver usando HTTPS com credenciais do Git para clonar um repositório denominado MyDemoRepo na região Leste dos EUA (Ohio):

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

   Se você estiver usando HTTPS com git-remote-codecommit:

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

   Se estiver usando SSH:

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

   nota

   Se você visualizar um erro ao tentar clonar um repositório, talvez não tenha concluído a configuração necessária no seu computador local. Para obter mais informações, consulte Configurando para AWS CodeCommit.

1. Use um editor de texto para criar os dois seguintes arquivos de texto de exemplo no seu diretório. Nomeie os arquivos cat.txt e dog.txt:

   cat.txt
   -------
   The domestic cat (Felis catus or Felis silvestris catus) is a small, usually furry, domesticated, and carnivorous mammal.

   dog.txt
   -------
   The domestic dog (Canis lupus familiaris) is a canid that is known as man's best friend.

2. Execute git config para adicionar seu nome de usuário e endereço de e-mail representados pelos espaços reservados your-user-name e your-email-address ao repositório local. Isso facilita a identificação das confirmações realizadas:

   git config --local user.name "your-user-name"
   git config --local user.email your-email-address

3. Se você não definiu o nome da ramificação padrão globalmente ao criar o repositório local, execute o comando a seguir para definir o nome da ramificação padrão como main:

   git config --local init.defaultBranch main

4. Execute git add para preparar a alteração:

   git add cat.txt dog.txt

5. Execute git commit para confirmar a alteração:

   git commit -m "Added cat.txt and dog.txt"

   dica

   Para ver os detalhes da confirmação que acabou de fazer, execute git log.

1. Mude para o diretório /tmp ou c:\temp.

2. Execute git clone para fazer o pull de uma cópia do repositório para o repositório compartilhado:

   Para HTTPS:

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

   Para HTTPS com git-remote-codecommit:

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

   Para o SSH:

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

   nota

   Quando um repositório é clonado usando SSH em sistemas operacionais Windows, talvez seja necessário adicionar o ID da chave SSH à cadeia 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.

   Neste comando, MyDemoRepo é o nome do seu repositório do CodeCommit. shared-demo-repo é o nome do diretório criado pelo Git no diretório /tmp ou no c:\temp. Depois que o Git criar o diretório, o Git extrairá uma cópia do seu repositório no diretório shared-demo-repo.

3. Mude para o diretório shared-demo-repo:

   (For Linux, macOS, or Unix) cd /tmp/shared-demo-repo
   (For Windows) cd c:\temp\shared-demo-repo

4. Execute git config para adicionar outro nome de usuário e endereço de e-mail representados pelos espaços reservados other-user-name e other-email-address. Isso facilita a identificação das confirmações realizadas pelo outro usuário:

   git config --local user.name "other-user-name"
   git config --local user.email other-email-address

5. Use um editor de texto para criar o seguinte arquivo de texto de exemplo no diretório shared-demo-repo. Nomeie o arquivo horse.txt:

   horse.txt
   -------
   The horse (Equus ferus caballus) is one of two extant subspecies of Equus ferus.

6. Execute git add para preparar a alteração no repositório compartilhado:

   git add horse.txt

7. Execute git commit para confirmar a alteração no repositório compartilhado:

   git commit -m "Added horse.txt"

8. Execute git push para enviar via push a confirmação por meio do nome remoto padrão usado pelo Git para o repositório do CodeCommit (origin) a partir da ramificação padrão no seu repositório local (main):

   git push -u origin main

9. Alterne para seu repositório local e execute git pull para extrair para o repositório local a confirmação que o repositório compartilhado fez no repositório do CodeCommit. Em seguida, execute git log para ver a confirmação que foi iniciada a partir do repositório compartilhado.

1. Do repositório local , execute git checkout, especificando o nome da ramificação (por exemplo, MyNewBranch) e a ID da primeira confirmação que você fez no repositório local.

   Se você não souber o ID da confirmação, execute git log para obtê-lo. Certifique-se de que a confirmação tem seu nome de usuário e endereço de e-mail, não o nome de usuário e endereço de e-mail do outro usuário. Isso é para simular que main é uma versão estável do repositório do CodeCommit e a ramificação MyNewBranch é para algum atributo novo e relativamente instável:

   git checkout -b MyNewBranch commit-ID

2. Execute git push para enviar a nova ramificação do repositório local para o repositório do CodeCommit:

   git push origin MyNewBranch

3. Agora, efetue o pull da ramificação para o repositório compartilhado e verifique os resultados:

   1. Alterne para o diretório de repositório compartilhado (shared-demo-repo).

   2. Faça o pull na nova ramificação (git fetch origin).

   3. Confirme se o pull da ramificação foi efetuado (o git branch --all exibe uma lista de todas as ramificações do repositório).

   4. Mude para a nova ramificação (git checkout MyNewBranch).

   5. Confirme se você mudou para a ramificação MyNewBranch, executando git status ou git branch. O resultado mostra em qual ramificação você está. Neste caso, deve ser MyNewBranch.

   6. Visualize a lista de confirmações na ramificação (git log).

   Aqui está a lista de comandos Git para chamar:

   git fetch origin
   git branch --all
   git checkout MyNewBranch
   git branch or git status
   git log

4. Alterne de volta para a ramificação main e visualize a lista de confirmações. Os comandos do Git devem ter essa aparência:

   git checkout main
   git log

5. Alterne para a ramificação main em seu repositório local. Você pode executar git status ou git branch. O resultado mostra em qual ramificação você está. Neste caso, deve ser main. Os comandos do Git devem ter essa aparência:

   git checkout main
   git branch or git status

1. Do repositório local , execute git tag, especificando o nome da nova tag (release) e a ID da primeira confirmação que você fez no repositório local.

   Se você não souber o ID da confirmação, execute git log para obtê-lo. Certifique-se de que a confirmação tem seu nome de usuário e endereço de e-mail, não o nome de usuário e endereço de e-mail do outro usuário. Isso é para simular que sua confirmação é uma versão estável do repositório do CodeCommit:

   git tag release commit-ID

   Execute git tag novamente para marcar a confirmação do outro usuário com a tag beta. Isso é para simular que a confirmação é para algum recurso novo relativamente instável:

   git tag beta commit-ID

2. Execute git push --tags para enviar as tags para o repositório do CodeCommit.

3. Agora, efetue o pull das tags para o repositório compartilhado e verifique os resultados:

   1. Alterne para o diretório do repositório compartilhado (shared-demo-repo).

   2. Faça o pull nas novas tags (git fetch origin).

   3. Confirme se foi efetuado o pull das tags (o comando git tag exibe uma lista das tags do repositório).

   4. Exiba as informações sobre cada tag (git log release e git log beta).

   Aqui está a lista de comandos Git para chamar:

   git fetch origin
   git tag
   git log release
   git log beta

4. Experimente isso também no repositório local:

   git log release
   git log beta

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

   Certifique-se de fazer login com o mesmo nome de usuário e senha utilizados em Configuração .

2. No painel de navegação, escolha Users e depois Create New Users.

3. Na primeira caixa Enter User Names (Inserir nomes de usuários), insira um nome de usuário de exemplo (por exemplo, JaneDoe-CodeCommit). Selecione a caixa Generate an access key for each user (Gerar uma chave de acesso para cada usuário) e selecione Create (Criar).

4. Escolha Show User Security Credentials. Anote o access key ID e a chave de acesso secreta ou escolha Download Credentials.

5. Siga as instruções em Para usuários de HTTPS usando credenciais do Git para gerar e fornecer as credenciais do usuário do IAM.

   Se você quiser usar SSH, siga as instruções em SSH e Linux, macOS ou Unix: configure as chaves públicas e privadas para Git e CodeCommit ou Etapa 3: configurar as chaves pública e privada para o Git e o CodeCommit para configurar o usuário com chaves públicas e privadas.

6. Executar git pull. O seguinte erro deve aparecer:

   Para HTTPS:

   fatal: unable to access 'https://git-codecommit.us-east-2.amazonaws.com/v1/repos/repository-name/': The requested URL returned error: 403.

   Para o SSH:

   fatal: unable to access 'ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/repository-name/': The requested URL returned error: 403.

   O erro aparece porque o novo usuário não tem permissão para sincronizar o repositório compartilhado com o repositório do CodeCommit.

7. Retorne ao console do IAM. No painel de navegação, escolha Policies e, em seguida, Create Policy. (Se aparecer um botão Get Started, selecione-o e, em seguida, Create Policy.)

8. Próximo a Create Your Own Policy, escolha Select.

9. Na caixa Policy Name (Nome da política), insira um nome (por exemplo, CodeCommitAccess-GettingStarted).

10. Na caixa Documento da política, insira o seguinte para permitir que um usuário do IAM extraia de qualquer repositório associado ao usuário do IAM:

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "codecommit:GitPull"
          ],
          "Resource": "*"
        }
      ]
    }

    dica

    Se quiser que o usuário do IAM possa enviar confirmações via push para qualquer repositório associado ao usuário do IAM, insira:

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "codecommit:GitPull",
            "codecommit:GitPush"
          ],
          "Resource": "*"
        }
      ]
    }

    Para obter mais informações sobre outras permissões de ações e recursos do CodeCommit que podem ser fornecidas aos usuários, consulte Autenticação e controle de acesso para o AWS CodeCommit.

11. No painel de navegação, escolha Users.

12. Escolha o nome de usuário de exemplo (por exemplo, JaneDoe-CodeCommit) ao qual você deseja anexar a política.

13. Escolha a aba Permissões.

14. Em Managed Policies, escolha Attach Policy.

15. Selecione a política CodeCommitAccess-GettingStarted que você acabou de criar e escolha Attach Policy (Anexar política).

16. Executar git pull. Dessa vez, o comando deve funcionar e deve aparecer uma mensagem Already up-to-date.

17. Se você estiver usando HTTPS, alterne para suas credenciais originais do Git ou, se estiver usando git-remote-codecommit, seu perfil habitual. Para obter mais informações, consulte as instruções em Configuração para usuários de HTTPS usando credenciais do Git ou Etapas de configuração para conexões HTTPS com o AWS CodeCommit com git-remote-codecommit.

    Se você estiver usando SSH, alterne para suas chaves originais. Para obter mais informações, consulte SSH e Linux, macOS ou Unix: configure as chaves públicas e privadas para Git e CodeCommit ou Etapa 3: configurar as chaves pública e privada para o Git e o CodeCommit.

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

2. Na página Painel, na lista de repositórios, selecione MyDemoRepo.

3. No painel de navegação, selecione Configurações.

4. Na página Settings, escolha Delete repository em Delete repository.

5. Na caixa ao lado de Type the name of the repository to confirm deletion (Digite o nome do repositório para confirmar a exclusão), insira MyDemoRepo e escolha Delete (Excluir).