このドキュメントでは、AEM as a Cloud Serviceの Cloud Manager に関するよくある質問に対する回答を示します。
はい。次の項目を追加する必要があります: maven-toolchains-plugin
Java 11 用の適切な設定を使用して、
このプロセスはドキュメントに記載されています ここ.
例えば、 wknd プロジェクトのサンプルプロジェクトコード.
ビルドを 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]
このプラグインの削除方法については、 こちら。
Cloud Manager ビルドの場合、 maven-enforcer-plugin
はこのエラーで失敗する場合があります。
"[main] [WARNING] Rule 1: org.apache.maven.plugins.enforcer.RequireJavaVersion".
これは既知の問題です。Cloud Manager では、maven コマンドの実行に、コードをコンパイルした際と異なるバージョンの Java を使用しているためです。単に省略する requireJavaVersion
から maven-enforcer-plugin
設定。
はい。セキュリティ評価を除くすべてのコード品質チェックの失敗は、重要でない指標なので、結果 UI の項目を展開することで回避できます。
ドキュメントを参照 コード品質テスト を参照してください。
はい。デベロッパーデプロイメントの場合、Git ブランチ pom.xml
ファイルに含める必要がある -SNAPSHOT
~の終わりに <version>
の値です。
これにより、バージョンが変更されなかった場合でも、以降のデプロイメントを引き続きインストールできます。 デベロッパーデプロイメントでは、maven ビルドの自動バージョンは追加または生成されません。
また、バージョンを -SNAPSHOT
ステージング環境および実稼動環境のビルドまたはデプロイメントの場合。 Cloud Manager は適切なバージョン番号を自動的に設定し、Git でタグを作成します。 このタグは、必要に応じて後で参照できます。
バージョン処理の詳細は次のとおりです。 ここで説明します。
ステージおよび実稼動環境でのデプロイメントでは、自動バージョンは ここで説明します。
ステージおよび実稼動環境でのデプロイメントのカスタムバージョン管理の場合は、次のような適切な 3 部構成の Maven バージョンを設定します。 1.0.0
. 実稼動環境にデプロイするたびに、バージョンを増やします。
Cloud Manager は、ステージビルドと実稼動ビルドにバージョンを自動的に追加し、Git ブランチを作成します。 特別な設定は必要ありません。前述のように Maven バージョンを設定しない場合、デプロイメントは成功し、バージョンが自動的に設定されます。
詳しくは、 この git リソース を参照してください。
デプロイメントが失敗する最も一般的な理由は、 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
ユーザー。
前の例のエラーでは、パッケージ myapp-base.ui.content-*.zip
次のコンテンツを含む /conf
および /var/workflow
. デプロイメントを成功させるには、 sling-distribution-importer
その下に必要なパスがあります。
次に例を示します org.apache.sling.jcr.repoinit.RepositoryInitializer-DistributionService.config
OSGi 設定で、 sling-distribution-importer
ユーザー。 この設定により、 /var
. このような設定は、以下のアプリケーションパッケージに追加する必要があります。 /apps/myapp/config
(ここで、myapp はアプリケーションコードが保存されるフォルダーです)。
If RepositoryInitializer OSGi 設定の追加 がエラーを解決しなかった場合は、これらの追加の問題の 1 つが原因である可能性があります。
標準のサービスを中断する無効な OSGi 設定が原因で、デプロイメントが失敗する可能性があります。
Dispatcher または Apache の設定が正しくないため、デプロイメントが失敗する可能性があります。
オーサーインスタンスからパブリッシュインスタンスへのコンテンツパッケージ(Sling 配布)のレプリケーション中に、他のエラーが発生したため、デプロイメントが失敗する場合があります。
以下を受け取ることができます: 403
経由でパイプライン変数をリストまたは設定しようとした場合に次のようなエラーが発生しました aio
コマンド
$ 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 の権限を参照してください。