実稼動環境にデプロイする前にコードの品質をテストするための実稼動以外のパイプラインを設定する方法を説明します。
ステージング環境と実稼動環境にデプロイする実稼動パイプラインに加えて、実稼動以外のパイプラインも設定して、コードを検証できます。
実稼動以外のパイプラインには次の 2 種類があります。
初期設定後にパイプライン設定を編集できます。
Cloud Manager UI を使用してプログラムを設定し、1 つ以上の環境を用意したら、次の手順に従って実稼動以外のパイプラインを追加する準備が整います。
my.cloudmanager.adobe.com で Cloud Manager にログインし、適切な組織とプログラムを選択します。
Cloud Manager のホーム画面からパイプラインカードにアクセスします。「+追加」をクリックし、「実稼動以外のパイプラインを追加」を選択します。
実稼動以外のパイプラインを追加ダイアログの「設定」タブで、追加する実稼動以外のパイプラインのタイプを選択します。
実稼動以外のパイプライン名を指定して、次の追加情報と共にパイプラインを特定します。
デプロイメントトリガー - 次のオプションで、パイプラインを開始するデプロイメントトリガーの時期を定義できます。
デプロイメントパイプラインを作成する場合、重要な指標のエラー動作も定義する必要があります。
「続行」をクリックします。
実稼動以外のパイプラインを追加ダイアログの「ソースコード」タブで、パイプラインが処理するコードのタイプを選択する必要があります。
実稼動以外のパイプラインの作成を完了する手順は、選択したソースコードのオプションによって変わります。上記のリンクをたどって、このドキュメントの次の節に移動し、パイプラインの設定を完了します。
フロントエンドコードパイプラインは、1 つ以上のクライアントサイド UI アプリケーションを含んだフロントエンドコードビルドをデプロイします。このタイプのパイプラインについて詳しくは、CI/CD パイプラインドキュメントを参照してください。
フロントエンドコードの実稼動以外のパイプラインの設定を完了するには、次の手順に従います。
「ソースコード」タブで、次のオプションを定義する必要があります。
Cloud Manager でリポジトリーを追加および管理する方法については、リポジトリーの追加と管理のドキュメントを参照してください。
「保存」をクリックします。
パイプラインが保存され、プログラムの概要ページのパイプラインカードのパイプラインを管理できるようになります。
フルスタックコードパイプラインは、1 つ以上の AEM サーバーアプリケーションを含んだバックエンドおよびフロンエンドコードビルドと HTTPD/Dispatcher 設定を同時にデプロイします。このタイプのパイプラインについて詳しくは、CI/CD パイプラインのドキュメントを参照してください。
選択した環境にフルスタックコードパイプラインが既に存在する場合、この選択は無効になります。
フルスタックコードの実稼動以外のパイプラインの設定を完了するには、次の手順に従います。
「ソースコード」タブで、次のオプションを定義する必要があります。
Cloud Manager でリポジトリーを追加および管理する方法については、リポジトリーの追加と管理のドキュメントを参照してください。
Git ブランチ - このオプションでは、選択したパイプラインのどのブランチからコードを取得するかを定義します。
web 階層設定を無視 - オンにすると、パイプラインは web 階層設定をデプロイしなくなります。
パイプライン - パイプラインがデプロイメントパイプラインの場合、テストフェーズを実行するように選択できます。このフェーズで有効にするオプションを選択します。どのオプションも選択していない場合、テストフェーズはパイプラインの実行中に表示されません。
「保存」をクリックします。
パイプラインが保存され、プログラムの概要ページのパイプラインカードのパイプラインを管理できるようになります。
Web 階層設定パイプラインは HTTPD/Dispatcher 設定をデプロイします。このタイプのパイプラインについて詳しくは、CI/CD パイプラインドキュメントを参照してください。
選択した環境に web 階層コードパイプラインが既に存在する場合、この選択は無効になります。
Web 階層コードの実稼動以外のパイプラインの設定を完了するには、次の手順に従います。
「ソースコード」タブで、次のオプションを定義する必要があります。
Cloud Manager でリポジトリーを追加および管理する方法については、リポジトリーの追加と管理のドキュメントを参照してください。
conf.d
、conf.dispatcher.d
および opt-in
ディレクトリを含んだパスになります。/dispatcher/src
のようになります。「保存」をクリックします。
既存のフルスタックパイプラインが環境にデプロイされている場合、同じ環境に対して web 層設定パイプラインを作成すると、フルスタックパイプライン内の既存の web 層設定が無視されます。
パイプラインが保存され、プログラムの概要ページのパイプラインカードでパイプラインを管理できるようになりました。
フロントエンドパイプラインを使用すると、フロントエンド開発者の作業の独立性が高まるほか、開発プロセスを速めることができます。
このプロセスの可能性を最大限に引き出すために知っておくべきいくつかの考慮事項と、このプロセスがどのように機能するかについては、フロントエンドパイプラインを使用したサイトの開発のドキュメントを参照してください。
Dispatcher パッケージをパイプラインの一部として作成しても、ビルドストレージに公開しない場合は、そのパッケージの公開を無効にすることができます。その結果、パイプラインの実行時間が短くなる可能性があります。
Dispatcher パッケージの公開を無効にする次の設定を、プロジェクトの pom.xml
ファイルを使用して追加する必要があります。この設定は環境変数に基づいています。この環境変数は、Cloud Manager ビルドコンテナに設定できるフラグの役目を果たすもので、Dispatcher パッケージをいつ無視すべきかを指定します。
<profile>
<id>only-include-dispatcher-when-it-isnt-ignored</id>
<activation>
<property>
<name>env.IGNORE_DISPATCHER_PACKAGES</name>
<value>!true</value>
</property>
</activation>
<modules>
<module>dispatcher</module>
</modules>
</profile>