更改 AWS CodeCommit 存储库设置 - AWS CodeCommit
更改存储库设置（控制台）更改 AWS CodeCommit 存储库设置 (AWS CLI)

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

更改 AWS CodeCommit 存储库设置

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

重要

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

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

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

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

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

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

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

    重要

    更改 AWS 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 字符。如果您是使用 GetRepository 或 BatchGetRepositories API 的应用程序开发人员，并且打算在 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 在 AWS CodeCommit 中更改 CodeCommit 存储库的设置，请运行以下一个或多个命令：

更改 CodeCommit 存储库的描述

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

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

      提示

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

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

      注意

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

    例如，要将名为 MyDemoRepo 的 CodeCommit 存储库的描述更改为 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 存储库的名称，请运行 list-repositories 命令。

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

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

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

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

    重要

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

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