こんにちは。DevOpsの世界へようこそ。
現場で「なぜか環境によって改行コードが変わってしまう」「特定のファイルだけGit管理から除外したいのに、チームメンバーが誤ってコミットしてくる」といったトラブルに遭遇したことはありませんか？
これらは単なる「運用のミス」ではありません。リポジトリのルールを「言語化（設定）」し、マシンに強制させていないことが原因です。
今日は、Gitの隠れた実力者である「`.gitattributes`」と、それをプログラムから読み解く「`git-check-attr`」を組み合わせた、「自動化の基盤を強固にする極限のテクニック」を伝授します。これをマスターすれば、あなたのプロジェクトは一気にプロフェッショナルな安定感を獲得します。
—
1. なぜ `.gitattributes` なのか？
Gitは単なるファイル保存庫ではありません。ファイルごとの「振る舞い」を定義する賢いエンジンです。
`.gitattributes` ファイルは、プロジェクトのルートに置くことで、Gitやエディタに対して「このファイルはどう扱うべきか」を明示的に指示します。特に、OSやエディタの差異による「改行コード（EOL）問題」を根絶できるのはこの仕組みのおかげです。
まずは基本のセットアップ
プロジェクトのルートに `.gitattributes` を作成し、以下を記述してください。
プロジェクト内の全ファイルを「自動的に改行コードを正規化（LF）」する設定
- text=auto
シェルスクリプトは必ずLFで保存（実行権限エラーを防ぐ）
.sh text eol=lf
重要な設定ファイルには「フィルタ」をかけておく（後述の自動化で使います）
config/.json filter=my-custom-filter
これだけで、チーム全員がWindowsを使おうがMacを使おうが、リポジトリ内は常にクリーンな状態で保たれます。
—
2. `git-check-attr` で設定をプログラムに語らせる
ここからが本題です。「設定ファイルの内容を、CI/CDスクリプトやビルドツールが自動で判断できたらどうなるか？」を想像してください。
例えば、「特定のファイルだけ特定の処理をスキップしたい」といったルールを `.gitattributes` に書き、それをビルドスクリプトで検知するのです。
動作確認：HelloWorld的アプローチ
まず、ターミナルで以下のコマンドを叩いてみてください。
特定のファイルがどんな属性を持っているかチェックする
git check-attr -a path/to/your/file.sh
出力結果はこうなります：
`path/to/your/file.sh: text: set`
`path/to/your/file.sh: eol: lf`
この出力をシェルスクリプトでパースすれば、「このファイルはLFであるべきだから、もしCRLFなら警告を出して修正する」といった自律的なゲートキーパーが完成します。
—
3. 極限の自動化：ビルドスクリプトとの連携
CI/CDパイプラインの中で、特定のファイル属性に基づいてデプロイ設定を切り替えるスクリプトの断片をご紹介します。
!/bin/bash
FILE=”config/settings.json”
git-check-attrからフィルタ属性を取得
ATTR=$(git check-attr my-custom-filter “$FILE” | cut -d’ ‘ -f3)
if [ “$ATTR” == “set” ]; then
echo “警告: $FILE は特別な処理が必要です。専用の秘匿化スクリプトを起動します…”
# ここに暗号化解除やマージ処理を自動実行するコードを記述
./scripts/decrypt_config.sh “$FILE”
else
echo “通常ファイルとして処理を続行します。”
fi
この手法の凄みは、「Gitが知っているルールを、スクリプトがそのまま利用できる」という点にあります。
設定ファイルを二重管理する必要はもうありません。`.gitattributes` にルールを書けば、人間も機械も同じルールに従うのです。
—
4. 先輩からのアドバイス：運用を「仕組み」に変える
多くの初心者は、ルールを「口頭」や「ドキュメント（README）」で共有しようとします。しかし、人間は忘れますし、無視します。
Gitの力を信じてください。
1. `.gitattributes` はコードの一部として扱う: 常にリポジトリに含め、PRのレビュー対象にしてください。
2. `git-check-attr` をCIの入り口にする: ビルド前のテストスクリプトに組み込み、属性が守られていないファイルを即座に弾くようにしましょう。
3. エディタとの連携: VSCodeなどのモダンなエディタは `.gitattributes` を自動で読み込みます。開発環境を整える手間さえも省けます。
まとめ
「設定を Git に書き、Git に尋ねる」。
このシンプルなサイクルこそが、大規模開発や複雑なCI/CDを支える安定性の正体です。
ツールが何をしてくれるのか、どうすればツールと「会話」できるのかを理解した瞬間、あなたの開発スピードは劇的に加速します。まずは今すぐ、あなたのプロジェクトに `.gitattributes` を配置してみてください。
何かあればいつでも聞いてくださいね。あなたのコードが、より洗練されたものになることを楽しみにしています。