CloudFormation de JSON para YAML

Converta templates do AWS CloudFormation em YAML que faz deploy exatamente como o JSON original.

Opções de saída

JSONentrada

Vazio

YAMLsaída

A saída YAML aparece aqui

Funciona inteiramente no seu navegador: nada é enviado. Limites de uso justo se aplicam (5 MB por entrada, conversões com limite de frequência) para evitar spam e bots.

Carregar de URL

O arquivo é buscado diretamente pelo seu navegador, portanto o servidor precisa permitir requisições de outras origens.

Atalhos de teclado

Ctrl / ⌘ + Enter Converter agora
Ctrl / ⌘ + S Baixar a saída
Alt + Shift + C Copiar a saída
Alt + Shift + F Corrigir e formatar o JSON de entrada
Alt + Shift + S Inverter a direção
Alt + Shift + T Alternar entre as visualizações de código, árvore e mapa
Ctrl / ⌘ + Z Desfazer, inclusive Formatar, Corrigir e Limpar
Esc Sair da tela cheia
Tamanho do texto do editor

As funções intrínsecas continuam válidas

Ref, Fn::Sub e Fn::GetAtt são escritas na forma completa, que o CloudFormation lê em YAML exatamente como em JSON.

Saída do conversor (forma completa)
BucketName:
  Fn::Sub: assets-${Environment}
Tags:
  - Key: env
    Value:
      Ref: Environment
Resource:
  Fn::GetAtt:
    - AssetsBucket
    - Arn
Forma curta equivalente
BucketName: !Sub 'assets-${Environment}'
Tags:
  - Key: env
    Value: !Ref Environment
Resource: !GetAtt AssetsBucket.Arn

As duas versões fazem deploy de forma idêntica. As tags de forma curta são uma extensão do CloudFormation, por isso o conversor mantém a forma completa, que qualquer ferramenta YAML consegue ler.

Templates menores e mais fáceis de revisar

O template de exemplo é 36% menor em YAML do que em JSON formatado, sem chaves nem aspas para atrapalhar a revisão.

bash
# Validate the converted template with the AWS CLI
aws cloudformation validate-template --template-body file://template.yaml

Detalhes do CloudFormation resolvidos para você

Compare a saída do conversor com os mesmos valores do template escritos à mão, sem aspas.

Datas de versão

'2010-09-09' e '2012-10-17' continuam strings em vez de virarem datas do YAML 1.1.

Strings de substituição

Os placeholders ${AWS::AccountId} dentro de Fn::Sub são mantidos caractere por caractere.

Documentos de política

Políticas IAM inline são convertidas como o resto do template, então ações e recursos aparecem como listas limpas.

Mais ferramentas

Conversores, validadores e guias passo a passo para cada lugar onde JSON e YAML se encontram.

Perguntas frequentes

Como converto um template do CloudFormation de JSON para YAML?

Cole o JSON do template ou faça upload do template.json. Copie o YAML ou baixe o template.yaml e faça o deploy como de qualquer outro template. Recursos, parâmetros e saídas continuam exatamente iguais.

O YAML usa funções de forma curta como !Ref e !Sub?

Não. O conversor escreve a forma completa (Ref:, Fn::Sub:, Fn::GetAtt:), que o CloudFormation aceita em templates YAML e que qualquer parser YAML consegue ler. As tags de forma curta são uma abreviação opcional.

Por que AWSTemplateFormatVersion fica entre aspas?

Um 2010-09-09 sem aspas é uma data no YAML 1.1. O CloudFormation espera a string, então o conversor escreve '2010-09-09'. Versões de políticas IAM como '2012-10-17' recebem aspas pelo mesmo motivo.

Posso converter um template YAML de volta para JSON?

Sim, para templates na sintaxe de forma completa: mude a direção para YAML → JSON. Templates escritos com tags de forma curta, como !Ref, precisam de uma ferramenta que conheça o CloudFormation, porque essas tags não são tipos YAML padrão.

É seguro colar templates com dados da conta?

Sim. A conversão roda no seu navegador e nada é enviado ou registrado, então IDs de conta, ARNs e valores padrão de parâmetros ficam na sua máquina.