CloudFormation : JSON en YAML

Convertissez des modèles AWS CloudFormation en YAML qui se déploie exactement comme l'original JSON.

Options de sortie

JSONentrée

Vide

YAMLsortie

La sortie YAML s'affiche ici

Fonctionne entièrement dans votre navigateur: rien n'est envoyé. Des limites d'usage raisonnable s'appliquent (5 MB par entrée, nombre de conversions limité) pour éviter le spam et les robots.

Charger depuis une URL

Le fichier est récupéré directement par votre navigateur : le serveur doit donc autoriser les requêtes cross-origin.

Raccourcis clavier

Ctrl / ⌘ + Enter Convertir maintenant
Ctrl / ⌘ + S Télécharger la sortie
Alt + Shift + C Copier la sortie
Alt + Shift + F Réparer et formater le JSON d'entrée
Alt + Shift + S Inverser le sens
Alt + Shift + T Basculer entre les vues code, arbre et correspondance
Ctrl / ⌘ + Z Annuler, y compris Formater, Réparer et Effacer
Esc Quitter le plein écran
Taille du texte de l'éditeur

Les fonctions intrinsèques restent valides

Ref, Fn::Sub et Fn::GetAtt sont écrites dans leur forme complète, que CloudFormation lit en YAML exactement comme en JSON.

Sortie du convertisseur (forme complète)
BucketName:
  Fn::Sub: assets-${Environment}
Tags:
  - Key: env
    Value:
      Ref: Environment
Resource:
  Fn::GetAtt:
    - AssetsBucket
    - Arn
Forme courte équivalente
BucketName: !Sub 'assets-${Environment}'
Tags:
  - Key: env
    Value: !Ref Environment
Resource: !GetAtt AssetsBucket.Arn

Les deux versions se déploient de façon identique. Les balises de forme courte sont une extension de CloudFormation : le convertisseur conserve donc la forme complète, lisible par tout outil YAML.

Des modèles plus petits et plus faciles à relire

Le modèle d'exemple est 36 % plus petit en YAML qu'en JSON indenté, sans accolades ni guillemets à parcourir pendant la relecture.

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

Les détails CloudFormation pris en charge pour vous

Comparez la sortie du convertisseur avec les mêmes valeurs de modèle écrites à la main, sans guillemets.

Dates de version

'2010-09-09' et '2012-10-17' restent des chaînes au lieu de devenir des dates YAML 1.1.

Chaînes de substitution

Les espaces réservés ${AWS::AccountId} dans Fn::Sub sont conservés caractère pour caractère.

Documents de stratégie

Les stratégies IAM en ligne sont converties comme le reste du modèle : actions et ressources apparaissent sous forme de listes claires.

Autres outils

Convertisseurs, validateurs et guides pas à pas pour tous les endroits où JSON et YAML se croisent.

Questions fréquentes

Comment convertir un modèle CloudFormation de JSON en YAML ?

Collez le JSON du modèle ou importez template.json. Copiez le YAML ou téléchargez template.yaml, puis déployez-le comme n'importe quel autre modèle. Ressources, paramètres et sorties restent exactement les mêmes.

Le YAML utilise-t-il des fonctions de forme courte comme !Ref et !Sub ?

Non. Le convertisseur écrit la forme complète (Ref:, Fn::Sub:, Fn::GetAtt:), que CloudFormation accepte dans les modèles YAML et que tout analyseur YAML sait lire. Les balises de forme courte sont un raccourci facultatif.

Pourquoi AWSTemplateFormatVersion est-il entre guillemets ?

Sans guillemets, 2010-09-09 est une date en YAML 1.1. CloudFormation attend la chaîne, le convertisseur écrit donc '2010-09-09'. Les versions de stratégie IAM comme '2012-10-17' sont mises entre guillemets pour la même raison.

Puis-je reconvertir un modèle YAML en JSON ?

Oui, pour les modèles en syntaxe de forme complète : passez le sens à YAML → JSON. Les modèles écrits avec des balises de forme courte comme !Ref nécessitent un outil qui comprend CloudFormation, car ces balises ne sont pas des types YAML standard.

Puis-je coller sans risque des modèles contenant des informations de compte ?

Oui. La conversion s'exécute dans votre navigateur et rien n'est envoyé ni journalisé : les ID de compte, les ARN et les valeurs par défaut des paramètres restent sur votre machine.