Salesforce CLI 設定ガイド
jSalesforce CLI のインストール
オペレーティングシステム固有のアーティファクト (macOS の .pkg など) や npm を使用して、コンピュータに CLI をインストールします。
コンピュータにインストールする方法を 1 つ選択します。たとえば、.pkg と npm の両方で macOs にインストールしないでください。
macOS での CLI のインストール
macOS では、.pkg ファイルを使用して Salesforce CLI をインストールします。
- .pkg ファイルをダウンロードします。
- .pkg ファイルを Finder からダブルクリックするなどして実行し、すべてのプロンプトに回答します。
- インストールが完了したら、ターミナルウィンドウまたは IDE を再起動して、Salesforce CLI 実行ファイルが使用可能であることを確認します。
Windows での CLI のインストール
Windows では、.exe ファイルを使用して Salesforce CLI をインストールします。
- .exe ファイルをダウンロードします。
- .exe ファイルを Windows Explorer からダブルクリックするなどして実行し、すべてのプロンプトに回答します。
- インストールが完了したら、コマンドプロンプト、PowerShell ウィンドウ、または IDE を再起動して、Salesforce CLI 実行ファイルが使用可能であることを確認します。
TAR ファイルを使用した CLI のインストール
Salesforce CLI では、サポートされているすべてのオペレーティングシステムにインストールできる TAR ファイルを配布しています。Linux の場合、TAR ファイルが Salesforce CLI をインストールする唯一の方法です。
下表に、オペレーティングシステム用の TAR ファイル (.tar.gz または .tar.xz) のバージョン設定されていない URL がリストされています。毎週 Salesforce CLI の新バージョンのリリース時に、この URL も最新バージョンを参照するように更新されます。CI の使用事例では特にバージョン設定されていない URL が役立ちます。同表には、各ファイルのバージョン設定されたマニフェスト URL も示されています。
| オペレーティングシステム | Tar ファイル | マニフェスト |
|---|---|---|
| Linux | ||
| macOS | ||
| Windows |
以下の例では、Salesforce CLI を Linux およびホームディレクトリの sfdx サブディレクトリにインストールすることを想定しています。
-
上記のいずれかの TAR ファイルをダウンロードするか、wget を実行します。
-
Salesforce CLI をインストールするディレクトリを作成します。
-
TAR ファイルの内容を展開します。
-C は ~/sfdx ディレクトリの内容を展開し、--strip-components 1 はルートパスのコンポーネントを削除します。
-
PATH 環境変数を更新して、Salesforce CLI の bin ディレクトリを含めます。たとえば、現在のターミナルセッションについては、次のとおり設定します。
PATH を永続的に更新するには、シェルの設定ファイルに適切なエントリを追加します。たとえば、Bash シェルを使用する場合、~/.bashrc または ~/.bash_profile ファイルに次の行を追加します。
npm を使用した CLI のインストール
コンピュータに Node.js をインストールしている場合、npm を使用して Salesforce CLI をインストールできます。この方法では、コマンドラインから Salesforce CLI をインストールできます。継続的インテグレーション (CI) の使用事例で特に役立ちます。
このインストール方法は、ワークステーションに対する管理者権限がない場合や、グループポリシーによって CLI のインストールと更新がブロックされる場合に適切なオプションです。npm を使用した CLI のインストールでは、ルート権限は必要ありません。
-
Node.js の長期サポート (Active LTS) バージョンがコンピュータにインストールされていることを確認します。LTS バージョンをインストールするには、https://nodejs.org/en/download/ にアクセス��ます。使用しているバージョン番号を確認するには、次のコマンドを実行します。
-
sfdx 実行ファイルをインストールするには、次のコマンドを実行します。
sf 実行ファイルをインストールするには、次のコマンドを実行します。npm を使用して CLI をインストールするときに権限エラーが発生する場合は、sudo を使用しないことをお勧めします。npm 権限の修正方法を参照してください。
Salesforce CLI の古いバージョンのインストール
最新バージョンまたはリリース候補の Salesforce CLI を常に使用することをお勧めします。ただし、古いバージョンの CLI が必要になる場合があることも理解しています。そのような場合のために、最近のバージョンのインストーラのダウンロード URL、およびサポートされる各オペレーティングシステムの TAR ファイルをリストした JSON ファイルが公開されています。
毎週、最新のリリースバージョンがリストに追加され、バージョンは 20 週間リストに残ります。TAR ファイルとインストーラファイル自体は少なくとも 40 週間保持されます。
| オペレーティングシステム | ファイルの種類 | 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 |