手順: デプロイ時に既存の Orchestrator リソースを再利用する

CI/CD パイプラインからソリューションをデプロイする場合は、新しいものをプロビジョニングするのではなく、既存の Orchestrator 接続、アセット、またはキューを再利用します。

ソリューションをデプロイすると、ソリューションで宣言されるすべてのリソース (キュー、アセット、プロセス、コネクション) がデプロイ フォルダーに新たにプロビジョニングされます。多くの場合、外部システムへの接続など、ターゲット環境に既に共有リソースがあり、新しいリソースを作成するのではなく、そのリソースを再利用したいと考えています。

リソースを手動でデプロイおよびリンクする場合は、Orchestrator の UI で [ カスタマイズ ] を選択します。この手動ステップは無人パイプラインには変換されません。CLI と同等の CLI は、デプロイ構成を取得し、そのファイル内のリソースをリンクしてから、そのファイルを に渡すこと deploy runです。

注:

config link 、宣言された 1 つのリソースを既存のリソースにバインドします。代わりに、すべてのリソースを既存のリソースを再利用するには、以下の「すべてのリソースを再利用する」をご覧ください。

前提条件

• テナントに パブリッシュ済み のソリューション パッケージ「 ソリューションをパッケージ化してパブリッシュする」をご覧ください。
• クライアント資格情報認証用に設定された 外部アプリケーション 。スコープは AutomationSolutions、 Solutions.Deployments、 Solutions.Packages、 OR.Folders、 RCS.FolderAuthorizationです。「 認証 - フロー 2」をご覧ください。 OR.Folders と RCS.FolderAuthorization は、CLI で Orchestrator フォルダー内に存在するリソースを解決してバインドできるようにするために必要です。
• 既存のリソースを保持する Orchestrator フォルダーに割り当てられた外部アプリケーション。

手順

1. 外部アプリケーションで認証する

   uip login \
     --client-id env.UIPATH_CLIENT_ID \
     --client-secret env.UIPATH_CLIENT_SECRET \
     --tenant "$UIPATH_TENANT"
   

2. パッケージのデプロイ構成をダウンロードします。

   uip solution deploy config get "my-package" \
     --package-version 1.0.0 \
     -d ./deploy-config.json
   

3. ソリューション リソースを既存の Orchestrator リソースにリンクします。構成ファイルに表示されているとおりのリソース名を使用し、既存のリソースが存在するフォルダーを --folder-path ポイントします。

   uip solution deploy config link ./deploy-config.json "MyConnection" \
     --name "SharedCrmConnection" \
     --folder-path "Shared"
   

4. 編集した設定でパッケージをデプロイします。

   uip solution deploy run \
     --name "my-deployment" \
     --package-name "my-package" \
     --package-version 1.0.0 \
     --folder-name "MySolution" \
     --parent-folder-path "Shared" \
     --config-file ./deploy-config.json
   

デプロイでは、リンクされたリソースは再利用され、デプロイ フォルダーに新しいリソースは作成されません。

注:

config linkでは、--folder-path は既存のリソースが存在する場所です。deploy runには、デプロイ フォルダーを作成する--parent-folder-pathです。これらは、別々のサブコマンド上の別々のフラグです。

接続: 選択は実行時に延期します

接続リソースの場合、既存の接続をリンクする唯一のオプションではありません。デプロイ設定でコネクションの authenticationType を ConfigurableByUsers に設定した場合は、コネクションをバインドしていないままにして、その選択と認証を実行時 (オートメーションの実行時にユーザーがコネクションを選択して認証する) まで延期できます。これもアクティブ化に対して有効な設定です。

authenticationType は、 ConfigurableByUsers (実行時にユーザーに優先) と AuthenticateAfterDeployment (デプロイ後にコネクションを認証する必要がある) の 2 つの値を受け入れます。AuthenticateAfterDeploymentでは、アクティベーションが実行されるまでに接続が認証されていない場合、アクティベーションは失敗として報告されます。

すべてのリソースを再利用

新しいリソースを作成するのではなく、デプロイ全体で既存のリソースを再利用する場合は、デプロイする前に 1 回の呼び出しですべてのリソースに競合ポリシーを設定します。

1. 構成ファイル内のすべてのリソースに競合ポリシーを設定します。

   uip solution deploy config set ./deploy-config.json --all conflictFixingAction UseExisting
   

2. 手順 4 に示すように、同じファイルを deploy run --config-fileに渡します。

参照

• uip solution deploy — config get、config link、config set、および deploy runの参照です。
• Orchestrator のアセットとキューの管理 — 後でリンクするリソースを作成します。
• CI から Orchestrator にデプロイ する — 認証、キャッシュ、およびこれが適合するパイプラインのバージョンのピン留め。
• 認証 — ここで使用する外部アプリケーション フローです。