Cloud Manager FAQ cloud-manager-faqs

このドキュメントでは、AEM as a Cloud Service の Cloud Manager に関するよくある質問とその回答を示します。

Cloud Manager ビルドで Java™ 11 を使用できますか？ java-11-cloud-manager

はい。Java™ 11 向けに適切に設定された maven-toolchains-plugin を追加します。

プロセスは、こちらのドキュメントに記載されています。

例えば、wknd プロジェクトサンプルプロジェクトコードを参照してください。

Java™ 8 から Java™ 11 に切り替えた後、maven-scr-plugin に関するエラーでビルドが失敗します。どうすればいいですか？ build-fails-maven-scr-plugin

ビルドを Java™ 8 から 11 に切り替えようとすると、AEM Cloud Manager のビルドに失敗する場合があります。次のエラーが発生した場合は、maven-scr-plugin を削除し、すべての OSGi 注釈を OSGi R6 注釈に変換する必要があります。

[main] [ERROR] Failed to execute goal org.apache.felix:maven-scr-plugin:1.26.4:scr (generate-scr-scrdescriptor) on project helloworld.core: /build_root/build/testsite/src/main/java/com/adobe/HelloWorldServiceImpl.java : Unable to load compiled class: com.adobe.HelloWorldServiceImpl: com/adobe/HelloWorldServiceImpl has been compiled by a more recent version of the Java Runtime (class file version 55.0), this version of the Java Runtime only recognizes class file versions up to 52.0 > [Help 1]

このプラグインの削除方法については、こちらを参照してください。

Java™ 8 から Java™ 11 に切り替えた後、RequireJavaVersion に関するエラーでビルドが失敗します。どうしたらいいでしょうか。 build-fails-requirejavaversion

Cloud Manager ビルドの場合、maven-enforcer-plugin がこのエラーで失敗する場合があります。

"[main] [WARNING] Rule 1: org.apache.maven.plugins.enforcer.RequireJavaVersion".

このエラーは既知の問題です。Cloud Manager で別のバージョンの Java™ を使用してコードのコンパイル用の maven コマンドを実行していることが原因です。この問題を解決するには、maven-enforcer-plugin の設定から requireJavaVersion を省略するだけです。

コード品質チェックに失敗し、デプロイメントが停止しています。このチェックを回避する方法はありますか？ deployment-stuck

はい。セキュリティ評価以外のコード品質チェックのエラーはすべて、重要な指標ではありません。そのため、結果の UI で項目を展開することで、デプロイメントパイプラインの一部としてこれらのチェックを回避できます。

デプロイメントマネージャー、プロジェクトマネージャーまたはビジネスオーナーの役割を持つユーザーは、問題をオーバーライドでき、その場合、パイプラインは続行されます。または、問題を受け入れることもでき、その場合、パイプラインはエラーで停止します。

コード品質テストおよび実稼動以外のパイプラインの設定について詳しくは、ドキュメントを参照してください。

Maven プロジェクトのバージョンに SNAPSHOT を使用できますか？ use-snapshot

はい。開発者向けデプロイメントの場合、Git ブランチの pom.xml ファイルには、<version> 値の最後に -SNAPSHOT が含まれている必要があります。

この値により、バージョンが変更されなかった場合でも、以降のデプロイメントを引き続きインストールできます。デベロッパーデプロイメントでは、maven ビルドの自動バージョンは追加または生成されません。

また、ステージおよび実稼働ビルドまたはデプロイメントのバージョンを -SNAPSHOT に設定することもできます。Cloud Manager では、適切なバージョン番号を自動的に設定し、Git にタグを作成します。このタグは、必要に応じて後で参照できます。

バージョン処理の詳細は、こちらで説明しています。

パッケージとバンドルのバージョン管理は、ステージングと実稼動のデプロイメントでどのように機能しますか？ snapshot-version

ステージング環境および実稼動環境でのデプロイメントでは自動バージョンが生成されます（こちらを参照）。

ステージングと実稼働のデプロイメントでカスタムバージョン管理を行うには、1.0.0 のように、3 つの部分から成る適切な Maven バージョンを設定します。実稼動にデプロイするたびに、バージョンを増やします。

Cloud Manager では、自らのバージョンをステージビルドと実稼動ビルドに自動的に追加し、Git ブランチを作成します。特別な設定は必要ありません。前述のように Maven バージョンを設定しない場合でも、デプロイメントは成功し、バージョンが自動的に設定されます。

Maven ビルドが Cloud Manager デプロイメントでは失敗しますが、ローカルではエラーなしでビルドされます。何が問題なのでしょうか。 maven-build-fail

詳しくは、こちらの Git リソースを参照してください。

AEM as a Cloud Service のデプロイステップで Cloud Manager のデプロイメントが失敗した場合は、どうすればよいですか？ cloud-manager-deployment-cloud-service

デプロイメントが失敗する最も一般的な理由は、sling-distribution-importer ユーザーの権限が不十分なことです。その場合、Cloud Manager のデプロイメント中にデプロイステップが失敗し、次のようなエラーが生成されます。

[Queue Processor for Subscriber agent forwardPublisherSubscriber] org.apache.jackrabbit.vault.fs.io.Importer Error while committing changes. Retrying import from checkpoint at /. Retries 4/10
[Queue Processor for Subscriber agent forwardPublisherSubscriber] org.apache.sling.distribution.journal.impl.subscriber DistributionSubscriber Error processing queue item
org.apache.sling.distribution.common.DistributionException: Error processing distribution package
dstrpck-1583514457813-c81e7751-2da6-4d00-9814-434187f08d32. Retry attempts 162/infinite.
Caused by: org.apache.sling.api.resource.PersistenceException: Unable to commit changes to session.
Caused by: javax.jcr.AccessDeniedException: OakAccess0000: Access denied [EventAdminAsyncThread #7] org.apache.sling.distribution.journal.impl.publisher.DistributionPublisher [null] Error processing distribution package` `dstrpck-1583514457813-c81e7751-2da6-4d00-9814-434187f08d32. Retry attempts 344/infinite. Message: Error trying to extract package at path /etc/packages/com.myapp/myapp-base.ui.content-5.1.0-SNAPSHOT.

sling-distribution-importer ユーザーは、ui.content package で定義されたコンテンツパスに対して追加の権限が必要です。このルールは、通常、/conf と /var の両方に対する権限を追加する必要があるということです。

解決策は、RepositoryInitializer OSGi 設定スクリプトをアプリケーションデプロイメントパッケージに追加して、sling-distribution-importer ユーザーの ACL を追加することです。

上記のエラー例では、パッケージ myapp-base.ui.content-*.zip の /conf と /var/workflow の下にコンテンツが含まれています。デプロイメントを成功させるには、これらのパスの下に sling-distribution-importer の権限が必要です。

sling-distribution-importer ユーザーの権限を追加する OSGi 設定の例として、org.apache.sling.jcr.repoinit.RepositoryInitializer-DistributionService.config を紹介します。この設定により、/var 下に権限が追加されます。このような設定は、/apps/myapp/config（myapp はアプリケーションコードが保存されるフォルダー）下のアプリケーションパッケージに追加する必要があります。

AEM as a Cloud Service のデプロイステップで Cloud Manager のデプロイメントが失敗します。RepositoryInitializer OSGi 設定は追加済みです。他に何ができますか？ build-failures

RepositoryInitializer OSGi 設定の追加でエラーが解決しない場合は、次のような問題の 1 つが原因である可能性があります。

aio コマンドを使用して変数を設定できません。どうすればいいですか？ set-variable

aio コマンドでパイプライン変数をリストアップまたは設定しようとすると、次のような 403 エラーが発生する場合があります。

$ aio cloudmanager:list-pipeline-variables 222

Cannot get variables: https://cloudmanager.adobe.io/api/program/111/pipeline/222/variables (403 Forbidden)

$ aio cloudmanager:set-pipeline-variables 222 --variable TEST 1

Cannot get variables: https://cloudmanager.adobe.io/api/program/111/pipeline/222/variables (403 Forbidden)

$ aio cloudmanager:set-environment-variables 1755 --variable TEST 1

setting variables... !

Cannot set variables: https://cloudmanager.adobe.io/api/program/111/environment/222/variables (403 Forbidden)

この場合、これらのコマンドを実行するユーザーに、Admin Console で​ デプロイメントマネージャー ​の役割を追加する必要があります。

詳しくは、API の権限を参照してください。