DocumentazioneExperience Cloud KCS

Le variabili di ambiente non si interpolano nelle configurazioni OSGi in Adobe Experience Manager

Ultimo aggiornamento: 24 luglio 2026

In Adobe Experience Manager as a Cloud Service (AEMaaCS), AEM Managed Services (AMS) e Adobe Developer App Builder, le variabili di ambiente non vengono visualizzate, non vengono interpolate in configurazioni OSGi o restituiscono valori Null. I valori segnaposto come $[ env:VAR] e $[ secret:VAR] vengono visualizzati letteralmente nei registri e Cloud Manager non consente la configurazione delle variabili di ambiente negli ambienti AMS. Per risolvere questo problema, identifica la variante AEM, convalida la configurazione delle variabili di ambiente e verifica i requisiti di implementazione OSGi.

Descrizione description

Ambiente

Adobe Experience Manager as a Cloud Service (AEMaaCS)

Problema/Sintomi

  • I valori delle variabili di ambiente vengono visualizzati come segnaposto letterali, ad esempio $[ secret:ACCESS_KEY] o $[ env:AEM_EXTERNALIZER_LIVE] nei registri.
  • Cloud Manager impedisce l’aggiunta o la modifica di variabili di ambiente in ambienti AMS.
  • Le variabili di ambiente non vengono risolte nelle configurazioni OSGi.
  • I valori segreti restituiscono null o rimangono non risolti.
  • La sostituzione booleana della variabile di ambiente non funziona.

Risoluzione resolution

Per risolvere il problema, effettua le seguenti operazioni:

  1. Identifica la variante AEM in Cloud Manager e conferma se il programma è AEM as a Cloud Service (AEMaaCS) o AEM Managed Services (AMS).
  2. Per gli ambienti AEMaaCS, apri Ambienti Cloud Manager > > [ Seleziona configurazione ambiente] > .
  3. Verifica che esistano le variabili di ambiente o i segreti richiesti e che corrispondano ai nomi utilizzati nella configurazione OSGi.
  4. Rivedi la configurazione OSGi e conferma che utilizzi la sintassi segnaposto supportata $[ env:VAR] o $[ secret:VAR].
  5. Verifica che le proprietà booleane non utilizzino la sostituzione delle variabili di ambiente. Memorizzare valori booleani in configurazioni specifiche dell’ambiente o implementare i clienti
  6. Verifica che la configurazione OSGi utilizzi @ObjectClassDefinition e @Designate annotazioni e che la configurazione sia mappata correttamente al PID.
  7. Per gli ambienti AMS, utilizza le variabili di pipeline invece delle variabili di ambiente runtime di Cloud Manager e fai riferimento a esse in Maven con ${env.VAR_NAME}.
  8. Attiva il componente dell’applicazione che legge la configurazione e verifica che i registri mostrino valori risolti o segreti mascherati invece dei segnaposto letterali.

Lettura correlata

recommendation-more-help
experience-cloud-kcs-help-kbarticles