Netlify CLI 完全コマンドリファレンス - 開発者必携の便利コマンド集

Netlify CLI は Web 開発者にとって必須のツールです。この記事では、日々の開発で使える実践的なコマンドを厳選してお届けします。コピペですぐに使える形式なので、ブックマークしてお使いください！

🚀 基本デプロイコマンド

プレビューデプロイ

# 基本のプレビューデプロイ
netlify deploy

# ビルド込みプレビューデプロイ
netlify deploy --build

# メッセージ付きプレビューデプロイ
netlify deploy --message "機能テスト: ログイン機能追加"

本番デプロイ

# 本番デプロイ
netlify deploy --prod

# ビルド込み本番デプロイ
netlify deploy --prod --build

# バージョン指定本番デプロイ
netlify deploy --prod --message "v1.2.0リリース"

よく使うワンライナー

# フルデプロイ（ビルド→本番）
npm run build && netlify deploy --prod

# 緊急デプロイ（現在の状態で即座に本番反映）
netlify deploy --prod --message "緊急修正"

# 現在のブランチ名を含むテスト用プレビュー
netlify deploy --message "機能テスト: $(git branch --show-current)"

📊 状況確認コマンド

サイト情報の確認

# サイトの基本情報
netlify status

# サイトの詳細情報
netlify sites:list

# 現在のサイト情報
netlify sites:show

デプロイ履歴の確認

# デプロイ履歴を表示
netlify deploy:list

# 最新10件のデプロイ履歴
netlify deploy:list --limit 10

# 特定のデプロイ詳細
netlify deploy:show DEPLOY_ID

ログの確認

# Function ログを表示
netlify logs

# リアルタイムでログを監視
netlify logs:function --follow

# 特定の時間範囲のログ
netlify logs --from="2024-01-01" --to="2024-01-31"

🛠️ サイト管理コマンド

プロジェクトの初期設定

# 新しいサイトを作成
netlify sites:create --name my-awesome-site

# 既存のサイトにリンク
netlify link

# Site ID を指定してリンク
netlify link --id YOUR_SITE_ID

# リンクを解除
netlify unlink

環境変数の管理

# 環境変数を設定
netlify env:set NODE_ENV production
netlify env:set API_URL "https://api.example.com"
netlify env:set DATABASE_URL "postgres://..."

# 環境変数を一覧表示
netlify env:list

# 特定の環境変数を取得
netlify env:get NODE_ENV

# 環境変数を削除
netlify env:unset OLD_VARIABLE

# 環境変数をファイルから一括設定
netlify env:import .env.production

ドメインの管理

# カスタムドメインを追加
netlify domains:create mydomain.com

# ドメイン一覧を表示
netlify domains:list

# DNS レコードを確認
netlify dns:show mydomain.com

🔄 デプロイ管理コマンド

ロールバック操作

# デプロイ履歴を確認
netlify deploy:list

# 特定のデプロイにロールバック
netlify deploy:restore DEPLOY_ID

# 直前の安定版にロールバック
netlify deploy:restore --latest-published

# プレビューデプロイを本番に昇格
netlify deploy:promote DEPLOY_ID

デプロイのキャンセル

# 実行中のデプロイをキャンセル
netlify deploy:cancel

# 特定のデプロイをキャンセル
netlify deploy:cancel DEPLOY_ID

⚙️ Functions 関連コマンド

Function の開発

# Functions をローカルで実行
netlify dev

# 特定のポートで Functions を実行
netlify dev --port 3000

# Functions をビルド
netlify functions:build

# Functions をデプロイ
netlify functions:create my-function

Function のテスト

# Function を直接呼び出し
netlify functions:invoke my-function

# ペイロード付きで Function を呼び出し
netlify functions:invoke my-function --payload '{"key": "value"}'

# Function のログを確認
netlify logs:function my-function

🔧 開発環境コマンド

ローカル開発サーバー

# 開発サーバーを起動
netlify dev

# 特定のポートで起動
netlify dev --port 8080

# 外部からアクセス可能にして起動
netlify dev --host 0.0.0.0

# ライブリロード無効で起動
netlify dev --no-open

ビルドとテスト

# ローカルでビルドをテスト
netlify build

# キャッシュをクリアしてビルド
netlify build --clear-cache

# 特定のコンテキストでビルド
netlify build --context deploy-preview

📈 分析とパフォーマンス

サイト分析

# サイトの基本分析
netlify analytics

# 帯域幅使用量を確認
netlify analytics:bandwidth

# 訪問者数を確認
netlify analytics:pageviews

パフォーマンステスト

# Lighthouse テストを実行（要 lighthouse パッケージ）
lighthouse $(netlify status --json | jq -r '.site_url')

# Core Web Vitals をチェック
npx @netlify/plugin-lighthouse --audit-url=$(netlify status --json | jq -r '.site_url')

🔐 セキュリティ関連コマンド

アクセストークンの管理

# ログイン
netlify login

# ログアウト
netlify logout

# ステータス確認（認証情報含む）
netlify status

# 新しいアクセストークンでログイン
netlify login --new

サイトの保護

# パスワード保護を設定
netlify sites:update --password "your-password"

# IP制限を設定（Proプラン以上）
netlify sites:update --allowed-ips "192.168.1.0/24,10.0.0.0/8"

📋 便利なスクリプト例

package.json に追加できるスクリプト

{
  "scripts": {
    "deploy": "netlify deploy --build",
    "deploy:prod": "netlify deploy --build --prod",
    "deploy:preview": "netlify deploy --build --message \"Preview: $(git branch --show-current)\"",
    "rollback": "netlify deploy:list && echo '上記からDEPLOY_IDを選んで: netlify deploy:restore DEPLOY_ID'",
    "status": "netlify status",
    "logs": "netlify logs --follow"
  }
}

Bash エイリアス設定

# ~/.bashrc または ~/.zshrc に追加
alias nd="netlify deploy"
alias ndp="netlify deploy --prod"
alias ndb="netlify deploy --build"
alias ndbp="netlify deploy --build --prod"
alias ns="netlify status"
alias ndl="netlify deploy:list"
alias nll="netlify logs --follow"

🚨 緊急時対応コマンド

緊急ロールバック

# 1. 現在のデプロイ状況を確認
netlify status

# 2. 直近のデプロイ履歴を確認
netlify deploy:list --limit 5

# 3. 安全な版にロールバック
netlify deploy:restore DEPLOY_ID

# 4. ロールバック確認
netlify status

サイトダウン時の対応

# 1. サイトステータス確認
netlify status

# 2. 最新のビルドログ確認
netlify logs

# 3. 強制的に前の安定版に戻す
netlify deploy:restore --latest-published

# 4. 緊急メンテナンスページの表示
echo "メンテナンス中" > maintenance.html
netlify deploy --dir . --prod --message "緊急メンテナンス"

🎯 効率的な使い方のコツ

コマンドの組み合わせ

# デプロイ後にステータスを確認
netlify deploy --prod && netlify status

# 環境変数を設定後にデプロイ
netlify env:set NEW_FEATURE_FLAG true && netlify deploy --prod

# ビルドエラー時の詳細確認
netlify build 2>&1 | tee build.log

JSON 出力の活用

# JSON形式でステータス取得
netlify status --json

# サイトURLを変数に格納
SITE_URL=$(netlify status --json | jq -r '.site_url')

# デプロイIDを取得
DEPLOY_ID=$(netlify deploy:list --json | jq -r '.[0].id')

📚 関連リソース

よく使う URL（テンプレート）

# 本番サイト
https://your-site-name.netlify.app

# Netlify ダッシュボード
https://app.netlify.com/sites/your-site-name

# デプロイ詳細
https://app.netlify.com/sites/your-site-name/deploys/DEPLOY_ID

設定ファイル例

# netlify.toml
[build]
  command = "npm run build"
  publish = "dist"

[build.environment]
  NODE_VERSION = "18"

[[plugins]]
  package = "@netlify/plugin-nextjs"

[dev]
  command = "npm run dev"
  port = 3000

---

この記事をブックマークして、Netlify CLI を使いこなしましょう！コマンドで困った時は、いつでもこのリファレンスに戻ってきてください。

💡 さらに学習したい方へ

• Netlify CLI 公式ドキュメント
• Netlify Functions ガイド
• Netlify Build プラグイン

Happy coding! 🚀