Salesforce DX 設定ガイド

Salesforce DX 設定ガイド

バージョン 41.0, Winter ’18

@salesforcedocs

本書の英語版と翻訳版で相違がある場合は英語版を優先するものとします。 ©

目次

Windows 10 Subsystem for Linux での CLI のインストール. . . 9

npm を使用した CLI のインストール. . . 11 インストールの確認 . . . 11 第 7 章: 会社のファイアウォールまたは Web プロキシの背後からの Salesforce CLI の使用. . . 12 第 8 章: CLI バイナリおよびプラグインの更新. . . 13 第 9 章: CLI バイナリまたはプラグインのアンインストール. . . 14 第 10 章: GitHub のサンプルソース. . . 15 第 11 章: 次のステップ. . . 16

第 1 章

ご利用になる前に

最初に Salesforce DX を試す場合は、Dev Hub が有効になっているトライアル組織に サインアップできます。

2. 組織で第二世代パッケージ (2GP) を有効にして、2GP パッケージを開発できるよう にします。

3. チームを含める場合は、Dev Hub 組織にユーザを追加できます。

4. コンピュータがすべてのシステム要件を満たしていることを確認します。 5. Force.com IDE 2 (ベータ) または Visual Studio Code 向け Salesforce 開発ツールを評価する

場合は、ダウンロードしてインストールします。 6. GitHub から Salesforce DX サンプルをダウンロードします。 関連トピック:

Salesforce DX トライアル組織 Force.com IDE 2 開発者ガイド (ベータ)

Visual Studio Code Extension Pack for Salesforce DX (Visual Studio | Marketplace)

第 2 章

システム要件

オペレーティングシステム

macOS の要件: 開発者ツールセット

Can’t install the software because it is not currently available from the Software Update server

xcode-select: error: command line tools are already installed, use "Software Update" to

install updates

メモ: macOS の新しいバージョンに更新する場合、このコマンドを再度実行し ます。

Windows の要件: PowerShell

Salesforce DX をインストールする各 Windows コンピュータに PowerShell (バージョン 5.1 以降) をインストールします。

コードエディタまたは IDE

Salesforce DX 用に構築され再設計された Force.com IDE など、任意のコードエディタを Salesforce DX で使用できます。

バージョン管理システム

第 3 章

組織での Dev Hub の有効化

2. [設定] から、[クイック検索] ボックスに「Dev Hub」と入力し、[Dev Hub] を選択 します。 3. Dev Hub を有効にするには、[有効化] をクリックします。 Dev Hub は一度有効化すると、無効化できません。トライアル組織を使用してい る場合、Dev Hub はすでに有効になっています。 関連トピック: Salesforce DX トライアル組織 Salesforce DX ユーザの追加

第 4 章

第二世代パッケージの有効化 (ベータ)

2. [設定] から、[クイック検索] ボックスに「Dev Hub」と入力し、[Dev Hub] を選択 します。 3. [第二世代パッケージ] のセクションで、[非正式リリースのサービス契約に同意す るものとします。] をクリックしてサービス契約を読みます。 4. 第二世代パッケージを有効にするには、[有効化] をクリックします。 第二世代パッケージは一度有効化すると、無効化できません。 5

第 5 章

Salesforce DX ユーザの追加

システム管理者は、デフォルトで Dev Hub にアクセスできます。他のユーザも Dev Hub にアクセスしてスクラッチ組織を作成できるようにすることができます。 Salesforce DX は、Salesforce、Salesforce Platform、および Salesforce Limited Access - Free (パー トナーのみ) の標準ユーザライセンスで使用できます。 システム管理者プロファイルでユーザを追加できます。Salesforce DX に必要な権限 セットを適用している場合、標準ユーザプロファイルでもユーザを追加できます。 Dev Hub 組織に追加するユーザは、システム管理者の権限レベルが必要な場合以外は システム管理者として追加しないでください。 1. 必要に応じて、ユーザを Dev Hub 組織に追加します。 a. [設定] から、[クイック検索] ボックスに「ユーザ」と入力し、[ユーザ] を選択 します。 b. [新規ユーザ] をクリックします。 c. フォームに入力し、システム管理者または標準ユーザプロファイルを割り当 てます。 d. [保存] をクリックします システム管理者ユーザを追加する場合は、これで終了です。 2. 標準ユーザを追加する場合は、Salesforce DX ユーザの権限セットを作成します (存 在しない場合)。 a. [設定] から、[クイック検索] ボックスに「権限セット」と入力し、[権限セット] を選択します。 b. [新規] をクリックします。

c. 表示ラベル、API 名、説明を入力します。API 名は Force.com API および管理パッ ケージで使用される一意の名前です。 d. ユーザライセンスオプションを選択します。この権限セットを異なるライセ ンスを持つ複数のユーザに割り当てる場合は、[なし] を選択します。 e. [保存] をクリックします権限セット概要ページが表示されます。このページ から、Salesforce DX に追加または変更する権限に移動できます。必要な権限に ついては、「Salesforce DX ユーザの権限セット」 (ページ 7)を参照してくださ い。 3. 標準ユーザに Salesforce DX 権限セットを適用します。

a. [設定] から、[クイック検索] ボックスに「権限セット」と入力し、[権限セット] を選択します。 b. Salesforce DX 権限セットを選択します。 c. [権限セット] ツールバーで、[割り当ての管理] をクリックします。 d. [割り当てを追加] をクリックします。 e. 権限セットを割り当てるユーザを選択します。 f. [割り当て] をクリックします。 g. [完了] をクリックします。 Salesforce DX ユーザの権限セット Dev Hub へのフルアクセス権を付与するには、権限セットに次の権限を含める必要が あります。 • [オブジェクト設定] -> [スクラッチ組織情報] -> [参照]、[作成]、[削除] • [オブジェクト設定] -> [有効なスクラッチ組織] -> [参照]、[削除] • [オブジェクト設定] -> [名前空間レジストリ] -> [参照]、[作成]、[削除] ユーザのアクセスを制限するには、権限を変更します。 関連トピック: 権限セット (Salesforce ヘルプ) Salesforce DX 開発者ガイド 7 Salesforce DX ユーザの追加

第 6 章

Salesforce CLI のインストール

macOS での CLI のインストール

macOS では、.pkgファイルを使用して Salesforce CLI をインストールします。

1. .pkgファイルをダウンロードします。

2. .pkgファイルをダブルクリックします。

関連トピック:

インストールの確認

Windows での CLI のインストール

Windows では、.exeファイルを使用して Salesforce CLI をインストールします。

1. Windows インストーラをダウンロードして実行します。インストーラが Git を検出できない場合、Git もイン ストールされます。

2. PATH 環境変数に Git バイナリの場所が含まれていることを確認します。たとえば、次のように指定します。 set PATH=%PATH%;C:\Program Files\Git\bin

警告: Salesforce CLI は、ネイティブ Windows コマンドプロンプト (cmd.exe) および Microsoft Powershell 内で最

適に動作します。cygwin や MinGW などの Linux ターミナルエミュレータはバグのサポートが制限されてい るため、これらのエミュレータで Salesforce CLI を使用することはお勧めしません。

関連トピック:

インストールの確認

Windows 10 Subsystem for Linux での CLI のインストール

Windows Subsystem for Linux (WSL) では、Windows 10 で従来の Windows デスクトップと共にネイティブ Linux コマン ドラインツールを実行できます。

1. [ファイル名を指定して実行] ダイアログボックス (Windows キー + R) から、optionalfeatures.exeを実行

します。

2. [Windows の機能] で、[Windows Subsystem for Linux] を選択します。

9

macOS での CLI のインストール Salesforce CLI のインストール

3. コマンドプロンプトから、bashと入力して Ubuntu のインストールを起動します。プロンプトで、yと入 力してコンポーネントをインストールすることに同意します。 > bash 4. Ubuntu のインストールが完了したら、/mnt/c/ProgramFilesLinuxディレクトリを作成します。 $ mkdir /mnt/c/ProgramFilesLinux 5. その新しいディレクトリに移動します。 $ cd /mnt/c/ProgramFilesLinux

6. 最新の Linux (amd64) tarball のダウンロード URL を使用して wget を実行します。適切な URL については、この マニフェストファイルを参照してください。 $ wget https://developer.salesforce.com/media/salesforce-cli/sfdx-v5.7.6-d42cf65-linux-amd64.tar.xz 7. コンテンツを解凍します。 $ tar xvf sfdx-v5.7.6-d42cf65-linux-amd64.tar.xz 8. sfdxディレクトリに移動します。 $ cd sfdx 9. インストールスクリプトを実行します。 $ ./install 10. Git をインストールします。 $ sudo apt-get install git

メモ: Salesforce CLI を正常に機能させるには、Git をインストールする必要があります。

Windows 10 Subsystem for Linux での CLI のインストール Salesforce CLI のインストール

npm

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

コンピュータにNode.jsをインストールしている場合、npmを使用して Salesforce CLI をインストールできま

す。

1. コンピュータに Node v8.4.0 以降がインストールされていることを確認します。たとえば、macOS または Linux で次のコマンドを実行します。

$ node --version v8.4.0

2. 次のコマンドを実行します。

$ npm install --global sfdx-cli

関連トピック:

インストールの確認

npm ドキュメント

インストールの確認

sfdx updateコマンドを実行して Salesforce CLI のインストールを確認します。

$ sfdx update

sfdx-cli: Updating CLI from 6.0.0-0743bea5 to 6.0.0-aebbfd66 (alpha)... done sfdx-cli: Updating CLI... already on latest version: 6.0.0-aebbfd66

sfdx-cli: Updating plugins... done

次のコマンドを実行して、コアプラグインバージョンを確認します。 $ sfdx plugins --core salesforcedx 41.2.0 (core) 次のコマンドを実行すると、forceトピックのコマンドファミリのリストが返されます。 sfdx force --help 次のコマンドでは、すべてのforceコマンドが返されます。 sfdx force:doc:commands:list 11 npm を使用した CLI のインストール Salesforce CLI のインストール

第 7 章

会社のファイアウォールまたは Web プロキシの

背後からの Salesforce CLI の使用

コンピュータでのエラーですが、Linux および macOS ユーザにも同様のエラーが表示 される場合があります。

Installing required plugins for force... ! Error installing package.

! npm ERR! Windows_NT 6.1.7601

! npm ERR! argv "C:\\Program Files\\SFDX\\lib\\node.exe" "C:\\Program Files\\SFDX\\lib\\npm\\cli.js" "install" "salesforcedx"

! npm ERR! node v6.9.5 ! npm ERR! npm v3.10.10

! npm ERR! error:0906D06C:PEM routines:PEM_read_bio:no start line ! npm ERR!

! npm ERR! If you need help, you may report this error at: ! npm ERR! <https://github.com/npm/npm/issues>

!

! npm ERR! Please include the following file with any support request: ! npm ERR! C:\Users\Admin\AppData\Local\sfdx\plugins\npm-debug.log この問題に対処するには、ターミナルまたは Windows コマンドプロンプトから、次 のコマンドのusername:pwdを Web プロキシのユーザ名とパスワードに置き換え て実行します。プロキシでこれらの値が不要な場合は省略します。また、

proxy.company.com:8080も会社のプロキシの URL とポートに置き換えます。 npm config set https-proxy https://username:pwd@proxy.company.com:8080 npm config set proxy https://username:pwd@proxy.company.com:8080 npm config set sslVerify false

npm config set strict-ssl false

次に、HTTP_PROXY 環境変数をプロキシの完全な URL に設定します。たとえば、UNIX で次のコマンドを実行します。

第 8 章

CLI バイナリおよびプラグインの更新

CLI は、CLI バイナリと Salesforce DX プラグインで構成されます。CLI バイナリと Salesforce DX プラグインの両方が更新される場合と、プラグインのみが更新される場合があり ます。 CLI バイナリと Salesforce DX プラグインを明示的に更新するには、次のコマンドを実 行します。 sfdx update デフォルトでは、CLI が定期的に更新を確認してインストールします。自動更新を無 効にするには、SFDX_AUTOUPDATE_DISABLE環境変数をtrueに設定します。 export SFDX_AUTOUPDATE_DISABLE=true 13

第 9 章

CLI バイナリまたはプラグインのアンインストー

ル

macOS または Linux

sudo rm -rf ~/.local/share/sfdx ~/.config/sfdx ~/.cache/sfdx sudo rm -rf ~/Library/Caches/sfdx

Windows

CLI がまだインストールされている場合は、Program Files の%LOCALAPPDATA%\sfdx

ディレクトリを削除します。

salesforcedx

プラグインのアンインストール

ターミナルまたは Windows コマンドプロンプトから次のコマンドを入力します。 sfdx plugins:uninstall salesforcedx

第 10 章

GitHub のサンプルソース

Salesforce DX を探索しながら、GitHub で Salesforce が提供するいくつかのサンプルリポ ジトリを確認することで、概念を理解するのに役立ちます。

• sfdx-simple — 2 つの Visualforce ページ、コントローラ、Apex テストが含まれる

サンプル。

• dreamhouse-sfdx — 複数の Apex クラス、設定項目、Lightning コンポーネント、 Visualforce コンポーネント、カスタムオブジェクトが含まれる、より複雑なサンプ ル。dreamhouse-sfdxサンプルはスタンドアロンアプリケーションです。

• sfdx-travisci — Salesforce DX を Travis CI と併用する方法を示す、継続的インテ

グレーション (CI) サンプル。Travis CI は、GitHub でホストされるソフトウェアプロ ジェクトを構築およびテストするために使用する、クラウドベースの継続的イン テグレーション (CI) サービスです。 関連トピック: sfdx-simple GitHub サンプル dreamhouse-sfdx GitHub サンプル sfdx-travisci GitHub サンプル 15

第 11 章

次のステップ

CLI コマンドの完全なリストとその使用方法については、『Salesforce CLI コマンドリ ファレンス』を参照してください。

関連トピック:

dreamhouse-sfdx GitHub サンプル Readme Salesforce CLI コマンドリファレンス Salesforce DX 開発者ガイド