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

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

更改 Amazon CodeCommit 存储库设置

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

重要

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

更改存储库设置(控制台)

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

  1. 打开 CodeCommit 控制台,网址为 https://console.aws.amazon.com/codesuite/codecommit/home

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

  3. 在导航窗格中,选择 Settings(设置)

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

    重要

    更改 Amazon CodeCommit 存储库的名称将更改用户连接到存储库所需的 SSH 和 HTTPS URL。在更新连接设置之前,用户无法连接到此存储库。此外,由于存储库的 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 字符。如果您是使用GetRepositoryBatchGetRepositories API 的应用程序开发人员,并且计划在 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 字符。如果您是使用GetRepositoryBatchGetRepositories API 的应用程序开发人员,并且计划在 Web 浏览器中显示存储库描述字段,请参阅 CodeCommit API 参考

    例如,要将名为的 CodeCommit 存储库的描述更改MyDemoRepoThis 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 存储库的名称会更改用户连接到该存储库所需的 SSH 和 HTTPS URL。在更新连接设置之前,用户无法连接到此存储库。此外,由于存储库的 ARN 会发生更改,更改存储库名称会使依赖该存储库 ARN 的任何 IAM 用户策略失效。

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