更改 Amazon CodeCommit 存储库设置 - Amazon CodeCommit
更改存储库设置（控制台）更改 Amazon CodeCommit 存储库设置 (Amazon CLI)
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

Amazon CodeCommit 不再向新客户提供。 Amazon CodeCommit 的现有客户可以继续正常使用该服务。了解更多

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

更改 Amazon CodeCommit 存储库设置

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

重要

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

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

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

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

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

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

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

    重要

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

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

    重要

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

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

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

Amazon CLI 要使用在中更改 CodeCommit 存储库的设置 Amazon 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

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

    重要

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

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