更改 AWS CodeCommit 存储库设置

您可以使用 AWS CLI 和 AWS CodeCommit 控制台来更改 CodeCommit 存储库的设置，例如其描述或名称。

重要

更改存储库的名称可能导致在其远程 URL 中使用旧名称的所有本地存储库连接中断。运行 git remote set-url 命令可以更新远程 URL，使其使用新的存储库名称。

更改存储库设置（控制台）

要使用 AWS CodeCommit 控制台在中更改 CodeCommit 存储库的设置 AWS CodeCommit，请按照以下步骤操作。

1. 在 https://console.aws.amazon.com/codesuite/codemmit /home 打开 CodeCommit 控制台。

2. 在存储库中，选择要更改设置的存储库的名称。

3. 在导航窗格中，选择 Settings（设置）。

4. 要更改存储库的名称，请在存储库名称中的名称文本框中输入新名称，然后选择保存。在出现提示时，确认您的选择。

   重要

   更改 AWS CodeCommit 存储库的名称将更改用户连接到存储库所需 URLs 的 SSH 和 HTTPS。在更新连接设置之前，用户无法连接到此存储库。此外，由于存储库的 ARN 会发生更改，更改存储库名称会使依赖该存储库 ARN 的所有 IAM 用户策略失效。

   更改名称后，所有用户都必须使用 git remote set-url 命令并指定要使用的新 URL，然后才能连接到存储库。例如，如果您将仓库名称从 MyDemoRepo 更改为 MyRenamedDemoRepo，则使用 HTTPS 连接仓库的用户将运行以下 Git 命令：

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

   使用 SSH 连接该存储库的用户需要运行下面的 Git 命令：

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

   有关更多选项，请参阅 Git 文档。

5. 要更改存储库的说明，请修改 Description 文本框中的文本，然后选择 Save 。

   注意

   “描述”字段在控制台中显示“Markdown”，并接受所有 HTML 字符和有效的 Unicode 字符。如果您是使用GetRepository或的应用程序开发人员，BatchGetRepositories APIs 并且计划在 Web 浏览器中显示存储库描述字段，请参阅 CodeCommit API 参考。

6. 要更改默认分支，请在默认分支中选择分支下拉列表，然后选择其他分支。选择保存。

7. 要更改用于 AWS KMS 加密和解密存储库中数据的加密密钥，请在存储库加密密钥中，选择其中一个AWS 托管式密钥或客户托管密钥以指定要使用的密钥类型。如果选择客户管理的密钥，请输入密钥的 ARN。选择保存。

8. 要删除存储库，请选择 Delete repository。在 Type the name of the repository to confirm deletion (键入存储库名称以确认删除) 旁边的框中，输入 delete，然后选择 Delete (删除)。

   重要

   在中删除此存储库后 AWS CodeCommit，您将无法再将其克隆到任何本地存储库或共享存储库。也无法再从任何本地存储库或共享存储库向其推送数据或从其提取数据。并且无法撤消。

更改 AWS CodeCommit 存储库设置 (AWS CLI)

要将 AWS CLI 命令与一起使用 CodeCommit，请安装 AWS CLI。有关更多信息，请参阅 命令行参考。

AWS CLI 要使用在中更改 CodeCommit 存储库的设置 AWS CodeCommit，请运行以下一个或多个命令：

• update-repository-description更改 CodeCommit 存储库的描述。

• update-repository-name更改 CodeCommit 存储库的名称。

更改 CodeCommit 仓库的描述

1. 运行 update-repository-description 命令，并指定：

   • CodeCommit 存储库的名称（带--repository-name选项）。

     提示

     要获取 CodeCommit 存储库的名称，请运行list-repositories命令。

   • 新存储库说明 (使用 --repository-description 选项)。

     注意

     “描述”字段在控制台中显示“Markdown”，并接受所有 HTML 字符和有效的 Unicode 字符。如果您是使用GetRepository或的应用程序开发人员，BatchGetRepositories APIs 并且计划在 Web 浏览器中显示存储库描述字段，请参阅 CodeCommit API 参考。

   例如，要将名为的 CodeCommit 存储库的描述更改MyDemoRepo为This description was changed：

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

   该命令只在出现错误时生成输出。

2. 要验证更改后的描述，请运行get-repository命令，指定使用该--repository-name选项更改其描述的 CodeCommit 存储库的名称。

   该命令的输出会在 repositoryDescription 中显示已更改的文本。

更改 CodeCommit 仓库的名称

1. 运行 update-repository-name 命令，并指定：

   • CodeCommit 存储库的当前名称（带--old-name选项）。

     提示

     要获取 CodeCommit 存储库的名称，请运行列表存储库命令。

   • CodeCommit 存储库的新名称（带--new-name选项）。

   例如，要将名为 MyDemoRepo 的存储库更改为 MyRenamedDemoRepo：

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

   该命令只在出现错误时生成输出。

   重要

   更改 AWS CodeCommit 存储库的名称会更改用户连接到存储库所需 URLs 的 SSH 和 HTTPS。在更新连接设置之前，用户无法连接到此存储库。此外，由于存储库的 ARN 会发生更改，更改存储库名称会使依赖该存储库 ARN 的任何 IAM 用户策略失效。

2. 要验证更改的名称，请运行 list-repositories 命令并查看存储库名称列表。