Gestione pacchetti working-with-packages
I pacchetti consentono l'importazione e l'esportazione del contenuto del repository. È possibile utilizzare i pacchetti per installare nuovi contenuti, installare nuove funzionalità, trasferire contenuti tra le istanze ed eseguire il backup del contenuto del repository.
Gestione pacchetti consente di trasferire i pacchetti tra l’istanza AEM e il file system locale a scopo di sviluppo.
Cosa sono i pacchetti? what-are-packages
Un pacchetto è un file zip che contiene il contenuto dell’archivio in un modulo di serializzazione del file system, denominato serializzazione dell’archivio, e fornisce una rappresentazione di file e cartelle facile da usare e da modificare. Il contenuto incluso nel pacchetto viene definito utilizzando i filtri.
Un pacchetto contiene anche metainformazioni di Vault, tra cui le definizioni dei filtri e le informazioni di configurazione dell’importazione. Nel pacchetto possono essere incluse proprietà di contenuto aggiuntive, non utilizzate per l’estrazione del pacchetto, ad esempio una descrizione, un’immagine visiva o un’icona. Queste proprietà di contenuto aggiuntive sono destinate al consumatore del pacchetto di contenuti e solo a scopo informativo.
Gestione pacchetti package-manager
Gestione pacchetti gestisce i pacchetti nell’installazione AEM. Dopo aver assegnato le autorizzazioni necessarie, puoi utilizzare Gestione pacchetti per varie azioni, tra cui la configurazione, la creazione, il download e l'installazione dei pacchetti.
Autorizzazioni richieste required-permissions
Per creare, modificare, caricare e installare pacchetti, gli utenti devono disporre delle autorizzazioni appropriate per i seguenti nodi:
- Diritti completi esclusa eliminazione su
/etc/packages - Nodo che contiene il contenuto del pacchetto
Accesso a Gestione pacchetti accessing
È possibile accedere a Gestione pacchetti in tre modi:
- Dal menu principale AEM > Strumenti > Distribuzione > Pacchetti
- Da CRXDE Liti utilizzando la barra del commutatore superiore
- Accedendo direttamente a
http://<host>:<port>/crx/packmgr/
Interfaccia utente di Gestione pacchetti ui
Gestione pacchetti è suddiviso in quattro aree funzionali principali:
-
Pannello di navigazione sinistro - Consente di filtrare e ordinare l'elenco dei pacchetti.
-
Elenco pacchetti: questo è l'elenco dei pacchetti nell'istanza filtrati e ordinati in base alle selezioni effettuate nel pannello di navigazione a sinistra.
-
Registro attività - Questo pannello viene ridotto a icona e si espande per descrivere in dettaglio l'attività di Gestione pacchetti, ad esempio quando un pacchetto viene generato o installato. Nella scheda Registro attività sono disponibili pulsanti aggiuntivi per:
- Cancella registro
- Mostra/Nascondi
-
Barra degli strumenti - La barra degli strumenti contiene i pulsanti di aggiornamento per il pannello di navigazione sinistro e l'elenco dei pacchetti, nonché i pulsanti per la ricerca, la creazione e il caricamento dei pacchetti.
Facendo clic su un’opzione nel pannello di navigazione a sinistra, l’elenco dei pacchetti viene filtrato immediatamente.
Se si fa clic sul nome di un pacchetto, la voce nell'elenco dei pacchetti viene espansa per visualizzare ulteriori dettagli sul pacchetto.
È possibile eseguire diverse azioni su un pacchetto tramite i pulsanti della barra degli strumenti disponibili quando i dettagli del pacchetto vengono espansi.
Ulteriori azioni sono disponibili sotto il pulsante Altro.
Stato pacchetto package-status
Ogni voce nell'elenco dei pacchetti dispone di un indicatore di stato che consente di conoscere immediatamente lo stato del pacchetto. Passando il puntatore del mouse sullo stato viene visualizzata una descrizione con i dettagli dello stato.
Se il pacchetto è stato modificato o non è mai stato creato, lo stato viene presentato come un collegamento per eseguire un’azione rapida di ricostruzione o installazione del pacchetto.
Impostazioni pacchetto package-settings
Un pacchetto è essenzialmente un set di filtri e i dati dell’archivio basati su tali filtri. Utilizzando l'interfaccia utente Gestione pacchetti, puoi fare clic su un pacchetto e quindi sul pulsante Modifica per visualizzare i dettagli di un pacchetto, incluse le impostazioni seguenti.
Impostazioni generali general-settings
È possibile modificare diverse impostazioni del pacchetto per definire informazioni quali la descrizione del pacchetto, le dipendenze e i dettagli del provider.
La finestra di dialogo Impostazioni pacchetto è disponibile tramite il pulsante Modifica durante la creazione o la modifica di un pacchetto. Dopo aver apportato le modifiche, fare clic su Salva.
Miniature pacchetto thumbnails
Una miniatura fornisce una rappresentazione visiva di riferimento rapido di ciò che contiene il pacchetto. Questo viene quindi mostrato nell’elenco dei pacchetti e può aiutare a identificare facilmente il pacchetto o la classe del pacchetto.
Di seguito sono riportati alcuni esempi di convenzioni utilizzate per i colli ufficiali:
Hotfix ufficiale
Installazione ufficiale dell’estensione per AEM
Service Pack ufficiale
Utilizza un’icona univoca per il pacchetto. Non riutilizzare un'icona utilizzata da Adobe.
Filtri per pacchetti package-filters
I filtri identificano i nodi dell’archivio da includere nel pacchetto. Una definizione filtro specifica le informazioni seguenti:
- Il percorso principale del contenuto da includere
- Regole che includono o escludono nodi specifici sotto il percorso principale
Aggiungere regole utilizzando il pulsante +. Rimuovere le regole utilizzando il pulsante -.
Le regole vengono applicate in base al loro ordine, quindi posizionale come richiesto utilizzando i pulsanti freccia Su e Giù.
I filtri possono includere zero o più regole. Se non sono definite regole, il pacchetto contiene tutto il contenuto sotto il percorso principale.
Puoi definire una o più definizioni di filtro per un pacchetto. Utilizza più di un filtro per includere il contenuto di più percorsi principali.
Durante la creazione di regole, viene definita un'espressione regolare (nota anche come espressione regex, regexp o razionale) per specificare tutti i nodi che si desidera includere o escludere.
I filtri dei pacchetti vengono spesso definiti al momento della creazione del pacchetto . Tuttavia, è anche possibile modificarli in un secondo momento, dopodiché il pacchetto deve essere ricompilato per aggiornarne il contenuto in base alle nuove definizioni di filtro.
Dipendenze dependencies
6.5groupId:name:versiongroupId:name:versionImpostazioni avanzate advanced-settings
WKND Media Grouphttps://wknd.sitehttps://wknd.site/package/Riavvia - È necessario riavviare AEM dopo l'installazione del pacchetto
Sovrascrivi - Sovrascrivi ACL nel repository
Unisci - Unisci entrambi i set di ACL
MergePreserve - Unisci il controllo di accesso nel contenuto con quello fornito con il pacchetto aggiungendo le voci di controllo di accesso delle entità non presenti nel contenuto
Cancella - Cancella ACL
Schermate del pacchetto package-screenshots
Puoi allegare più schermate al pacchetto per fornire una rappresentazione visiva di come viene visualizzato il contenuto.
Azioni pacchetto package-actions
È possibile eseguire molte azioni su un pacchetto.
Creazione di un pacchetto creating-a-new-package
-
Fare clic su Crea pacchetto.
note tip TIP Se l’istanza dispone di molti pacchetti, potrebbe essere presente una struttura di cartelle. In questi casi, è più facile passare alla cartella di destinazione richiesta prima di creare il nuovo pacchetto. -
Nella finestra di dialogo Nuovo pacchetto, immetti i campi seguenti:
-
Nome pacchetto - Selezionare un nome descrittivo che consenta di identificare facilmente il contenuto del pacchetto.
-
Versione - Campo di testo per indicare una versione. Viene aggiunto al nome del pacchetto per formare il nome del file zip.
-
Gruppo - Nome gruppo (o cartella) di destinazione. I gruppi consentono di organizzare i pacchetti. Se non esiste già, viene creata una cartella per il gruppo. Se si lascia vuoto il nome del gruppo, il pacchetto verrà creato nell'elenco dei pacchetti principale.
-
-
Fare clic su OK per creare il pacchetto.
-
L’AEM elenca il nuovo pacchetto all’inizio dell’elenco.
-
Fai clic su Modifica per definire il contenuto del pacchetto. Fare clic su Salva al termine della modifica delle impostazioni.
-
Ora puoi Generare il tuo pacchetto.
Non è obbligatorio costruire immediatamente il pacchetto dopo averlo creato. Un pacchetto non generato non contiene alcun contenuto ed è costituito solo dai dati del filtro e da altri metadati del pacchetto.
Creazione di un pacchetto building-a-package
Un pacchetto viene spesso creato contemporaneamente alla creazione del pacchetto, ma è possibile tornare in un secondo momento per generare o ricreare il pacchetto. Questo può essere utile se il contenuto all’interno dell’archivio è stato modificato o i filtri del pacchetto sono stati modificati.
-
Aprire i dettagli del package dall'elenco dei package facendo clic sul nome del package.
-
Fare clic su Build. Una finestra di dialogo richiede la conferma che desideri creare il pacchetto poiché tutti i contenuti del pacchetto esistenti verranno sovrascritti.
-
Fare clic su OK. L’AEM crea il pacchetto, elencando tutti i contenuti aggiunti al pacchetto così come fanno nell’elenco delle attività. Una volta completato AEM, viene visualizzata una conferma che il pacchetto è stato creato e, quando si chiude la finestra di dialogo, vengono aggiornate le informazioni sull’elenco dei pacchetti.
Modifica di un pacchetto edit-package
Una volta caricato un pacchetto in AEM, puoi modificarne le impostazioni.
-
Aprire i dettagli del package dall'elenco dei package facendo clic sul nome del package.
-
Fai clic su Modifica e aggiorna le Impostazioni pacchetto come richiesto.
-
Fai clic su Salva per salvare.
Potrebbe essere necessario ricompilare il pacchetto per aggiornarne il contenuto in base alle modifiche apportate.
Ripetizione del wrapping di un pacchetto rewrapping-a-package
Una volta creato un pacchetto, è possibile eseguirne il rewrapping. Il ritorno a capo determina la modifica delle informazioni del pacchetto senza anteprime, descrizioni e così via, senza modificare il contenuto del pacchetto.
-
Aprire i dettagli del package dall'elenco dei package facendo clic sul nome del package.
-
Fai clic su Modifica e aggiorna le Impostazioni pacchetto come richiesto.
-
Fai clic su Salva per salvare.
-
Fai clic su Altro > Ripeti adattamento. Verrà visualizzata una finestra di dialogo in cui verrà richiesta la conferma.
Visualizzazione di altre versioni del pacchetto other-versions
Poiché ogni versione di un pacchetto viene visualizzata nell'elenco come qualsiasi altro pacchetto, Gestione pacchetti può trovare altre versioni di un pacchetto selezionato.
-
Aprire i dettagli del package dall'elenco dei package facendo clic sul nome del package.
-
Fai clic su Altro > Altre versioni per aprire una finestra di dialogo con un elenco di altre versioni dello stesso pacchetto con informazioni sullo stato.
Visualizzazione del contenuto del pacchetto e verifica dell’installazione viewing-package-contents-and-testing-installation
Dopo aver generato un pacchetto, puoi visualizzarne il contenuto.
-
Aprire i dettagli del package dall'elenco dei package facendo clic sul nome del package.
-
Per visualizzare il contenuto, fare clic su Altro > Contenuto e Gestione pacchetti elenca l'intero contenuto del pacchetto nel registro attività.
-
Per eseguire un'esecuzione di prova dell'installazione, fare clic su Altro > Installazione test e sui report Gestione pacchetti nel registro attività. I risultati verranno visualizzati come se l'installazione fosse stata eseguita.
Download dei pacchetti nel file system downloading-packages-to-your-file-system
-
Aprire i dettagli del package dall'elenco dei package facendo clic sul nome del package.
-
Fare clic sul pulsante Scarica o sul nome del file collegato del pacchetto nell'area dei dettagli del pacchetto.
-
AEM scarica il pacchetto sul computer.
Condivisione di un pacchetto share
Package Share era un servizio pubblico centralizzato per la distribuzione di pacchetti di contenuti. Package Share è stato sostituito da Software Distribution e questo pulsante non funziona più.
Caricamento di pacchetti dal file system uploading-packages-from-your-file-system
-
Selezionare la cartella del gruppo in cui si desidera caricare il pacchetto.
-
Fare clic sul pulsante Carica pacchetto.
-
Fornisci le informazioni necessarie sul pacchetto caricato.
- Pacchetto - Utilizza il pulsante Sfoglia… per selezionare il pacchetto richiesto dal file system locale.
- Forza caricamento - Se esiste già un pacchetto con questo nome, questa opzione forza il caricamento e sovrascrive il pacchetto esistente.
-
Fare clic su OK e il pacchetto selezionato viene caricato e l'elenco dei pacchetti viene aggiornato di conseguenza.
Il contenuto del pacchetto esiste ora in AEM, ma per renderlo disponibile per l'uso, assicurati di installare il pacchetto.
Convalida dei pacchetti validating-packages
Poiché i pacchetti possono modificare il contenuto esistente, spesso è utile convalidare queste modifiche prima di installarle.
Opzioni di convalida validation-options
Gestione pacchetti può eseguire le convalide seguenti:
Convalida importazioni di pacchetti OSGi osgi-package-imports
Elementi controllati
Questa convalida esamina il pacchetto per tutti i file JAR (bundle OSGi), estrae i relativi manifest.xml (che contengono le dipendenze con versione su cui si basa il bundle OSGi) e verifica che l’istanza AEM esporti tali dipendenze con le versioni corrette.
Modalità di segnalazione
Tutte le dipendenze con versione che non possono essere soddisfatte dall’istanza AEM sono elencate nel registro attività di Gestione pacchetti.
Stati di errore
Se le dipendenze non sono soddisfatte, i bundle OSGi nel pacchetto con tali dipendenze non verranno avviati. Questo si traduce in una distribuzione dell’applicazione interrotta, poiché qualsiasi cosa che si basi sul bundle OSGi non avviato a sua volta non funzionerà correttamente.
Risoluzione errore
Per risolvere gli errori dovuti a bundle OSGi non soddisfatti, è necessario regolare la versione della dipendenza nel bundle con importazioni non soddisfatte.
Convalida sovrapposizioni overlays
Elementi controllati
Questa convalida determina se il pacchetto da installare contiene un file già sovrapposto nell’istanza AEM di destinazione.
Ad esempio, data una sovrapposizione esistente in /apps/sling/servlet/errorhandler/404.jsp, un pacchetto contenente /libs/sling/servlet/errorhandler/404.jsp, tale da modificare il file esistente in /libs/sling/servlet/errorhandler/404.jsp.
Modalità di segnalazione
Tali sovrapposizioni sono descritte nel registro attività di Gestione pacchetti.
Stati di errore
Uno stato di errore indica che il pacchetto sta tentando di distribuire un file già sovrapposto, pertanto le modifiche nel pacchetto verranno ignorate (e quindi "nascoste") dalla sovrapposizione e non avranno effetto.
Risoluzione errore
Per risolvere il problema, il gestore del file di sovrapposizione in /apps deve rivedere le modifiche apportate al file sovrapposto in /libs, incorporarle in base alle esigenze ( /apps) e ridistribuire il file sovrapposto.
Convalida ACL acls
Elementi controllati
Questa convalida controlla quali autorizzazioni vengono aggiunte, come verranno gestite (unione/sostituzione) e se le autorizzazioni correnti saranno interessate.
Modalità di segnalazione
Le autorizzazioni sono descritte nel registro attività di Gestione pacchetti.
Stati di errore
Non è possibile fornire errori espliciti. La convalida indica semplicemente se l’installazione del pacchetto interesserà o aggiungerà nuove autorizzazioni ACL.
Risoluzione errore
Utilizzando le informazioni fornite dalla convalida, i nodi interessati possono essere esaminati in CRXDE e gli ACL possono essere regolati nel pacchetto in base alle esigenze.
Esecuzione della convalida performing-validation
La convalida dei pacchetti può essere eseguita in due modi diversi:
La convalida deve sempre avvenire dopo il caricamento del pacchetto, ma prima della sua installazione.
Convalida Dei Pacchetti Tramite Gestione Pacchetti via-package-manager
-
Aprire i dettagli del package dall'elenco dei package facendo clic sul nome del package.
-
Per convalidare il pacchetto, fare clic su Altro > Convalida,
-
Nella finestra di dialogo modale visualizzata, utilizzare le caselle di controllo per selezionare il tipo o i tipi di convalida e avviare la convalida facendo clic su Convalida.
-
Le convalide scelte vengono quindi eseguite e i risultati vengono visualizzati nel registro attività di Gestione pacchetti.
Convalida del pacchetto tramite richiesta HTTP POST via-post-request
La richiesta POST ha il seguente formato.
https://<host>:<port>/crx/packmgr/service.jsp?cmd=validate&type=osgiPackageImports,overlays,acls
Il parametro type può essere qualsiasi elenco non ordinato separato da virgole costituito da:
osgiPackageImportsoverlaysacls
Il valore di type viene impostato automaticamente su osgiPackageImports se non passato in modo esplicito.
Quando si utilizza cURL, eseguire un'istruzione simile alla seguente:
curl -v -X POST --user admin:admin -F file=@/Users/SomeGuy/Desktop/core.wcm.components.all-1.1.0.zip 'http://localhost:4502/crx/packmgr/service.jsp?cmd=validate&type=osgiPackageImports,overlays,acls'
Durante la convalida tramite richiesta POST, la risposta viene inviata nuovamente come oggetto JSON.
Visualizzazione della copertura del pacchetto package-coverage
I pacchetti sono definiti dai relativi filtri. In Gestione pacchetti puoi applicare i filtri di un pacchetto al contenuto dell’archivio esistente per mostrare quale contenuto dell’archivio è coperto dalla definizione del filtro del pacchetto.
-
Aprire i dettagli del package dall'elenco dei package facendo clic sul nome del package.
-
Fai clic su Altro > Copertura.
-
I dettagli della copertura sono elencati nel registro attività.
Installazione dei pacchetti installing-packages
Il caricamento di un pacchetto aggiunge solo il contenuto del pacchetto all’archivio, ma non è accessibile. Installa il pacchetto caricato per utilizzare il contenuto del pacchetto.
Prima dell’installazione del pacchetto, Gestione pacchetti crea automaticamente un pacchetto di istantanee contenente il contenuto che verrà sovrascritto. Questa istantanea verrà reinstallata se disinstalli il pacchetto.
- Se stai installando risorse digitali, devi:
Innanzitutto, disattiva WorkflowLauncher.
Utilizza l’opzione del menu Componenti della console OSGi per disattivarecom.day.cq.workflow.launcher.impl.WorkflowLauncherImpl. - Al termine dell’installazione, riattiva WorkflowLauncher.
-
Aprire i dettagli del pacchetto che si desidera installare dall'elenco dei pacchetti facendo clic sul nome del pacchetto.
-
Fare clic sul pulsante Installa nei dettagli dell'elemento o sul collegamento Installa nello stato del pacchetto.
-
Una finestra di dialogo richiede conferma e consente di specificare opzioni aggiuntive.
- Estrai solo - Estrai il pacchetto solo in modo che non venga creata alcuna copia istantanea e pertanto non sarà possibile disinstallarlo
- Soglia salvataggio - Numero di nodi transitori fino all'attivazione del salvataggio automatico (aumenta se si verificano eccezioni di modifica simultanee)
- Estrai pacchetti secondari - Abilita estrazione automatica dei pacchetti secondari
- Gestione controllo accesso - Specifica la modalità di gestione delle informazioni di controllo accesso definite nel pacchetto durante l'installazione del pacchetto (le opzioni sono le stesse delle impostazioni avanzate del pacchetto)
- Gestione dipendenze - Specificare come gestire le dipendenze durante l'installazione
-
Fare clic su Installa.
-
Il registro attività descrive l’avanzamento dell’installazione.
Una volta completata e completata l'installazione, l'elenco dei pacchetti viene aggiornato e nello stato del pacchetto viene visualizzata la parola Installed.
Reinstallazione dei pacchetti reinstalling-packages
La reinstallazione dei pacchetti esegue gli stessi passaggi in un pacchetto già installato elaborato durante l'installazione iniziale del pacchetto .
Caricamento e installazione basati su file system file-system-based-upload-and-installation
Durante l’installazione dei pacchetti, puoi rinunciare completamente a Gestione pacchetti. L’AEM può rilevare i pacchetti posizionati in una posizione specifica sul file system locale del computer host e caricarli e installarli automaticamente.
-
Nella cartella di installazione AEM è presente una cartella
crx-quicksartaccanto al file jar e al filelicense.properties. Creare una cartella denominatainstallincrx-quickstartcon il percorso<aem-home>/crx-quickstart/install. -
In questa cartella, aggiungi i pacchetti. Verranno caricati e installati automaticamente nell’istanza.
-
Una volta completato il caricamento e l’installazione, puoi visualizzare i pacchetti in Gestione pacchetti come se avessi utilizzato l’interfaccia utente di Gestione pacchetti per installarli.
Se l'istanza è in esecuzione, il caricamento e l'installazione iniziano immediatamente quando vengono aggiunti al pacchetto nella cartella install
Se l'istanza non è in esecuzione, i pacchetti inseriti nella cartella install vengono installati all'avvio in ordine alfabetico.
Disinstallazione dei pacchetti uninstalling-packages
La disinstallazione del pacchetto ripristina il contenuto dell’archivio allo snapshot creato automaticamente da Gestione pacchetti prima dell’installazione.
-
Aprire i dettagli del pacchetto che si desidera disinstallare dall'elenco dei pacchetti facendo clic sul nome del pacchetto.
-
Fare clic su Altro > Disinstalla per rimuovere il contenuto del pacchetto dal repository.
-
Una finestra di dialogo richiede conferma ed elenca tutte le modifiche apportate.
-
Il pacchetto viene rimosso e viene applicata l’istantanea. L’avanzamento del processo è indicato nel registro attività.
Eliminazione dei pacchetti deleting-packages
L’eliminazione di un pacchetto comporta solo l’eliminazione dei relativi dettagli da Gestione pacchetti. Se il pacchetto è già stato installato, il contenuto installato non verrà eliminato.
-
Aprire i dettagli del package che si desidera eliminare dall'elenco dei package facendo clic sul nome del package.
-
Gestione pacchetti richiede la conferma dell’eliminazione del pacchetto. Fai clic su OK per confermare l'eliminazione.
-
Le informazioni del pacchetto vengono eliminate e i dettagli vengono riportati nel registro attività.
Replica dei pacchetti replicating-packages
Replica il contenuto di un pacchetto per installarlo nell’istanza Publish.
-
Aprire i dettagli del package che si desidera replicare dall'elenco dei package facendo clic sul nome del package.
-
Fai clic su Altro > Replica.
-
Il pacchetto viene replicato e i dettagli vengono riportati nel registro attività.
Distribuzione di software software-distribution
I pacchetti AEM possono essere utilizzati per creare e condividere contenuti tra gli ambienti AEM.
Software Distribution è un servizio centralizzato progettato per semplificare la ricerca e il download di pacchetti AEM.
Per ulteriori informazioni, vedere la documentazione sulla distribuzione software.