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

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

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

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

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

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

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

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

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

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

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

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

フィールド	説明
パッケージ	Select the solution package to deploy from the dropdown. 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. Each entry shows the feed the version was published to. The publish date and release notes for the selected version appear beneath the field. Select a different version from the dropdown if needed.
オプション	後続のデプロイ設定を展開または折りたたみます。折りたたむと、選択した値の概要が表示されます。
デプロイの名前	このデプロイで指定する、テナント固有の必須の名前。パッケージ名から自動入力されます。別の名前を使用するように編集します。名前は入力中に検証されます。同じ名前のデプロイが既に存在する場合、フォームにエラーが表示され、名前が一意になるまで続行できません。
場所	The folder where the solution folder will be created. Defaults to Shared. Select a specific folder from the dropdown, or select Install as root folder to create it under the tenant.
ソリューションのフォルダー名	作成先フォルダー内に作成されるサブフォルダーの名前です。編集するまで、デプロイ名と一致するように自動入力されます。編集して、このデプロイに合わせてカスタマイズします。
ビジネス オーナー	任意です。このデプロイの責任者。[ 所有権] セクションに表示されます。
業務領域	任意です。このデプロイが属する 1 つ以上のビジネス領域[ デプロイ ] タブでデプロイをフィルター処理するために使用されます。[ 所有権] セクションに表示されます。
今すぐアクティブ化	切り替え (既定ではオン)。有効化すると、トリガーが存在する場合はすぐに有効化されます。
ランタイムを設定	切り替え (既定ではオン)。有効化すると、既定の実行マシンがテナント レベルで設定されていない場合に、サーバーレス ランタイムがプロビジョニングされます。

Feeds and deployment location

A version published to the tenant feed is labeled Tenant in the Version dropdown. The Location field sets where the solution folder is created. For a package published to the tenant feed, you can select any folder. A package published to a folder feed can be deployed only within that feed's folder hierarchy.

To publish a package to a folder feed, use the Feed option in the Studio Web Publish panel. For the steps, see Publish a solution to a feed.

For how feeds relate to each other, see Solution feed.

デプロイを実行します

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

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

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

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

  • 表示コントロールを使用して、コンポーネントに表示されるプロパティをフィルター処理します ([すべてのプロパティ]、[空のプロパティ]、[必須のプロパティ]、または [設定可能なプロパティ])。
  • コンポーネントを既存のリソースにリンクしたり、リンク先のリソースを変更したり、リンクを解除したりします (以下のコンポーネントの リンク、変更、リンク解除 を参照してください)。
  • リセットを使用して、コンポーネントへの変更を元に戻 します。
  • 問題カウンター (エラー、警告、情報) と [ログ] パネルを確認します。

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

  • デプロイを続行します。
  • デプロイせずに構成を確認するために検証します。
  • 下書きとして保存 すると保存でき、後で再開できます。
  • キャンセルして 変更を破棄します。確認ダイアログで、失われる内容の説明や、破棄するのではなく下書きとして保存するオプションが表示されます。

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

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

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

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

コンポーネントのリンク、変更、リンク解除 (任意)

コンポーネントを既存のリソースにリンクすると、デプロイ間で接続、アセット、キューが重複するのを回避できます。ドラフト デプロイをカスタマイズする際に、コンポーネントを既存のリソースにリンクしたり、リンク先のリソースを変更したり、リンクを解除したりできます。

注:

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

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

[ カスタマイズ] を選択すると、リソース エクスプローラーにソリューション パッケージ内のすべてのコンポーネントが表示されます。テナントに同じ名前のコンポーネントがすでに存在する場合は、新しいコンポーネントを作成するのではなく、ソリューションをそのコンポーネントにリンクできます。このオプションは、アセット、ストレージ バケット、Webhook、キューで使用できます。競合ごとに、次のことが可能です。

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

フォルダーではなくテナント レベルに存在するリソースは、リソース エクスプローラー ツリーに専用のアイコンでマークされ、[リソースの詳細] ヘッダーに テナントの チップが表示されます。

既存のリソースへのコンポーネントのリンク

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

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

   [ 既存のリソースにリンク ] ピッカーの各候補行には、リソースの種類アイコン (コネクションの場合はコネクタの画像)、フレンドリーの種類ラベル、およびリソースのフォルダーの場所が表示されます。個人用ワークスペース内の場所には 、[マイ ワークスペース] というラベルが付けられます。

3. リンク先のリソースを選択します。

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

注:

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

リンクされたコンポーネントを理解する

コンポーネントがリンクされると、リソース エクスプローラーには、一連の読み取り専用フィールドの代わりに、リンクされたリソースの情報を含むカードが表示されます。

コンポーネントを変更またはリンク解除する

リンクされたコンポーネントには、リソース エクスプローラーで [リンク済み ] バッジが付けられます。

1. リソース エクスプローラーで、リンクされたコンポーネントを選択します。
2. 以下のいずれかを選択します。
   • 変更すると、上記と同じピッカーを使用してコンポーネントを別のリソースにリンクできます。
   • リンクを解除 してリンクを削除します。

結果: リンクを解除すると、ソリューションと外部リソースの間の接続が削除されます。その後、リソースは、リンクされたリソースを再利用するのではなく、ソリューション フォルダー内に新たに作成されます。

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

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

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

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

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

注:

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

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

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

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

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

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

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

     リンクされたコンポーネントは、アクティベーション中に再リンクまたはリンク解除することはできません。コンポーネントがリンクされている場合、設定ビューには編集可能なフィールドの代わりに通知が表示されます。

     注:

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

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

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

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

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