01. Git 基本コマンド

そもそも Git とは何か

Git は 「ファイルの変更履歴を保存する仕組み」 です。Word の「変更履歴」を、フォルダ全体に対して、しかもチーム全員と共有しながら使えると思ってください。

Terraform で書いた .tf ファイルは「いまの AWS 構成を作るレシピ」そのものです。レシピの履歴がないと、「先週は動いていたのに、誰かが変えた瞬間から壊れている」 という事故が起きても元に戻せません。Git があれば、git log で「いつ・誰が・どこを・なぜ」変えたかが全部追えます。

最初の 1 回だけやる初期設定

名前とメールアドレスは、コミット 1 件ごとに記録されます。最初に登録しておきます。

git config --global user.name  "Your Name"
git config --global user.email "you@example.com"
# ブランチのデフォルト名を main に
git config --global init.defaultBranch main

新しいリポジトリを作る／既存をコピーする

# 新規: いまのフォルダを Git 管理にする
git init

# 既存: GitHub から手元にコピー
git clone https://github.com/your-org/your-repo.git

毎日使うコマンド（add → commit → push）

Git の基本サイクルは 3 ステップです。

1. 変更する: エディタでファイルを編集する
2. git add: 「このファイルの変更をコミット対象にする」と指示する
3. git commit: 履歴に 1 行追加する（メッセージ付き）
4. git push: 手元の履歴を GitHub に送る

# 何が変わっているか見る
git status
git diff                    # まだ add していない変更
git diff --cached           # add 済みの変更（commit 直前のレビュー）

# ステージング（add）
git add main.tf             # 1 ファイル
git add .                   # カレント以下の全変更（注意して使う）

# コミット
git commit -m "feat: add VPC module for staging"

# GitHub に送る
git push origin main

コミットメッセージのコツ

1 行目に「何をしたか」を簡潔に書きます。Conventional Commits のような型を 1 つ決めるとチームで揃います。

feat: add VPC module for staging   # 機能追加
fix: correct CIDR overlap in dev   # バグ修正
chore: bump aws provider to 5.80   # 雑務（依存更新など）
docs: add README to s3 module      # ドキュメント
refactor: extract iam to module    # 動作不変のリファクタ

ブランチを切って作業する

ブランチ (branch) は「履歴の枝分かれ」です。main ブランチを本番の正、と決めて、変更は必ず別ブランチで行ってから main にマージする のが標準的な使い方です。

git branch                  # ブランチ一覧
git switch -c add-vpc-module  # 作って切り替え（推奨）
# 旧式: git checkout -b add-vpc-module

# 作業して commit したら GitHub に push
git push -u origin add-vpc-module

その後 GitHub 上で Pull Request (PR) を開き、レビューと CI（GitHub Actions による terraform plan 等）を経て main にマージします。

ブランチを統合する（merge と rebase）

# merge: 取り込み履歴を残す（チーム作業の標準）
git switch main
git merge add-vpc-module

# rebase: 自分のコミットを main の最新の上に積み直す
git switch add-vpc-module
git rebase main           # 履歴をきれいに保てる、ただし衝突注意

リモートと同期する（pull / fetch）

git fetch origin            # GitHub の最新を取得（手元はまだ動かない）
git pull origin main        # fetch + 手元の main にマージ
git pull --rebase origin main  # マージコミットを作らず rebase で取り込む

やり直す（reset / revert / stash）

# 直前のコミットを「なかったこと」にする（手元のみ、未 push 時に）
git reset --soft HEAD~1     # コミットだけ取り消し、変更は残る

# すでに push 済みのコミットを取り消す（履歴を残したまま打ち消すコミットを追加）
git revert HEAD

# 作業中の変更を一時的に退避（ブランチ切替したい時）
git stash
git stash pop               # 戻す

コマンド早見表