Documentatie

AEM-implementatiepijplijn mislukt als gevolg van ongeldig OSGi-configuratieeigenschap

Last update: Thu Nov 13 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

De pijpleidingen van de plaatsing in de milieu's van het Stadium en van de Productie ontbreken tijdens de onderstap van de Diensten van de Update na het runnen voor wat tijd. Om dit te bevestigen, werk of verwijder de lege sleutel in het configuratiedossier bij en hergroepeer zich door Cloud Manager.

Beschrijving description

Omgeving

  • Adobe Experience Manager (AEM) as a Cloud Service
  • Cloud Manager CI/CD-pijpleidingen (werkgebied/productie)
  • Starten van sellfunctie

Probleem/symptomen

  • De pijpleiding van de plaatsing ontbreekt met a systeemkwestie bericht.
  • De mislukking komt in de substep van de Diensten van de Update na het lopen voor meer dan 2 uren voor.

Oorzaak

  • De slingerende Lanceerinrichting van de Eigenschap slaagt er niet in om wegens een ongeldig OSGi configuratiebezit in de projectcodebase te initialiseren.

  • Hier is een voorbeeld waar een OSGi- configuratiedossier een lege bezitssleutel heeft,

    code language-none 
    {
                "scheduler.expression": "0 0 6 * * ?",
                "job.enabled": true,
                "": "notifications@example.com",
                "emailName": "System Reminder",
                "emailSubject": "Reminder",
                "emailMessage": "This is an automated reminder for your content."
            }

Het lege bezit ("") veroorzaakt AEM om te ontbreken terwijl het ontleden van configuratie tijdens opstarten, dat tot de pijpleidingsfout in de de diensten van de Update stap leidt.

Resolutie resolution

Om de kwestie op te lossen, werk of verwijder het ongeldige bezit in het beïnvloede configuratiedossier bij.

  1. Open het betreffende configuratiebestand, meestal te vinden onder:

    ui.config/src/main/content/jcr_root/apps/<project-name>/osgiconfig/config.<runmode>/
    Verwijs naar ​ het Vormen OSGi voor Adobe Experience Manager as a Cloud Service ​ voor meer details.

  2. Verwijder of corrigeer de ongeldige eigenschap.

    Voorbeeld (de eigenschap corrigeren)

    code language-none 
    {
                "scheduler.expression": "0 0 6 * * ?",
                "job.enabled": true,
                "recipientEmail": "notifications@example.com",
                "emailName": "System Reminder",
                "emailSubject": "Reminder",
                "emailMessage": "This is an automated reminder for your content."
            }

    Belangrijk : omvat nooit geheimen, wachtwoorden, API sleutels, of andere gevoelige informatie direct in OSGi configuratiedossiers. Om gevoelige waarden veilig te beheren, gebruik ​ de variabelen van het Milieu in Cloud Manager ​.

  3. Leg de gecorrigeerde configuratie vast en implementeer deze opnieuw via Cloud Manager. Verwijs naar ​ het Opstellen aan AEM as a Cloud Service ​ in de Gids van de Gebruiker van AEM as a Cloud Service voor meer details.

Na het bevestigen van de configuratie, zou de pijpleiding met succes moeten uitvoeren.

Aanvullende opmerkingen

  • Valideer JSON-configuraties lokaal voordat u ze toewijst, met hulpprogramma's zoals jsonlint of IDE-validatie.
  • Zorg ervoor dat alle eigenschapnamen niet leeg, uniek en correct zijn getypt.
  • Bekijk AEM as a Cloud Service-buildlogboeken in Cloud Manager om configuratieproblemen vroegtijdig te detecteren.
  • Houd configuraties milieuspecifiek door ze onder config.<runmode> mappen (bijvoorbeeld config.author , config.publish ) te plaatsen.
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f