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

Salesforce CLI のインストール

オペレーティングシステム固有のアーティファクト (macOS の .pkg など)、TAR ファイル、または npm を使用して、コンピュータに Salesforce CLI をインストールします。

コンピュータにインストールする方法を 1 つ選択します。たとえば、.pkg ファイルと npm の両方で macOs にインストールしないでください。両方を使用してインストールすると、コンピュータ上のパスが混乱することがあり、場合によっては、明確なエラーが表示されず、診断が困難になります。

macOS での CLI のインストール

macOS では、.pkg ファイルを使用して Salesforce CLI をインストールします。
  1. .pkg ファイルをダウンロードします。
  2. .pkg ファイルを Finder からダブルクリックするなどして実行し、すべてのプロンプトに回答します。
  3. インストールが完了したら、ターミナルウィンドウまたは IDE を再起動して、Salesforce CLI が使用可能であることを確認します。

Windows での CLI のインストール

Windows では、.exe ファイルを使用して Salesforce CLI をインストールします。
  1. .exe ファイルをダウンロードします。
  2. .exe ファイルを Windows Explorer からダブルクリックするなどして実行し、すべてのプロンプトに回答します。
  3. インストールが完了したら、コマンドプロンプト、PowerShell ウィンドウ、または IDE を再起動して、Salesforce CLI が使用可能であることを確認します。

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

警告

TAR ファイルを使用した CLI のインストール

Salesforce CLI では、サポートされているすべてのオペレーティングシステムにインストールできる TAR ファイルを配布しています。

下表に、オペレーティングシステム用の TAR ファイル (.tar.gz または .tar.xz) のバージョン設定されていない URL がリストされています。毎週 Salesforce CLI の新バージョンのリリース時に、この URL も最新バージョンを参照するように更新されます。CI の使用事例では特にバージョン設定されていない URL が役立ちます。同表には、各ファイルのバージョン設定されたマニフェスト URL も示されています。

Salesforce CLI を Windows にインストールするときは、インストーラまたは npm を使用することを強くお勧めします。ただし、Windows の TAR ファイルを使用する場合、最初に 7Zip などの別のプログラムをインストールしてファイルの内容を抽出する必要があります。

重要

以下の例では、Salesforce CLI を Linux およびホームディレクトリの cli/sf サブディレクトリにインストールすることを想定しています。

  1. 上記のいずれかの TAR ファイルをダウンロードするか、wget を実行します。
    1wget https://developer.salesforce.com/media/salesforce-cli/sf/channels/stable/sf-linux-x64.tar.xz
  2. Salesforce CLI をインストールするディレクトリを作成します。
    1mkdir ~/cli/sf
  3. TAR ファイルの内容を展開します。
    1tar xJf sf-linux-x64.tar.xz -C ~/cli/sf --strip-components 1

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

    この例は、Linux の tar コマンドで考えられるフラグセットの 1 つのみを示しています。オペレーティングシステムの他のオプションについては、tar ドキュメントを参照してください。

    メモ

  4. PATH 環境変数を更新して、Salesforce CLI の bin ディレクトリを含めます。たとえば、現在のターミナルセッションについては、次のとおり設定します。
    1export PATH=~/cli/sf/bin:$PATH

    PATH を永続的に更新するには、シェルの設定ファイルに適切なエントリを追加します。たとえば、Bash シェルを使用する場合、~/.bashrc または ~/.bash_profile ファイルに次の行を追加します。

    1PATH=~/cli/sf/bin:$PATH

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

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

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

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

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

CLI リリース候補版またはナイトリービルドのインストール

毎週 CLI の新しいバージョンがリリースされています。同時に、次週のリリースで導入予定の変更を含む CLI のリリース候補も公開されます。リリース候補は Salesforce Sandbox プレビューの CLI バージョンと考えることができます。次回の機能を確認したい場合、リリース候補版をインストールできます。最新の正式リリースのままでも構いませんし、両版を切り替えることもでき、好きなところから使用を開始できます。

また、ナイトリービルドが毎日リリースされています。ナイトリービルドには、すべてのライブラリとプラグインの最新バージョンが含まれています。1 日前にマージされた修正をすぐに試したい場合は、ナイトリービルドをインストールしてみてください。リリース候補と同様に、ナイトリービルドは、安定版リリースに至る前に問題を検出できるため、Salesforce CLI の安定性の向上に利用されます。 

最新の (安定版) リリースが最も信頼性が高いですが、リリース候補版やナイトリービルドもテストして GitHub の Issues (問題) リポジトリに問題を報告していただくことをお願いしております。継続的インテグレーション (CI) ジョブを最新リリースとリリース候補版の両方で実行し、破壊的変更が生じる前にその可能性を特定することをお勧めします。

次のコマンドを実行すると、インストール済みの Salesforce CLI のバージョンが表示されます。バージョンにはリリース候補版かナイトリービルドかが示されていないため、リリースノートで現在のバージョン番号を確認してください。

1sf version

インストーラを使用したインストール

インストーラでは、現在のリリースには stable、リリース候補版には stable-rc、ナイトリービルドには nightly というタグを使用します。

Salesforce CLI をインストール済みで、最新リリースを使用している場合、次のコマンドを実行すると、リリース候補版に切り替わります。

1sf update stable-rc

同様に、ナイトリービルドをインストールするには次のコマンドを実行します。

1sf update nightly

リリース候補版またはナイトリービルドをアンインストールして、最新バージョンに戻すには、次のコマンドを実行します。

1sf update stable

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

npm インストーラでは、現在のリリースには latest、リリース候補版には latest-rc、ナイトリービルドには nightly というタグを使用します。

npm を使用してリリース候補版をインストールする場合は、次のコマンドを実行します。

1npm install --global @salesforce/cli@latest-rc

同様に、ナイトリービルドをインストールするには次のコマンドを実行します。

1npm install --global @salesforce/cli@nightly

リリース候補版またはナイトリービルドをアンインストールして、最新バージョンに戻すには、次のコマンドを実行します。

1npm install --global @salesforce/cli@latest

次のコマンドを実行すると、現在 npm タグに関連付けられている Salesforce CLI のバージョンが表示されます。

1npm view @salesforce/cli dist-tags --json

TAR ファイルからのインストール

Salesforce CLI では、サポートされているすべてのオペレーティングシステムにインストールできる、リリース候補版およびナイトリービルドの TAR ファイルが配布されています。ダウンロード URL は最新リリースをインストールする場合の URL に似ていますが、stable チャネルではなく、stable-rc または nightly チャネルを使用します。

たとえば、リリース候補版の Linux TAR ファイルの wget を実行する場合、次のコマンドを実行して、stable-rc チャネルからダウンロードします。

1wget https://developer.salesforce.com/media/salesforce-cli/sf/channels/stable-rc/sf-linux-x64.tar.xz

次のコマンドはナイトリービルドをダウンロードします。

1wget https://developer.salesforce.com/media/salesforce-cli/sf/channels/nightly/sf-linux-x64.tar.xz

使用するチャネルが異なる点を除けば、TAR ファイルからリリース候補版またはナイトリービルドをインストールする手順も、最新リリースをインストールする手順と同じです。

Salesforce CLI の古いバージョンのインストール

最新バージョンまたはリリース候補の Salesforce CLI を常に使用することをお勧めします。ただし、古いバージョンの CLI が必要になることも理解しています。

インストーラ

インストーラを使用して Salesforce CLI をインストールした場合は、--version フラグを使用して古いバージョンに更新してください。たとえば、バージョン 2.0.1 に更新するには、次のコマンドを実行します。

1sf update --version 2.0.1

--available フラグによって、更新が可能なすべての旧バージョンを一覧表示できます。また、すでにローカルにコピーがあるかどうかや、ダウンロードが必要かどうかも表示されます。

1sf update --available

--interactive を使用することで、バージョンをインタラクティブに選択できます。

このコマンドを使用することで、現在のバージョンに戻ることができます。

1sf update stable

npm

npm を使用して Salesforce CLI を古いバージョンで更新するには、@salesforce/cli パッケージ名の後に @<version> でバージョンを指定します。たとえば、バージョン 2.0.1 に更新するには、次のコマンドを実行します。

1npm install @salesforce/cli@2.0.1 --global

このコマンドを使用することで、現在のバージョンに戻ることができます。

1npm install @salesforce/cli --global

全バージョンのリストについては、Salesforce CLI の npmjs.com のページを参照してください。Salesforce では、@salesforce/cli お��び sfdx-cli (廃止) npm パッケージのすべての古いバージョンを保管しています。

TAR ファイル

Salesforce は、最近のバージョンのインストーラのダウンロード URL、およびサポートされる各オペレーティングシステムの TAR ファイルをリストした JSON ファイルを公開しています。このリストには、新しいバージョンが継続的に追加されており、追加されたバージョンは 20 週間リストに残されます。TAR ファイルとインストーラファイル自体は少なくとも 40 週間保持されます。

sf (v2)

オペレーティングシステム ファイルの種類 TAR 圧縮の種類 JSON ファイルへのリンク
Linux ARM TAR gz sf-linux-arm-tar-gz.json
Linux ARM TAR xz sf-linux-arm-tar-xz.json
Linux 64 TAR gz sf-linux-x64-tar-gz.json
Linux 64 TAR xz sf-linux-x64-tar-xz.json
Windows 64 TAR gz sf-win32-x64-tar-gz.json
Windows 64 TAR xz sf-win32-x64-tar-xz.json
Windows x86 TAR gz sf-win32-x86-tar-gz.json
Windows x86 TAR xz sf-win32-x86-tar-xz.json
macOS (Intel CPU) TAR gz sf-darwin-x64-tar-gz.json
macOS (Intel CPU) TAR xz sf-darwin-x64-tar-xz.json
macOS (Apple シリコン) TAR gz sf-darwin-arm64-tar-gz.json
macOS (Apple シリコン) TAR xz sf-darwin-arm64-tar-xz.json
Windows 64 インストーラ sf-x64-exe.json
Windows x86 インストーラ sf-x86-exe.json
macOS (Intel CPU) インストーラ sf-x64-pkg.json
macOS (Apple シリコン) インストーラ sf-arm64-pkg.json

sfdx (v7) - 廃止

2023 年 7 月 12 日をもって、sfdx (v7) の更新は終了しました。こ��ような古いバージョンは、履歴管理の目的のためだけに保管されています。

メモ

オペレーティングシステム ファイルの種類 TAR 圧縮の種類 JSON ファイルへのリンク
Linux ARM TAR gz sfdx-linux-arm-tar-gz.json
Linux ARM TAR xz sfdx-linux-arm-tar-xz.json
Linux 64 TAR gz sfdx-linux-x64-tar-gz.json
Linux 64 TAR xz sfdx-linux-x64-tar-xz.json
Windows 64 TAR gz sfdx-win32-x64-tar-gz.json
Windows 64 TAR xz sfdx-win32-x64-tar-xz.json
Windows x86 TAR gz sfdx-win32-x86-tar-gz.json
Windows x86 TAR xz sfdx-win32-x86-tar-xz.json
macOS (Intel CPU) TAR gz sfdx-darwin-x64-tar-gz.json
macOS (Intel CPU) TAR xz sfdx-darwin-x64-tar-xz.json
macOS (Apple シリコン) TAR gz sfdx-darwin-arm64-tar-gz.json
macOS (Apple シリコン) TAR xz sfdx-darwin-arm64-tar-xz.json
Windows 64 インストーラ sfdx-x64-exe.json
Windows x86 インストーラ sfdx-x86-exe.json
macOS (Intel CPU) インストーラ sfdx-x64-pkg.json
macOS (Apple シリコン) インストーラ sfdx-arm64-pkg.json

インストールの確認とバージョン情報の取得

Salesforce CLI のインストールが正しく行われていることを確認します。
次のコマンドを実行して、Salesforce CLI バージョンを確認します。
1sf --version
2@salesforce/cli/2.1.0 darwin-arm64 node-v16.17.0

次のコマンドを実行すると、インストール済みのコアプラグインとそのバージョンが表示されます。

1sf plugins --core
2@oclif/plugin-autocomplete 2.2.0 (core)
3@oclif/plugin-commands 2.2.15 (core)
4@oclif/plugin-help 5.2.9 (core)
5@oclif/plugin-not-found 2.3.24 (core)
6@oclif/plugin-plugins 3.1.2 (core)
7@oclif/plugin-search 0.0.17 (core)
8@oclif/plugin-update 3.1.16 (core)
9@oclif/plugin-version 1.3.4 (core)
10@oclif/plugin-warn-if-update-available 2.0.37 (core)
11@oclif/plugin-which 2.2.21 (core)
12@salesforce/cli 2.0.0 (core)
13apex 2.2.22 (core)
14auth 2.7.17 (core)
15data 2.3.20 (core)
16deploy-retrieve 1.10.4 (core)
17info 2.6.16 (core)
18limits 2.3.17 (core)
19login 1.2.11 (core)
20org 2.9.2 (core)
21schema 2.3.10 (core)
22settings 1.4.10 (core)
23sobject 0.1.22 (core)
24source 2.10.10 (core)
25telemetry 2.2.0 (core)
26templates 55.4.18 (core)
27trust 2.4.20 (core)
28user 2.3.14 (core)

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

1sf commands

コマンドのリストには別名に置き換えられたコマンドも含まれています。たとえば、apex run の別名である sfdx 形式のコマンド force:apex:execute などです。

次のコマンドを実行すると、現在コンピュータにインストールされている Salesforce CLI のバージョンのリリースノートが表示されます。

1sf whatsnew