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

Salesforce CLI 設定ガイド

ご利用になる前に
Salesforce CLI およびプラグインのインストール
macOS での CLI のインストール
Windows での CLI のインストール
Linux での CLI のインストール
npm を使用した CLI のインストール
インストールの確認
特定バージョンの salesforcedx プラグインのインストール
信頼できる未署名のプラグインの自動インストール
Salesforce プラグインの確認
Salesforce CLI の設定とヒント
CLI の更新
CLI バイナリまたはプラグインのアンインストール
Salesforce CLI のトラブルシューティング
CLI 非推奨ポリシー
次のステップ
PDF

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 を実行します。 
    1wget https://developer.salesforce.com/media/salesforce-cli/sfdx-cli/channels/stable/sfdx-cli-linux-x64.tar.xz
  2. sfdx ディレクトリを作成します。 
    1mkdir sfdx
  3. tarball バージョンのコンテンツを展開します。 
    1tar xJf sfdx-cli-linux-x64.tar.xz -C sfdx --strip-components 1

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

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

    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/ にアクセスします。使用しているバージョン番号を確認するには、次のコマンドを実行します。 
    1node --version
  2. 次のコマンドを実行します。 
    1npm install sfdx-cli --global

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

インストールの確認

Salesforce CLI のインストールおよびプラグインバージョンを確認します。
次のコマンドを実行して、Salesforce CLI バージョンを確認します。
1$ sfdx --version
2sfdx-cli/7.76.1-f301d5641f darwin-x64 node-v12.18.3

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

1$ sfdx plugins --core
2@oclif/plugin-autocomplete 0.1.5 (core)
3@oclif/plugin-commands 1.3.0 (core)
4@oclif/plugin-help 3.2.0 (core)
5@oclif/plugin-not-found 1.2.4 (core)
6@oclif/plugin-plugins 1.9.1 (core)
7@oclif/plugin-update 1.3.10 (core)
8@oclif/plugin-warn-if-update-available 1.7.0 (core)
9@oclif/plugin-which 1.0.3 (core)
10@salesforce/sfdx-trust 3.4.3 (core)
11alias 1.1.2 (core)
12analytics 1.12.1 (core)
13config 1.1.9 (core)
14generator 1.1.3 (core)
15salesforcedx 50.1.1 (core)                        //salesforcedx plug-in version
16|- templates 50.1.0 (core)
17|- @salesforce/sfdx-plugin-lwc-test 0.1.7 (core)
18|- apex 0.1.1 (core)
19|- custom-metadata 1.0.10 (core)
20|- salesforce-alm 50.1.1 (core)
21sfdx-cli 7.76.1 (core)                            //CLI version

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

1$ sfdx plugins

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

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

1$ sfdx force --help

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

1$ sfdx commands

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

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

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

1$ sfdx plugins --core
2
3@oclif/plugin-autocomplete 0.1.5 (core)
4@oclif/plugin-commands 1.3.0 (core)
5@oclif/plugin-help 3.2.0 (core)
6@oclif/plugin-not-found 1.2.4 (core)
7@oclif/plugin-plugins 1.9.0 (core)
8@oclif/plugin-update 1.3.10 (core)
9@oclif/plugin-warn-if-update-available 1.7.0 (core)
10@oclif/plugin-which 1.0.3 (core)
11@salesforce/sfdx-trust 3.4.3 (core)
12alias 1.1.2 (core)
13analytics 1.12.1 (core)
14config 1.1.8 (core)
15generator 1.1.3 (core)
16salesforcedx 49.13.1 (core)                        // salesforcedx plug-in version
17|- custom-metadata 1.0.10 (core)
18|- @salesforce/sfdx-plugin-lwc-test 0.1.7 (core)
19|- templates 49.9.1 (core)
20|- apex 0.1.1 (core)
21|- salesforce-alm 49.12.2 (core)
22sfdx-cli 7.75.1 (core)                             // CLI version

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

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

1sfdx plugins:install salesforcedx@49.14.0

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

1sfdx plugins:install salesforcedx@pre-release

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

1sfdx plugins:install salesforcedx@latest-rc

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

1sfdx plugins:uninstall salesforcedx

重要

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

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 ファイルに追加します。次に例を示します。 
    1[
2    "sfdx-templates",
3    "salesforce-cmdt",
4    ...
5]