Atualizações de versão para o manifesto cFct

Para obter informações sobre a versão mais recente de Customizations for AWS Control Tower (cFct), consulte o CHANGELOG.mdarquivo no repositório. GitHub

Atenção

A versão 2.2.0 de Customizations for AWS Control Tower (cFct) introduziu um esquema de manifesto cFct (versão 2021-03-15) para se alinhar ao serviço relacionado. AWS APIs O esquema do manifesto permite que um único arquivo manifest.yaml gerencie recursos compatíveis (AWS CloudFormation modelos e RCPs) por meio de fluxos de trabalho SCPs desacoplados. DevOps

É altamente recomendável que você atualize o esquema do manifesto cFct da versão 2020-01-01 para a versão 2021-03-15 ou posterior.

O CfCT mantém a compatibilidade com as versões 2021-03-15 e 2020-01-01 do arquivo manifest.yaml. Nenhuma alteração na configuração existente é necessária. No entanto, a versão 2020-01-01 está no Fim do suporte. Não fornecemos mais atualizações nem adicionamos aprimoramentos à versão 2020-01-01. Os recursos de UO raiz e UO aninhada não são compatíveis com a versão 2020-01-01.

Propriedades obsoletas na versão do manifesto cFct 2021-03-15:

organization_policies
policy_file
apply_to_accounts_in_ou

cloudformation_resources
template_file
deploy_to_account
deploy_to_ou
ssm_parameters

Etapas obrigatórias de atualização do cFct

Ao atualizar para a versão 2021-03-15 do esquema de manifesto cFct, aqui estão as alterações que você deve fazer para atualizar seus arquivos. As próximas seções descrevem as mudanças obrigatórias e recomendadas para a transição.

Políticas de organizações

1. Mova SCPs ou RCPs em organization_policies em novos recursos de propriedade.

2. Altere a propriedade policy_file para a nova propriedade resource_file.

3. Altere apply_to_accounts_in_ou para a nova propriedade deployment_targets. A lista de UOs deve ser definida na subpropriedade organizational_units. A subpropriedade accounts não é compatível com as políticas da organização.

4. Adicione uma nova propriedade deploy_method com o valor scp ou rcp.

AWS CloudFormation recursos

1. Mova os CloudFormation recursos em cloudformation_resources em novos recursos de propriedade.

2. Altere a propriedade template_file para a nova propriedade resource_file.

3. Altere deploy_to_ou para a nova propriedade deployment_targets. A lista de UOs deve ser definida na subpropriedade organizational_units.

4. Altere deploy_to_accounts para a nova propriedade deployment_targets. A lista de contas deve ser definida na subpropriedade accounts.

5. Altere a propriedade ssm_parameters para a nova propriedade export_outputs.

Etapas de atualização do cFCT altamente recomendadas

AWS CloudFormation parâmetros

1. Altere a propriedade parameter_file para a nova propriedade parameters.

2. Remova o caminho do arquivo no valor da propriedade parameter_file.

3. Copie a chave e o valor do parâmetro existente do arquivo JSON para o novo formato da propriedade parameters. Isso ajudaria você a gerenciá-los no arquivo de manifesto.

nota

A propriedade parameter_file é suportada na versão 2021-03-15 do manifesto CFct.