ソリューションのバージョンを変更する

Automation Cloud でソリューションのデプロイを別のパッケージ バージョンにアップグレードまたはダウングレードする。

ヒント:

運用環境のデプロイをアップグレードする前に、まず専用のテスト デプロイでアップグレードを検証することをお勧めします。詳しくは、「 テスト環境でソリューションのアップグレードを検証する」をご覧ください。

[バージョンを変更] 操作では、デプロイを新しいパッケージ バージョンにアップグレードしたり、古いパッケージ バージョンにダウングレード (ロールバック) できます。

ソリューションをダウングレードしても、エンティティ、チョイス セット、Webhook は削除されません。

バージョン変更ワークフローを開きます

1. Orchestrator で、テナント レベルで [ ソリューション ] を選択します。

2. [デプロイ] タブで、更新するデプロイを見つけます。

   ヒント:

   デプロイで新しいパッケージ バージョンが利用可能になると、[ バージョン ] 列には現在のバージョン番号の横にアップグレード インジケーターが表示されます。行から直接 [ アップグレード ] を選択してフローを開始することもできます。

3. 行の端にある 3 点リーダー メニュー (⋮) を選択し、[ バージョンの変更] を選択します。

   [設定] フォームで [バージョンの変更] ワークフローが開きます。

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

セットアップ フォームには、現在のデプロイの詳細が事前に入力されています。以下を確認して更新します。

フィールド	説明
パッケージ	このデプロイに関連付けられているソリューション パッケージ。読み取り専用です。
バージョン	対象のパッケージ バージョン。既定では、最新のパブリッシュ済みバージョン (または現在インストールされているバージョン以外の最新バージョン) が使用されます。ドロップダウンから別のバージョンを選択して、特定のバージョンにアップグレードまたはダウングレードします。
デプロイの名前	既存のデプロイの名前です。読み取り専用です。

[ バージョンを変更 ] を選択して続行するか、ドロップダウン矢印を選択して [ カスタマイズ ] を選択し、リソース エクスプローラーを開いてコンポーネントの変更を確認してから操作を実行します。

コンポーネントの変更を確認する

[カスタマイズ] を選択すると、リソース エクスプローラーに変更内容の概要が表示されます。

• 新たに追加されたコンポーネントです。プラス (+) アイコンでマークされています。これらのコンポーネントは、バージョンの変更後にターゲット環境で作成されます。

  移行後のバージョンで、このバージョン変更によって削除されたコンポーネントと同じ名前のコンポーネントが追加された場合、名前の競合によって操作がブロックされなくなりました。削除が確定すると、その名前が利用可能になります。その名前のリソースが削除されていない場合、競合によってバージョンの変更はブロックされます。

• 削除されたコンポーネント。マイナス (−) アイコンのマークが付いています。これらのコンポーネントは、他のソリューションから参照されない限り、対象の環境から削除されます。その場合、コンポーネントは環境内に残りますが、ソリューションから削除されます。

  このバージョン変更以外のものがキューまたはストレージ バケットに依存している場合、キューまたはストレージ バケットの削除はブロックされます。つまり、バージョン変更後も生き残ったトリガーがキューを使用し続ける間はキューを削除できず、バージョン変更後も生き残ったキュー、タスク カタログ、またはプロセスがバケットを保持ターゲットとして使用している間はバケットを削除できません。同じバージョン変更の依存コンポーネントを削除して続行します。

  キューまたはストレージ バケットを削除すると、その最後の参照 (他のフォルダーで共有されていない) が削除される場合は、バージョンの変更を実行する前に削除を確定する必要があります。以下の 「置換されたリソースの削除を確認する 」をご覧ください。

• 編集されたコンポーネント。アスタリスク (*) アイコンでマークされています。[ プロパティの違いを比較 ] パネルでは、プロパティ レベルのすべての変更が強調表示されます。

  設定可能なプロパティのみが変更されたコンポーネントは、編集されるコンポーネントとしてマークされません。編集されるコンポーネントは、設定可能なプロパティの既存の設定値を既定で保持しますが、パッケージ設定を使用するように切り替えることができます。プロパティ レベルの変更をすべて確認するには、[ プロパティの違いを比較 ] パネルを使用します。

必要に応じて、設定可能なコンポーネントのプロパティを編集し、[ 続行 ] を選択してバージョンを変更して操作を実行します。コネクション コンポーネントの場合、[認証の種類] プロパティはラジオ カードとして表示され、ドロップダウンではなく各カードにオプションのタイトルと説明が表示されます。

リソースのリンク、変更、リンク解除

リソース エクスプローラーが開いているときに、バージョン変更を実行する前に、コンポーネントを既存のリソースにリンクしたり、リンク先のリソースを変更したり、リンクを解除したりできます。リンクを解除すると、ソリューションと外部コンポーネントの間の接続が削除されます。アップグレード時に、リソースはリンクされたコンポーネントを再利用するのではなく、ソリューション フォルダー内に新たに作成されます。

これは、以前のバージョンで自動的にインストールされたリソースにも当てはまります。リンク コントロールはこれらのリソースに対してロックされなくなり、リンクされていない他のリソースと同じ方法でリンクできます。インストール済みリソースのリンクは、次のリソースの種類でサポートされています。

• プロセス
• アセット
• ストレージ バケット
• キュー
• Webhook
• コネクション
• インデックス

リンクされたコンポーネントには、リソース エクスプローラーで [リンク済み ] バッジが付けられます。リンクされたコンポーネントを選択すると、リンクされたリソースの情報を含むカードが表示されます。リソースがフォルダー内ではなくテナント レベルで存在する場合は、 テナント のチップが含まれます。

リソースをリンク、変更、またはリンク解除するには:

1. リソース エクスプローラーで、コンポーネントを選択します。
2. 以下のいずれかを選択します。
   • 既存のコンポーネントにリンク - リンクされていないコンポーネントをリンクします。
   • リンクされたコンポーネントを別のリソースにリンクするには、 を変更します。
   • リンクを解除 - 既存のリンクを削除します。

注:

リソースを、インストール済みのコピー自体にリンクすることはできません。

[ 既存のピッカーにリンク ] ピッカーについて詳しくは、「ソリューションをデプロイする」の「 コンポーネントをリンク、変更、リンク解除 する」をご覧ください。

結果: リンク解除後、リソースは、バージョンの変更を適用する前に別の既存のコンポーネントにリンクしない限り、アップグレード時にソリューション フォルダー内に新たに作成されます。バージョンの変更が適用されると、リソースを再リンクできなくなります。

以前のバージョンで自動的にインストールされたリソースをリンクすると、インストールされたコピーは廃止され、バージョン変更が実行されると、データとともに完全に削除されます。以下の 「置換されたリソースの削除を確認する 」をご覧ください。

置換されたリソースの削除を確定します

インストール済みのリソースを既存のリソースにリンクするか、他に参照のないキューまたはストレージ バケットを削除すると、置き換えられたリソースとそのデータが完全に削除されます。バージョンの変更を実行する前に、この損失を確認する必要があります。

アクション ボタンの上にインライン アラートが表示され、影響を受けるリソースが一覧表示されます。[ 削除してデプロイ ] を選択して確定して続行するか、代わりに [ 検証 ] または [ 下書きとして保存 ] を使用して設定を変更します。確認後に設定を変更すると、再度アラートが表示されて再度確認されます。

この確認なしに (API などを介して) バージョンの変更を開始した場合、操作は拒否されます。

警告:

削除されたリソースは、後のロールバックでは回復されません。ロールバックすると、ソリューション パッケージのリソースが、以前のデータは含まれずに、新しくインストールされたリソースとして再作成されます。

バージョン変更後

[ デプロイ ] タブでは、動作ステータスを監視できます。すべてのステータスについて詳しくは、「 デプロイのステータス」をご覧ください。

注:

バージョン変更後、デプロイのステータスは [非アクティブ] になります。非アクティブなデプロイは、アクティブ化する前に追加の構成が必要かどうかに応じて、 さらに [非アクティブ (アクティブ化の準備完了)] または [非アクティブ] (アクティブ化するには設定が必要) に分類されます。ソリューションを機能させるには、デプロイを手動でアクティブ化する必要があります。

結果: 選択したバージョンにデプロイがアップグレードまたはダウングレードされます。[デプロイ] タブに [バージョンを変更 - 前回の操作で成功] と表示され、[バージョン] 列には新しいバージョンが反映されます。