CloudFormation の JSON から YAML へ

AWS CloudFormation テンプレートを、元の JSON とまったく同じようにデプロイできる YAML に変換します。

出力オプション

JSON入力

空

YAML出力

YAML の出力がここに表示されます

すべてブラウザ内で動作し、データはアップロードされません。スパムやボットを防ぐため、公正利用の制限(入力 1 件あたり 5 MB、変換回数のレート制限)があります。

URL から読み込む

ファイルはブラウザから直接取得されるため、サーバー側でクロスオリジンリクエストが許可されている必要があります。

キーボードショートカット

Ctrl / ⌘ + Enter 今すぐ変換
Ctrl / ⌘ + S 出力をダウンロード
Alt + Shift + C 出力をコピー
Alt + Shift + F 入力の JSON を修復して整形
Alt + Shift + S 変換方向を入れ替え
Alt + Shift + T コード、ツリー、マップ表示を切り替える
Ctrl / ⌘ + Z 元に戻す(整形、修復、クリアも対象)
Esc 全画面表示を終了
エディターの文字サイズ

組み込み関数は有効なまま

Ref、Fn::Sub、Fn::GetAtt は完全形式で書かれるため、CloudFormation は YAML でも JSON とまったく同じように読み取ります。

コンバーターの出力(完全形式)
BucketName:
  Fn::Sub: assets-${Environment}
Tags:
  - Key: env
    Value:
      Ref: Environment
Resource:
  Fn::GetAtt:
    - AssetsBucket
    - Arn
同等の短縮形式
BucketName: !Sub 'assets-${Environment}'
Tags:
  - Key: env
    Value: !Ref Environment
Resource: !GetAtt AssetsBucket.Arn

どちらの形式も同じようにデプロイされます。短縮形式のタグは CloudFormation 独自の拡張なので、コンバーターはどの YAML ツールでも読める完全形式を使います。

小さく、レビューしやすいテンプレート

サンプルのテンプレートは、整形済みの JSON より YAML のほうが 36% 小さく、レビュー時に波括弧や引用符を読み飛ばす必要もありません。

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

CloudFormation の細かな点にも対応

コンバーターの出力と、同じテンプレートの値を引用符なしで手書きした場合を比べてみてください。

バージョンの日付

'2010-09-09' と '2012-10-17' は YAML 1.1 の日付にならず、文字列のまま保たれます。

置換文字列

Fn::Sub 内の ${AWS::AccountId} プレースホルダーは 1 文字も変わらずに保持されます。

ポリシードキュメント

インラインの IAM ポリシーもテンプレートの他の部分と同じように変換され、アクションとリソースは読みやすいリストになります。

その他のツール

JSON と YAML が出会うあらゆる場面のための変換ツール、検証ツール、手順ガイド。

よくある質問

CloudFormation テンプレートを JSON から YAML に変換するには?

テンプレートの JSON を貼り付けるか、template.json をアップロードします。YAML をコピーするか template.yaml をダウンロードし、通常のテンプレートと同じようにデプロイしてください。リソース、パラメーター、出力はまったく変わりません。

YAML では !Ref や !Sub のような短縮形式の関数を使いますか?

いいえ。コンバーターは完全形式(Ref:、Fn::Sub:、Fn::GetAtt:)で書きます。この形式は CloudFormation が YAML テンプレートで受け付け、どの YAML パーサーでも読み取れます。短縮形式のタグは任意の省略記法です。

AWSTemplateFormatVersion が引用符で囲まれるのはなぜですか?

引用符のない 2010-09-09 は YAML 1.1 では日付です。CloudFormation は文字列を想定しているため、コンバーターは '2010-09-09' と書きます。'2012-10-17' のような IAM ポリシーのバージョンも同じ理由で引用符で囲みます。

YAML テンプレートを JSON に戻せますか?

はい、完全形式の構文で書かれたテンプレートなら可能です。変換方向を YAML → JSON に切り替えてください。!Ref などの短縮形式のタグを使ったテンプレートは標準の YAML 型ではないため、CloudFormation に対応したツールが必要です。

アカウント情報を含むテンプレートを貼り付けても安全ですか?

はい。変換はブラウザ内で行われ、何もアップロードも記録もされないため、アカウント ID、ARN、パラメーターのデフォルト値は手元のマシンから出ません。