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]

このプラグインを削除する手順については、SCR 注釈から OSGi 注釈へを参照してください。

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 にタグを作成します。 このタグは、必要に応じて後で参照できます。

バージョン処理について詳しくは、Maven プロジェクトのバージョン処理を参照してください。

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

ステージングおよび実稼動デプロイメントでは、自動バージョンが生成されます。 Maven プロジェクトバージョン処理を参照してください。

ステージング環境および実稼動環境でのカスタムバージョン管理の場合は、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設定を追加しても エラーが解決しなかった場合は、次のいずれかの問題が原因である可能性があります。

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 の権限を参照してください。