パッチで設定ファイルを更新する
Unified Diffパッチを使って設定ファイルを更新します。YAML、JSON、INI設定ファイルのパッチを安全に処理する方法を学びます。
Common Use Cases
詳細な説明
設定ファイルへのパッチ適用
設定ファイルはパッチの一般的な対象です。YAMLデプロイ設定、JSON設定ファイル、INI構成のいずれでも、プロセスは同じです:パッチはコンテキストによって特定の行を対象とします。
例:YAML設定の更新
オリジナル docker-compose.yml:
version: "3.8"
services:
web:
image: nginx:1.21
ports:
- "80:80"
environment:
- NODE_ENV=development
パッチ:
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -3,7 +3,9 @@
services:
web:
- image: nginx:1.21
+ image: nginx:1.25
ports:
- "80:80"
+ - "443:443"
environment:
- - NODE_ENV=development
+ - NODE_ENV=production
+ - LOG_LEVEL=info
設定ファイルにパッチを使う理由
- 再現性 — 正確な変更をチームメンバーと共有
- 監査証跡 — パッチは何が変わったか、なぜかを明確に示す
- 自動化 — パッチをデプロイパイプラインにスクリプト化可能
- 安全性 — ファイル全体の置換と異なり、対象行のみを変更
インデントの処理
YAMLのような設定ファイルは空白文字に敏感です。パッチはオリジナルファイルの正確なインデントと一致する必要があります。パッチの適用に失敗した場合は以下を確認:
- 先頭の空白文字が正確に一致しているか
- タブがスペースに変換されていないか(またはその逆)
- 改行コード(LF vs CRLF)が統一されているか
ユースケース
DevOpsチームがファイル全体の置換ではなくパッチとして設定更新を配布しています。これにより、対象の設定が更新されながらローカルのカスタマイズが保持されます。