INTEREST JOURNAL DRUPAL & WEB

Drupalガイド詳細:11.11 コードと設定の履歴をGitで管理する

約1,600文字 読了目安:約4分

English ↗
この記事の目次

詳細版:公式User Guide 11.11を翻訳・再構成した非公式の解説です。原文の更新表示は2025年4月14日、今回の参照日は2026年11月6日です。Drupal実機での手順検証は未実施です。

公式原文 ↗ · 前へ: 11.10 設定全体の差分を確認して同期する · 第11章の入口

目的と準備

Gitでコードと書き出した設定の変更を記録します。Git、ターミナル、用意したリポジトリーと接続URLが必要です。DBの投稿、ユーザー、アップロード画像を自動保存する仕組みではありません。

公式例の流れと本サイトの補足

  1. プロジェクトのトップとドキュメントルートを確認します。Composer構成ではwebが公開ルートでも、composer.json/lockは上の階層にあります。
  2. .gitignoreで認証情報入りのsettings.php、アップロード等を除外します。原文の例はsites/*/settings*.php、sites/*/files、configです。web構成ならパスを合わせます。ただし設定を追跡する保存先まで除外しないよう、後述の書き出し先と整合させます。
  3. 新規リポジトリーならgit init後、statusとdiffで内容を確認して必要なファイルをステージし、コミットして接続先へpushします。既存リポジトリーは再初期化やremote追加を重ねません。
# 例。実際のプロジェクトで対象を確認して実行する。
git status
git diff
git add composer.json composer.lock
git diff --cached
git commit -m "Record dependency changes"
git push

原文はgit add -Aとmasterへの初回pushを示します。本サイトは対象を選ぶ例にし、ブランチは実際のmain/master等の設定に合わせると補足します。別コピーの取得はgit clone、既存コピーの更新はgit pull等で行い、作業中の差分や競合を確認します。

設定を履歴に含める

11.10 で全設定を書き出し、公開ルート外の追跡対象ディレクトリーへ展開します。次回も同じ場所に現在の全体を書き出し、追加・変更だけでなく削除も比較します。原文のconfig除外を残す場合は、追跡する書き出し先を別にするなど整合が必要です。履歴から他環境へ反映する際は、設定の取り込み操作が別途必要です。

本サイトの確認例

.gitignoreは既に追跡した秘密情報を履歴から消すものではありません。ダンプ・資格情報・ユーザーファイルを含めないか確認し、公開リポジトリーへのpush前には内容と接続先を点検します。DBとアップロードは別のバックアップを用意します。今回はリポジトリーの作成・コミット・pushは行っていません。

出典・帰属・変更内容

原典はDrupal User Guide 11.11 ↗ です。原文のAttributionsに記載された貢献者・元資料:Jennifer Hodgdon ↗ · “Building a Drupal site with Git” ↗ · Drupal Community Documentation ↗ 。各人の執筆・編集・翻案の役割は公式原文、全体の帰属は公式A.1 ↗ を参照してください。

原著の著作権は各貢献者にあり、公式著作権ページ ↗ は© 2015–2025と表記しています。変更点は、日本語への翻訳、説明・手順の再構成、独自の準備・確認・見直し例、原文の表記や更新情報への補足です。公式の画面画像・動画は転載していません。本文は原典と同じCC BY-SA 2.0 で提供します。公式版や公式の承認を示すものではなく、サイトデザインや無関係の記事へ適用する表示ではありません。

前へ: 11.10 設定全体の差分を確認して同期する · 第11章の入口

第10章の詳細一覧 · 第12章 · ガイド全体 · 公式情報を検索

この章の目次へ ↗