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á.
Conceitos básicos do AWS CodeCommit
Este tutorial mostra como usar alguns dos principais atributos do CodeCommit. Primeiro, crie um repositório e confirme algumas alterações nele. Depois disso, procure os arquivos e visualize as alterações. Também é possível criar uma solicitação pull para que outras pessoas possam analisar e comentar as alterações em seu código.
Se você quiser migrar o código atual para o CodeCommit, consulte Migração para o AWS CodeCommit.
Se você não está familiarizado com o Git, considere concluir Começando com o Git e CodeCommit também. Após concluir esses tutoriais, você terá prática suficiente para começar a usar o CodeCommit em seus próprios projetos e em ambientes de equipe.
O console do CodeCommit inclui informações úteis em um painel expansível que você pode abrir pelo ícone de informações (
) ou pelos links de Informações na página. Você pode fechar esse painel a qualquer momento.
O console do CodeCommit também oferece uma maneira rápida de pesquisar seus recursos, como repositórios, projetos de compilação, aplicativos de implantação e pipelines. Selecione Go to resource (Acessar recurso) ou pressione a tecla / e digite o nome do recurso. Qualquer correspondência aparecerá na lista. As pesquisas não diferenciam letras maiúsculas de minúsculas. Só é possível ver recursos para os quais você tem permissão de visualizar. Para obter mais informações, consulte Visualizar recursos no console.
Pré-requisitos
Antes de começar, conclua os pré-requisitos e configuração, incluindo:
-
Atribuir permissões ao usuário do IAM.
-
Configuração de gerenciamento de credenciais para conexões HTTPS ou SSH na máquina local que você usar para este tutorial.
-
Configure a AWS CLI se você quiser usar a linha de comando ou o terminal para todas as operações, incluindo a criação do repositório.
Tópicos
Etapa 1: Criar um repositório do CodeCommit
Você pode usar o console do CodeCommit para criar um repositório do CodeCommit. Se você já tem um repositório que deseja usar para este tutorial, ignore esta etapa.
nota
Dependendo do seu 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
Para criar o repositório do CodeCommit
Abra o console do CodeCommit em https://console.aws.amazon.com/codesuite/codecommit/home
. -
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.
-
Na página Repositories (Repositórios), selecione Create repository (Criar repositório).
-
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.
-
(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. -
(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.
-
(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.
(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.
-
Escolha Criar.
nota
Se você usar outro nome que não seja MyDemoRepo para o repositório, use-o nas etapas restantes deste tutorial.
Quando o repositório é aberto, você visualiza informações sobre como adicionar arquivos diretamente do console do CodeCommit.
Etapa 2: adicionar arquivos ao repositório
Você pode adicionar arquivos ao repositório da seguinte forma:
-
Criar um arquivo no console do CodeCommit. Se você criar o primeiro arquivo para um repositório no console, uma ramificação chamada principal será criada para você. Essa ramificação é a ramificação padrão do seu repositório.
-
Fazer upload de um arquivo do seu computador local usando o console do CodeCommit. Se você criar o primeiro arquivo para um repositório no console, uma ramificação chamada principal será criada para você. Essa ramificação é a ramificação padrão do seu repositório.
-
Usar um cliente Git para clonar o repositório no seu computador local e, então, adicionar, confirmar e enviar arquivos ao repositório do CodeCommit. Uma ramificação será criada para você como parte da primeira confirmação do Git, definida como a ramificação padrão para seu repositório. O nome da ramificação é a escolha padrão do seu cliente Git. Considere configurar seu cliente Git para usar principal como nome da ramificação inicial.
nota
Você pode criar ramificações e alterar a ramificação padrão de um repositório a qualquer momento. Para obter mais informações, consulte Trabalhando com ramificações em AWS CodeCommit repositórios.
A maneira mais simples de começar a usar é abrir o console do CodeCommit e adicionar um arquivo. Ao fazer isso, você também cria uma ramificação padrão para seu repositório chamada principal. Para obter instruções sobre como adicionar um arquivo e criar uma primeira confirmação em um repositório usando a AWS CLI, consulte Criar a primeira confirmação para um repositório usando a AWS CLI.
Como adicionar um arquivo a um repositório
-
Na barra de navegação do repositório, escolha Code (Código).
-
Escolha Add file (Adicionar arquivo) e escolha se deseja criar um arquivo ou fazer upload de um arquivo do seu computador. Este tutorial mostra como realizar as duas ações.
-
Para adicionar um arquivo, faça o seguinte:
-
Na lista suspensa de ramificações, escolha a ramificação onde deseja adicionar o arquivo. A ramificação padrão é selecionada automaticamente para você. No exemplo mostrado aqui, a ramificação padrão é chamada
principal. Se você deseja adicionar o arquivo a outra ramificação, escolha uma ramificação diferente. -
Em File name (Nome do arquivo), insira um nome para o arquivo. No editor de código, insira o código do arquivo.
-
Em Author name (Nome do autor), insira o nome a ser exibido para outros usuários do repositório.
-
Em Email address (Endereço de e-mail), forneça um endereço de e-mail.
-
(Opcional) Em Commit message (Mensagem de confirmação), insira uma mensagem breve. Embora seja opcional, recomendamos que você adicione uma mensagem de confirmação para ajudar os membros da equipe a entender porque o arquivo foi adicionado. Se você não inserir uma mensagem de confirmação, uma mensagem padrão será usada.
-
Escolha Commit changes (Confirmar alterações).
Para fazer upload de um arquivo, faça o seguinte:
-
Se você estiver fazendo upload de um arquivo, escolha o arquivo desejado.
-
Em Author name (Nome do autor), insira o nome a ser exibido para outros usuários do repositório.
-
Em Email address (Endereço de e-mail), forneça um endereço de e-mail.
-
(Opcional) Em Commit message (Mensagem de confirmação), insira uma mensagem breve. Embora seja opcional, recomendamos que você adicione uma mensagem de confirmação para ajudar os membros da equipe a entender porque o arquivo foi adicionado. Se você não inserir uma mensagem de confirmação, uma mensagem padrão será usada.
-
Escolha Commit changes (Confirmar alterações).
-
Para obter mais informações, consulte Trabalhar com arquivos em repositórios do AWS CodeCommit.
Para usar um cliente Git para clonar o repositório, instale o Git no computador local e, em seguida, clone o repositório do CodeCommit. Adicione alguns arquivos ao repositório local e envie-os via push ao repositório do CodeCommit. Para uma introdução detalhada, experimente o Começando com o Git e CodeCommit. Se você conhece o Git, mas não souber como fazer isso em um repositório do CodeCommit, você poderá visualizar exemplos e instruções em Criar uma confirmação, Etapa 2: criação de um repositório local ou Conexão a um repositório.
Depois de adicionar alguns arquivos ao repositório do CodeCommit, você poderá visualizar eles no console.
Etapa 3: navegar pelos conteúdos do seu repositório
É possível usar o console do CodeCommit para analisar os arquivos em um repositório ou para ler rapidamente os conteúdos de um arquivo. Isso ajuda a determinar qual ramificação deve ter o check-out feito ou se você deseja criar uma cópia local de um repositório.
Como navegar no repositório
-
Em Repositórios, escolha MyDemoRepo.
-
A página exibe o conteúdo na ramificação padrão do repositório. Para visualizar outra ramificação ou visualizar o código em uma tag específica, escolha a ramificação ou tag que deseja visualizar na lista. Na captura de tela a seguir, a exibição é definida como a ramificação principal.
-
Para visualizar os conteúdos de um arquivo no seu repositório, escolha o arquivo na lista. Para alterar a cor do código exibido, escolha o ícone de configurações.
Para obter mais informações, consulte Procurar arquivos em um repositório.
-
Para navegar pelo histórico de confirmações do repositório, escolha Commits (Confirmações). O console exibe o histórico de confirmações da ramificação padrão, em ordem cronológica inversa. Revise os detalhes de confirmações por autor, data e muito mais.
-
Para visualizar o histórico de confirmações por ramificação ou tag do Git, escolha a ramificação ou tag que deseja visualizar na lista.
-
Para visualizar as diferenças entre uma confirmação e sua confirmação pai, escolha o ID de confirmação abreviado. Você pode escolher como as alterações são exibidas, incluindo mostrar ou ocultar alterações no espaço em branco e se você deseja visualizar alterações embutidas (exibição Unified (Unificada)) ou lado a lado (exibição Split (Dividida)).
nota
Suas preferências para visualizar código e outras configurações do console são salvas como cookies do navegador sempre que você as altera. Para obter mais informações, consulte Trabalhar com preferências do usuário.
-
Para ver todos os comentários em uma confirmação, escolha a confirmação e, em seguida, role pelas alterações para visualizá-las em linha. Você também pode adicionar seus próprios comentários e responder aos comentários feitos por outros.
Para obter mais informações, consulte Comentar sobre uma confirmação.
-
Para visualizar as diferenças entre dois especificadores de confirmação incluindo tags, ramificações e IDs de confirmação, escolha Commits (Confirmações) e, em seguida, escolha Compare commits (Comparar confirmações), no painel de navegação.
Para obter mais informações, consulte Navegar pelo histórico de confirmações de um repositório e Comparar confirmações.
-
Em Commits (Confirmações), escolha a guia Commit visualizer (Visualizador de confirmações).
O gráfico de confirmações será exibido, com a linha de assunto de cada confirmação mostrada próxima ao seu respectivo ponto no gráfico. A exibição da linha de assunto é limitada a 80 caracteres.
-
Para ver mais detalhes sobre uma confirmação, escolha o ID abreviado da confirmação. Para renderizar o gráfico de uma confirmação específica, escolha este ponto no gráfico. Para obter mais informações, consulte Visualizar um gráfico do histórico de confirmações de um repositório .
Etapa 4: criar e colaborar em uma solicitação pull
Ao trabalhar em um repositório com outros usuários, é possível colaborar no código e revisar alterações. É possível criar uma solicitação pull para que outros usuários possam revisar e comentar suas alterações de código em uma ramificação. Também é possível criar uma ou mais regras de aprovação da solicitação pull. Por exemplo, é possível criar uma regra de aprovação que exija que pelo menos dois outros usuários aprovem a solicitação pull para que possa ser mesclada. Depois que a solicitação pull for aprovada, você poderá mesclar essas alterações à ramificação de destino. Se você configurar notificações para seu repositório, os usuários do repositório poderão receber e-mails sobre eventos do repositório (por exemplo, para solicitações pull ou quando alguém fizer comentários sobre o código). Para obter mais informações, consulte Configurar notificações para eventos em um repositório do AWS CodeCommit.
Importante
Antes de criar uma solicitação pull, você deve criar uma ramificação que contenha as alterações de código que deseja rever. Para obter mais informações, consulte Criar uma ramificação.
Como criar e colaborar em uma solicitação pull
-
No painel de navegação, escolha Pull Requests (Solicitações pull).
-
Em Pull request (Solicitação pull), escolha Create pull request (Criar solicitação pull).
dica
Você também pode criar solicitações pull em Branches (Ramificações) e em Code (Código).
Em Create pull request, em Source, escolha a ramificação que contém as alterações que deseja revisar. Em Destination (Destino), escolha a ramificação na qual você deseja que o código seja revisado para ser mesclado quando a solicitação pull for fechada. Escolha Compare.
-
Reveja os detalhes da mesclagem e as alterações para confirmar que a solicitação pull contém as alterações e confirmações que você deseja analisar. Em caso positivo, em Title (Título), insira um título para esta revisão. Este é o título que aparece na lista de solicitações pull para o repositório. Em Description (Descrição), insira detalhes sobre essa revisão e sobre qualquer outra informação útil para os revisores. Escolha Criar.
-
Sua solicitação pull aparece na lista de solicitações pull para o repositório. Você pode filtrar a exibição para mostrar apenas solicitações abertas, solicitações fechadas, solicitações que você criou e muito mais.
-
É possível adicionar uma regra de aprovação à solicitação pull a fim de garantir que determinadas condições sejam atendidas antes que ela seja mesclada. Para adicionar uma regra de aprovação à solicitação pull, escolha a solicitação pull na lista. Na guia Approvals (Aprovações), escolha Create approval rule (Criar regra de aprovação).
-
Em Rule name (Nome da regra), dê à regra um nome descritivo. Por exemplo, se você deseja exigir que duas pessoas aprovem uma solicitação pull para que ela possa ser mesclada, é possível nomear a regra
Require two approvals before merge. Em Number of approvals needed (Número de aprovações necessárias), insira2, o número que você deseja. O padrão é 1. Selecione Enviar. Para saber mais sobre regras de aprovação e membros do grupo de aprovações, consulte Criar uma regra de aprovação de uma solicitação pull.
-
Se você tiver configurado notificações para o seu repositório e optou por notificar os usuários sobre eventos de solicitação pull, os usuários receberão e-mails sobre sua nova solicitação pull. Os usuários podem visualizar as alterações e comentar em linhas específicas do código, em arquivos e na solicitação pull propriamente dita. Elas também podem responder aos comentários com texto e emojis. Se necessário, você pode inserir as alterações na ramificação da solicitação pull, o que atualiza a solicitação pull.
-
Se você estiver satisfeito com as alterações feitas na solicitação, escolha Approve (Aprovar). É possível optar por aprovar uma solicitação pull mesmo que nenhuma regra de aprovação esteja configurada para ela. Isso fornece um registro claro de que você revisou a solicitação pull e sua aprovação das alterações. Também é possível optar por revogar sua aprovação se mudar de ideia.
nota
Não é possível aprovar uma solicitação pull se você a criou.
-
Quando todas as alterações de código forem analisadas e aceitas apropriadamente, na solicitação pull, siga um destes procedimentos:
-
Se você deseja fechar a solicitação pull sem mesclar ramificações, selecione Close pull request (Fechar solicitação pull).
-
Se deseja mesclar as ramificações e fechar a solicitação pull, escolha Merge (Mesclar). Será possível escolher entre as estratégias de mesclagem disponíveis para seu código, que dependem das diferenças entre as ramificações de origem e de destino, e a opção de excluir automaticamente a ramificação de origem depois que a mesclagem for concluída. Após ter feito suas escolhas, selecione Merge pull request (Mesclar solicitação pull) para concluir a mesclagem.
-
Se houver conflitos de mesclagem nas ramificações que não possam ser resolvidos automaticamente, você pode tentar resolvê-los no console do CodeCommit ou usar o cliente Git local para mesclar as ramificações e enviar via push a mesclagem. Para obter mais informações, consulte Resolver conflitos em uma solicitação pull em um repositório do AWS CodeCommit.
nota
Você sempre pode mesclar as ramificações manualmente, incluindo ramificações de solicitação pull, usando o comando git merge no repositório local e enviando as alterações por push.
-
Para obter mais informações, consulte Trabalhar com solicitações pull e Trabalhar com modelos de regra de aprovação.
Etapa 5: limpar
Se não precisar mais do repositório do CodeCommit, você deve excluir o repositório do CodeCommit e outros recursos usados neste exercício para que você não continue sendo cobrado pelo espaço de armazenamento.
Importante
Esta ação não pode ser desfeita. Após excluir esse repositório, você não poderá mais cloná-lo para nenhum repositório local ou compartilhado. Também não será mais possível extrair dados do repositório ou enviar dados via push para ele, nem executar operações do Git, tanto de repositórios locais como compartilhados.
Se você tiver configurado notificações para seu repositório, a exclusão do repositório também exclui a regra do Amazon CloudWatch Events criada para o repositório. Isso não exclui o tópico do Amazon SNS usado como destino para essa regra.
Se você tiver configurado acionadores para seu repositório, a exclusão do repositório não exclui os tópicos do Amazon SNS nem as funções do Lambda que foram configurados como destinos desses acionadores. Lembre-se de excluir esses recursos se não forem necessários. Para obter mais informações, consulte Excluir gatilhos de um repositório.
Para excluir o repositório do CodeCommit
Abra o console do CodeCommit em https://console.aws.amazon.com/codesuite/codecommit/home
. -
Em Repositories (Repositórios), escolha o repositório que você deseja excluir. Se você tiver seguido a convenção de nomenclatura neste tópico, ele será chamado MyDemoRepo.
-
No painel de navegação, selecione Configurações.
-
Na página Settings, escolha Delete repository em Delete repository.
-
Digite
deletee, em seguida, escolha Delete (Excluir). O repositório será excluído permanentemente.
Etapa 6: próximas etapas
Agora que você se familiarizou com o CodeCommit e com alguns de seus atributos, considere fazer o seguinte:
-
Se é sua primeira vez no Git e no CodeCommit, ou quiser rever exemplos de como usar o Git com o CodeCommit, prossiga para o tutorial Começando com o Git e CodeCommit.
-
Se você quiser trabalhar com outras pessoas em um repositório do CodeCommit, consulte Compartilhar um repositório. (Para compartilhar seu repositório com usuários em outra conta da Amazon Web Services, consulte Configurar o acesso entre contas a um AWS CodeCommit repositório usando funções.)
-
Para migrar um repositório para o CodeCommit, siga as etapas em Migrar para o CodeCommit.
-
Se você quiser adicionar o repositório a um pipeline de entrega contínua, siga as etapas em Passo-a-passo de pipeline simples.
-
Para saber mais sobre produtos e serviços que se integram ao CodeCommit, incluindo exemplos da comunidade, consulte Integrações de produtos e serviços.
