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

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

变更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，然后才能连接到存储库。例如，如果您从更改存储库的名称，请运行以下命令：MyDemo存储库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要么BatchGetRepositoriesAPI 并且您计划在 Web 浏览器中显示存储库描述字段，请参阅CodeCommitAPI 参考.

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

  7. 要删除存储库，请选择 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要么BatchGetRepositoriesAPI 并且您计划在 Web 浏览器中显示存储库描述字段，请参阅CodeCommitAPI 参考.

    例如，要更改的描述，请运行以下命令：CodeCommit存储库名称MyDemoRepo到This description was changed：

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

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

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

    该命令的输出会在 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 命令并查看存储库名称列表。