Ferramentas de nuvem

validar modelo CloudFormation— confira antes de implantar

Cole um modelo JSON ou YAML e veja diagnósticos e prévia formatada no mesmo formato.

validar modelo CloudFormation

Modelo de entrada

Diagnósticos e prévia

Nenhum problema nas regras cobertas.

Processado no navegador; sem chamadas à AWS.

Opções de verificação

Digite um modelo ou carregue o exemplo.

Limite: 300000 caracteres.

Um YAML válido ainda pode ter um Ref sem declaração ou um bloco Resources no lugar errado. Validar modelo CloudFormation separa essas falhas antes da próxima tentativa de criar uma pilha.

A validação de modelo CloudFormation feita aqui é limitada e explícita. Consulte a cobertura do relatório antes de usar a validação da AWS para a decisão final.

Por que validar modelo CloudFormation?

Separar sintaxe de referência

Erro de parsing e Ref desconhecido pedem correções diferentes. Validar modelo CloudFormation mostra linha, caminho e tipo de diagnóstico.

Um modelo passa pela checagem de sintaxe e uma referência ausente é marcada na etapa seguinte.

Exibir o que não foi verificado

Só propriedades de primeiro nível de S3 Bucket, SQS Queue e SNS Topic entram na checagem de tipos. Recursos desconhecidos aparecem como pendentes, sem falso aval ao validar modelo CloudFormation.

Três formatos de recurso conhecidos são medidos; um formato desconhecido segue o ramo não coberto.

Entenda formato, versão e cobertura

01

Fixe o formato quando preciso

O modo automático reconhece um objeto JSON inicial. Se houver dúvida, escolha JSON ou YAML; falha de parsing não troca o formato silenciosamente.

02

Confira versão e contagens

Sem campo de versão, vale 2010-09-09. Compare recursos cobertos e não cobertos antes de interpretar os avisos.

03

Exporte a revisão atual

Mudanças no texto ou recuo tornam a cópia e o download antigos indisponíveis. Rode de novo e salve o relatório JSON ou o modelo no formato original.

Checagens da estrutura CloudFormation

Sintaxe JSON e YAML

Um documento é analisado e o erro recebe linha e coluna. As formas curtas !Ref e !Sub continuam na prévia YAML formatada.

Referências locais

Ref, Fn::GetAtt e nomes simples de Fn::Sub são comparados com parâmetros, recursos e pseudoparâmetros do mesmo modelo.

Esquema delimitado

Nomes e tipos básicos de propriedades de primeiro nível de AWS::S3::Bucket, AWS::SQS::Queue e AWS::SNS::Topic são conferidos; valores internos não são calculados.

Limites do resultado local

Um modelo por vez
A entrada aceita um documento JSON ou YAML. Resources ausente, ID lógico inválido e versão incorreta são informados; pilhas aninhadas não são abertas.
Cobertura parcial de esquema
Recurso ou propriedade desconhecida vira aviso de não cobertura. Validar modelo CloudFormation não aprova todo o catálogo AWS.
Valores dinâmicos sem execução
Nomes Ref são conferidos, mas condições, macros e valores da conta não são avaliados. O tipo final não é presumido.
Nenhuma ação AWS
Não há credenciais, consulta de região nem criação de pilha. Permissões e cotas exigem a validação da AWS.

Dúvidas sobre validar modelo CloudFormation

Como resolvo erros de validação de modelo ou de formato de modelo no CloudFormation?

Corrija primeiro a linha de sintaxe, depois verifique seções e referências. O relatório separa parsing de regras locais CloudFormation.

Por que aparece YAML not well-formed?

Confira recuo, dois-pontos e tags curtas na linha mostrada. Quando o parsing falha, nenhum arquivo formatado é gerado.

Como corrigir dependências de recursos não resolvidas?

Ref, GetAtt ou Sub aponta para um nome ausente deste modelo. Revise a declaração de parâmetro ou recurso e a grafia.

O que significa propriedade inválida de modelo?

Verifique o caminho em Resources e a documentação AWS. Propriedade fora do esquema local é pendência, não erro definitivo.

Por que falha a validação do parâmetro?

Não. Aqui só rodam as regras locais descritas; conta, região e serviço podem exigir outras validações.

Ainda tem uma dúvida?

Comece a validar modelo CloudFormation

Rode novamente depois de editar e leve o relatório atual para a revisão da implantação.