Zinnector®を使用したデプロイ: リンク、確認、プッシュ

プロジェクトがローカルで動作したら、4つのコマンドで Zinn Digital®ホスティング上の本番サイトへと移行できます。サインイン、プロジェクトのホスティングスロットへの紐付け、事前チェックの確認、そしてプッシュです。この記事では、それぞれのコマンド、出力内容、そしてその後に使用するコマンド (再デプロイ、デプロイ履歴、ビルドログ) について順を追って説明します。

API キーでサインインする

ダッシュボードの設定 → API キーでキーを作成し、次を実行します。

zinnector login

キーはプロンプトで入力します。コマンドラインでの直接指定は決して受け付けないため、シェルの履歴やプロセス一覧に残ることはありません。CI では、パイプで渡すか (echo "$ZINN_API_KEY" | zinnector login --profile ci)、ZINNECTOR_TOKENを設定してloginを完全にスキップします。キーは保存前に検証され、ファイルモード600で保存されます。zinnector whoami --scopesを実行すると、サインインしている組織とキーに付与されている権限が表示されます。サンドボックスキーにはその旨が明記されます。

プロジェクトをスロットに紐付ける

zinnector link                                   # リストからサイトを選択
zinnector link example.com --repo acme/site --branch main

linkはサイトの ID をzinnector.jsonに書き込み、--no-repoを指定しない限り、プロジェクトの Git リモートをプラットフォーム上のサイトに接続してプッシュでデプロイできるようにします。zinnector.jsonをコミットしてください。これにより、リポジトリをクローンした同僚も指示を受けることなく同じ場所にデプロイできるようになります。このファイルに機密情報は含まれません。

事前チェックを確認する

zinnector check

これこそが CLI が存在する目的となるコマンドです。デプロイ先のスロットとプロジェクトを比較し、あらゆる不一致や比較できなかったすべての項目を出力します。

• PHP バージョン: メジャーバージョンの差異は確実にサイトを破損させるため高と判定され、マイナーバージョンの差異は低めに判定されます。すべてを致命的と判定すると警告が無視されるようになるためです。
• スロットが構築時のバージョンに切り替え可能かどうか、スロットの PHP がサポート終了を過ぎているかどうか、そしてマシンがそのバージョンを適用済みか単に指示されただけか。
• スロットに残っている実際のディスクおよび inode の空き容量に対する、プロジェクトのサイズとファイル数 (WordPress のツリーは、ディスク上限に達する前にファイル上限に達することがあります)。
• 両環境のWordPress バージョン、スロットのプロビジョニングが完了しているか、プッシュ先となるリポジトリが接続されているか。

これは警告を行うのみで、処理をブロックすることはありません。すべての検出項目はzinnector push --forceで上書き可能です。ご自身のサイトについてはチェッカーよりもお客様自身のほうが把握しているためです。比較できなかった項目は、合格ではなく不明として報告され、概要には常にその件数が表示されます。デフォルトでは、ローカルの PHP バージョンはzinnector.jsonで宣言されているものになります。--probeを指定すると、代わりにローカルランタイムを起動して測定します。--strictを指定すると不明な項目がある場合もゼロ以外の終了コードで終了します。これは CI ゲートが求める挙動です。

プッシュ

zinnector push

pushは事前チェックを実行し、コミットをプッシュしてデプロイをトリガーし、完了まで監視して最終ステータスとデプロイされたコミットを出力します。--dry-runはデプロイ以外のすべてを実行します。--no-waitはデプロイをトリガーしてすぐに終了します。--no-gitはプッシュを行わずにプラットフォーム上にすでに存在するものをデプロイします。デプロイされたコミットが今プッシュしたものと異なる場合は、その旨が表示されます。

トラブルが発生した場合

zinnector deploys example.com        # デプロイ履歴 — ステータス、コミット、トリガー、メッセージ
zinnector logs example.com --build   # 最新デプロイのビルドログ
zinnector logs example.com --error   # サイトのエラーログ
zinnector deploy example.com         # プラットフォーム上にすでに存在するものを再デプロイ
zinnector ai "why is my deploy failing?"

zinnector aiはプラットフォーム上でお客様自身のアカウントに対して実行されるため、同じデプロイ履歴やログを参照できます。プロジェクト内から実行した場合、プロジェクトの構造 (ディレクトリ名、バージョン、サイト ID) が送信されますが、ファイルの内容が送信されることは決してありません。

関連情報

• [はじめに] (/kb/zinnector-getting-started) · [ローカル開発] (/kb/zinnector-local-development) · [コマンドリファレンス] (/kb/zinnector-command-reference) · [トラブルシューティング] (/kb/zinnector-troubleshooting)