サイトアイコン プログラマー(PG)・システムエンジニア(SE)になるための入門講座

【完全保存版】YAMLとは何か？初心者プログラマー・SEでもわかる使い方と実践例を徹底解説

pgse

【完全保存版】YAMLとは何か？プログラマー・SE向けに基本から応用までわかりやすく解説

プログラマーやSEとして仕事をしていると、ある日突然「この設定ファイル、YAMLだからよろしく」と言われた経験はないでしょうか。
私はあります。しかもその時、「ヤムル？ヤメル？」と読み方すら自信がありませんでした。

本記事では、そんな私自身の戸惑いと失敗談を交えながら、YAMLとは何か、どんな場面で使われるのか、なぜ知っておくと仕事が楽になるのかを、専門用語をできるだけ避けて詳しく解説していきます。

これからYAMLを触る初心者の方はもちろん、「なんとなく使っているけど実はよくわかっていない」という方にも役立つ内容になっています。

YAMLとは何か？一言で言うと「人にやさしい設定ファイル」

YAML（ヤムル、またはヤメル）とは、主に設定ファイルを書くための形式の一つです。
正式には「YAML Ain’t Markup Language」の略で、「YAMLはマークアップ言語じゃないよ」という少しひねった名前をしています。

難しそうに聞こえますが、役割はとてもシンプルです。

「プログラムが読むための情報を、人間にも読みやすく書くためのルール」

これがYAMLの本質だと私は思っています。

なぜYAMLが生まれたのか

昔から設定ファイルといえば、JSONやXML、INIファイルなどが使われてきました。
しかし、これらには共通した悩みがありました。

私自身、JSONのカンマを一つ消し忘れて30分ハマったことがあります。
その時、「人間が読む前提じゃない書き方って、やっぱりしんどいな」と感じました。

YAMLは、そうした不満を解消するために、「人が読んで理解しやすいこと」を最優先に設計されています。

YAMLの基本構文を超やさしく解説

YAMLの最大の特徴は、見た目がとてもシンプルなことです。
まずは基本ルールを押さえましょう。

コロンで「名前」と「中身」を分ける

YAMLでは、基本的に「キー: 値」という形で情報を書きます。 

name: yamada
age: 30

これは「nameはyamada」「ageは30」という意味です。
日本語で箇条書きしている感覚に近いですね。

インデント（字下げ）が超重要

YAMLでは、スペースによる字下げ（インデント）で階層を表現します。
ここが最初につまずきやすいポイントです。 

server:
  host: localhost
  port: 8080

この場合、「serverの中にhostとportがある」という意味になります。
カッコは一切使いません。

私は最初、インデントがズレていて設定が読み込まれず、原因に気づくまで1時間かかりました。
YAMLでは「見た目＝構造」なので、見た目が崩れると意味も崩れます。

リストはハイフンで書く

複数の値を並べたい場合は、ハイフンを使います。 

languages:
  - Java
  - Python
  - Ruby

これも人間がメモを書く感覚に近いですね。

YAMLはどんな場面で使われているのか

YAMLは、現代のシステム開発では非常に多くの場面で使われています。

インフラ設定（Docker・Kubernetes）

Docker ComposeやKubernetesの設定ファイルは、ほぼYAMLです。

私が初めてDockerを触ったとき、docker-compose.ymlを見て
「え、これプログラムじゃないのに、めちゃくちゃ重要じゃない？」
と驚いた記憶があります。

YAML一つで、サーバー構成やサービスのつながりが全部決まってしまう。
それだけ影響力の大きい存在です。

CI/CDツールの設定

GitHub ActionsやGitLab CIなどの自動化設定もYAMLで書かれます。

ここを理解してから、私は「ボタン一つでテストとデプロイが走る」仕組みを作れるようになりました。
YAMLを読めるかどうかで、作業効率が段違いになります。

アプリケーション設定

Webフレームワークでも、設定ファイルとしてYAMLが使われることがあります。
コードを書かなくても動作を変えられる点が大きなメリットです。

筆者の体験談：YAMLを知らずに苦労した話

私がYAMLの重要性を痛感したのは、ある案件でのことでした。

先輩から「このYAML直しといて」と言われ、正直「設定ファイルでしょ、余裕」と思っていました。
しかし、インデントを1つずらしただけで、アプリが起動しなくなりました。

エラーメッセージは不親切で、原因は不明。
最終的に先輩に見てもらい、
「YAMLは見た目が命だよ」
と言われて初めて理解しました。

それ以来、YAMLはコード以上に丁寧に書くようになりました。

YAMLを知っておくメリット

設定ファイルが怖くなくなる

YAMLが読めるようになると、設定ファイルを見ることへの抵抗がなくなります。
「ブラックボックス」だった部分が、「ただの文章」に見えるようになります。

インフラや自動化に強くなる

YAMLを理解すると、インフラ構築や自動化ツールに一気に近づけます。

私自身、YAMLを理解したことで「インフラも触れるエンジニア」として評価されるようになりました。

チーム開発で信頼される

設定ファイルはミスが許されない部分です。
YAMLを正しく扱える人は、チーム内で重宝されます。

応用編：YAMLをさらに便利に使うコツ

コメントを活用する

YAMLでは「#」でコメントを書けます。
未来の自分や他人のために、必ず説明を書きましょう。

共通部分をまとめる

YAMLには、同じ設定を使い回すための仕組みもあります。
これを使うと、設定の修正漏れが減ります。

私はこの機能を知ってから、設定ファイルの行数を半分以下にできました。

必ずフォーマットチェックをする

人が書く以上、ミスは避けられません。
YAMLチェックツールを使うことで、事故を未然に防げます。

まとめ：YAMLは現代エンジニアの必須スキル

YAMLは一見地味ですが、現代の開発現場では欠かせない存在です。

難しい文法を覚える必要はありません。
「見た目をきれいに、丁寧に書く」
これだけ意識すれば、YAMLはあなたの強力な味方になります。

ぜひ本記事をきっかけに、YAMLを「怖い存在」から「頼れる相棒」に変えてみてください。

モバイルバージョンを終了