Criar 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"

Criar um repositório do AWS CodeCommit

Use o console do AWS CodeCommit ou a AWS Command Line Interface (AWS CLI) para criar um repositório do CodeCommit vazio. Para adicionar tags a um repositório depois de criá-lo, consulte Adicionar uma tag a um repositório.

Estas instruções supõem que você tenha concluído as etapas em Configurando .

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.

Criar um repositório (console)

Para criar um repositório do CodeCommit

Importante

A criação de um repositório no AWS CodeCommit não está mais disponível para novos clientes. Os clientes atuais do AWS CodeCommit podem continuar usando a API normalmente. Saiba mais"

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

    nota

    Os nomes de repositórios diferenciam maiúsculas de minúsculas. O nome deve ser exclusivo na Região da AWS para sua conta da Amazon Web Services.

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

    nota

    O campo de descrição exibe o Markdown no console e aceita todos os caracteres HTML e caracteres Unicode válidos. Se você é um desenvolvedor de aplicativos que está usando as APIs GetRepository ou BatchGetRepositories e planeja exibir o campo de descrição do repositório em um navegador da Web, consulte a Referência de API do CodeCommit.

  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 Marcação de repositórios no 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 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 o 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 Criar.

Depois de criar um repositório, você pode conectá-lo e começar a adicionar códigos usando o console do CodeCommit ou um cliente Git local, ou integrando seu repositório do CodeCommit com seu IDE favorito. Para obter mais informações, consulte Configuração do AWS CodeCommit. Você também pode adicionar seu repositório a um pipeline de entrega contínua. Para obter mais informações, consulte Passo-a-passo de pipeline simples.

Para obter mais informações sobre o novo repositório do CodeCommit, como as URLs usadas ao clonar o repositório, escolha o nome do repositório na lista, ou escolha só o protocolo de conexão que deseja usar próximo ao nome do repositório.

Para compartilhar o repositório com outros, envie o link HTTPS ou SSH a ser usado para clonar o repositório. Verifique se eles têm as permissões necessárias para acessar o repositório. Para obter mais informações, consulte Compartilhar um repositório e Autenticação e controle de acesso para o AWS CodeCommit.

Criar um repositório (AWS CLI)

Você pode usar a AWS CLI para criar um repositório do CodeCommit. Ao contrário do console, você pode adicionar tags a um repositório se criá-lo usando a AWS CLI.

Importante

A criação de um repositório no AWS CodeCommit não está mais disponível para novos clientes. Os clientes atuais do AWS CodeCommit podem continuar usando a API normalmente. Saiba mais"

  1. Verifique se configurou a AWS CLI com a Região da AWS em que está o repositório. Para verificar a região, execute o seguinte comando na linha de comando ou no terminal e revise as informações referentes ao nome da região padrão:

    aws configure

    O nome da região padrão deve corresponder à Região da AWS do repositório no CodeCommit. Para obter mais informações, consulte Regiões e endpoints de conexão do Git.

  2. Execute o comando create-repository, especificando:

    • Um nome que identifica de forma exclusiva o repositório do CodeCommit (com a opção --repository-name).

      nota

      Esse nome precisa ser exclusivo em toda a conta da Amazon Web Services.

    • Um comentário opcional sobre o repositório do CodeCommit (com a opção --repository-description).

    • Um par ou pares de valores-chave opcionais para serem usados como tags do repositório do CodeCommit (com a opção --tags).

    • Uma chave gerenciada pelo cliente opcional para usar ao criptografar e descriptografar esse repositório. Todos os repositórios são criptografados em trânsito e em repouso usando uma chave no AWS KMS. Se nenhuma chave for especificada, será usada a chave padrão aws/codecommit gerenciada pela AWS.

    Por exemplo, para criar um repositório do CodeCommit nomeado MyDemoRepo com a descrição "My demonstration repository" e uma tag com uma chave nomeada Equipe com o valor de Saanvi, use este comando.

    aws codecommit create-repository --repository-name MyDemoRepo --repository-description "My demonstration repository" --tags Team=Saanvi
    nota

    O campo de descrição exibe Markdown no console e aceita todos os caracteres HTML e caracteres Unicode válidos. Se você é um desenvolvedor de aplicativos que está usando as APIs GetRepository ou BatchGetRepositories e planeja exibir o campo de descrição do repositório em um navegador da Web, consulte Referência de API do CodeCommit.

  3. Se houver êxito, o comando gerará como saída um objeto repositoryMetadata com as seguintes informações:

    • A descrição da (repositoryDescription).

    • O ID exclusivo gerado pelo sistema (repositoryId).

    • O nome (repositoryName).

    • O ID da conta da Amazon Web Services associada ao repositório do CodeCommit (accountId).

    Veja a seguir um exemplo de saída com base no comando do exemplo anterior.

    { "repositoryMetadata": { "repositoryName": "MyDemoRepo", "cloneUrlSsh": "ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo", "lastModifiedDate": 1446071622.494, "repositoryDescription": "My demonstration repository", "cloneUrlHttp": "https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo", "defaultBranch": main, "kmsKeyId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "creationDate": 1446071622.494, "repositoryId": "f7579e13-b83e-4027-aaef-650c0EXAMPLE", "Arn": "arn:aws:codecommit:us-east-2:111111111111:MyDemoRepo", "accountId": "111111111111" } }
    nota

    As tags que foram adicionadas quando o repositório foi criado não são retornadas na saída. Para visualizar uma lista de tags associadas a um repositório, execute o comando list-tags-for-resource.

  4. Anote o nome e o ID do repositório do CodeCommit. Eles são necessários para monitorar e alterar informações do repositório do CodeCommit, principalmente se você usa a AWS CLI.

    Se você esquecer o nome ou o ID, siga as instruções em Visualizar detalhes de repositórios do CodeCommit (AWS CLI).

Depois de criar um repositório, é possível conectar-se a ele e começar a adicionar código. Para obter mais informações, consulte Conexão a um repositório. Você também pode adicionar seu repositório a um pipeline de entrega contínua. Para obter mais informações, consulte Passo-a-passo de pipeline simples.