Orbit
Orbit デプロイメント パイプライン
The Pipeline tab is a single page that answers "what happens when we push". It shows every way a deploy can be triggered, every gate that can stop one, the state of each environment, and which build…
Orbit デプロイメントパイプライン
Pipeline タブは、「プッシュ時に何が起こるか」という質問に答える単一ページです。デプロイをトリガーできるすべての方法、デプロイを停止できるすべてのゲート、各環境の状態、どのビルド機能がオンになっているかを表示します。すべてプロジェクトの実際の設定から読み込まれます。
Pipeline の場所
Orbit を開き、プロジェクトをクリックして、プロジェクトタブストリップの Deployments グループから Pipeline を選択します。ページは Deployment pipeline というラベルが付いています。
これは読み取り専用ダッシュボードです。ここでは何も設定されません。すべてのセクションは、設定が実際に存在する場所にリンクしています。これがその価値です: 8 つの設定カードを読む代わりに、プロジェクトを理解するための 1 つの画面です。
上部のアラート
2 つのバナーが該当する場合に表示されます:
- Deploy lock active: Manage リンク付き。プッシュでトリガーされるデプロイがスキップされています。
- N deployments awaiting approval: Review リンク付き。誰かが承認または却下する必要があります。
どちらかが表示されていて、プッシュがデプロイされていない理由が気になる場合は、さらに読む必要なく答えが得られます。
ビルド統計
コンパクトなパネルに、最近のビルドについて成功率、平均ビルド時間、成功数が表示されます。これは分析というより健全性チェックです。全体像については、Orbit Project Analytics と Orbit Build Insights を参照してください。
トリガーソース
このセクションでは、このプロジェクトのデプロイへのすべてのルートをリストします:
| ソース | 表示内容 |
|---|---|
| Git push | 接続されているリポジトリ、または No repo connected |
| Branch previews | プレビューが任意のブランチで自動的に作成されるかどうか |
| Git tag | タグパターン（設定されている場合） |
| Manual deploy | 常に利用可能 |
デプロイに驚いたときはいつでもこれを読んでください。誰もプッシュしていないのにビルドが表示された場合、これが説明です: タグ、デプロイフック、またはボタンを押した誰か。
ゲートと安全性
最大のセクションはゲートのリストで、各ゲートは現在の状態を Configure リンク付きで表示し、関連する設定カードにリンクしています。
| ゲート | 機能 |
|---|---|
| Approval gate | 本番環境へのデプロイは明示的な承認が必要 |
| Staging prerequisite | 本番環境は同じコミットでのステージングを待つ |
| CI checks | パスする必要のある必須チェック、または No checks required |
| Freeze window | 週末をブロック、カスタム時間、またはフリーズスケジュールなし |
| Deploy lock | アクティブ、またはロックなし |
| Health check | デプロイ後にチェックするパス、または Disabled |
| Auto-rollback | ヘルスチェック失敗時に復帰 |
| Skew protection | 古いアセットの保持ウィンドウ |
| Auto retry | インフラストラクチャの失敗が再試行される回数 |
これらのほとんどのゲートはプッシュでトリガーされるデプロイにのみ適用されます。パネルからのマニュアルデプロイとデプロイフックは直進します。例外は異なる動作をします。各ゲートの詳細は Deploying Your Project で説明されています。ゲートをコントロールとして信頼する前にそれを読んでください。
チェックリストとしてゲートを読む
重要なプロジェクトの場合、合理的なベースラインは以下の通りです:
- Health check: 設定済み、キャッシュされたシェルではなくアプリを実行するパスを指しています。
- Auto-rollback: オン。ヘルスチェックがなければ機能する対象がないため、2 つはセットです。
- Auto retry: 1 つまたは 2 つ。ネットワーク不具合などのインフラストラクチャエラーで失敗したビルドを再キューイングし、コードエラーは再試行しないため、何も費用がかかりませんが時間を節約できます。
- Approval gate: 不正なデプロイが高いもの向けはオン、保護するよりも速度を低下させるもの向けはオフ。
ページが Health check Disabled と Auto-rollback on を表示している場合、その組み合わせは何もしません。これは、気づかずに数ヶ月間実行するのが最も簡単な構成ミスの 1 つであり、このページはそれを見つける場所です。
環境フロー
Environment flow セクションは、各環境をカードとして描画します。現在の状態: LIVE、BUILDING、または PAUSED、トラッキング中のブランチ、および現在のデプロイが再試行の場合は再試行番号です。
各カードのバッジは、その環境に対して有効になっているもの表示します:
- Smoke tests: 各デプロイ成功後に選択されたパスに対して実行される GET リクエスト。
- Auto-promote: 一定数の健全時間後のステージングから本番環境への昇格。
- Canary: カナリアデプロイのトラフィックのパーセンテージ。
- Inherits prod vars: ステージングが低い優先度で本番環境変数をマージする場所。
- Scheduled rebuild: 本番環境が間隔で再構築される場所。
各カードはその環境のデプロイにリンクしています。環境が No deployments yet と表示されている場合、設定に存在しますが、何もデプロイされていません。
アクティブな機能
最後のセクションではビルドレベルの設定をまとめます:
| 機能 | 値 |
|---|---|
| Server mode | SSR 有効またはスタティックのみ |
| Auto-create on push | ブランチプッシュが環境を作成するかどうか |
| Health checks | オンまたはオフ |
| Build retry | 最大値、またはオフ |
| Deploy groups | 他のプロジェクトとグループ化、またはスタンドアロン |
| Build timeout | ビルドあたりの制限 |
| Preview expiry | プレビューが一時停止される日数、または無期限 |
Server mode は人々が引っかかるものです。サーバーでレンダリングするフレームワークはこれをオンにする必要があります。スタティックエクスポートはそうではありません。プロジェクトがビルドは正常だが、ホームページ以外のすべてのルートで空白ページまたは 404 が提供される場合は、まずこれを確認してください。Frameworks Orbit Supports を参照してください。
Preview expiry はハウスキーピングのものです。無期限に設定すると、プレビュー環境が無期限に蓄積されます。
Pipeline ページの使用
誰かをオンボードするとき。 まずここに送ってください。ドキュメントよりも高速で正確なブリーフィングです。ライブ設定から生成されるからです。
デプロイが発生しなかった場合。 トップダウンで作業します: バナー、次にトリガーソース、次にゲート。3 つの 1 つがそれを説明します。
リスクのあるリリースの前に。 ゲートセクションが期待通りに読み込まれることを確認してください。auto-rollback があると信じることと実際にあることの違いです。
インシデント中。 環境フローは、どこが現在のところかを教えます。また、何かが構築中であるかどうか。
トラブルシューティング
ページが No repo connected を表示します。 プロジェクトにはリポジトリがありません。1 つを接続します: Connecting a GitHub Repository を参照してください。
ゲートがオンですがデプロイは通過します。 これはプッシュでトリガーされるだけです。デプロイフックまたはマニュアルパネルデプロイは影響を受けません。
環境が PAUSED を表示します。 プレビュー環境は、有効期限を過ぎると自動的に一時停止されます。再デプロイして 1 つを復帰させます。
Auto-promote が表示されていますが何も昇格しません。 ヘルスチェックが合格しているスモークテストを実行する設定された健全時間数と、即座ではなく定期的に評価される必要があります。
次のステップ
- Deploying Your Project で各ゲートが実際に何をブロックするかについては。
- Orbit Project Settings でそのいずれかを変更するには。
- Rolling Back a Deployment ゲートがあなたを救わなかった場合。