Salesforce DX 開発者ガイド
jCLI の使用による第二世代管理パッケージのインストール
Salesforce CLI で作業している場合、force:package:install コマンドを使用してスクラッチ組織または対象登録者組織にパッケージをインストールできます。
スクラッチ組織に第二世代管理パッケージ (管理 2GP) をインストールする前に、次のコマンドを実行してすべてのパッケージをリストし、ID またはパッケージの別名を見つけます。
1sfdx force:package:version:listインストールするバージョンを特定します。パッケージの別名またはパッケージ ID (04t から始まる) を指定して次のコマンドを入力します。
1sfdx force:package:install --package "Expense Manager@1.2.0-12" --targetusername jdoe@example.comすでにデフォルトのユーザ名でスクラッチ組織を設定している場合は、パッケージバージョン ID のみを入力します。
1sfdx force:package:install --package "Expense Manager@1.2.0-12"インストールに関する状況メッセージが CLI に表示されます。
1Waiting for the subscriber package version install request to get processed. Status = InProgress Successfully installed the subscriber package version: 04txx0000000FIuAAM.管理 2GP パッケージインストールのタイムアウトの制御
force:package:install コマンドを実行した後、パッケージバージョンが対象組織で使用可能になってインストールが完了するまで数分かかります。インストールを正常に終了するための十分な時間を確保するには、相互に排他的なタイマーを表す次のパラメータを使用します。
-
--publishwait では、パッケージバージョンが対象組織で使用可能になるまでコマンドが待機する最長時間 (分単位) を定義します。デフォルトは 0 です。この期間内でパッケージが対象組織で使用可能にならない場合、インストールは終了します。
新しいパッケージバージョンを作成してすぐに対象組織にインストールする場合、--publishwait の設定が���立ちます。
- --wait では、パッケージが使用可能になった後、インストールが完了するまでコマンドが待機する最長時間 (分単位) を定義します。デフォルトは 0 です。--wait 期間が終了すると、インストールコマンドは完了しますが、インストールは失敗または成功するまで続行します。インストールの状況をポーリングするには、sfdx force:package:install:report を使用できます。
たとえば、Expense Manager (経費マネージャ) というパッケージがあり、これが対象組織で使用可能になるまで 5 分かかり、インストールに 11 分かかるとします。次のコマンドでは publishwait が 3 分に設定され、wait が 10 分に設定されています。Expense Manager (経費マネージャ) は、設定された publishwait 期間以上の時間を必要とするため、インストールは 3 分の publishwait 期間が終了した後に中止されます。
1sfdx force:package:install --package "Expense Manager@1.2.0-12" --publishwait 3 --wait 101sfdx force:package:install --package "Expense Manager@1.2.0-12" --publishwait 6 --wait 10