- はじめに
- ソリューション プロジェクトとパッケージを管理する
- ソリューションのデプロイを管理する
- ベスト プラクティス
ソリューション ユーザー ガイド
ソリューションのデプロイとは、ソリューション パッケージを新しいデプロイとして Orchestrator フォルダーにインストールすることを意味します。ソリューションのデプロイについて詳しくは 、「ソリューション開発ライフサイクルについて」をご覧ください。
ソリューションのデプロイは Studio Web または Orchestrator から開始できます。どちらのサーフェスも、基になる同じデプロイ エクスペリエンスを駆動します。 Studio Web は、単一のフローでパッケージ化してデプロイするソリューション作成者向けに設計された元のサーフェスです。Orchestrator は、大規模なデプロイを管理するテナント管理者向けに設計された管理画面です。このページでは、Orchestrator の流れについて説明します。
Orchestrator のデプロイ フローには、フィードにパブリッシュ済みのソリューション パッケージが必要です。ここにデプロイする前に、Studio Web またはデスクトップ版の Studio からパッケージをパブリッシュできます。
この手順は通常、管理者が実行します。
デプロイ ワークフローを開きます
デプロイ ワークフローは、Orchestrator の次のいずれかの場所から開くことができます。
- [デプロイ] タブ — 右上隅の [ + デプロイ ] を選択します。
- [パッケージ] タブ — デプロイするパッケージの [行をデプロイ ] アクションを選択します。
- パッケージのサイドバー — パッケージを開いてサイドバーを展開し、サイドバーの右上隅にある [ デプロイ ] を選択します。
- パッケージ サイドバーの [バージョン] タブ — デプロイする特定のパッケージ バージョンの[行 をデプロイ ] アクションを選択します。
4 つのパスすべてで、セットアップ フォームで同じデプロイ ワークフローが開きます。上部の階層リンクには、[ テナント] > [ソリューション>デプロイ] > [デプロイ] と表示されます。
セットアップ フォームに入力します
セットアップフォームでは、何をリリースするか、どこに着地するか、どのようにアクティブにするかを定義します。フォームの以下のフィールドに入力し、[ デプロイ] を選択します。
| フィールド | 説明 |
|---|---|
| パッケージ | デプロイするソリューション パッケージをドロップダウンから選択します。このリストには、テナント フィードにパブリッシュされたすべてのパッケージが表示されます。 |
| バージョン | インストールするパッケージのバージョンです。パッケージを選択すると表示されます。既定では、最新のパブリッシュ済みバージョンが使用されます。必要に応じて、ドロップダウンから別のバージョンを選択します。 |
| デプロイの名前 | このデプロイに必要なテナントの一意の名前。パッケージ名から自動入力されます。別の名前を使用するように編集します。 |
| 場所 | ソリューション フォルダーが作成されるフォルダーです。既定値は Shared です。ドロップダウンから別のフォルダーを選択して、保存先を変更します。 |
| ソリューションのフォルダー名 | 移動先フォルダー内に作成されるサブフォルダーの名前です。編集して、このデプロイ用にカスタマイズします。 |
| 今すぐアクティブ化 | 切り替え (既定ではオン)。有効化すると、トリガーが存在する場合はすぐに有効化されます。 |
| ランタイムを設定 | 切り替え (既定ではオン)。有効化すると、既定の実行マシンがテナント レベルで設定されていない場合に、サーバーレス ランタイムがプロビジョニングされます。 |
デプロイを実行します
「セットアップ」フォームに入力したら、フォームの下部にある以下のいずれかのオプションを選択します。
-
デプロイ — 設定を検証し、デプロイをすぐに実行します。ワークフローは、左側の [何が起こるか ] パネルに示す手順に従って進行します。
手順 説明 設定 デプロイを検証して設定します。 デプロイ フォルダーを設定し、リソースをプロビジョニングします。 アクティベート トリガーを有効化し、[ すぐにアクティブ化] がオンの場合はデプロイを検証します。 -
カスタマイズ ( [デプロイ ] ボタンのドロップダウン矢印を選択) — リソース エクスプローラーが開き、デプロイを実行する前に個々のソリューション コンポーネントを確認して設定できます。コンポーネントを確認したら、[ 続行] を選択してデプロイ を続行します。
既存のコンポーネントを再利用する (任意)
::: メモ 展開が個人用ワークスペースの外部 (共有フォルダーなど) にある場合、候補リストには、個人用ワークスペースに格納されているリソースが、入れ子になったサブフォルダーを含む任意のフォルダーの深さで除外されます。これにより、共同作業者が個人用ワークスペースのリソースにアクセスできないために実行または維持できない、破損したデプロイの設定を防ぐことができます。
デプロイが個人用ワークスペース内にある場合、個人用ワークスペースのリソースを含め、アクセス可能なすべてのリソースをリンクできます。:::
[カスタマイズ] を選択すると、リソース エクスプローラーにソリューション パッケージのすべてのコンポーネントが表示されます。同じ名前のコンポーネントがテナントに既に存在する場合は、新しいコンポーネントを作成する代わりに、そのコンポーネントにソリューションをリンクできます。
このオプションは、アセット、ストレージ バケット、Webhook、キューに使用できます。競合ごとに、以下の操作を実行できます。
- 既存のコンポーネントはそのままにし、追加のコンポーネントは作成しません。
- 既存のコンポーネントを保持し、ソリューションから新しいフィールドを追加します (既存のフィールドは変更されません)。
- 各サービスで競合しているリソースの名前を変更します。
- 可能であれば、ソリューション デプロイ内のリソースの名前を変更します。
既存のコンポーネントをリンクするには:
- リソース エクスプローラーで、リンクするコンポーネントを選択します。
- [ 既存のものにリンク] を選択します。
- [ 既存のプロセスにリンク ] ダイアログで、リンクするコンポーネントを選択します。
- [ リンク] を選択します。
デプロイのステータスを監視する
デプロイが開始されたら、ワークフロー ビューまたは [ソリューション] の [デプロイ] タブから進行状況を監視できます。以下のステータスが考えられます。
| ステータス | 説明 |
|---|---|
| 処理中 | デプロイ操作が実行中です。 |
| 成功 | デプロイが完了し、すべてのコンポーネントがインストールされます。 |
| 失敗 | デプロイは失敗し、自動ロールバックが実行されました。 |
| ロールバックに失敗 | デプロイが失敗し、一部のコンポーネントを手動でクリーンアップする必要があります。 |
すべてのステータスについて詳しくは、「 デプロイのステータス」をご覧ください。
デプロイをアクティブ化する
ソリューションにアプリが含まれていて、指定したリンクを使用してアクティブ化されていない場合、デプロイのアクティブ化は失敗します。詳しくは、 Orchestrator と Apps のドキュメントをご覧ください。
デプロイが成功すると、Orchestrator はアクティベーションの準備状況を評価します。デプロイは、次のいずれかのステータスで [ デプロイ] タブに表示されます。
-
非アクティブ (アクティブ化の準備完了): 追加の構成は不要です。[ その他のアクション ] アイコンを選択し、[ デプロイをアクティブ化] を選択します。
-
非アクティブ (アクティベーションするには設定が必要): アクティベーションの前に、追加の前提条件を満たす必要があります。
-
[その他のアクション] アイコンを選択し、[アクティベーションを設定] を選択します。
-
アクティベーションの検証結果を確認し、必要な項目を完了します。
- アカウントを追加し、ロールを割り当てます。
- ソリューション フォルダーにマシンを追加します。
- 必要に応じて、アカウントとマシンのマッピングを定義します。
- 該当する場合、ロボットごとのアセット値を定義します。
- ソリューションで使用されているアプリをアクティブ化する
- 該当する場合、プロセスの種類コンポーネントのバインドを入力します。
注:ソリューションをデプロイする際に、[セットアップ] フォームで [ランタイムを設定] トグルが有効化されている場合、既定のサーバーレス テンプレートがターゲット フォルダーに自動的にアタッチされることがあります。
- これにより、マシン テンプレートを手動で設定しなくてもソリューションを実行できます。
- サーバーレス テンプレートがすでに継承されている場合、追加のテンプレートはアタッチされません。
-
リストされた項目を解決します。
-
[ 検証] を選択します。
-
[アクティベーション] を選択します。
-