Salesforce DX 開発者ガイド
jスクラッチ組織の作成
スクラッチ組織を作成する前に、次の操作を実行します。
- Salesforce DX プロジェクトを設定する
- Dev Hub 組織を認証する
- スクラッチ組織定義ファイルを作成する (独自に作成するか、組織シェイプを使用する)
機能開発用、名前空間が含まれるパッケージの開発用、ユーザー受け入れテスト用など、さまざまな機能用のスクラッチ組織を作成できます。
現在のディレクトリに対するスクラッチ定義ファイルへの相対パスを示します。サンプルリポジトリと新しいプロジェクトの場合、このファイルは config ディレクトリにあります。
スクラッチ組織を作成する方法
org create scratch を実行するときにコマンドラインで対応するフラグを指定することで、ユーザー定義ファイル内の多くのオプションを上書きできます。この方法により、複数のユーザーまたは継続的インテグレーションジョブで基本定義ファイルを共有し、コマンドの実行時にオプションをカスタマイズできます。次の例は、adminEmail と edition オプションを上書きします。
スクラッチ組織を作成する際に、必須フラグの --edition を指定している限り、定義ファイルを指定する必要はありません。
この例は、ID を指定して組織シェイプからスクラッチ組織を作成します。
ユーザー受け入れテスト用またはパッケージのインストールのテスト用にスクラッチ組織を作成します。この場合、名前空間を持つスクラッチを作成する必要はありません。次のコマンドを使用して、スクラッチ組織定義ファイルの名前空間値を上書きできます。またこの例では、スクラッチ組織の期間、つまりスクラッチ組織の有効期限がいつ切れるかを指定します (1 ～ 30 日)。デフォルトの期間は 7 日です。
スクラッチ組織の Salesforce リリースを指定する。Salesforce リリースの移行中、スクラッチ組織を作成するときにリリース (プレビューまたは以前) を指定できます。詳細は、「スクラッチ組織の Salesforce リリースの選択」を参照してください。
--async フラグを指定することで、スクラッチ組織を要求すしますが、完了するまで待機しません。
このコマンドは、org resume scratch コマンドに渡すジョブ ID を表示します。このコマンドは、タイムアウトになったスクラッチ組織の作成を再開する場合にも使用します。
ソース追跡を無効にして、スクラッチ組織を作成します。
スクラッチ組織を正常に作成した場合
org create scratch コマンドは、実行時に、リクエストの送信や組織設定のリリースなどのバックグラウンドプロセスに関する実行情報を表示します。コマンドが完了すると、2 つの重要な情報 (組織 ID とユーザー名) が表示されます。
--alias フラグを使用して別名を設定した場合は、その値を --target-org に使用することができます。
トラブルシューティングのヒント
create コマンドがエラーになった場合には、スクラッチ組織が作成されたかどうか明確ではない場合があります。Dev Hub 組織で次のコマンドを実行し、スクラッチ組織の ID が返されるかどうかを確認します。この方法によって、今日作成したスクラッチ組織が存在するかどうかと、自分が所有しているかどうかを確認できます。
次の情報を参考にして、作成が実際に機能したかどうかを判断します。たとえば次の場合、ユーザー名が Jane Doe で、別名が DevHub の Dev Hub 組織が作成されています。