AWS CodeCommit
用户指南 (API 版本 2015-04-13)

创建 AWS CodeCommit 存储库

使用 AWS CLI 或 CodeCommit 控制台创建空 CodeCommit 存储库。如果使用 AWS CLI 创建一个 CodeCommit 存储库,您可以在创建存储库时为其添加标签。要在创建存储库后为其添加标签,请参阅为存储库添加标签

编写这些说明时,假定您已完成设置 中的步骤。

注意

根据您的使用情况,您可能需要为创建或访问存储库付费。有关更多信息,请参阅 CodeCommit 产品信息页面上的定价

创建存储库(控制台)

创建 CodeCommit 存储库

  1. 通过以下网址打开 CodeCommit 控制台:https://console.aws.amazon.com/codesuite/codecommit/home

  2. 在区域选择器中,选择要创建存储库的 AWS 区域。有关更多信息,请参阅区域和 Git 连接终端节点

  3. 存储库页面上,选择创建存储库

  4. 创建存储库页面上的存储库名称中,为存储库输入名称。

    注意

    存储库名称区分大小写。此名称在您的 AWS 账户所在的 AWS 区域中必须是唯一的。

  5. (可选)在描述中,输入存储库的描述。这可以帮助您及其他用户了解存储库的用途。

    注意

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

  6. (可选)选择Add tag (添加标签),向您的存储库添加一个或多个存储库标签(自定义属性标签,可帮助您组织和管理您的 AWS 资源)。有关更多信息,请参阅 在 AWS CodeCommit 中标记存储库

  7. 选择 Create

创建存储库后,您可以通过 CodeCommit 控制台或本地 Git 客户端或通过将 CodeCommit 存储库与您常用的 IDE 集成来连接到该存储库并开始添加代码。有关更多信息,请参阅针对 AWS CodeCommit 进行设置 。您也可以将存储库添加到持续交付管道中。有关更多信息,请参阅简单管道演练

要获取有关新的 CodeCommit 存储库的信息(例如,克隆存储库时需要使用的 URL),请从列表中选择存储库的名称,或只在存储库名称的旁边选择要使用的连接协议。

要与其他用户共享该存储库,您必须向其发送用于克隆该存储库的 HTTPS 或 SSH 链接。确保他们具备访问该存储库所需的权限。有关更多信息,请参阅共享存储库AWS CodeCommit 的身份验证和访问控制

创建存储库 (AWS CLI)

您可以使用 AWS CLI 创建 CodeCommit 存储库。与控制台不同,如果使用 AWS CLI 创建存储库,您可以为其添加标签。

  1. 确保您已为 AWS CLI 配置该存储库所在的 AWS 区域。要验证 AWS 区域,请在命令行或终端中键入下面的命令,并查看默认区域名称的信息:

    aws configure

    默认区域名称必须与 CodeCommit 中存储库的 AWS 区域相匹配。有关更多信息,请参阅区域和 Git 连接终端节点

  2. 运行 create-repository 命令,并指定:

    • 唯一标识 CodeCommit 存储库的名称(使用 --repository-name 选项)。

      注意

      该名称必须在 AWS 账户间保持唯一。

    • 有关 CodeCommit 存储库的可选评论(使用 --repository-description 选项)。

    • 一个或多个用作 CodeCommit 存储库标签的可选键值对(使用 --tags 选项)。

    例如,使用描述 "My demonstration repository" 以及具有名为 Team 的键和值 Saanvi 的标签创建一个名为 MyDemoRepo 的 CodeCommit 存储库:

    aws codecommit create-repository --repository-name MyDemoRepo --repository-description "My demonstration repository" --tags Team=Saanvi

    注意

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

  3. 如果成功,此命令会输出一个包含以下信息的 repositoryMetadata 对象:

    • 说明 (repositoryDescription)。

    • 系统生成的唯一 ID (repositoryId)。

    • 名称 (repositoryName)。

    • 与 CodeCommit 存储库关联的 AWS 账户的 ID (accountId)。

    下面是前面示例命令的一些示例输出:

    { "repositoryMetadata": { "repositoryName": "MyDemoRepo", "cloneUrlSsh": "ssh://ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo", "lastModifiedDate": 1446071622.494, "repositoryDescription": "My demonstration repository", "cloneUrlHttp": "https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo", "creationDate": 1446071622.494, "repositoryId": "f7579e13-b83e-4027-aaef-650c0EXAMPLE", "Arn": "arn:aws:codecommit:us-east-2:111111111111:MyDemoRepo", "accountId": "111111111111" } }

    注意

    不会在输出中返回创建存储库时添加的标签。要查看与存储库关联的标签列表,请运行 list-tags-for-resource 命令。

  4. 记下 CodeCommit 存储库的名称和 ID。监控和更改有关 CodeCommit 存储库的信息时(特别是当您使用 AWS CLI 时),需要用到这些信息。

    如果您忘记了名称或 ID,请按照查看 CodeCommit 存储库详细信息 (AWS CLI)中的说明操作。

创建存储库后,您可以连接到该存储库并开始添加代码。有关更多信息,请参阅 连接存储库。您也可以将存储库添加到持续交付管道中。有关更多信息,请参阅简单管道演练