---
title: デプロイ
description: GitHub Actions などの CI/CD を使い、ブランチへのマージをきっかけに自動でデプロイする運用ルール
---

デプロイは GitHub Actions などの CI/CD で自動化し、ヒューマンエラーを減らします。

:::danger[手動アップロードの禁止]
FTP クライアントなどによる手動アップロードは、アップロード漏れや上書きミスが起きやすく、何をいつ反映したか追跡できないため、原則禁止です。
レンタルサーバーでも、GitHub Actions から配信してください（[レンタルサーバーへのデプロイ](#レンタルサーバーへのデプロイ)を参照）。
:::

## 環境の分離

- **ステージング環境**（`staging`）: 本番と同等の構成で、公開前の確認に使う
- **本番環境**（`production`）: 公開中のサイト

プロジェクトによっては、プレビュー環境や QA 環境を追加することもあります。

:::warning[ステージング環境は非公開にする]
ステージング環境は Basic 認証などでアクセスを制限し、`X-Robots-Tag: noindex` ヘッダーや `<meta name="robots" content="noindex">` で検索エンジンにインデックスされないようにしてください。
本番環境に noindex の設定が残っていないことも、公開時に確認してください。
:::

## デプロイのトリガー

- **`develop` ブランチへのマージ**: ステージング環境へ自動デプロイ
- **`main` ブランチへのマージ**: 本番環境へ自動デプロイ（または手動承認後）

ブランチの運用は[ブランチ戦略](/git/branch)を参照してください。

## ワークフロー例

`develop` と `main` へのマージは PR 経由に限り、PR では CI の成功を必須にしています（[ブランチ保護](/git/branch#ブランチ保護)を参照）。
そのため、デプロイのワークフローでは Lint やテストを再実行せず、ビルドとデプロイだけを行います。
`develop` / `main` への push では CI ワークフローとデプロイワークフローが別々に走り、マージ時に CI でチェック済みである前提です（[CI](/deploy-release/ci)）。

### ステージング環境へのデプロイ

```yaml .github/workflows/deploy-staging.yml
name: Deploy to Staging

on:
  push:
    branches: [develop]

permissions:
  contents: read

# 同じ環境へのデプロイを同時に実行しない
concurrency:
  group: deploy-staging
  cancel-in-progress: false

jobs:
  deploy:
    runs-on: ubuntu-latest
    environment: staging

    steps:
      - uses: actions/checkout@v7
      - uses: pnpm/action-setup@v6
      - uses: actions/setup-node@v7
        with:
          node-version-file: ".nvmrc"
          cache: "pnpm"

      - run: pnpm install --frozen-lockfile
      - run: pnpm run build

      - name: Deploy to Staging
        # Cloudflare の場合の例。値は Environment（staging）の Secrets から読み込まれる
        env:
          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
          CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
        # デプロイ先に応じたコマンド（Cloudflare、Vercel など）
        run: pnpm run deploy:staging
```

### 本番環境へのデプロイ

```yaml .github/workflows/deploy-production.yml
name: Deploy to Production

on:
  push:
    branches: [main]

permissions:
  contents: read

concurrency:
  group: deploy-production
  cancel-in-progress: false

jobs:
  deploy:
    runs-on: ubuntu-latest
    # GitHub Environments で承認者（Required reviewers）を設定できる（プランの制約は後述）
    environment: production

    steps:
      - uses: actions/checkout@v7
      - uses: pnpm/action-setup@v6
      - uses: actions/setup-node@v7
        with:
          node-version-file: ".nvmrc"
          cache: "pnpm"

      - run: pnpm install --frozen-lockfile
      - run: pnpm run build

      - name: Deploy to Production
        # ステージング環境と同じ Secret 名で、Environment（production）の値が使われる
        env:
          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
          CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
        run: pnpm run deploy:production
```

:::tip[GitHub Environments の活用]
GitHub Environments を使用すると、環境ごとに Secrets を分離できます。
Secret 名は環境間で揃え（例: `CLOUDFLARE_API_TOKEN`）、値だけを Environment ごとに設定してください。
:::

:::warning[Private リポジトリでのプランの制約]
Private リポジトリで Environments と Environment Secrets を使うには GitHub Team 以上、承認者（Required reviewers）を設定するには GitHub Enterprise が必要です。
承認者を設定できない場合は、`workflow_dispatch` による手動実行と、`main` への PR の承認で代替してください。
:::

## レンタルサーバーへのデプロイ

Cloudflare や Vercel を使わないレンタルサーバーの案件でも、GitHub Actions でビルドした成果物を配信します。

- **接続方式**: SSH が使えるサーバーでは、SFTP または rsync over SSH を使う。FTP しか使えない場合は FTPS（FTP over TLS）を使い、暗号化されない FTP は避ける
- **認証情報**: 接続先のホスト・ユーザー・秘密鍵やパスワードは Environment Secrets に登録し、ワークフローに直接書かない
- **配信対象（静的サイト）**: リポジトリ直下などのビルド成果物（`dist/`）だけを配信する
- **配信対象（WordPress）**: `theme/` ディレクトリ全体を配信する（PHP ソース、`functions/`、テーマ内の `dist/` など。テーマ内の `dist/` は CI の `pnpm run build` で生成済み）。`wp-content/uploads` やプラグインなど、サーバー上で管理しているファイルを上書き・削除しない

```yaml title="rsync over SSH の例 — 静的サイト（ステップ部分）"
- name: Deploy via rsync
  env:
    SSH_PRIVATE_KEY: ${{ secrets.SSH_PRIVATE_KEY }}
    SSH_KNOWN_HOSTS: ${{ secrets.SSH_KNOWN_HOSTS }}
    SSH_DEST: ${{ secrets.SSH_DEST }} # 例: user@example.com:/home/user/example.com/public_html/
  run: |
    mkdir -p ~/.ssh
    echo "$SSH_PRIVATE_KEY" > ~/.ssh/id_ed25519
    chmod 600 ~/.ssh/id_ed25519
    echo "$SSH_KNOWN_HOSTS" > ~/.ssh/known_hosts
    rsync -az dist/ "$SSH_DEST"
```

```yaml title="rsync over SSH の例 — WordPress テーマ（ステップ部分）"
- name: Deploy theme via rsync
  env:
    SSH_PRIVATE_KEY: ${{ secrets.SSH_PRIVATE_KEY }}
    SSH_KNOWN_HOSTS: ${{ secrets.SSH_KNOWN_HOSTS }}
    SSH_DEST: ${{ secrets.SSH_DEST }} # 例: user@example.com:/path/to/wp-content/themes/your-theme/
  run: |
    mkdir -p ~/.ssh
    echo "$SSH_PRIVATE_KEY" > ~/.ssh/id_ed25519
    chmod 600 ~/.ssh/id_ed25519
    echo "$SSH_KNOWN_HOSTS" > ~/.ssh/known_hosts
    rsync -az theme/ "$SSH_DEST"
```

:::warning[rsync の --delete に注意]
`--delete` を付けると、配信元にないファイルが配信先から削除されます。
配信先のディレクトリにサーバー側で管理しているファイルがないことを確認してから使ってください。
:::

## デプロイ時の注意

- **デプロイ後の確認**: 本番環境で正常に動作しているか確認する
- **ロールバックの準備**: 問題発生時にすぐ戻せる手順を用意しておく（[ロールバック](/deploy-release/release#ロールバック)を参照）
- **デプロイの時間帯**: アクセスの多い時間帯や、休日前・終業直前の本番デプロイは避ける
