第三回の今回は、CircleCI を DevHub に接続から最後のCircleci での自動ビルドまでの設定して、動かしてみましょう。

前回の記事はこちら

参考

CircleCIを使った継続的インテグレーション（Continuous Integration）第2回

第一回では、GuthubのセットアップからCircleCIのセットアップ、そして…

続きを読む

CircleCI を DevHub に接続

CircleCI を認証して接続アプリケーション経由でコンテンツを Dev Hub に転送できるようにします。

手順①コマンドプロンプトを起動し、server.key ファイルがあるフォルダから JWT ベース認証を実行できることを確認します。

以下のコマンドを実行

</p>
<p>>sfdx auth:jwt:grant –clientid <your_consumer_key> –jwtkeyfile server.key –username <your_username> –setdefaultdevhubusername</p>
<p>

【実行例】

</p>
<p>>sfdx auth:jwt:grant –clientid 3MVG95mg0lk4batiP7Q5f8gZVROjIpEdZT… –jwtkeyfile server.key –username cclt.sfdc@mail.com –setdefaultdevhubusername</p>
<p>

以下のようなメッセージが表示されれば認証成功です。

Successfully authorized<ユーザ名> with org ID 00D5h000004bs…

ローカルにsfdx-circleci リポジトリをフォーク

手順①ブラウザで以下のURLへアクセスしsfdx-circleci のリポジトリを表示します。

手順②GitHubを開いたら画面右上の【Fork（フォーク）】リンクをクリックします。

手順③GitHubのログイン画面が表示される場合は、IDとパスワードを入力してログインします。

手順④Create forkを実行して、sfdx-circleciリポジトリをコピーします。

手順⑤フォークが完了すると自分のGitHubに以下の内容が表示されます。

手順⑥次にCircleCIにログインして、プロジェクトメニューを表示します。

すると先ほどフォークしたsfdx-circleciのリポジトリが表示されているので、リポジトリ名のリンクをクリックします。

手順⑦config.ymlファイル選択画面が表示されます。sfdx-circleciに用意されているconfig.ymlをそのまま利用してSet up Projectを実行します。

手順⑧新規プロジェクトが作成されPipelineが実行されます。

手順⑨初回（環境設定を行っていない状態）では、実行結果がFailedとなります。

ビルドにエラーの原因が表示されます。※環境設定などを実施しない限り必ずエラーとなります。

手順⑩続いて環境設定を行います。実行結果の右側に表示されている・・・ボタンをクリックして、プロジェクト設定（Project Settings）メニューを表示します。

手順⑪プロジェクト設定画面で環境変数の設定（Environment Variables）メニューを実行します。

手順⑫以下の環境変数設定画面で、Add Environment Variableをクリックします。

手順⑬環境変数の登録画面で、以下4つのパラメータを指定します。

【登録する環境変数と値】

1. [HUB_CONSUMER_KEY]：作成したSFDCの接続アプリケーション画面で生成されたコンシューマ鍵を指定します。
2. [HUB_SFDC_USER]：組織に接続するユーザ名を指定します。
3. [DECRYPTION_KEY]：server.keyファイルの暗号化の際に生成したkeyを指定します。
4. [DECRYPTION_IV]：server.keyファイルの暗号化の際に生成したivを指定します。

※2番目のパラメータについて、Salesforceの説明サイトでは、HUB_SFDX_USERとなっていますが、sfdx-circleciから取得したconfig.ymlを確認すると正しくは、$HUB_SFDC_UESRとなっているので、間違えないように注意してください。

手順⑭続いて、server.key.encファイルを更新します。

コマンドプロンプトを起動して以下のコマンドを実行します。sfdx-circleciリポジトリをローカル環境へクローンします。

</p>
<p>> cd C:\Users\e\dev\jdoe\JWT   ※JWTフォルダへ移動（※Git専用のフォルダがあればそちらへ移動してもよいです）</p>
<p>>git clone https://github.com/<GitHubのユーザ名>/sfdx-circleci.git<br />
Cloning into ‘sfdx-circleci’…<br />
remote: Enumerating objects: 90, done.<br />
remote: Counting objects: 100% (24/24), done.<br />
remote: Compressing objects: 100% (21/21), done.<br />
remote: Total 90 (delta 9), reused 2 (delta 0), pack-reused 66<br />
Receiving objects: 100% (90/90), 357.09 KiB | 13.73 MiB/s, done.<br />
Resolving deltas: 100% (28/28), done.</p>
<p>

手順⑮ローカルのgitへクローンが作成されたら..\sfdx-circleci\assets\配下にエンコードした[server.key.enc]ファイルをコピーします。

</p>
<p>>copy server.key.enc sfdx-circleci\assets\</p>
<p>

手順⑯リポジトリを作成したら次はgit addコマンドでファイルをインデックスに追加します。

</p>
<p>>cd sfdx-circleci\assets\</p>
<p>>git add server.key.enc</p>
<p>

手順⑰追加されたかステータスを確認

</p>
<p>>git status</p>
<p>On branch master<br />
Your branch is up to date with ‘origin/master’.</p>
<p>Changes to be committed:<br />
(use “git restore –staged <file>…” to unstage)<br />
new file: server.key.enc</p>
<p>

手順⑱追加されていることを確認したらコミットします

</p>
<p>>git commit -m “update server.key.end” -v</p>
<p>[master 827e48b] update server.key.end<br />
1 file changed, 37 insertions(+)<br />
create mode 100644 assets/server.key.enc</p>
<p>

手順⑲最後にgitにプッシュします。

</p>
<p>>git push</p>
<p>info: please complete authentication in your browser…<br />
Enumerating objects: 6, done.<br />
Counting objects: 100% (6/6), done.<br />
Delta compression using up to 8 threads<br />
Compressing objects: 100% (4/4), done.<br />
Writing objects: 100% (4/4), 2.13 KiB | 2.13 MiB/s, done.<br />
Total 4 (delta 1), reused 0 (delta 0), pack-reused 0<br />
remote: Resolving deltas: 100% (1/1), completed with 1 local object.<br />
To https://github.com/creativecontentlabtokyo/sfdx-circleci.git<br />
94c267b..827e48b master -> master</p>
<p>

※GitHubへのログイン認証が必要な場合はIDとパスワードを入力します。最後にリポジトリにserver.key.encファイルが登録されていることを確認します。

手順⑳CircleCIの画面に戻り、プロジェクト[sfdx-circleci]のConfigurationを実行します。

手順㉑config.ymlについて、以下2点の修正を行いSave＆Runを実行します。

1. –setdefaultdevhubusername -a hub　⇒　今回は[my-hub-org]というエイリアスを使っていたのでこちらに修正します。
2. force:org:createの　–waitはデフォルト2ですが、3にしたほうがよいと記載があったので3に修正します。

</p>
<p>sfdx force:auth:jwt:grant –clientid $HUB_CONSUMER_KEY –jwtkeyfile assets/server.key –username $HUB_SFDC_USER –setdefaultdevhubusername -a <span style="color: #ff0000;">my-hub-org</span><br />
sfdx force –help<br />
sfdx force:org:create -s -f ~/ci_app/config/project-scratch-def.json -a circle_build_$CIRCLE_BUILD_NUM –wait <span style="color: #0000ff;">3</span></p>
<p>

手順㉒CircleCIの画面に戻って、再実行されたWorkflowの結果を確認しましょう

以下のSetup Orgの箇所で、Successfully Authorized ord ID ….と表示されていれば組織認証までは成功しています。

手順㉓Setup Orgで以下のエラーが発生していたので修正していきます。

</p>
<p><span style="color: #ff0000;">WARNING: Warning: If you’re using Contacts to Multiple Accounts, beginning with the Spring ’21 release, the feature isn’t automatically enabled. You must manually enable the setting for new scratch orgs. Enable the setting in one of these ways: update the Account Settings page in Setup, add the enableRelateContactsToMultipleAccounts setting to your scratch org definition file, or enable it via Metadata API.</span></p>
<p>ERROR running force:org:create: We’ve deprecated OrgPreferences. Update the scratch org definition file to replace OrgPreferences with their corresponding settings.</p>
<p><span style="color: #ff6600;">Replace the orgPreferences section:</span><br />
<span style="color: #ff6600;">{</span><br />
<span style="color: #ff6600;">“orgPreferences”: {</span><br />
<span style="color: #ff6600;">“enabled”: [</span><br />
<span style="color: #ff6600;">“S1DesktopEnabled”</span><br />
<span style="color: #ff6600;">]</span><br />
<span style="color: #ff6600;">}</span><br />
<span style="color: #ff6600;">}</span><br />
<span style="color: #ff6600;">With their updated settings:</span><br />
<span style="color: #ff6600;">{</span><br />
<span style="color: #ff6600;">“settings”: {</span><br />
<span style="color: #ff6600;">“lightningExperienceSettings”: {</span><br />
<span style="color: #ff6600;">“enableS1DesktopEnabled”: true</span><br />
<span style="color: #ff6600;">}</span><br />
<span style="color: #ff6600;">}</span><br />
<span style="color: #ff6600;">}</span><br />
For more info on configuring settings in a scratch org definition file see: https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_scratch_orgs.htm.’</p>
<p>Exited with code exit status 1<br />
CircleCI received exit code 1</p>
<p>

手順㉓GitHubの[project-scratch-def.json]ファイルを以下のように修正します。

ファイルパス：sfdx-circleci/config/project-scratch-def.json

</p>
<p><span style="color: #ff6600;">{</span><br />
<span style="color: #ff6600;">“orgName”: “Sample Org”,</span><br />
<span style="color: #ff6600;">“edition”: “developer”,</span><br />
<span style="color: #ff6600;">“settings”: {</span><br />
<span style="color: #ff6600;">“lightningExperienceSettings”: {</span><br />
<span style="color: #ff6600;">“enableS1DesktopEnabled”: true</span><br />
<span style="color: #ff6600;">}</span><br />
<span style="color: #ff6600;">}</span><br />
<span style="color: #ff6600;">}</span></p>
<p>

手順㉔最後にもう一度CircleCIの画面からsfdx-circleciプロジェクトのworkflowを再実行してみます。

Run Apex Tests

Setup Org

Uploading test results / Delete Useless Scratch Org

Parallel runs

全てSign up envirnmentから最後まですべて正常終了しました。

まとめ

今回の記事では、sfdx（CLI） と CircleCI を使って CI環境を作る手順について記しました。

GitHubの使い方やCircleCIなどのCI/DIツールについての基本知識がないと難しく感じる内容だったと思います。これを気に関係するツールや機能について学習することをお勧めします。

サポーターさん

ブログランキングに参加しましたので、ご支援していただけると幸いです。

にほんブログ村

第二回の今回は、Salesforceの組織とCircleCI間の認証に関する設定をしていきます。

前回の記事はこちら

参考

CircleCIを使った継続的インテグレーション（Continuous Integration）第1回

Salesforceの大型プロジェクトやアジャイル開発方式を採用したプロジェクト…

続きを読む

Dev Hub組織に対してJWTベースフローを使用した組織の認証を実行

Dev Hub組織に対してJWTベースフローを使用した組織の認証を実行します。※CircleCIからSalesforce組織に対する認証の設定

継続的インテグレーション（CI）の環境は自動化されており、OAuth2.0Webサーバ認証フローのユーザインタラクションはサポートされていないため、代替手段としてJWT（Json Web トークン）ベアラーフローを使用して組織を認証する必要があります。

非公開鍵と自己署名デジタル証明書の作成

OAuth 2.0 JWT ベアラー認証フローでは、証明書の署名に使用されるデジタル証明書と非公開鍵が必要になります。デジタル証明書をカスタム接続アプリケーションにアップロードします。このカスタム接続アプリケーションも JWT ベアラー認証フローで必要になります。認証機関で発行された独自の非公開鍵と証明書を使用できます。または、OpenSSL を使用して鍵と自己署名デジタル証明書を作成することもできます。

【Open SSLをインストール（未インストールの場合）】

手順①以下のサイトにWindows用にビルドされたインストーラがあるので、ダウンロードします。

Webサイト「Shining Light Productions（Win32/Win64 OpenSSL）」　※実行時点の最新版で構いません。

今回は、Win64 OpenSSL v1.1.1oのMSIをダウンロードします。

※Win64 OpenSSL v3.0.3の場合、最後のsfdxでの認証でエラーになることがわかっているので間違えないようにしてください。Issue（https://developer.salesforce.com/forums?id=9062I000000BmNHQA0）

ERROR running auth:jwt:grant: We encountered a JSON web token error, which is likely not an issue with Salesforce CLI. Here’s the error: error:25078067:DSO support routines:win32_load:could not load the shared library

Windows以外の場合は、Opensslのサイトよりダウンロードしてください。

「openssl.org：https://www.openssl.org/」

手順②ダウンロードしたインストーラ（MSIファイル）を実行します。

以下の警告メッセージが表示されるので、詳細情報のリンクをクリックします。

手順③実行ボタンが表示されるためクリックしてインストールを実行します。

手順④インストーラが起動されます。同意にチェックをして次に進みます。

手順⑤Opensslのインストール先フォルダを選択します。※デフォルトのままで大丈夫です。

手順⑥ショートカット名を指定します。※デフォルトのままで大丈夫です。

手順⑦OpenSSL DLLについては、二つ目のオプション（OpenSSL binaries(/bin)directory）を選択してください。

手順⑧最終確認後、Installボタンをクリックします。

手順⑨最後に寄付の画面が表示されますが、チェックを外してそのまま終了します。※寄付したい場合は任意のオプションを選択

手順⑩続いて、インストールしたOpensslのパスを設定します。システムのプロパティから詳細設定を開きます。環境変数のボタンをクリックします。

手順⑪環境変数の画面にて、ユーザ環境変数の編集ボタンをクリックします。

手順⑫新規ボタンをクリックして、Opensslをインストールしたフォルダのフルパスを登録します。

手順⑬以下のように新規パスが追加されていることを確認して終了します。

手順⑬パスが通っているか確認するためコマンドプロンプトを起動して、以下のコマンドを実行します。

>openssl version

バージョンの情報が表示されていれば成功です。

OpenSSL を使用して非公開鍵と自己署名デジタル証明書の作成

つぎにOpensslを使って自己署名デジタル証明書を作成していきます。（以下2つのファイルを生成します）

・server.key — 非公開鍵。auth:jwt:grant コマンドで組織を認証するときにこのファイルを指定します。
・server.crt — デジタル証明書。JWT ベアラーフローで必要な接続アプリケーションを作成するときにこのファイルをアップロードします。

手順①コマンドプロンプトを起動して、非公開鍵を生成するワークフォルダを作成します。

>　mkdir 任意のワークフォルダ（フルパスで指定）　※システム管理者権限が必要なフォルダ階層はやめたほうが良いです。

例：mkdirコマンドを使って以下のフォルダを作成して、cdコマンドで作成したフォルダへ移動します。

</p>
<p>> mkdir C:\Users\e\dev\jdoe\JWT</p>
<p>> cd C:\Users\e\dev\jdoe\JWT</p>
<p>

※エクスプローラからフォルダを作成しても構いません。

手順②以下のコマンドを実行して非公開鍵を生成し、server.key というファイルに保存します。

</p>
<p>> openssl genrsa -des3 -passout pass:SomePassword -out server.pass.key 2048</p>
<p>> openssl rsa -passin pass:SomePassword -in server.pass.key -out server.key</p>
<p>

手順③上記コマンド実行後、作業用フォルダに以下2つのファイルが生成されているため[server.pass.key]のほうを削除します。

・server.key

・server.pass.key

手順④server.key ファイルを使用して、証明書署名要求を生成します。（server.csr というファイルに証明書署名要求を保存）

以下のコマンドを実行します。

</p>
<p>> openssl req -new -key server.key -out server.csr</p>
<p>

以下、会社情報などの情報入力が求められるため適宜ご自身の情報を入力してください。

</p>
<p>>openssl req -new -key server.key -out server.csr<br />
You are about to be asked to enter information that will be incorporated<br />
into your certificate request.<br />
What you are about to enter is what is called a Distinguished Name or a DN.<br />
There are quite a few fields but you can leave some blank<br />
For some fields there will be a default value,<br />
If you enter ‘.’, the field will be left blank.<br />
—–</p>
<p><span style="color: #99ccff;">Country Name (2 letter code) [AU]:JP</span><br />
<span style="color: #99ccff;">State or Province Name (full name) [Some-State]:TOKYO</span><br />
<span style="color: #99ccff;">Locality Name (eg, city) []:KOTO-KU</span><br />
<span style="color: #99ccff;">Organization Name (eg, company) [Internet Widgits Pty Ltd]:CCLT</span><br />
<span style="color: #99ccff;">Organizational Unit Name (eg, section) []:IT</span><br />
<span style="color: #99ccff;">Common Name (e.g. server FQDN or YOUR name) []:CCLT</span><br />
<span style="color: #99ccff;">Email Address []:cclt@mail.com</span></p>
<p><span style="color: #99ccff;">Please enter the following ‘extra’ attributes</span><br />
<span style="color: #99ccff;">to be sent with your certificate request</span><br />
<span style="color: #99ccff;">A challenge password []:　※パスワードを設定</span><br />
<span style="color: #99ccff;">An optional company name []:CCLT</span></p>
<p>

手順⑤以下のcsrファイルが生成されていることを確認します。

server.csr

手順⑥以下のコマンドを実行し、server.key および server.csr ファイルから自己署名デジタル証明書を生成します。

※server.crt というファイルに証明書を保存します。

</p>
<p>> openssl x509 -req -sha256 -days 365 -in server.csr -signkey server.key -out server.crt</p>
<p>（実行結果）<br />
Certificate request self-signature ok<br />
subject=C = JP, ST = TOKYO, L = KOTO-KU, O = CCLT, OU = IT, CN = CCLT, emailAddress = cclt@mail.com</p>
<p>

※非公開鍵： server.key とデジタル証明書： server.crt が存在することを確認します。

接続アプリケーションを作成して Salesforce DX 用に設定

OAuth 2.0 JWT ベアラー認証フローを使用して、Dev Hub 組織にCircleCI用の接続アプリケーションを作成します。

Dev Hub 組織用の接続アプリケーションの作成

手順①Dev Hubを有効化したSalesforce組織にログインして、[設定] から、アプリケーションマネージャを実行します。

手順②接続アプリケーション名などの情報を入力して、OAuth 設定の有効化にチェックを入れます。

※OAuth にチェックを入れるとOAuthの設定情報を入力できるようになります。

• コールバックURL：「http://localhost:1717/OauthRedirect」を入力します。
• デジタル署名を使用：JWT認証の場合こちらをチェック
• 証明書ファイルのアップロード：ローカル環境で生成したserver.crt をアップロードします。

手順③OAuthの範囲は以下を選択します。

• API を使用してユーザデータを管理 (api)
• Web ブラウザを使用してユーザデータを管理 (web)
• いつでも要求を実行 (refresh_token, offline_access)

上記を設定後、保存をクリックします。

手順④保存後の画面に表示されるコンシューマ鍵をコピーしてテキストに張り付けておきます。※後で利用するため

手順⑤manageボタンをクリックして、ポリシーの編集画面にて、[ポリシーを編集] をクリックします。

手順⑥ [OAuth ポリシー]の許可されているユーザで [管理者が承認したユーザは事前承認済み] を選択します。

以下の警告メッセージが表示されるためOKをクリックします。

手順⑦上記の設定が完了したら保存します。

手順⑧プロファイルを管理するのメニューを実行します。

手順⑨この接続アプリケーションを許可するプロファイルを選択して保存します。

※プロファイルの選択の代わりに権限セットを作成して、ユーザへ付与しても構いません。

手順⑩認証する組織が https://login.salesforce.com でホストされていない場合、プロジェクトの設定ファイル (sfdx-project.json) を更新する必要があります。

sfdx-project.jsonファイルは、Salesforce CLIをインストールしたフォルダ内にあります。

C:\Program Files\Salesforce CLI\client\node_modules\@salesforce\templates\lib\templates\project\sfdx-project.json

sfdx-project.jsonファイルを開いて、URLを書き換えて保存します。

https://test.salesforce.comの場合、sfdcLoginUrlの箇所を”sfdcLoginUrl”: “”とする。

手順⑪コマンドプロンプトを起動して以下のコマンドを実行し、接続アプリケーションのクライアント ID (コンシューマ鍵)、非公開鍵ファイル (server.key) へのパス、および JWT 認証ユーザ名を指定します。

>sfdx auth:jwt:grant –clientid （手順④でコピーしておいたコンシューマ鍵を指定） –jwtkeyfile （server.keyをフルパスで指定） –username （SalesforceへのログインユーザIDを指定） –setdefaultdevhubusername –setalias （エイリアス名を指定）my-hub-org

実行例：

</p>
<p>>sfdx auth:jwt:grant –clientid 3MVG95mg0lk4batiP7Q5f8gZVROjIpEdZT –jwtkeyfile C:\Users\e\dev\jdoe\JWT\server.key –username cclt.sfdc@mail.com –setdefaultdevhubusername –setalias my-hub-org</p>
<p>

※ –setdefaultdevhubusername パラメータを指定するとDev Hub 組織を認証するときにデフォルトに設定されます。

サーバキーの暗号化

続いては、server.keyファイルの暗号化を実施します。※鍵と初期化ベクトル (iv) を生成して server.key ファイルを暗号化する。

CircleCI 側では、ここで利用する鍵と vi を使ってビルド環境でサーバキーの復号化を行います。

手順①コマンドプロンプトを起動して、server.keyファイルを生成したフォルダへ移動します。

</p>
<p>>cd \server.keyファイルがあるディレクトリのフルパスを指定</p>
<p>

手順②以下のコマンドを実行します。※<passphrase> は、一意の鍵を作成するためのフレーズを指定します。

</p>
<p>> openssl enc -aes-256-cbc -k <passphrase> -P -md sha1 -nosalt</p>
<p>

実行すると生成された鍵（key)とivベクトルが表示されるので、テキストに張り付けて保存しておきます。

</p>
<p>C:\Users\e\dev\jdoe\JWT>openssl enc -aes-256-cbc -k <password> -P -md sha1 -nosalt<br />
*** WARNING : deprecated key derivation used.<br />
Using -iter or -pbkdf2 would be better.<br />
key=6431BAAE651D440343874873ADE64EB02B5311DAAF550BDD67A8C9892…<br />
iv =3F8DB47ADD8BF92D751EE0B2BEF…</p>
<p>

手順③上記手順②で生成されたkeyとivを使ってserver.keyファイルを暗号化します。

コマンドプロンプトで以下のコマンドを実行します。※フォルダは上記鍵を生成したところで実行すること。

>openssl enc -nosalt -aes-256-cbc -in server.key -out server.key.enc -base64 -K <key> -iv <iv>

<key>は、手順②で生成してkeyを指定し、<iv>は、手順②で生成したivを指定

実行例

</p>
<p>C:\Users\e\dev\jdoe\JWT>openssl enc -nosalt -aes-256-cbc -in server.key -out server.key.enc -base64 -K 6431BAAE651D440343874873ADE64EB02B5311DAAF550BDD67A8C9892… -iv 3F8DB47ADD8BF92D751EE0B2BEF…</p>
<p>

まとめ

今回の記事では、JWTベースフローを使用した組織の認証で、非公開鍵と自己署名デジタル証明書の作成からサーバーキーの暗号化までの手順について説明しました。

次回は、CircleCI を DevHub に接続から最後のCircleci での自動ビルドまで説明していきます。もう一息ですね。

参考

CircleCIを使った継続的インテグレーション（Continuous Integration）第3回

第二回では、JWTベースフローを使用した組織の認証で、非公開鍵と自己署名デジタル…

続きを読む

サポーターさん

ブログランキングに参加しましたので、ご支援していただけると幸いです。

にほんブログ村

これらの作業を自動化することで、作業工数の削減や品質の向上（手作業によるミスの低減）を実現することができます。

以前は、Salesforceの継続的インテグレーションの実現方法が、Jenkinsを使ったCIが主流でしたが、最近ではほかにもいくつか推奨されるものが出てきています。

• CircleCI + Salesforce
• Jenkins + Salesforce
• Travis CI + Salesforce

詳細は、以下Salesforce公式サイトを参照ください。

今回は、これらの中からCircleCIを使った環境構築手順についてご説明していきたいと思います。

作業手順

まずは、簡単に全体の流れを説明します。

GitHubのサインアップ

本記事をご覧になっている方のほとんどは、おそらくGithubをすでに使っている方ばかりだと思いますが、初めての方もいらっしゃるかもしれませんので、GitHubのセットアップ手順について説明させてい頂きます。

GitHub（ギットハブ）とは、プログラムのソースコードなどのリソースファイルをバージョン管理（保存）したり、公開するためのクラウドサービスとなります。もちろん非公開として自分だけやプロジェクトメンバーだけアクセスさせるような利用も可能です。

現在では、世界中のエンジニアの方が自身が作成したプログラムを公開していて、自分のスキルを証明するための資産として利用している側面もあります。Salesforce関連の非常に有用なソースコードも多数公開されているため、新しい機能を作るときには一度探してみるのもよいかもしれません。

セットアップ手順

手順①以下のサイトへアクセスします。

手順②公式サイトから「Sign up」ボタンをクリックします。

手順③アカウント作成画面にて以下の情報を登録する。

• ユーザ名（Username）
• Email address（メールアドレス）
• Password（パスワード）
• Verify your account（指定の画像を選択する）
• Create Accountボタンをクリックして完了

手順④登録したメールアドレスに以下のメールが届くため、メール内のリンクをクリックして認証を行います。

手順⑤認証が完了するとログイン後の画面が表示されます。

手順⑥新規リポジトリ（リソースを登録するスペースのこと）を作成します。※すでにお持ちの場合は省略

画面右上の＋メニューから「New repository」をクリックします。

手順⑦以下の内容を入力して、Create Repositoryボタンをクリックします。

• Repository name:リポジトリ名
• Description（説明）
• 公開設定：Public（公開）/Private（非公開）
• Add a README File：Readmeファイルを作成するかどうか

手順⑧リポジトリが作成されると以下のように表示されます。

この後は、リポジトリにソースコードを登録する作業がありますが、CircleCIの環境セットアップを先に実施します。

※CircleCIはGitHubやGitBucketなどと連携できますが、今回はGithubを利用します。

CircleCIの環境構築（CircleCI で GitHub リポジトリを設定）

まずは、CircleCIのサインアップから行っていきます。

手順①以下、ブラウザでCircleCIの公式HPを開きます。

手順②ホーム画面トップメニューにある「Sign up」ボタンをクリックします。

手順③サインアップ画面では、以下3種類の認証が用意されています。

今回は先ほどセットアップしたGithubの認証を使うので、「Sign up with GitHub」を選択してください。

手順④GitHubのログイン画面が表示されるため、セットアップしたアカウントでログインします。

手順⑤Autorize CircleCIの画面が表示されます。リポジトリのアクセス権限や個人データ（メールアドレス）に対するアクセス権限を求められるため問題なければ「Authorize CircleCI」をクリックします。

手順⑥セットアップ画面では以下の内容を登録して、Setup Projectを実行します。

• Select Organization：GitHub組織を選択
• Select Repository：リポジトリを選択
• Select your config.yml file：config.ymlファイルを選択（存在しない場合は2番目のオプションを選択します。）

手順⑦セットアップが完了すると以下の画面が表示されます。

GitHubを確認するとCircleCIから作成されたBranchが確認できます。

Salesforce CLIのインストール

Salesforceのコマンドラインインタフェース（CLI）については、インストールが必要となりますので、ご利用中のOSに合わせて

公式サイトからダウンロードしてインストールを実行してください。

詳細な手順はこちらの記事を参照ください。

参考

Salesforce CLI（Command Line Interface）の利用ガイド

本記事では、Salesforceが提供するCLI（Command Line In…

続きを読む

Dev Hub の有効化

Dev Hubを有効化するとスクラッチ組織の作成と管理、第二世代パッケージの作成と管理、Einstein 機能が利用可能となります。

注意：Sandbox で Dev Hub を有効にすることはできません。そのほか制約事項や注意点は、Salesforce公式HELPサイト「組織のDev Hub機能の有効化」を参照してください。

ではDev Hubを有効化していきましょう。

手順①Salesforceにシステム管理者でログインして、設定->Dev Hubを実行します。

手順②Dev Hubの設定画面にて、Dev Hubを有効化を実行します。

注意: 一度有効化すると元に戻す（無効化）することができないので注意！

まとめ

今回は、GuthubのセットアップからCircleCIのセットアップ、そしてGitHubとの連携と、DevHubの有効化までの手順をご説明しました。

次回は残りの手順についてご説明していきます。Salesforceの組織とCircleCIの認証に関する設定をしていくことになりますが、内容としてはこれまでよりも難しい内容となりますが、頑張って設定していきましょう。

参考

CircleCIを使った継続的インテグレーション（Continuous Integration）第2回

第一回では、GuthubのセットアップからCircleCIのセットアップ、そして…

続きを読む

サポーターさん

ブログランキングに参加しましたので、ご支援していただけると幸いです。

にほんブログ村