プレリリースチャネルを使用して、AEM as a Cloud Service の今後の機能のプレビューを取得する方法について説明します。
Adobe Experience Manager as a Cloud Service は、Experience Manager リリースロードマップに従って、毎月のリリースサイクルで新機能を提供します。
次の機能リリースで公開予定の機能を把握できるように、プレリリースチャネルを購読できます。プレリリースチャネルにアクセスするには、開発環境または任意のサンドボックス環境を設定します。AEM ユーザーインターフェイスからアクセス可能な変更をプレビューしたり、新しいプレリリース API に対してコードを作成したりできます。
特定の機能リリースのプレリリース機能のリストは、リリースノートに掲載されています。
AEM as a Cloud Service には 2 種類のリリースがあります。
このパターンにより、サービスが中断されることなく継続的にリリースされます。
プレリリースチャネルでは、今後の機能を評価し、独自のプロジェクトで可能な実装を計画するために、今後の機能リリースでスケジュールされている機能をプレビューできます。これにより、次の機能リリースに向けて事前に計画できます。
例えば、5月にプレリリースチャネルを購読している場合、今後の 6月のリリースで機能を評価できます。
プレリリースでは、今後の AEMaaCS の機能を 1 か月間にわたって利用できるので、この期間に、新機能がプロジェクトやカスタマイズに与える影響を評価し、これらの機能、テスト、ユーザートレーニングの展開を計画できます。
プレリリースチャネルを効果的に活用するには、4 つの手順が必要です。
機能リリースは事前にスケジュールされており、リリース日は Adobe Experience League で公開されています。
リリース日を控えておくと、今後の機能の確認やテストを計画できます。
カレンダーにリリース日をマークしたら、リリース日に Adobe Experience League の web サイトで最新のリリースノートを確認します。
各リリースには、そのリリースの新機能だけでなく、プレリリース評価で使用できる機能についても記載したリリースノートが付属しています。事前に情報を取得して、AEMaaCS の最新機能を活用する計画を立ててください。
また、すべてのリリースと共に公開されている既知の問題を確認することもできます。これにより、新機能の評価や最終的な採用に課題が生じる可能性のある技術的な問題を認識することもできます。
プレリリースチャネルは、任意の開発環境またはサンドボックス環境で有効にできます。プレリリースは、ステージング環境または実稼動環境では有効にできません。
プレリリース機能は、次のような異なる方法で使用できます。
プレリリースを使用するようにクラウド環境を更新するには、新しい環境変数を追加する必要があります。これは、Cloud Manager UI または CLI を使用して実行できます。
my.cloudmanager.adobe.com で Cloud Manager にログインし、適切な組織を選択します。
プレリリースを有効にするプログラムに移動します。
プレリリースを有効にする環境を選択し、プログラム/環境/環境設定に移動して、設定にアクセスします。
新しい環境変数を追加します。
名前 | 値 | 適用されるサービス | タイプ |
---|---|---|---|
AEM_RELEASE_CHANNEL |
prerelease |
すべて | 変数 |
変更内容を保存すると、プレリリース機能の切り替えが有効になった状態で環境が更新されます。
Cloud Manager API と CLI を使用して環境変数を更新することもできます。
Cloud Manager API の環境変数エンドポイントを使用して、AEM_RELEASE_CHANNEL
環境変数に値 prerelease
を設定します。
PATCH /program/{programId}/environment/{environmentId}/variables
[
{
"name" : "AEM_RELEASE_CHANNEL",
"value" : "prerelease",
"type" : "string"
}
]
Cloud Manager CLI も使用できます
aio cloudmanager:environment:set-variables <ENVIRONMENT_ID> --programId=<PROGRAM_ID> --variable AEM_RELEASE_CHANNEL "prerelease
環境を通常の(プレリリース以外の)チャネルの動作に戻す場合は、変数を削除するか、別の値に設定し直します。
Maven Central にあるプレリリース API Jar
を参照するように Maven プロジェクトを設定することで、ローカル Quickstart SDK の Sites コンソールの新機能と、プレリリースの新しい API に対応するコードを確認できます。通常の Quickstart SDK をプレリリースモードで起動することにより、ローカル開発環境でこれらのプレリリース機能を確認することもできます。
-r prerelease
を含めます。この値は、sticky なので最初の起動時にのみ選択できます。コマンドラインオプションを変更するには、SDK を再インストールします。
毎月の機能リリースの間に複数の AEM メンテナンスリリースが行われる可能性があるので、これらの新しい SDK をダウンロードし、Maven プロジェクトで新しい SDK API Jar バージョンを参照できます。メンテナンスリリースには、追加のプレリリース機能はありませんが、バグ修正、セキュリティ修正、パフォーマンス強化などの小規模な変更が含まれる場合があります。
Javadoc は Maven Central に公開されます。
Maven プロジェクトの pom.xml
を変更して、Maven Central に公開されている個別のプレリリース SDK API jar を参照するようにします。これには、プレリリース機能の新しい Java API が含まれており、SDK API jar に依存しています。同じバージョンが使用されます。
例として、通常の API jar を参照する親 POM の依存関係管理セクションのスニペットを次に示します。
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>aem-sdk-api</artifactId>
<version>${aem.sdk.api}</version>
<scope>provided</scope>
</dependency>
この場合、モジュールでの使用方法は次のようになります。
<dependencies>
<dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>aem-sdk-api</artifactId>
</dependency>
プレリリース SDK に変更するには、次に示すように、依存関係を com.adobe.aem:aem-sdk-api
から com.adobe.aem:aem-prerelease-sdk-api
に変更するだけです。
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>aem-prerelease-sdk-api</artifactId>
<version>${aem.sdk.api}</version>
<scope>provided</scope>
</dependency>
<dependencies>
<dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>aem-prerelease-sdk-api</artifactId>
</dependency>
通常どおり、個々のプロジェクトでこの依存関係を使用できます。
ローカルサーバーにデプロイします。。
ローカルで想定どおりに動作することを確認したら、コードを開発ブランチにコミットし、Cloud Manager の実稼動以外のパイプラインを使用して、プレリリースチャネルをサブスクライブする環境にデプロイします。
aem-prerelease-sdk-api
artifactId は、ステージまたは実稼働環境にデプロイするときには使用しないでください。実稼働パイプラインでデプロイする場合は、必ず aem-sdk-api
を使用します。同様に、プレリリース API を参照するコードは、実稼動パイプラインでデプロイしないでください。
AEM CS SDK ビルドアナライザー Maven プラグイン v1.0 以降では、依存関係を調べて、プレリリース API がプロジェクトで使用されているかどうかを検出します。アナライザーで検出すると、プレリリース SDK API を使用してプロジェクトを分析します。
プレリリースチャネルの新機能をテストし、プロジェクトで活用することにしたら、ユーザーのトレーニングを行う必要があります。
Adobe Experience League では、AEMaaCS を学ぶための多くのリソースを提供しています。
プレリリースチャンネルを使用する際には、いくつかの注意事項があります。
Adobe Experience Manager 2021.4.5226.20210427T070726Z-210429-PRERELEASE
などのプレリリースサフィックスが含まれているかどうかを確認します。