ソリューションをデプロイする

Automation Cloud の Orchestrator テナントにソリューション パッケージをデプロイします。

ソリューションのデプロイとは、ソリューション パッケージを新しいデプロイとして Orchestrator フォルダーにインストールすることを意味します。ソリューションのデプロイについて詳しくは 、「ソリューション開発ライフサイクルについて」をご覧ください。

ソリューションのデプロイは Studio Web または Orchestrator から開始できます。どちらのサーフェスも、基になる同じデプロイ エクスペリエンスを駆動します。 Studio Web は、単一のフローでパッケージ化してデプロイするソリューション作成者向けに設計された元のサーフェスです。Orchestrator は、大規模なデプロイを管理するテナント管理者向けに設計された管理画面です。このページでは、Orchestrator の流れについて説明します。

Orchestrator のデプロイ フローには、フィードにパブリッシュ済みのソリューション パッケージが必要です。ここにデプロイする前に、Studio Web またはデスクトップ版の Studio からパッケージをパブリッシュできます。

この手順は通常、管理者が実行します。

デプロイ ワークフローを開きます

デプロイ ワークフローは、Orchestrator の次のいずれかの場所から開くことができます。

• [デプロイ] タブ: 右上隅の [デプロイ] を選択します。
• [パッケージ] タブ: デプロイするパッケージの [行をデプロイ] アクションを選択します。
• パッケージのサイドバー: パッケージを開いてサイドバーを展開し、サイドバーの右上隅にある [ デプロイ ] を選択します。
• パッケージのサイドバーの [バージョン] タブ: デプロイする特定のパッケージ バージョンの [行を デプロイ ] アクションを選択します。

4 つのパスすべてで、セットアップ フォームで同じデプロイ ワークフローが開きます。上部の階層リンクには、[ テナント] > [ソリューション>デプロイ] > [デプロイ] と表示されます。

セットアップ フォームに入力します

[セットアップ] フォームでは、何をデプロイし、デプロイする場所、アクティブ化する方法を定義します。以下のフィールドに入力し、[ デプロイ] を選択します。[ パッケージ] フィールドと [ バージョン ] フィールドは常に表示されます。残りのフィールドは [ オプション] コントロールの下にグループ化され、展開または折りたたむことができます。折りたたむ と、現在の 値の概要 (ターゲット フォルダー、トリガーがすぐに有効化されるかどうか、ランタイムが設定されているかどうかなど) が表示されます。

フィールド	説明
パッケージ	デプロイするソリューション パッケージをドロップダウンから選択します。このリストには、テナント フィードにパブリッシュされたすべてのパッケージが表示されます。パッケージを選択すると、フィールドの下にその説明が表示されます。
バージョン	インストールするパッケージ バージョンです。パッケージを選択すると表示されます。既定では、最新のパブリッシュ済みバージョンが使用されます。選択したバージョンのパブリッシュ日とリリース ノートがフィールドの下に表示されます。必要に応じて、ドロップダウンから別のバージョンを選択します。
オプション	後続のデプロイ設定を展開または折りたたみます。折りたたむと、選択した値の概要が表示されます。
デプロイの名前	このデプロイで指定する、テナント固有の必須の名前。パッケージ名から自動入力されます。別の名前を使用するように編集します。名前は入力中に検証されます。同じ名前のデプロイが既に存在する場合、フォームにエラーが表示され、名前が一意になるまで続行できません。
場所	ソリューション フォルダーが作成されるフォルダーです。既定値は Shared です。ドロップダウンから別のフォルダーを選択して、保存先を変更します。
ソリューションのフォルダー名	作成先フォルダー内に作成されるサブフォルダーの名前です。編集するまで、デプロイ名と一致するように自動入力されます。編集して、このデプロイに合わせてカスタマイズします。
今すぐアクティブ化	切り替え (既定ではオン)。有効化すると、トリガーが存在する場合はすぐに有効化されます。
ランタイムを設定	切り替え (既定ではオン)。有効化すると、既定の実行マシンがテナント レベルで設定されていない場合に、サーバーレス ランタイムがプロビジョニングされます。

デプロイを実行します

「セットアップ」フォームに入力したら、フォームの下部にある以下のいずれかのオプションを選択します。

• デプロイ: 構成を検証し、デプロイを直ちに実行します。ワークフローは、左側の [処理の 予定] パネルに示されている以下の手順に従って進みます。

  手順	説明
  設定	デプロイを検証して設定します。
  デプロイ	フォルダーを設定し、リソースをプロビジョニングします。
  アクティベート	トリガーを有効化し、[ すぐにアクティブ化] がオンの場合はデプロイを検証します。

• カスタマイズ ( [デプロイ] ボタンのドロップダウン矢印を選択): リソース エクスプローラーが開き、デプロイの実行前に個々のソリューション コンポーネントを確認および設定できます。リソース エクスプローラーでは、次のことを実行できます。

  • 表示コントロールを使用して、コンポーネントに表示されるプロパティをフィルター処理します ([すべてのプロパティ]、[空のプロパティ]、[必須のプロパティ]、または [設定可能なプロパティ])。
  • Link a component to an existing resource, change which resource it's linked to, or unlink it — see Link, change, or unlink a component below.
  • リセットを使用して、コンポーネントへの変更を元に戻 します。
  • 問題カウンター (エラー、警告、情報) と [ログ] パネルを確認します。

  完了したら、次のいずれかを選択します。

  • デプロイを続行します。
  • デプロイせずに構成を確認するために検証します。
  • 下書きとして保存 すると保存でき、後で再開できます。
  • 下書きを削除 - デプロイを破棄します。

デプロイを下書きとして保存する

デプロイを実行する準備ができていない場合は、進行状況を保存して後で完了できます。

1. [デプロイ] ボタンのドロップダウンから [カスタマイズ] を選択して、リソース エクスプローラーを開きます。
2. 必要に応じてコンポーネントを設定します。
3. [ 下書きとして保存] を選択します。

下書きが [ デプロイ ] タブに表示され、ステータス チップが [ 下書き ] になります。再開するには、下書き行を選択し、[ 編集を続行] を選択します。下書きを破棄するには、[ 下書きを削除] を選択します。

Link, change, or unlink a component (optional)

Linking a component to an existing resource avoids duplicating connections, assets, and queues across deployments. While customizing a draft deployment, you can link a component to an existing resource, change which resource it's linked to, or unlink it.

注:

デプロイが個人用ワークスペースの外部 (共有フォルダーなど) にある場合、候補リストでは、個人用ワークスペースに保存される任意のフォルダーの深さ (入れ子になったサブフォルダーを含む) のリソースは除外されます。これにより、共同作業者が個人用ワークスペースのリソースにアクセスできないために実行または保守できない、破損したデプロイ設定を防止できます。

デプロイが個人用ワークスペース内にある場合は、個人用ワークスペースのリソースを含む、アクセス可能なすべてのリソースをリンクできます。

When you select Customize, the resource explorer shows all components in the solution package. If a component with the same name already exists in the tenant, you can link the solution to it instead of creating a new one. This option is available for Assets, Storage buckets, Webhooks, and Queues. For each conflict, you can:

• 既存のコンポーネントはそのままにし、追加のコンポーネントは作成しません。
• 既存のコンポーネントを保持し、ソリューションから新しいフィールドを追加します (既存のフィールドは変更されません)。
• 各サービスで競合しているリソースの名前を変更します。
• 可能であれば、ソリューション デプロイ内のリソースの名前を変更します。

Resources that live at the tenant level rather than in a folder are marked with a dedicated icon in the resource explorer tree, and their resource details header shows a Tenant chip.

Link a component to an existing resource

1. リソース エクスプローラーで、リンクするコンポーネントを選択します。

2. [ 既存のものにリンク] を選択します。

   In the Link to existing picker, each candidate resource row shows the resource kind icon (or the connector image, for connections), a friendly type label, and the resource's folder location. Locations in your Personal Workspace are labeled My Workspace.

3. Select the resource you want to link to.

4. [ リンク] を選択します。

注:

• リソースがリンクされている場合、そのリソースはデプロイの一部としては作成されません。ソリューションは、リンクされたリソースを直接使用します。別の名前のリソースをリンクすると、この設定をサポートするソリューションが開発されていない限り、実行時エラーが発生する可能性があります。
• 別のフォルダーに存在するリソースをリンクすると、ソリューションには、元のソース フォルダーではなく、リソースがコピーされたソリューション フォルダーに対する実行時の依存関係が格納されます。ソリューション フォルダーに対する権限を持つユーザーは、元のリソースの場所に対する権限を必要とせずにプロセスを実行できます。

Understand a linked component

When a component is linked, the resource explorer shows a card with the linked resource's information instead of a set of read-only fields.

Change or unlink a component

Linked components are marked with a Linked badge in the resource explorer.

1. In the resource explorer, select the linked component.
2. 以下のいずれかを選択します。
   • Change to link the component to a different resource, using the same picker described above.
   • Unlink to remove the link.

Result: Unlinking removes the connection between the solution and the external resource. The resource is then created fresh inside the solution folder instead of reusing the linked one.

デプロイのステータスを監視する

デプロイが開始されたら、ワークフロー ビューまたは [ソリューション] の [デプロイ] タブから進行状況を監視できます。以下のステータスが考えられます。

ステータス	説明
処理中	デプロイ操作が実行中です。
成功	デプロイが完了し、すべてのコンポーネントがインストールされます。
失敗	デプロイは失敗し、自動ロールバックが実行されました。
ロールバックに失敗	デプロイが失敗し、一部のコンポーネントを手動でクリーンアップする必要があります。

すべてのステータスについて詳しくは、「 デプロイのステータス」をご覧ください。

デプロイをアクティブ化する

注:

ソリューションにアプリが含まれていて、指定したリンクを使用してアクティブ化されていない場合、デプロイのアクティブ化は失敗します。詳しくは、 Orchestrator と Apps のドキュメントをご覧ください。

デプロイが成功すると、Orchestrator はアクティベーションの準備状況を評価します。デプロイは、次のいずれかのステータスで [ デプロイ] タブに表示されます。

• 非アクティブ (アクティブ化の準備完了): 追加の構成は不要です。[ その他のアクション ] アイコンを選択し、[ デプロイをアクティブ化] を選択します。

• 非アクティブ (アクティベーションするには設定が必要): アクティベーションの前に、追加の前提条件を満たす必要があります。

  1. [その他のアクション] アイコンを選択し、[アクティベーションを設定] を選択します。

  2. アクティベーションの検証結果を確認し、必要な項目を完了します。

     • アカウントを追加し、ロールを割り当てます。
     • ソリューション フォルダーにマシンを追加します。
     • 必要に応じて、アカウントとマシンのマッピングを定義します。
     • 該当する場合、ロボットごとのアセット値を定義します。
     • ソリューションで使用されているアプリをアクティブ化する
     • 該当する場合、プロセスの種類コンポーネントのバインドを入力します。

     Linked components cannot be relinked or unlinked during activation. If a component is linked, the setup view shows a notice instead of editable fields.

     注:

     [セットアップ] フォームで [ランタイムを設定] トグルが有効化されている場合、ソリューションをデプロイする際に既定のサーバーレス テンプレートがターゲット フォルダーに自動的にアタッチされることがあります。これにより、マシン テンプレートを手動で設定しなくてもソリューションを実行できます。サーバーレス テンプレートがすでに継承されている場合、追加のテンプレートはアタッチされません。

  3. リストされた項目を解決します。

  4. [ 検証] を選択します。

  5. [アクティベーション] を選択します。

結果: ソリューションがデプロイされ、正常にアクティブ化されると、そのソリューションが [デプロイ] タブに [アクティブ] のステータスで表示されます。