- はじめに
- ソリューション プロジェクトとパッケージを管理する
- ソリューションのデプロイを管理する
- ベスト プラクティス
ソリューション ユーザー ガイド
ソリューションのデプロイとは、ソリューション パッケージを新しいデプロイとして Orchestrator フォルダーにインストールすることを意味します。ソリューションのデプロイについて詳しくは 、「ソリューション開発ライフサイクルについて」をご覧ください。
ソリューションのデプロイは Studio Web または Orchestrator から開始できます。どちらのサーフェスも、基になる同じデプロイ エクスペリエンスを駆動します。 Studio Web は、単一のフローでパッケージ化してデプロイするソリューション作成者向けに設計された元のサーフェスです。Orchestrator は、大規模なデプロイを管理するテナント管理者向けに設計された管理画面です。このページでは、Orchestrator の流れについて説明します。
Orchestrator のデプロイ フローには、フィードにパブリッシュ済みのソリューション パッケージが必要です。ここにデプロイする前に、Studio Web またはデスクトップ版の Studio からパッケージをパブリッシュできます。
この手順は通常、管理者が実行します。
デプロイ ワークフローを開きます
デプロイ ワークフローは、Orchestrator の次のいずれかの場所から開くことができます。
- Deployments tab: Select Deploy in the upper-right corner.
- Packages tab: Select the Deploy row action for the package you want to deploy.
- Package sidebar: Open a package to expand its sidebar, then select Deploy in the upper-right corner of the sidebar.
- Versions tab of the Package sidebar: Select the Deploy row action for the specific package version you want to deploy.
4 つのパスすべてで、セットアップ フォームで同じデプロイ ワークフローが開きます。上部の階層リンクには、[ テナント] > [ソリューション>デプロイ] > [デプロイ] と表示されます。
セットアップ フォームに入力します
The Setup form is where you define what to deploy, where it lands, and how it activates. Complete the following fields, then select Deploy. The Package and Version fields are always visible; the remaining fields are grouped under the Options control, which you can expand or collapse. When collapsed, Options shows a summary of the current values (for example, the destination folder, whether triggers are enabled right away, and whether a runtime is set up).
| フィールド | 説明 |
|---|---|
| パッケージ | Select the solution package to deploy from the dropdown. The list shows all packages published to your tenant feed. After you select a package, its description appears beneath the field. |
| バージョン | The package version to install. Appears after you select a package. Defaults to the latest published version. The publish date and release notes for the selected version appear beneath the field. Select a different version from the dropdown if needed. |
| オプション | Expands or collapses the deployment settings that follow. When collapsed, it shows a summary of the selected values. |
| デプロイの名前 | A required, tenant-unique name for this deployment. Auto-filled from the package name. Edit to use a different name. The name is validated as you type: if a deployment with the same name already exists, the form shows an error and you cannot continue until the name is unique. |
| 場所 | ソリューション フォルダーが作成されるフォルダーです。既定値は Shared です。ドロップダウンから別のフォルダーを選択して、保存先を変更します。 |
| ソリューションのフォルダー名 | The name of the subfolder created inside the destination folder. Auto-filled to match the deployment name until you edit it. Edit to customize it for this deployment. |
| 今すぐアクティブ化 | 切り替え (既定ではオン)。有効化すると、トリガーが存在する場合はすぐに有効化されます。 |
| ランタイムを設定 | 切り替え (既定ではオン)。有効化すると、既定の実行マシンがテナント レベルで設定されていない場合に、サーバーレス ランタイムがプロビジョニングされます。 |
デプロイを実行します
「セットアップ」フォームに入力したら、フォームの下部にある以下のいずれかのオプションを選択します。
-
Deploy: validates the configuration and runs the deployment immediately. The workflow progresses through the following steps shown in the What will happen panel on the left:
手順 説明 設定 デプロイを検証して設定します。 デプロイ フォルダーを設定し、リソースをプロビジョニングします。 アクティベート トリガーを有効化し、[ すぐにアクティブ化] がオンの場合はデプロイを検証します。 -
Customize (select the dropdown arrow on the Deploy button): opens the resource explorer so you can review and configure individual solution components before the deployment runs. In the resource explorer, you can:
- Filter the properties shown for a component using the Display control (All properties, Empty properties, Required properties, or Configurable properties).
- Link a component to an existing resource using Link to existing.
- Revert your changes to a component using Reset.
- Review the Issues counter (errors, warnings, and information) and the Logs panel.
When you finish, select one of the following:
- Continue to proceed with the deployment.
- Validate to check the configuration without deploying.
- Save as draft to save and resume later.
- Delete draft to discard the deployment.
Save a deployment as a draft
If you are not ready to run a deployment, you can save your progress and finish it later:
- Select Customize from the Deploy button dropdown to open the resource explorer.
- Configure components as needed.
- Select Save as draft.
The draft appears in the Deployments tab with a Draft status chip. To resume it, select the draft row, then select Continue editing. To discard it, select Delete draft.
既存のコンポーネントを再利用する (任意)
When the deployment is located outside your Personal Workspace (for example, in a shared folder), the candidate list excludes resources stored in your Personal Workspace at any folder depth, including nested subfolders. This prevents broken deployment configurations that your collaborators cannot run or maintain because they cannot access your Personal Workspace resources.
If the deployment is inside your Personal Workspace, all your accessible resources, including your Personal Workspace resources, are available for linking.
[カスタマイズ] を選択すると、リソース エクスプローラーにソリューション パッケージのすべてのコンポーネントが表示されます。同じ名前のコンポーネントがテナントに既に存在する場合は、新しいコンポーネントを作成する代わりに、そのコンポーネントにソリューションをリンクできます。
このオプションは、アセット、ストレージ バケット、Webhook、キューに使用できます。競合ごとに、以下の操作を実行できます。
- 既存のコンポーネントはそのままにし、追加のコンポーネントは作成しません。
- 既存のコンポーネントを保持し、ソリューションから新しいフィールドを追加します (既存のフィールドは変更されません)。
- 各サービスで競合しているリソースの名前を変更します。
- 可能であれば、ソリューション デプロイ内のリソースの名前を変更します。
既存のコンポーネントをリンクするには:
-
リソース エクスプローラーで、リンクするコンポーネントを選択します。
-
[ 既存のものにリンク] を選択します。
-
[ 既存のプロセスにリンク ] ダイアログで、リンクするコンポーネントを選択します。
-
[ リンク] を選択します。
- When a resource is linked, it is not created as part of the deployment; the solution uses the linked resource directly. Linking a resource with a different name may lead to runtime errors unless the solution was developed to support this configuration.
- When you link a resource that exists in another folder, the solution stores the runtime dependency against the solution folder where the resource is copied, not the original source folder. Users with permissions on the solution folder can run the process without needing permissions on the original resource location.
デプロイのステータスを監視する
デプロイが開始されたら、ワークフロー ビューまたは [ソリューション] の [デプロイ] タブから進行状況を監視できます。以下のステータスが考えられます。
| ステータス | 説明 |
|---|---|
| 処理中 | デプロイ操作が実行中です。 |
| 成功 | デプロイが完了し、すべてのコンポーネントがインストールされます。 |
| 失敗 | デプロイは失敗し、自動ロールバックが実行されました。 |
| ロールバックに失敗 | デプロイが失敗し、一部のコンポーネントを手動でクリーンアップする必要があります。 |
すべてのステータスについて詳しくは、「 デプロイのステータス」をご覧ください。
デプロイをアクティブ化する
ソリューションにアプリが含まれていて、指定したリンクを使用してアクティブ化されていない場合、デプロイのアクティブ化は失敗します。詳しくは、 Orchestrator と Apps のドキュメントをご覧ください。
デプロイが成功すると、Orchestrator はアクティベーションの準備状況を評価します。デプロイは、次のいずれかのステータスで [ デプロイ] タブに表示されます。
-
非アクティブ (アクティブ化の準備完了): 追加の構成は不要です。[ その他のアクション ] アイコンを選択し、[ デプロイをアクティブ化] を選択します。
-
非アクティブ (アクティベーションするには設定が必要): アクティベーションの前に、追加の前提条件を満たす必要があります。
-
[その他のアクション] アイコンを選択し、[アクティベーションを設定] を選択します。
-
アクティベーションの検証結果を確認し、必要な項目を完了します。
- アカウントを追加し、ロールを割り当てます。
- ソリューション フォルダーにマシンを追加します。
- 必要に応じて、アカウントとマシンのマッピングを定義します。
- 該当する場合、ロボットごとのアセット値を定義します。
- ソリューションで使用されているアプリをアクティブ化する
- 該当する場合、プロセスの種類コンポーネントのバインドを入力します。
注:When deploying a solution, a Default Serverless template may be automatically attached to the target folder if the Set up runtime toggle was enabled on the Setup form. This ensures the solution can run without manually configuring machine templates. If a serverless template is already inherited, no additional template is attached.
-
リストされた項目を解決します。
-
[ 検証] を選択します。
-
[アクティベーション] を選択します。
-
Result: Once your solution is deployed and successfully activated, that solution is displayed on the Deployments tab with an Active status.