AEM as a Cloud Service Developer Console developer-console
AEM as a Cloud Service Developer Console include un set di strumenti di sola lettura per il debug degli ambienti cloud. È accessibile tramite un collegamento per ambiente in Cloud Manager e offre funzioni per visualizzare bundle, impostazioni OSGi, servizi e servlet e altro ancora.
- AEM Developer Console (Cloud Service) non deve essere confuso con il nome simile Adobe Developer Console.
Accesso ad AEM Developer Console
Per accedere e utilizzare AEM Developer Console è necessario concedere le seguenti autorizzazioni all’Adobe ID dello sviluppatore tramite Admin Console di Adobe.
- Assicurati che nel selettore dell’organizzazione Adobe sia visibile l’organizzazione Adobe relativa agli ambienti che desideri ispezionare in AEM Developer Console.
- Per poter accedere ad AEM Developer Console, lo sviluppatore deve essere membro di uno dei seguenti ruoli:
+ Profilo prodotto Sviluppatore - Cloud Service di Cloud Manager: in questo caso, lo sviluppatore visualizzerà l’elenco completo degli ambienti disponibili nell’URL Developer Console di AEM selezionato. Se è stato selezionato un ambiente di sviluppo o un RDE in Cloud Manager, è possibile che vengano visualizzati altri ambienti di sviluppo o RDE nello stesso programma.
+ Amministratori AEM profilo di prodotto in AEM Author: in questo caso, l’elenco degli ambienti descritti nel punto precedente sarà limitato ai profili di prodotto correlati a cui è assegnato questo ruolo. - Lo sviluppatore deve essere membro del profilo di prodotto Utenti AEM o Amministratori AEM in AEM Author e/o Publish.
+ Se l’appartenenza non esiste, le immagini di stato stato si interromperanno con un errore 401 Non autorizzato.
Cancella i cookie del browser e lo stato dell’applicazione (archiviazione locale) e accedi di nuovo ad AEM Developer Console
Risoluzione dei problemi di accesso ad AEM Developer Console
Quando accedo non vedo elencato l’ambiente che sto cercando
Verifica quanto segue:
+ Hai selezionato l’URL AEM Developer Console corretto facendo clic sui tre punti per l’ambiente selezionato tramite Cloud Manager e seleziona AEM Developer Console.
+ Hai il profilo di prodotto Sviluppatore - Cloud Service di Cloud Manager per visualizzare l’elenco completo degli ambienti oppure fai parte del profilo di prodotto Amministratori AEM in AEM Author per l’ambiente che non trovi.
401 Errore non autorizzato durante il dumping dello stato
Per risolvere il problema non autorizzato:
- Assicurati che l’utente sia membro del profilo di prodotto Adobe IMS appropriato (Amministratori di AEM o Utenti di AEM) per l’istanza di prodotto AEM as a Cloud Service associata ad AEM Developer Console.
+ Ricorda che AEM Developer Console accede a 2 istanze di prodotto Adobe IMS; le istanze di prodotto AEM as a Cloud Service Author e Publish, quindi assicurati che vengano utilizzati i profili di prodotto corretti a seconda del livello di servizio che richiede l’accesso tramite AEM Developer Console. - Attendi fino a 30 minuti per la sincronizzazione con AEM as a Cloud Service dell’iscrizione al profilo di prodotto Adobe IMS.
- Accedi ad AEM as a Cloud Service (Author o Publish) e assicurati che gli utenti e i gruppi siano sincronizzati correttamente in AEM.
+ AEM Developer Console richiede la creazione del record utente nel livello di servizio AEM corrispondente per l’autenticazione in tale livello di servizio. - Cancella i cookie del browser e lo stato dell’applicazione (archiviazione locale) ed effettua di nuovo l’accesso ad AEM Developer Console, verificando che il token di accesso utilizzato da AEM Developer Console sia corretto e non scaduto.
Restrizioni IP ip-restrictions
L’accesso a Developer Console dipende dalla capacità di raggiungere l’istanza di authoring. Se la tua organizzazione ha configurato un elenco Consentiti IP per il servizio di authoring in Cloud Manager, devi connetterti da un indirizzo IP compreso nell’intervallo consentito.
Ad esempio, se l’istanza di authoring è limitata alla VPN aziendale, puoi utilizzare il Developer Console solo mentre sei connesso a tale VPN.
Passa a Developer Console
Developer Console è accessibile per ogni ambiente AEM as a Cloud Service tramite Cloud Manager.
- Passa a Cloud Manager
- Apri il programma che contiene l’ambiente AEM as a Cloud Service per aprire Developer Console.
- Individuare l’ambiente e selezionare
.... - Seleziona Developer Console dall’elenco a discesa.
Oppure apri questo URL per accedere: https://experience.adobe.com/skyline-console
In alternativa, utilizza questo comando dalla CLI di Cloud Manager:
aio cloudmanager:open-developer-console <ENVIRONMENTID> --programId <PROGRAMID>
Ambiente / selettore di programma
Per utilizzare AEM Developer Console, è necessario selezionare l’ambiente e il programma da controllare.
I selettori si trovano nell’angolo in alto a sinistra e a destra dell’interfaccia utente di AEM Developer Console.
La selezione di un ambiente attiva un aggiornamento dei dati in AEM Developer Console e vedrai i dati per l’ambiente selezionato.
Quando si accede al browser del repository, l’ambiente selezionato viene utilizzato per aprire il browser del repository in una nuova scheda.
I pulsanti di aggiornamento accanto ai selettori attivano una cancellazione della cache del browser per le chiamate di programmi/ambiente a Cloud Manager.
Puoi utilizzarlo se è stato creato un nuovo ambiente che non viene visualizzato nell’elenco degli ambienti.
Potrebbero essere necessari alcuni minuti perché il nuovo ambiente sia disponibile in AEM Developer Console.
Le spie di stato indicano lo stato di salute dell’ambiente.
- Rosso: indica che l’ambiente non è integro e non disponibile (è possibile che sia sospeso).
- Arancione: l’ambiente potrebbe essere in fase di riavvio o degradazione (alcuni dei baccelli sono temporaneamente inattivi, ma sono ancora disponibili baccelli sani).
- Verde: in esecuzione, tutti i pod sono attivi e sani
Dopo aver selezionato un ambiente, puoi utilizzare le schede per passare alle diverse viste di AEM Developer Console.
Puoi visualizzare lo stato di ogni livello dell’ambiente.
Bundle OSGi
- Panoramica dei bundle OSGI distribuiti nel tipo di ambiente selezionato. Consente una ricerca full-text.
- È utile ottenere informazioni sullo stato effettivo dei bundle nell’ambiente. Puoi ottenere informazioni quali pacchetti esportati, pacchetti importati, servizi utilizzati e altro ancora.
- Gli sviluppatori desiderano verificare l’ambiente effettivo e verificare se il bundle esegue le operazioni previste.
- Caso d’uso di esempio: Nel pacchetto è specificato un intervallo di versioni di una dipendenza. Qualcosa sta andando storto nella dipendenza. Desideri verificare quale versione della dipendenza viene collegata al bundle. Per verificare, vai ai dettagli del bundle e utilizza l’importazione di bundle/pacchetti per verificare quale versione del bundle o del pacchetto viene utilizzata in fase di esecuzione. Con queste informazioni, puoi regolare l’intervallo di versioni della dipendenza Maven o adattare il codice.
Per eseguire una ricerca, utilizza la barra di ricerca. Per scaricare l’elenco dei bundle come JSON, fai clic sul pulsante Scarica elenco in alto a destra per ottenere un’immagine JSON completa.
Se desideri ottenere il dump di pubblicazione o anteprima, puoi utilizzare il selettore dell’ambiente per selezionare l’ambiente di pubblicazione o anteprima e quindi scaricare l’elenco.
Pacchetti Java
I pacchetti Java vengono utilizzati per risolvere i problemi che impediscono l’avvio dei bundle di ripresa a causa di importazioni non risolte o classi non risolte negli script (HTL, JSP, ecc.). Se in Pacchetti Java non viene segnalato alcun bundle, esporta un pacchetto Java (o la versione non corrisponde a quella importata da un bundle OSGi):
+ Assicurati che la versione della dipendenza Maven dall’API AEM del tuo progetto corrisponda alla versione di AEM Release dell’ambiente (e, se possibile, aggiorna tutto alla versione più recente).
+ Se nel progetto Maven vengono utilizzate dipendenze Maven aggiuntive
+ Determina se è possibile utilizzare un’API alternativa fornita dalla dipendenza API di AEM SDK.
+ Se è necessaria una dipendenza aggiuntiva, assicurati che sia fornita come bundle OSGi (anziché come Jar normale) e che sia incorporata nel pacchetto di codice del progetto, (ui.apps), in modo analogo a come il bundle OSGi principale è incorporato nel pacchetto ui.apps.
Facendo clic su un pacchetto si passa ai dettagli del pacchetto:
Configurazioni configurations
- Un elenco ricercabile di configurazioni attive nell’ambiente. Puoi vedere quali proprietà vengono fornite dalle configurazioni estraendo la pagina dei dettagli.
- Caso d’uso di esempio: uno sviluppatore vuole assicurarsi che le configurazioni specificate siano effettivamente presenti nell’ambiente. Se la configurazione non è presente, è possibile controllare il modello di feature, la modalità di esecuzione della configurazione o la cartella.
Per ulteriori informazioni sulla configurazione delle autorizzazioni utente, vedere Documentazione di Cloud Manager.
Servlet servlets
- Un prompt di ricerca in cui è possibile specificare un percorso con i selettori e un’estensione con GET o POST. Fornisce quindi i risultati dei servlet in ordine di preferenza, che gestisce la richiesta in Sling.
- Caso d’uso di esempio: disponi di un servlet OSGI che deve essere attivato su richiesta e stampare l’output nella risposta. Tuttavia, invece dell’output previsto, la risposta restituisce vuoto. È necessario verificare se un altro servlet ha la precedenza sul servlet a causa di selettori,
resourceType, estensioni o classificazione più specifici. Cerchi il percorso previsto e scopri che è attivo un altro servlet con una classificazione più alta. Quindi decidi se puoi ottenere il tuo servlet sopra in classifica aggiungendo selettori, ad esempio.
Servizi services
Componenti elenca tutti i servizi OSGi.
I servizi OSGi aiutano nel debug:
+ Elencando tutti i servizi OSGi in AEM, insieme al bundle OSGi che lo fornisce e a tutti i bundle OSGi che lo utilizzano
Componenti OSGi osgi-components
I componenti facilitano il debug mediante:
+ Elenco di tutti i componenti OSGi distribuiti in AEM as a Cloud Service
+ Fornire lo stato di ciascun componente OSGi, anche se è attivo o non soddisfatto
+ Se si forniscono dettagli sui riferimenti di servizio non soddisfatti, i componenti OSGi potrebbero diventare attivi
+ Elenco delle proprietà OSGi e dei relativi valori associati al componente OSGi.
+ Verranno visualizzati i valori effettivi inseriti tramite variabili di configurazione dell’ambiente OSGi.
Integrazioni integrations
- Gli amministratori di sistema possono generare, rinominare ed eliminare le credenziali del servizio e i token per sviluppatori.
- Ulteriori informazioni sono disponibili qui: Generazione dei token di accesso per le API lato server.
Archivio repository
- Apre il Browser dell’archivio.
- Avviso: per accedere al browser dell’archivio devi poter accedere al servizio AEM. Se non riesci ad accedere, contatta l’amministratore di sistema per ottenere l’accesso.
- È necessario concedere l’accesso al livello a cui si sta tentando di accedere. Ad esempio, se tenti di accedere al browser dell’archivio sul livello di pubblicazione, devi avere l’accesso (Amministratore AEM o Utente AEM) concesso sul livello di pubblicazione.
Dump/query stato status-dumps-queries
- Un’immagine full text o JSON dello stato corrente di bundle, pacchetti, configurazioni, servizi, componenti, processi sling o definizioni di Oak.
- Utile soprattutto se lo sviluppatore ha rilevato uno stato imprevisto e desidera comunicare o documentare questo stato per altri sviluppatori. Il download dell’immagine fornisce un’istantanea dello stato per riferimento successivo.
Processi Sling
Processi Sling elenca tutte le code dei processi Sling.
I processi Sling facilitano il debug:
+ Elenco delle code di processi Sling e relative configurazioni
+ Fornire informazioni sul numero di processi Sling attivi, in coda ed elaborati, utile per il debug dei problemi relativi ai flussi di lavoro, ai flussi di lavoro transitori e ad altri lavori eseguiti dai processi Sling in AEM.
Definizioni di Oak
Gli indici Oak forniscono un dump dei nodi definiti sotto /oak:index. Tieni presente che questo non mostra gli indici uniti, che si verifica quando viene modificato un indice AEM.
Gli indici di Oak aiutano nel debug:
+ Elenco di tutte le definizioni degli indici di Oak che forniscono informazioni approfondite sull’esecuzione delle query di ricerca in AEM. Tieni presente che le modifiche apportate agli indici AEM non vengono riportate qui. Questa visualizzazione è utile solo per gli indici forniti esclusivamente da AEM o solo dal codice personalizzato.
Strumento Prestazioni query
- Le query forniscono informazioni approfondite su cosa e come vengono eseguite le query di ricerca su AEM.
- Le query funzionano solo quando viene selezionato un pod specifico, poiché apre la console web Prestazioni query del pod, che richiede allo sviluppatore di avere accesso al servizio AEM.
Le query consentono di eseguire il debug mediante:
+ Spiegazione del modo in cui Oak interpreta, analizza ed esegue le query. Questo è molto importante quando si tiene traccia del motivo per cui una query è lenta e si capisce come può essere velocizzata.
+ Elencare le query più popolari in esecuzione in AEM, con la possibilità di spiegarle.
+ Elenco delle query più lente in esecuzione in AEM, con la possibilità di spiegarle.
Ulteriori informazioni sono disponibili qui.