Cloud Manager FAQ

次の節では、Cloud Services向けCloud Managerに関するよくある質問と、その回答を示します。

Java 11をCloud Managerビルドと共に使用することは可能ですか?

ビルドをJava 8から11に切り替えようとすると、AEM Cloud Managerのビルドに失敗する。 この問題には多くの原因があり、ほとんどの一般的な原因は以下に記載されています。

  • 追加に記載されているように、maven-toolchains-pluginをJava 11用に正しい設定にして記述します。 例えば、wkndサンプルプロジェクトコードを参照してください。

  • 以下のエラーが発生した場合は、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プラグインはエラー"[main] [WARNING] Rule 1: org.apache.maven.plugins.enforcer.RequireJavaVersion"で失敗します。 これは既知の問題です。Cloud Managerで、mavenコマンドを実行するのに別のバージョンのJavaを使用し、コードをコンパイルするのに対して、既知の問題です。 ここでは、maven-enforcer-plugin設定からrequireJavaVersionを省略します。

コードの質のチェックに失敗したため、展開が停止します。 このチェックを回避する方法はありますか。

セキュリティレーティング​を除くすべてのコード品質のエラーは重要ではない指標なので、結果UIの項目を展開すると、これらのエラーを回避できます。

Deployment Manager、Project Manager、またはBusiness Ownerの役割を持つユーザーは、問題を上書きできます。この場合、パイプラインは続行するか、問題を受け入れることができます。この場合、パイプラインは失敗して停止します。 詳細は、パイプラインの実行中の3層ゲートを参照してください。

MavenプロジェクトのバージョンでSNAPSHOTを使用できますか。 パッケージとバンドルjarファイルのバージョン付けは、ステージおよび実稼働環境ではどのように機能しますか。

ステージおよび実稼働環境での展開用のパッケージおよびバンドルjarファイルのバージョンの設定については、次のシナリオを参照してください。

  1. 開発者のデプロイメントでは、Gitブランチpom.xmlファイルの<version>値の末尾に-SNAPSHOTを含める必要があります。 これにより、バージョンが変更されない場合でも、以降のデプロイメントは引き続きインストールされます。 開発者デプロイメントでは、Mavenビルドの自動バージョンは追加または生成されません。

  2. ステージおよび実稼働環境でのデプロイメントでは、ここに記載されているように、自動バージョンが生成されます。

  3. ステージおよび実稼働環境でのカスタムバージョン設定の場合は、1.0.0のように、適切なmavenバージョンを3つのパーツに設定します。 実稼働環境に別のデプロイを実行するたびに、バージョンを増やします。

  4. Cloud Managerは、自動的にStageビルドとProductionビルドにバージョンを追加し、Gitブランチを作成します。 特別な設定は必要ありません。 上記の手順3をスキップした場合、デプロイメントは引き続き問題なく動作し、バージョンが自動的に設定されます。

  5. ステージ版と実稼働版のビルドまたはデプロイメント用に-SNAPSHOTを残しておくと問題はありません。 Cloud Managerは、適切なバージョン番号を自動的に設定し、Gitにタグを作成します。 このタグは、必要に応じて後で参照できます。

  6. 開発環境で試験的なコードを試す場合は、新しいGitブランチを作成し、その異なるブランチを使用するようにパイプラインを設定します。 これは、デプロイメントの開始に失敗し、古いバージョンのコードを使用してテストし、コードが壊れたかどうかを確認する場合に便利です。

    以下のGitコマンドは、特定の既存のコミット485548e4fbafbc83b11c3cb12b035c9d26b6532bに対して、testbranch1​という名前のリモートブランチを作成します。 この特別なブランチは、Cloud Managerで使用でき、他のブランチに影響を与えません。

    git push origin 485548e4fbafbc83b11c3cb12b035c9d26b6532b:refs/heads/testbranch1

    詳しくは、Gitドキュメントを参照してください。

    後でテストブランチを削除する場合は、次のdeleteコマンドを使用します。

    git push origin --delete testbranch1

MavenのビルドはCloud Managerでは失敗しますが、ローカルにビルドされ、エラーは発生しません。 デバッグの方法?

詳しくは、Git Resourceを参照してください。

AEMでの展開手順でCloud Managerの展開が失敗し、Cloud Service環境としてのでの展開に失敗した場合、どうすればよいですか?

展開が失敗する最も一般的な理由は、sling-distribution-importerユーザーに対する権限が不十分であるためです。
問題、原因、解決方法については、次の例を参照してください。


問題AEMでのCloud Managerのデプロイメント中に、Cloud Service環境としてデプロイすると、デプロイ手順が失敗し、次のようなエラーが発生します。

[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パッケージで定義されているコンテンツパスごとに、追加の権限が必要です。 これは、通常、/confと/varの両方に対する権限を追加する必要があることを意味します。

解決
策:sling-distribution-importerユーザーのACLを追加するには、 RepositoryInitializer OSGi 設定スクリプトをアプリケーション展開パッケージに追加します。上の例のエラーでは、パッケージmyapp-base.ui.content-*.zipには/conf/var/workflowの下のコンテンツが含まれています。 デプロイメントが失敗しないようにするには、それらのパスの下にSling-Distribution-importerの権限を追加する必要があります。
以下は、sling-distribution-importerユーザーに追加の権限を追加するOSGi設定の例です。org.apache.sling.jcr.repoint.RepositoryInitializer-DistributionService.config この設定は、/varの下に権限を追加します。 [1]の下のこのxmlファイルは、/apps/myapp/configの下のアプリケーションパッケージに追加する必要があります(myappはアプリケーションコードが保存されているフォルダー)。
org.apache.sling.jcr.repoinit.RepositoryInitializer-DistributionService.config

  1. sling-distribution-importer​が原因でない場合は、初期設定のサービスを中断する不正なOSGi設定が原因で、デプロイが失敗する可能性があります。 展開中にログを確認し、明らかなエラーがないかどうかを確認します。

  2. ディスパッチャーまたはApacheの設定が正しくないため、デプロイメントに失敗する場合があります。 SDKに含まれるDockerイメージを使用して、Apacheの設定とディスパッチャーの設定をローカルでテストしてください。 ローカルテストを簡単に行うためのディスパッチャーDockerコンテナの設定方法については、Cloud](/docs/experience-manager-cloud-service/implementing/content-delivery/disp-overview.html?lang=ja#content-delivery)の[ディスパッチャーを参照してください。

  3. コンテンツパッケージの作成者から発行インスタンスへのレプリケーション(Sling配布)中に、他のエラーが発生したため、展開が失敗する場合があります。

    ローカル設定でこの動作をシミュレートするには、次の手順を参照してください。

    • 作成者インスタンスと発行インスタンスのインストール(最新のAEM SDK JARを使用)
    • 作成者インスタンスにログインします
    • ツール -> 導入 -> 配布​に移動します
    • コードベースの一部であるコンテンツパッケージを配布し、キューがエラーでブロックされるかどうかを確認します。

Aio Cloud Managerが設定したパイプライン変数を介して変数を設定できません。 これらの問題のデバッグ方法

以下に示すようなコマンドを使用してパイプライン変数をリストまたは設定しようとすると403エラーが発生する場合は、Admin Consoleに​Deployment Manager Cloud Manager製品ロールとして追加する必要があります。
詳しくは、API権限を参照してください。

関連するコマンドとエラー:

$ 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)

このページ

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now