使用创建 CodeCommit 资源 Amazon CloudFormation - Amazon CodeCommit
CodeCommit 和 Amazon CloudFormation 模板模板示例Amazon CloudFormation CodeCommit、和 Amazon Cloud Development Kit (Amazon CDK)了解更多关于 Amazon CloudFormation
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

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

使用创建 CodeCommit 资源 Amazon CloudFormation

Amazon CodeCommit 与一项服务集成 Amazon CloudFormation，该服务可帮助您对 Amazon 资源进行建模和设置，从而减少创建和管理资源和基础架构所花费的时间。您可以创建一个描述所需的所有 Amazon 资源（例如存储库）的模板，并为您 Amazon CloudFormation 预置和配置这些资源。

使用时 Amazon CloudFormation，您可以重复使用模板来一致且重复地设置 CodeCommit 资源。只需描述一次您的资源，然后在多个 Amazon Web Services 账户 区域中一遍又一遍地配置相同的资源。

CodeCommit 和 Amazon CloudFormation 模板

要为和相关服务配置 CodeCommit 和配置资源，必须了解Amazon CloudFormation 模板。模板是 JSON 或 YAML 格式的文本文件。这些模板描述了您要在 Amazon CloudFormation 堆栈中配置的资源。如果你不熟悉 JSON 或 YAML，可以使用 D Amazon CloudFormation esigner 来帮助你开始使用 Amazon CloudFormation 模板。有关更多信息，请参阅《Amazon CloudFormation 用户指南》中的什么是 Amazon CloudFormation Designer？。

CodeCommit 支持在中创建存储库与通过控制台或命令行创建存储库 Amazon CloudFormation 不同，您可以使用 Amazon CloudFormation 创建存储库并自动将代码从 Amazon S3 存储桶中的指定.zip 文件提交到新创建的存储库。有关更多信息，包括存储库的 JSON 和 YAML 模板示例，请参阅AWS::CodeCommit::Repository。

使用创建 CodeCommit 存储库时 Amazon CloudFormation，只要存档小于 20 MB，您就可以选择通过在 AWS::CodeCommit: Repository Code 中配置属性，在创建过程中将代码提交到该存储库。您可以指定存储代码的 Amazon S3 存储桶，也可以选择使用BranchName 属性指定将在该代码的初始提交中创建的默认分支的名称。这些属性仅用于初始存储库创建，在堆栈更新时会被忽略。您无法使用这些属性对存储库进行其他提交，也无法在初始提交完成后更改默认分支的名称。

注意

2021 年 1 月 19 日，将默认分支的名称 CodeCommit 从主分支 Amazon 更改为主分支。此名称更改会影响使用 CodeCommit 控制台、、和为存储库创建初始提交 CodeCommit 时的默认行为 Amazon CLI。 CodeCommit APIs Amazon SDKs在 2021 年 3 月 4 日开始的变更中， Amazon CDK 使用 Amazon CloudFormation 或在创建过程中初始提交代码的存储库与这一变更保持一致。这一变更不会影响现有的存储库或分支。使用本地 Git 客户端创建初始提交的客户有一个默认分支名称，该名称遵循这些 Git 客户端的配置。有关更多信息，请参阅使用分支、创建提交和更改分支设置。

您还可以创建用于创建相关资源的模板，例如存储库通知规则、Amazon CodeBuild 构建项目、Amazon CodeDeploy 应用程序和 Amazon CodePipeline 管道。

模板示例

以下示例创建了一个名为的 CodeCommit 存储库MyDemoRepo。新创建的存储库中填充了存储在名MySourceCodeBucket为的 Amazon S3 存储桶中的代码，该存储桶位于名为的分支中development，该分支是存储库的默认分支。

注意

对于包含内容将提交到新存储库的 ZIP 文件的 Amazon S3 桶，您可以使用 ARN 或 Amazon Web Services 账户中该桶的名称来指定该桶的名称。有关 Amazon S3 对象键的定义，请参阅 Amazon S3 开发人员指南。

JSON:

{
    "MyRepo": {
        "Type": "AWS::CodeCommit::Repository",
        "Properties": {
            "RepositoryName": "MyDemoRepo",
            "RepositoryDescription": "This is a repository for my project with code from MySourceCodeBucket.",
            "Code": {
                "BranchName": "development",
                "S3": {
                    "Bucket": "MySourceCodeBucket",
                    "Key": "MyKey",
                    "ObjectVersion": "1"
                }
            }
        }
    }
}

YAML：

MyRepo:
  Type: AWS::CodeCommit::Repository
  Properties:
    RepositoryName: MyDemoRepo
    RepositoryDescription: This is a repository for my project with code from MySourceCodeBucket.
    Code:
      BranchName: development
      S3: 
        Bucket: MySourceCodeBucket,
        Key: MyKey,
        ObjectVersion: 1

有关更多示例，请参阅AWS::CodeCommit::Repository。

Amazon CloudFormation CodeCommit、和 Amazon Cloud Development Kit (Amazon CDK)

在创建时使用 Amazon CDK 使用 Amazon CloudFormation 功能创建的存储库。了解 Amazon CloudFormation 模板如何使用 CodeCommit 资源可以帮助您创建和管理 Amazon CDK 代码。有关更多信息 Amazon CDK，请参阅《Amazon Cloud Development Kit (Amazon CDK) 开发者指南》和《Amazon CDK API 参考》。

以下 Amazon CDK Typescript 示例创建了一个名MyDemoRepo为的 CodeCommit 存储库。新创建的存储库中填充了存储在名MySourceCodeBucket为的 Amazon S3 存储桶中的代码，该存储桶位于名为的分支中development，该分支是存储库的默认分支。

import * as cdk from '@aws-cdk/core';
import codecommit = require('@aws-cdk/aws-codecommit');
export class CdkCodecommitStack extends cdk.Stack {
  constructor(scope: cdk.Construct, id: string, props?: cdk.StackProps) {
    super(scope, id, props);
    // The code creates a CodeCommit repository with a default branch name development
      new codecommit.CfnRepository(this, 'MyRepoResource', {
            repositoryName: "MyDemoRepo",
            code: {
              "branchName": "development",
              "s3": {
                "bucket": "MySourceCodeBucket",
                "key": "MyKey"
              }
            },
        }
     );
  }
}

了解更多关于 Amazon CloudFormation

要了解更多信息 Amazon CloudFormation，请参阅以下资源：