CLOUD SECURITY LAB

YAML、どこまでご存知ですか？ 📜 バージョン別完全解説 (1.0から1.2まで)

—

by

cslab
in

こんにちは！開発者なら誰もが一度は目にしたことがあるであろうYAML。Kubernetesの設定からGitHub Actionsのワークフロー、Ansibleのプレイブックまで、本当に様々な場所で使われていますよね。🧐

ところで、YAMLにも複数のバージョンがあることをご存知でしたか？特に特定のバージョンの微妙な違いが原因で、予期せぬエラーを経験することもあります。今日は、YAMLの誕生から現在の標準である1.2バージョンまで、その全体的な背景と核心的な違いを徹底的に掘り下げていきます！

YAMLの誕生：「マークアップ言語じゃないの？」🤔

YAMLの歴史は2001年に遡ります。Clark Evansが最初に提案し、Ingy döt Net、Oren Ben-Kikiと共に開発が始まりました。

  • 初期の名前：当初はYet Another Markup Language（「もう一つのマークアップ言語」）という名前でした。当時の複雑なXMLの代替として、人間がより簡単に読み書きできるマークアップ言語を目指していたためです。
  • 名前の変更💡：しかし、開発過程でYAMLが文書の構造を表現する「マークアップ」よりも、データを表現する「データ直列化」に重点を置くという哲学が明確になりました。そのため、YAML Ain’t Markup Language（「YAMLはマークアップ言語ではない」）という再帰的な頭字語に名前を変更しました。この名前自体がYAMLの核心的なアイデンティティ（データ中心！）を示しています。
  • インスピレーションの源 📚：YAMLはC、Python、Perlのようなプログラミング言語やメール形式（RFC 822）から多くのインスピレーションを受けました。特にPythonのようにインデントでデータの階層構造を表現する方式は、YAMLの最大の特徴の一つです。

バージョン別主要機能の掘り下げ 🚀

それでは、各バージョンがどのような特徴を持ち、どのように進化してきたのかを見ていきましょう。

YAML 1.0 (2004年) – 👶 すべての始まり

  • 最初の公式仕様(specification)です。
  • YAMLの根幹をなす基本データ構造を定義しました。
  • スカラー(Scalars)：文字列、数値、ブーリアンなどの単一値
  • シーケンス(Sequences)：リストまたは配列 (例：- item1)
  • マップ(Mappings)：ハッシュまたは辞書 (例：key: value)
  • インデントを通じてデータ階層を表現する核心的な文法を確立し、YAMLのアイデンティティを築きました。

YAML 1.1 (2005年) – 🏃‍♂️ 広く普及したが、若干の混乱

  • 最も長く、そして最も広く採用されたバージョンです。多くの古いライブラリやツールがこのバージョンを基盤に作られました。
  • UTF-8、UTF-16のような文字エンコーディングのサポートを明確にしました。
  • 多様なエスケープシーケンス(n, tなど)をサポートし、文字列表現能力を拡張しました。

⚠️ しかし、YAML 1.1には一つ重要な「落とし穴」がありました。それは、特定の文字列をブーリアン(Boolean, true/false)としてあまりにも寛大に解釈するという点です。

例えば、yes, no, on, offのような単語をすべてブーリアンに自動変換しました。

YAML 1.2 (2009年) – 👑 現在の標準、混乱の終結者

現在私たちが使用するほとんどの最新ツールが従う事実上の標準(de facto standard)バージョンです。YAML 1.1の問題点を解決し、はるかに予測可能で安定的に発展しました。

最大の変更点：JSONとの完璧な互換性 🤝

YAML 1.2の最も重要な特徴は、JSONを公式な下位集合(subset)として採用したことです。これは何を意味するのでしょうか？

「すべての有効なJSONドキュメントは、それ自体が有効なYAML 1.2ドキュメントである。」

このおかげで、JSONデータをYAMLパーサーでそのまま読み込んだり、両形式間の変換が非常に簡単になりました。

// 私は有効なJSONファイルです。
{
  "name": "John Doe",
  "age": 30,
  "isStudent": false,
  "courses": ["History", "Math"]
}

上記のJSONデータは、別途変換なしに完全に有効なYAML 1.2データでもあります。本当に便利ですよね！

文法整理と曖昧さの解消：最も重要な違い！ ✨

YAML 1.2は、1.1の最大の問題であった「過度に寛大なブーリアン解釈」問題を解決しました。

🤔 ここでちょっと、なぜこれが問題だったのでしょうか？例えば、国コードを保存すると想像してみてください。ノルウェーの国コードはNOです。もしYAML 1.1パーサーを使用すると、このNOを文字列ではなくブーリアン値のfalseとして解釈してしまうという恐ろしいバグが発生する可能性があります。

👇 コードで直接比較してみましょう。

# data.yaml
country_code: NO
all_inclusive: YES
power: on

このファイルを各バージョンのパーサーで読み込むとどうなるでしょうか？

  • YAML 1.1パーサーの解釈結果 (Raw Data) 👎ご覧の通り、私たちの意図とは全く異なり、すべての値をブーリアンに変換してしまいました。これは深刻なデータ不整合を引き起こす可能性があります。
  • { “country_code”: false, “all_inclusive”: true, “power”: true }
  • YAML 1.2パーサーの解釈結果 (Raw Data) 👍YAML 1.2はtrueとfalseのみを明示的なブーリアンとして認識し、残りはすべて文字列として安全に処理します。はるかに予測可能で安全ですよね！これが私たちがYAML 1.2を使用すべき核心的な理由です。
  • { “country_code”: “NO”, “all_inclusive”: “YES”, “power”: “on” }

YAML 1.2.1 & 1.2.2 (2021年) – ✍️ 誤字修正および明確化

1.2バージョンがリリースされてから約12年後に改訂版が出ましたが、新しい機能の追加は一切ありません。既存の1.2仕様の誤字を修正したり、曖昧だった説明をより明確にしたりするなど、ドキュメント自体の改善に焦点を当てたメンテナンスリリースです。したがって、私たちは引き続きYAML 1.2を基準と考えるべきです。

一目でわかる要約 📊
バージョン リリース日 主な特徴
1.0 2004年1月 👶 最初の公式仕様、基本構造を定義
1.1 2005年1月 🏃‍♂️ エンコーディングを明確化、しかしブーリアン解釈に曖昧さが存在
1.2 2009年7月 👑 現在の標準、JSONと完全互換、曖昧さを解消し安定性向上
1.2.2 2021年10月 ✨ 機能変更なしに仕様書の明確性を改善

###

結論：私たちはYAML 1.2の時代に生きている！ ✅

結論として、現在YAMLを使用するなら、必ずYAML 1.2バージョンを基準に理解し、作成することをお勧めします。幸い、Kubernetes、Ansible、GitHub Actions、Docker Composeなど、私たちが使用するほとんどの最新ツールはYAML 1.2仕様に忠実に従っています。

これで、YAMLファイルでtrue/falseではないyes、onのような値を見たら、「ああ、あれはYAML 1.1スタイルの遺物だな！」と思えるようになるでしょう。私たちが使用するツールの歴史を理解することは、予期せぬバグを避け、より堅牢なシステムを構築する上で大いに役立ちます。😊

Comments

コメントを残す

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です