YAML to JSON コンバーター

JSONとは何ですか？

// Convert YAML to JSON in Node.js using the eemeli/yaml library
import { parseAllDocuments } from 'yaml';

const yamlString = `apiVersion: apps/v1
kind: Deployment`;

// parseAllDocuments handles multi-document YAML (--- separator)
// version: '1.2' ensures yes/no are strings, not booleans
// merge: true expands anchor/alias merge keys (<<: *anchor)
const docs = parseAllDocuments(yamlString, { version: '1.2', merge: true });

// Take the first document (skip additional --- blocks)
const json = JSON.stringify(docs[0].toJSON(), null, 2);

console.log(json);
// {
//   "apiVersion": "apps/v1",
//   "kind": "Deployment"
// }

主な機能

サンプル

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-app
  namespace: production
  labels:
    app: my-app
    version: 1.0.0
spec:
  replicas: 3
  selector:
    matchLabels:
      app: my-app
  template:
    metadata:
      labels:
        app: my-app
    spec:
      containers:
        - name: my-app
          image: my-app:1.0.0
          ports:
            - containerPort: 8080
          resources:
            requests:
              memory: 64Mi
              cpu: 250m
            limits:
              memory: 128Mi
              cpu: 500m

version: '3.9'
services:
  web:
    image: nginx:1.25-alpine
    ports:
      - '80:80'
      - '443:443'
    environment:
      NGINX_HOST: example.com
      NGINX_PORT: '80'
    depends_on:
      - db
    restart: unless-stopped
  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_DB: mydb
      POSTGRES_USER: admin
      POSTGRES_PASSWORD: secret
    volumes:
      - pgdata:/var/lib/postgresql/data
volumes:
  pgdata: {}

name: CI
on:
  push:
    branches:
      - main
  pull_request:
    branches:
      - main
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Set up Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: pnpm
      - name: Install dependencies
        run: pnpm install --frozen-lockfile
      - name: Run tests
        run: pnpm test

openapi: 3.0.3
info:
  title: User API
  version: 1.0.0
  description: Manage application users
paths:
  /users:
    get:
      summary: List users
      operationId: listUsers
      parameters:
        - name: limit
          in: query
          schema:
            type: integer
            default: 20
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/User'
  /users/{id}:
    get:
      summary: Get user
      operationId: getUser
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
components:
  schemas:
    User:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        email:
          type: string
          format: email

replicaCount: 3
image:
  repository: my-app
  tag: 1.0.0
  pullPolicy: IfNotPresent
service:
  type: ClusterIP
  port: 80
ingress:
  enabled: true
  className: nginx
  hosts:
    - host: my-app.example.com
      paths:
        - path: /
          pathType: Prefix
resources:
  requests:
    memory: 64Mi
    cpu: 250m
  limits:
    memory: 128Mi
    cpu: 500m
autoscaling:
  enabled: false
  minReplicas: 1
  maxReplicas: 10
  targetCPUUtilizationPercentage: 80

- name: Configure web servers
  hosts: webservers
  become: true
  vars:
    http_port: 80
    max_clients: 200
  tasks:
    - name: Ensure nginx is installed
      ansible.builtin.package:
        name: nginx
        state: present
    - name: Start nginx service
      ansible.builtin.service:
        name: nginx
        state: started
        enabled: true
    - name: Copy nginx config
      ansible.builtin.template:
        src: nginx.conf.j2
        dest: /etc/nginx/nginx.conf
        owner: root
        group: root
        mode: '0644'
      notify:
        - Restart nginx
  handlers:
    - name: Restart nginx
      ansible.builtin.service:
        name: nginx
        state: restarted

使い方

1. 1

   YAMLを貼り付ける

   上の入力欄にYAMLデータを入力または貼り付けてください。「サンプルを読み込む」をクリックして、Kubernetes Deployment・Docker Composeファイル・Helm values.yamlなどのサンプルを試すこともできます。

2. 2

   JSON出力をリアルタイムで確認

   JSONは即座に出力パネルに表示されます。オプション（インデント2または4スペース）を調整して、対象ツールの要件に合わせてください。

3. 3

   コピーまたはダウンロード

   「コピー」でJSONをクリップボードに取得するか、「ダウンロード」でjq・APIコール・その他の下流ツールにすぐ使える.jsonファイルとして保存してください。

よくあるYAMLの問題

services:
	web:
		image: nginx:1.25-alpine

services:
  web:
    image: nginx:1.25-alpine

metadata:
  name: my-app
   namespace: production

metadata:
  name: my-app
  namespace: production

url: http://example.com:8080/api
tag: #latest

url: 'http://example.com:8080/api'
tag: '#latest'

# Circular anchor (rare but possible)
base: &base
  parent: *base

# Use explicit fields instead of circular references
base:
  parent: null

# Only the first document is converted
apiVersion: v1
kind: ConfigMap
---
apiVersion: v1
kind: Secret

# Convert each document separately
apiVersion: v1
kind: ConfigMap

# This comment will be lost
replicas: 3 # scale this up for production

replicas: 3
_comment: scale this up for production

よくある使用場面

Kubernetesマニフェストの分析

Kubernetes YAMLマニフェストをJSONに変換し、jqでのクエリ・Kubernetes REST APIへの送信・Terraformデータソースでの処理・JSONを期待するCI/CDパイプラインへの入力に使用します。

Docker ComposeからJavaScriptツールへ

Docker Compose YAMLをJSONに解析して、自動化スクリプト・依存グラフ・Node.jsツールで使用するためのサービス定義・イメージ名・ポートマッピング・環境変数を抽出します。

GitHub Actions APIとの統合

GitHub Actionsワークフロー YAMLをJSONに変換し、プログラム的に構造を検証したり、ジョブとステップの定義を抽出したり、JSONワークフロー仕様を受け付けるCI/CD APIと統合したりします。

OpenAPIからクライアントコード生成へ

多くのコードジェネレーター（openapi-generator・swagger-codegen・oazapfts）はどちらの形式のOpenAPI仕様も受け付けます。ツールが特にJSON入力を必要とする場合や、JSON Schemaバリデーターで検査する必要がある場合に、YAML仕様をJSONに変換します。

Helm Valuesの分析

Helm chartのvalues.yamlをJSONに変換し、レポートの生成・環境間のvalueの比較・ポリシー適用ツールへの入力・JSON設定を期待する自動化での処理に使用します。

JSONベースのツールへの設定移行

アプリケーション設定をYAML（インフラツールで一般的）からJSONに移行し、JavaScript環境・REST API・AWS AppConfig・Azure App Configuration・JSONで設定を保存するあらゆるシステムで使用します。

技術的詳細

merge:trueのparseAllDocumentsによるYAML 1.2仕様

YAMLはeemeli/yamlライブラリ（v2.8+、CVE安全）を使用してparseAllDocumentsと{ version: '1.2', merge: true }で解析されます。YAML 1.2スキーマはyesやnoなどの裸の文字列が文字列として扱われること（ブール値ではなく）を保証し、現行のYAML仕様に一致します。merge: trueオプションはアンカー/エイリアスのマージキー（<<: *anchor）を完全に展開し、JSON出力が完全な参照解除済みデータを含むようにします。複数ドキュメントYAML（---区切り）は最初のドキュメントを返します。

ライブラリによるアンカーとエイリアスの展開

eemeli/yamlライブラリは循環参照検出を含む安全なアンカー（&name）とエイリアス（*name）の展開を処理します。すべての参照されたデータブロック（マージキーの展開を含む）はJSON出力に完全にインライン化されます。JSONには参照やアンカーの概念がないため、これが正しい変換です。ライブラリの安全な展開は不正なYAMLによる無限ループを防ぎます。

ブラウザベース — アップロードなし、サーバーなし

すべての処理はブラウザのJavaScriptエンジン内で完結します。データはいかなる時点でもネットワーク経由で送信されません。200KBを超える入力はリアルタイムモードから手動モードへ自動的に切り替わります（明示的な「変換」クリックが必要）。ブラウザのレスポンスを維持し、重いシリアライゼーション中にメインスレッドがブロックされるのを防ぐためです。

ベストプラクティス

クリーンな変換のためにYAML 1.2互換の構文を使用する

YAML 1.2の慣習でYAMLを作成してください — yes・no・on・off・y・nの文字列値に明示的に引用符を付け（例：enabled: 'yes'）、曖昧さを避けます。このツールはYAML 1.2スキーマで解析します（これらは文字列）が、パイプライン内の古いツールはYAML 1.1を使用する可能性があります（ブール値として扱われる）。ソースYAMLで明示的に引用符を付けることが、すべてのパーサーに対して最も安全な実践です。

精度を保持するためにYAML内の大きな数値をクォートする

JavaScriptは2^53 - 1（9007199254740991）より大きな整数を正確に表現できません。KubernetesのresourceVersionとuidなどのフィールドはサーバー側でint64であり、この制限を超える可能性があります。YAMLソース内でこれらの値をクォートし（resourceVersion: '9007199254740993'）、パーサーが文字列として扱い、JSON出力でも文字列値として正確に保持されるようにしてください。

APIで使用する前にJSON出力を検証する

YAMLをJSONに変換した後は、APIに送ったり保存したりプログラム的に処理する前に結果を検証してください。JSON整形ツールを使って構造が正しいことを確認してください。これはKubernetes APIコール・OpenAPI仕様・JSON Schemaで検証されるペイロードで特に重要で、構造エラーは変換ステップではなくAPIレイヤーでわかりにくい拒否を引き起こします。

変換前に複数ドキュメントYAMLを分割する

YAMLファイルに複数の---区切りドキュメントが含まれていてすべてをJSONとして必要とする場合は、まずファイルを---で分割してから各ドキュメントを個別に変換してください。このツールは最初のドキュメントのみを取得します。シンプルな方法：エディタまたはawkを使って'\n---\n'で分割し、各セクションを別々に貼り付けます。

下流のJSON処理にjqを使用する

YAMLからJSONを取得したら、jqがコマンドラインでクエリおよび変換する最速の方法です。このツールとjqを組み合わせて使います：YAMLをオンラインで変換し、JSONを貼り付け、jq '.spec.replicas'やjq '.services | keys'を使って必要なものを正確に抽出します。多くのファイルのバッチ処理には-o jsonフラグ付きのyq CLIを直接使用してください。

よくある質問