デプロイ申請
概要
デプロイ申請は、プロジェクトバージョンをデバイスにデプロイするための管理された方法です。デバイスへ即座に書き込む代わりに、申請では何をデプロイすべきか、誰が何のために要求したのかを記録し、承認権限を持つ担当者による承認を待ちます。承認された後、かつ承認有効期間内でのみ、デプロイを実行できます。
これにより、本番設備に対して四つの目の原則（ダブルチェック）が適用されます。変更を準備するエンジニアと、それを承認する担当者が同一である必要はなく、すべての手順が監査用に記録されます。
申請は、デバイスの Deployments タブ内の Requests で管理します。その隣の Jobs ビューには、デプロイの実行そのものが表示されます。詳細は Deployments ページを参照してください。
申請の作成
ステップ 1 – バージョンの選択と変更内容の記述
Request deployment を選択し、ダイアログの最初のステップに入力します。
| フィールド | 説明 |
|---|---|
| Project version | デプロイするプロジェクトバージョン。一覧にはバージョン番号、作成日、作成者が表示されます。 |
| Title | 必須。変更内容の短い要約で、申請一覧および承認者に送信される通知に表示されます。 |
| Description | 任意。承認者向けの背景情報 — 何がどのように変更され、その理由は何かを記載します。 |
| Operation mode after deployment | デプロイ完了後にデバイスを Stop Mode と Run Mode のどちらに設定するか。 |
続行するには Review changes を選択します。
ステップ 2 – 変更内容の確認
2 番目のステップでは、申請を確定する前に、デプロイによってデバイス上で何が変更されるかを正確に確認できます。
サマリーにはデバイス、プロジェクト、タイトルが再表示され、現在デプロイされているバージョンとターゲットバージョンが比較されます。変更されたオブジェクトは Modified と Unchanged としてカウントされ、プロジェクト内のパス（例: Program / Scan / MAIN / ProgPou）で一覧表示されます。Open full comparison を選択すると、2 つのバージョンの完全な並列比較が開きます。
送信するには Request deployment を選択します。最初のステップに戻って入力内容を修正するには Back を選択します。
送信後
申請はステータス Requested で Requests 一覧に表示され、そのデバイスに対する承認権限を持つすべてのユーザーに通知されます。
一覧には、タイトル、ステータス、説明、プロジェクト、バージョン、申請者、作成日時が表示されます。Expires at と Executed at は、申請が承認され実行されるまで空欄のままです。
申請ステータス
| ステータス | 意味 |
|---|---|
| Requested | 送信済みで、承認者の対応待ちです。 |
| Approved | 承認済みで、承認有効期間が切れるまで実行可能です。 |
| Denied | 承認者が申請を却下しました。実行できません。 |
| Canceled | 申請者が実行前に申請を取り下げました。 |
| Executed | 承認された申請からデプロイが開始されました。 |
| Expired | 実行されないまま承認有効期間が経過しました。新しい申請が必要です。 |
決定の通知
承認者があなたの申請について決定を行うと、Deployments 通知カテゴリで設定されたチャネルを通じて通知されます。
申請には Approved と、承認有効期間の終了時刻である Expires at が表示されます。これらのメッセージを受信する方法や受信の有無を変更するには、Notifications を参照してください。
承認済み申請の実行
承認済みの申請を開いて実行します。詳細ビューには、申請者、デバイス、プロジェクト、バージョンが再表示され、Created at と Expires at の両方が示されます。
Changes タブには、説明、デプロイ済みバージョンとターゲットバージョン、デプロイ後に適用される動作モード、および変更されたオブジェクトの一覧が表示されます。Compare を選択すると完全な比較が開きます。Activity タブには、申請のライフサイクルにおけるすべての手順 — 作成、承認者のコメントを伴う承認、実行 — が記録されます。
- Execute – デプロイを開始します。他のデプロイと同様に実行され、独自の実行ログとともに Jobs に表示されます。
- Cancel request – デプロイせずに申請を取り下げます。
デプロイは Expires at より前に実行する必要があります。期間が経過すると申請は失効し、新しい申請を作成する必要があります。
ユースケース
- すべての変更について第二者による承認が必要な本番設備へのデプロイ。
- 監査および変更管理の記録のために、変更内容とその理由を併せて文書化する。
- エンジニアがデプロイを準備・レビューし、シフトリーダーが実行のタイミングを判断できるようにする。
- 承認有効期間を利用して、デプロイを合意されたメンテナンスウィンドウ内に制限する。
詳細情報
- Approve Deployment — 申請のレビューと決定。
- Deployments — デプロイ履歴と直接実行。
- Notifications — デプロイ通知の設定。