View a markdown version of this page

Visão geral do pipeline de código - AWS Control Tower

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á.

Visão geral do pipeline de código

O pacote de configuração requer o Amazon Simple Storage Service (Amazon S3) e. AWS CodePipeline O pacote de configuração contém os seguintes itens:

  • Um arquivo de manifesto

  • Um conjunto de modelos complementar

  • Outros arquivos JSON para descrever e implementar suas personalizações de ambiente do AWS Control Tower

Por padrão, o pacote de configuração _custom-control-tower-configuration.zip é carregado em um bucket do Amazon S3 com a seguinte convenção de nomenclatura:

custom-control-tower-configuration-accountID-region.

nota

Por padrão, o CfCT cria um bucket do Amazon S3 para armazenar a origem do pipeline. A maioria dos clientes permanece com esse padrão. Se você tiver um AWS CodeCommit repositório existente, poderá alterar o local de origem do seu AWS CodeCommit repositório. Para obter mais informações, consulte Editar um pipeline CodePipeline no Guia AWS CodePipeline do usuário.

O arquivo de manifesto é um arquivo de texto que descreve os AWS recursos que você pode implantar para personalizar sua landing zone. CodePipeline executa as seguintes tarefas:

  • extrai o arquivo de manifesto, o conjunto de modelos complementar e outros arquivos JSON

  • realiza validações de manifesto e modelo

  • invoca seções no arquivo de manifesto CfCT para executar estágios do pipeline específicos.

Quando você atualiza o pacote de configuração personalizando o arquivo de manifesto e removendo o sublinhado (_) do nome do arquivo do pacote de configuração, ele inicia o AWS CodePipeline automaticamente.

Lembre-se do sublinhado

O nome do arquivo do pacote de configuração de amostra começa com um sublinhado (_) para que o AWS CodePipeline não seja acionado automaticamente. Ao concluir a personalização do pacote de configuração, faça upload do arquivo custom-control-tower-configuration.zip sem o sublinhado (_) para acionar a implantação no AWS CodePipeline.

AWS CodePipeline estágios

O pipeline do cFct requer vários AWS CodePipeline estágios para implementar e atualizar seu ambiente do AWS Control Tower.

  1. Estágio de origem

    O estágio de origem é o estágio inicial. Seu pacote de configuração personalizado inicia esse estágio do pipeline. A origem do AWS CodePipeline pode ser um bucket do Amazon S3 ou um AWS CodeCommit repositório, no qual o pacote de configuração pode ser hospedado.

  2. Estágio de compilação

    O estágio de construção exige AWS CodeBuild a validação do conteúdo do pacote de configuração. Essas verificações incluem testar a sintaxe e o esquema do manifest.yaml arquivo, junto com todos os CloudFormation modelos incluídos no pacote ou hospedados remotamente, usando e. CloudFormation validate-template cfn_nag Se o arquivo manifesto e os modelos do CloudFormation passarem nos testes, o pipeline continuará para o próximo estágio. Se os testes falharem, você poderá revisar os CodeBuild registros para identificar o problema e editar o arquivo de origem da configuração conforme necessário.

  3. Estágio de aprovação manual (opcional)

    Estágio de aprovação manual é opcional. Se você habilitar esse estágio, ele fornecerá controle adicional sobre o pipeline de configuração. Ele pausa o pipeline durante a implantação, até que uma aprovação seja dada. Você pode optar pela aprovação manual editando o parâmetro Estágio de aprovação do pipeline como Sim ao iniciar a pilha.

  4. Estágio da Política de Controle de Serviços

    O estágio da Política de Controle de Serviços invoca a máquina de estado da Política de Controle de Serviços (SCP) para chamar AWS Organizations APIs que criam SCPs.

  5. Estágio da política de controle de recursos

    O estágio Política de Controle de Recursos invoca a máquina de estado da política de controle de recursos (RCP) para chamar AWS Organizations APIs que criam RCPs.

  6. CloudFormation estágio de recursos

    O estágio de CloudFormation recursos invoca a máquina de estado do conjunto de pilhas para implantar os recursos especificados na lista de contas ou unidades organizacionais (OUs), que você forneceu no arquivo de manifesto. A máquina de estado cria os CloudFormation recursos na ordem em que são especificados no arquivo de manifesto. Para especificar uma dependência de recursos, organize a ordem na qual os recursos são especificados no arquivo de manifesto. A ordem dos recursos no arquivo de manifesto é a única forma de especificar uma dependência.