Alteração das configurações de repositório do AWS CodeCommit - AWS CodeCommit
Alteração de configurações de repositório (console)Alteração de configurações de repositório do AWS CodeCommit (AWS CLI)

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"

Alteração das configurações de repositório do AWS CodeCommit

Você pode usar a AWS CLI e o console do AWS CodeCommit para alterar as configurações de um repositório do CodeCommit, como a descrição ou o nome.

Importante

A alteração do nome de um repositório pode corromper repositórios locais que usem o nome antigo no URL remoto. Execute o comando git remote set-url para atualizar a URL remota para usar o novo nome do repositório.

Alteração de configurações de repositório (console)

Para usar o console do AWS CodeCommit para alterar as configurações de um repositório do CodeCommit no AWS CodeCommit, siga estas etapas.

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

  2. Em Repositories (Repositórios), escolha o nome do repositório onde você deseja alterar as configurações.

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

  4. Para alterar o nome do repositório, em Repository name (Nome do repositório), insira um nome novo na caixa de texto Name (Nome) e selecione Save (Salvar). Quando solicitado, verifique sua opção.

    Importante

    Alterar o nome do repositório do AWS CodeCommit alterará os URLs de SSH e HTTPS necessários para a conexão dos usuários ao repositório. Os usuários não poderão se conectar ao repositório até que atualizem suas configurações de conexão. Além disso, devido à alteração no ARN do repositório, alterar o nome do repositório invalidará todas as políticas de usuário do IAM que dependem do ARN desse repositório.

    Para se conectar ao repositório após o nome ter sido alterado, cada usuário deve usar o comando git remote set-url e especificar a nova URL a ser usada. Por exemplo, se você alterou o nome do repositório de MyDemoRepo para MyRenamedDemoRepo, os usuários usando HTTPS para se conectar a ele executariam o seguinte comando do Git:

    git remote set-url origin https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyRenamedDemoRepo

    Os usuários usando o SSH para se conectar ao repositório executariam o seguinte comando do Git:

    git remote set-url origin ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyRenamedDemoRepo

    Para obter mais opções, consulte a documentação do Git.

  5. Para alterar a descrição do repositório, modifique o texto na caixa de texto Description (Descrição) e selecione Save (Salvar).

    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.

  6. Para alterar a ramificação padrão, na Default branch (Ramificação padrão), escolha a lista suspensa da ramificação e escolha uma ramificação diferente. Escolha Salvar.

  7. Para alterar a chave de criptografia do AWS KMS usada para criptografar e descriptografar dados no repositório, em Chave de criptografia do repositório, escolha Chave gerenciada pela AWS ou Chave gerenciada pelo cliente para especificar o tipo de chave a ser usado. Se escolher uma chave gerenciada pelo cliente, insira o ARN da chave. Escolha Salvar.

  8. Para excluir o repositório, selecione Delete repository. 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 delete e escolha Delete (Excluir).

    Importante

    Após excluir esse repositório no AWS CodeCommit, você não poderá mais cloná-lo para nenhum repositório local ou compartilhado. Também não será mais possível extrair dados dele nem enviar via push dados para ele de nenhum repositório local ou compartilhado. Esta ação não pode ser desfeita.

Alteração de configurações de repositório do AWS CodeCommit (AWS CLI)

Para usar comandos da AWS CLI com o CodeCommit, instale a AWS CLI. Para obter mais informações, consulte Referência da linha de comando.

Para usar a AWS CLI para alterar as configurações de um repositório do CodeCommit no AWS CodeCommit, execute pelo menos um dos seguintes comandos:

Para alterar a descrição de um repositório do CodeCommit

  1. Execute o comando update-repository-description, especificando:

    • O nome do repositório do CodeCommit (com a opção --repository-name).

      dica

      Para obter o nome do repositório do CodeCommit, execute o comando list-repositories.

    • A nova descrição do repositório (com a opção --repository-description).

      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.

    Por exemplo, para alterar a descrição de um repositório do CodeCommit chamado MyDemoRepo para This description was changed:

    aws codecommit update-repository-description --repository-name MyDemoRepo --repository-description "This description was changed"

    Esse comando gerará saídas somente se houver erros.

  2. Para verificar a descrição alterada, execute o comando get-repository, especificando o nome do repositório do CodeCommit cuja descrição você mudou com a opção --repository-name.

    A saída do comando exibe o texto alterado em repositoryDescription.

Para alterar o nome de um repositório do CodeCommit

  1. Execute o comando update-repository-name, especificando:

    • O nome atual do repositório do CodeCommit (com a opção --old-name).

      dica

      Para obter o nome do repositório do CodeCommit, execute o comando list-repositories.

    • O nome do repositório do CodeCommit (com a opção --new-name).

    Por exemplo, para alterar o repositório chamado MyDemoRepo para MyRenamedDemoRepo:

    aws codecommit update-repository-name --old-name MyDemoRepo --new-name MyRenamedDemoRepo

    Esse comando gerará saídas somente se houver erros.

    Importante

    A alteração do nome do repositório do AWS CodeCommit vai alterar as URLs de SSH e HTTPS necessárias para a conexão dos usuários com o repositório. Os usuários não poderão se conectar a este repositório até que atualizem suas configurações de conexão. Além disso, devido às alterações no ARN do repositório, a alteração do nome do repositório invalidará todas as políticas de usuário do IAM que dependem do ARN desse repositório.

  2. Para verificar o nome alterado, execute o comando list-repositories e revise a lista de nomes de repositório.