��の文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

Salesforce CLI およびプラグインのインストール

CLI コマンドを使用して、開発環境とテスト環境を作成し、スクラッチ組織とバージョン管理システム間でソースコードを同期し、テストスイートを実行できます。

macOS での CLI のインストール

macOS では、.pkg ファイルを使用して Salesforce CLI をインストールします。
  1. .pkg ファイルをダウンロードします。
  2. .pkg ファイルをダブルクリックします。

Windows での CLI のインストール

Windows では、.exe ファイルを使用して Salesforce CLI をインストールします。
Windows インストーラをダウンロードして実行します。

Salesforce CLI は、ネイティブ Windows コマンドプロンプト (cmd.exe) および Microsoft Powershell 内で最適に動作します。Windows 10 Subsystem for Linux、cygwin、MinGW などの Linux ターミナルエミュレータはバグのサポートが制限されているため、これらのエミュレータで Salesforce CLI を使用することはお勧めしません。

警告

Linux での CLI のインストール

Linux バージョンの Salesforce CLI は、tarball として配布されます。

tarball のダウンロード URL はこのマニフェストファイル内にあります。downloads セクションには、最新のインストーラのバージョン設定されていない URL がリストされます。これらは、CI の使用事例で特に役立ちます。対象プラットフォームに基づいて URL を選択します。

  1. これらの tarball のいずれかをダウンロードするか、wget を実行します。
  2. sfdx ディレクトリを作成します。
  3. tarball バージョンのコンテンツを展開します。

    -Csfdx ディレクトリの内容を展開し、--strip-components 1 はルートパスのコンポーネントを削除します。

  4. インストールスクリプトを実行します。

    Salesforce CLI は /usr/local/bin/sfdx にインストールされます。インストーラは、インストールディレクトリに適切な権限を付与するように設計されています。sudo または chmod を使用したときに解決できない権限エラーやアクセスエラーが発生した場合は、npm を使用して CLI をインストールしてみてください

npm を使用した CLI のインストール

コンピュータに Node.js をインストールしている場合、npm を使用して Salesforce CLI をインストールできます。この方法では、コマンドラインから Salesforce CLI をインストールできます。継続的インテグレーション (CI) の使用事例で特に役立ちます。

このインストール方法は、ワークステーションに対する管理者権限がない場合や、グループポリシーによって CLI のインストールと更新がブロックされる場合に適切なオプションです。npm を使用した CLI のインストールでは、ルート権限は必要ありません。

  1. Node.js の長期サポート (Active LTS) バージョンがコンピュータにインストールされていることを確認します。LTS バージョンをインストールするには、https://nodejs.org/en/download/ にアクセスします。使用しているバージョン番号を確認するには、次のコマンドを実行します。
  2. 次のコマンドを実行します。

    npm を使用して CLI をインストールするときに権限エラーが発生する場合は、sudo を使用しないことをお勧めします。npm 権限の修正方法を参照してください。

Salesforce CLI の以前のバージョンのインストール

v45.8.0 以降の salesforcedx プラグインをインストールするには Salesforce CLI (sfdx-cli) v7 以降が必要です。それ以前のバージョンの Salesforce CLI をインストールするには次のコマンドを実行します (この場合、v6 がインストールされます)。

インストールの確認

Salesforce CLI のインストールおよびプラグインバージョンを確認します。
次のコマンドを実行して、Salesforce CLI バージョンを確認します。

次のコマンドを実行して、Salesforce CLI プラグインバージョンを確認します。

次のコマンドでは、CLI にインストールされている他のプラグインのリストが返されます。

コア salesforcedx プラグインは、sfdx plugins:install コマンドを使用して新しいバージョンをインストールした場合にのみ、前述のリストに含まれます。

次のコマンドを実行すると、force 名前空間のコマンドファミリ (トピック) のリストが返されます。

次のコマンドを実行すると、使用可能なすべての Salesforce CLI コマンドが表示されます。

特定バージョンの salesforcedx プラグインのインストール

デフォルトでは、初めて Salesforce CLI をインストールするときに、最新バージョンの salesforcedx プラグインがインストールされます。ただし、特定バージョンの salesforcedx プラグインの使用が必要な場合があります。

インストールした Salesforce CLI (sfdx-cli) および salesforcedx のバージョンを確認するには、次を実行します。

出力には、インストールされているすべてのプラグインが含まれています。プラグインの名前の横に (core) がある場合、これは、CLI にバンドルされているバージョンであることを示しています。特定バージョンのプラグインをインストールする場合は、代わりにそのバージョン番号またはタグが表示されます。

特定バージョンのプラグイン (49.14.0 など) をインストールするには、次のコマンドを実行します。

Sandbox プレビューでは、プレビューの新しい機能でのみ動作する更新を含む salesforcedx プラグインのプレリリースが提供されます。プレリリースをインストールするには、次のコマンドを実行します。

毎週の Salesforcedx プラグインリリースの早期リリース候補版をインストールするには、次のコマンドを実行します。

@pre-releaselatest-rc などのタグを使用してプラグインバージョンをインストールすると、プラグインをアンインストールするまでそのタグが使用されます。このリリースタグへの関連付けを停止して、CLI にバンドルされている salesforcedx コアプラグインを使用するには、次のコマンドを実行します。

重要

Salesforce プラグインの確認

Salesforce CLI と salesforcedx コアプラグインをインストールしたら、特定の Salesforce 機能とともに動作するその他のプラグインを確認します。
ISV テクニカルイネーブルメントプラグイン
この ISVTE プラグインは、オンデマンドのテクニカルエバンジェリストです。パッケージのメタデータとコードをスキャンし、的を絞ってフィードバックを提供するため、アプリケーションを改善したり、時代遅れにならないようにしたりするのに役立ちます。このフィードバックには、詳細なメタデータの在庫、使用を検討する機能や技術に関する推奨事項、イネーブルメントリソース、インストールの制限が含まれています。また、ベストプラクティス、パートナーアラート、パートナー Trailblazer スコアの改善に関するガイダンスなども含まれています。ISV および OEM パートナー向けに設計されていますが、プラットフォーム上で開発しているユーザであれば、誰でも使用できます。

このプラグインをインストールするときは、プラグインが未署名であることを確認するように求められます。[はい] と回答してください。この動作が想定されています。

ドキュメントと詳細な情報については、GitHub を参照してください。

Einstein Analytics プラグイン
Salesforce Einstein Analytics は、複数ソースからのデータの接続、そのデータの対話ビューの作成、アプリケーションでのそれらのビューの共有を行うためのクラウドベースのプラットフォームです。

Analytics Studio で Einstein Analytics CLI プラグインを使用してスクラッチ組織を作成します。この組織を使用して、ソースコードの開発とテストができます。このプラグインには、Salesforce Analytics REST API エンドポイントのサブセットをコールして、Analytics アセットをプログラムで管理するためのコマンドが含まれています。Analytics テンプレートを作成して、反復的に開発します。アプリケーション、ダッシュボード、レンズ、データフローを更新および削除します。history コマンドを使用して、以前のバージョンのダッシュボードとデータフローを復元します。組み込みテンプレートアプリケーションの自動インストールのライフサイクルを管理します。

「Salesforce CLI の Analytics プラグインを使用した開発」を参照してください。

信頼できる未署名のプラグインの自動インストール

sfdx plugins:install コマンドでプラグインをインストールする場合、Salesforce CLI は、最初にそのデジタル署名を検証します。プラグインの署名が有効である場合、CLI はプラグインをインストールします。署名が有効でない場合、Salesforce CLI は、ユーザが警告メッセージに応答し、リスクについて理解したことを確認するまで、プラグインをインストールしません。この手順は、プラグインをコマンドラインで対話形式でインストールする場合に適していますが、CI/CD バッチジョブの完了を妨げる場合があります。未署名のときでもプラグインを確認なしで自動的にインストールするには、ローカルファイルシステム上に許可リストを作成して、信頼するプラグインを追加します。

プラグインをインストールして、そのいずれかのコマンドをターミナルで実行した後、コマンドは、ユーザ権限で実行されます。その結果、コマンドは、暗号化データを読み取ったり、ユーザが認証した任意の Salesforce 組織と通信したり、ホームディレクトリ内のファイルを削除したりできます。未署名および未検証のプラグインは、信頼できるものだけをインストールしてください。

警告

  1. unsignedPluginAllowList.json という名前のファイルを作成して、次のいずれかのディレクトリに格納します。
    • (Linux および macOS): $HOME/.config/sfdx
    • (Windows) Windows の設定に応じて、C:\Users\username\.config\sfdx または %LOCALAPPDATA%\sfdx のいずれか
  2. 信頼するプラグインの名前を単純な文字列の配列として JSON ファイルに追加します。次に例を示します。