As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Criação de CodeCommit recursos com AWS CloudFormation
AWS CodeCommit é integrado com AWS CloudFormation, um serviço que ajuda você a modelar e configurar seus AWS recursos para que você possa gastar menos tempo criando e gerenciando seus recursos e infraestrutura. Você cria um modelo que descreve todos os AWS recursos que você deseja (como repositórios) e CloudFormation provisiona e configura esses recursos para você.
Ao usar CloudFormation, você pode reutilizar seu modelo para configurar seus CodeCommit recursos de forma consistente e repetida. Descreva seus recursos uma vez e, em seguida, provisione os mesmos recursos repetidamente em várias Contas da AWS regiões.
CodeCommit e CloudFormation modelos
Para provisionar e configurar recursos CodeCommit e serviços relacionados, você deve entender CloudFormation os modelos. Os modelos são arquivos de texto formatados em JSON ou YAML. Esses modelos descrevem os recursos que você deseja provisionar em suas CloudFormation pilhas. Se você não estiver familiarizado com JSON ou YAML, você pode usar o CloudFormation Designer para ajudá-lo a começar a usar modelos. CloudFormation Para obter mais informações, consulte O que é o Designer CloudFormation ? no Manual do usuário do AWS CloudFormation .
CodeCommit suporta a criação de repositórios em CloudFormation Diferentemente da criação de repositórios a partir do console ou da linha de comando, você pode usar CloudFormation para criar repositórios e enviar automaticamente o código para o repositório recém-criado a partir de um arquivo.zip especificado em um bucket do Amazon S3. Para obter mais informações, incluindo exemplos de modelos JSON e YAML para repositórios, consulte. AWS::CodeCommit::Repository
Ao criar um CodeCommit repositório usando CloudFormation, você tem a opção de enviar código para esse repositório como parte do processo de criação, desde que o arquivo tenha menos de 20 MB, configurando propriedades no AWS:CodeCommit: :Repository Code. Você pode especificar o bucket do Amazon S3 em que o código é armazenado e, opcionalmente, usar a BranchName propriedade para especificar o nome da ramificação padrão que será criada na confirmação inicial desse código. Essas propriedades são usadas somente na criação inicial do repositório e são ignoradas nas atualizações de pilhas. Você não pode usar essas propriedades para fazer confirmações adicionais em um repositório ou para alterar o nome da ramificação padrão após a confirmação inicial ser feita.
nota
Em 19 de janeiro de 2021, AWS alterou o nome da ramificação padrão CodeCommit de master para main. Essa alteração de nome afeta o comportamento padrão da CodeCommit criação da confirmação inicial para repositórios usando o CodeCommit console, o CodeCommit APIs AWS SDKs, o e o. AWS CLI Os repositórios criados com CloudFormation ou AWS CDK com uma confirmação inicial de código como parte da criação se alinham a essa alteração a partir de 4 de março de 2021. Essa alteração não afeta repositórios ou ramificações existentes. Os clientes que usam clientes Git locais para criar suas confirmações iniciais têm um nome de ramificação padrão que segue a configuração desses clientes Git. Para obter mais informações, consulte Trabalhar com ramificações, Criar uma confirmação e Alterar as configurações da ramificação.
Você também pode criar modelos que criam recursos relacionados, como regras de notificação para repositórios, projetos de compilação do AWS CodeBuild, aplicativos do AWS CodeDeploy e pipelines do AWS CodePipeline.
Exemplos de modelos
Os exemplos a seguir criam um CodeCommit repositório chamadoMyDemoRepo. O repositório recém-criado é preenchido com código armazenado em um bucket do Amazon S3 MySourceCodeBucket chamado e colocado em uma ramificação development chamada, que é a ramificação padrão do repositório.
nota
O nome do bucket do Amazon S3 que contém o arquivo ZIP com o conteúdo que será confirmado para o novo repositório pode ser especificado usando um ARN ou o nome do bucket na conta do Amazon Web Services. Essa é uma chave de objeto do Amazon S3 conforme definido no Guia do desenvolvedor do 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:MyDemoRepoRepositoryDescription:This is a repository for my project with code from MySourceCodeBucket.Code: BranchName:developmentS3: Bucket:MySourceCodeBucket, Key:MyKey, ObjectVersion:1
Para obter mais exemplos, consulte AWS::CodeCommit::Repository.
CloudFormation, CodeCommit, e o AWS Cloud Development Kit (AWS CDK)
Repositórios criados usando a CloudFormation funcionalidade de AWS CDK uso em sua criação. Entender como CloudFormation os modelos funcionam com CodeCommit os recursos pode ajudar você a criar e gerenciar seu AWS CDK código. Para obter mais informações sobre o AWS CDK, consulte o Guia do AWS Cloud Development Kit (AWS CDK) desenvolvedor e a referência AWS CDK da API.
O exemplo de texto AWS CDK datilografado a seguir cria um CodeCommit repositório chamado. MyDemoRepo O repositório recém-criado é preenchido com código armazenado em um bucket do Amazon S3 MySourceCodeBucket chamado e colocado em uma ramificação development chamada, que é a ramificação padrão do repositório.
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" } }, } ); } }
Saiba mais sobre CloudFormation
Para saber mais sobre isso CloudFormation, consulte os seguintes recursos: