Come lavorare con i pacchetti how-to-work-with-packages
I pacchetti consentono l'importazione e l'esportazione del contenuto del repository. Ad esempio, puoi utilizzare i pacchetti per installare nuove funzionalità, trasferire contenuti tra le istanze e eseguire il backup del contenuto dell’archivio.
I pacchetti sono accessibili e/o mantenuti dalle pagine seguenti:
-
Gestione pacchetti, che consente di gestire i pacchetti nell’istanza AEM locale.
-
Condivisione pacchetti, un server centralizzato che contiene sia i pacchetti disponibili al pubblico che quelli privati per la tua azienda. I pacchetti pubblici possono contenere hotfix, nuove funzionalità, documentazione, ecc.
Puoi trasferire i pacchetti tra Gestione pacchetti, Condivisione pacchetti e il file system.
Cosa sono i pacchetti? what-are-packages
Un pacchetto è un file zip che tiene il contenuto dell’archivio sotto forma di una serializzazione del file system (chiamata serializzazione "vault"). Questo fornisce una rappresentazione semplice da usare e modificare di file e cartelle.
I pacchetti includono contenuto, sia contenuto di pagina che contenuto relativo al progetto, selezionato utilizzando i filtri.
Un pacchetto contiene anche metadati vault, incluse le definizioni del filtro e le informazioni di configurazione dell'importazione. Nel pacchetto possono essere incluse ulteriori proprietà di contenuto (non utilizzate per l’estrazione del pacchetto), ad esempio una descrizione, un’immagine visiva o un’icona; queste proprietà sono riservate al consumatore del pacchetto di contenuti e solo a scopo informativo.
Puoi eseguire le seguenti azioni su o con i pacchetti:
- Creare nuovi pacchetti; definizione delle impostazioni del pacchetto e dei filtri in base alle esigenze
- Anteprima del contenuto del pacchetto (prima della generazione)
- Creare pacchetti
- Visualizza informazioni sul pacchetto
- Visualizza il contenuto del pacchetto (dopo la creazione)
- Modificare la definizione dei pacchetti esistenti
- Rigenera i pacchetti esistenti
- Riavvolgere i pacchetti
- Scarica i pacchetti da AEM al tuo file system
- Caricare pacchetti dal file system nell'istanza AEM locale
- Convalida il contenuto del pacchetto prima dell’installazione
- Eseguire un'installazione a secco
- Installa i pacchetti (AEM non installa automaticamente i pacchetti dopo il caricamento)
- Elimina pacchetti
- Scarica pacchetti, come hotfix, dalla libreria Condivisione pacchetti
- Carica i pacchetti nella sezione interna dell'azienda della libreria Condivisione pacchetti
Informazioni sul pacchetto package-information
Una definizione del pacchetto è composta da vari tipi di informazioni:
Impostazioni pacchetto package-settings
Puoi modificare diverse impostazioni del pacchetto per definire aspetti quali la descrizione del pacchetto, i bug correlati, le dipendenze e le informazioni sul provider.
La Impostazioni pacchetto la finestra di dialogo è disponibile tramite Modifica quando creazione o modifica un pacchetto e fornisce tre schede per la configurazione. Dopo aver apportato le modifiche, fai clic su OK per salvarli.
Filtri del pacchetto package-filters
I filtri identificano i nodi del repository da includere nel pacchetto. A Definizione del filtro specifica le seguenti informazioni:
- La Percorso radice del contenuto da includere.
- Regole che includono o escludono nodi specifici sotto il percorso principale.
I filtri possono includere zero o più regole. Quando non sono definite regole, il pacchetto contiene tutto il contenuto presente nel 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.
La tabella seguente descrive queste regole e fornisce esempi:
I filtri dei pacchetti sono definiti più spesso al primo momento crea il pacchetto, ma possono essere modificati anche in un secondo momento (dopo di che il pacchetto deve essere ricostruito).
Schermate del pacchetto package-screenshots
Puoi allegare le schermate al pacchetto per fornire una rappresentazione visiva dell’aspetto del contenuto; ad esempio, fornendo schermate di nuove funzionalità.
Icone del pacchetto package-icons
Puoi anche allegare un’icona al pacchetto per fornire una rappresentazione visiva di riferimento rapido di ciò che contiene il pacchetto. Questo viene quindi mostrato nell'elenco dei pacchetti e può aiutarti a identificare facilmente il pacchetto, o la classe del pacchetto.
Poiché un pacchetto può contenere un’icona, le seguenti convenzioni vengono utilizzate per i pacchetti ufficiali:
Pacchetto Hotfix ufficiale:
Pacchetto di installazione o estensione AEM ufficiale:
Feature pack ufficiale:
Gestione pacchetti package-manager
Gestione pacchetti gestisce i pacchetti nell’installazione AEM locale. Dopo aver assegnate le autorizzazioni necessarie puoi utilizzare Gestione pacchetti per diverse azioni, tra cui configurazione, creazione, download e installazione dei pacchetti. Gli elementi chiave da configurare sono:
Autorizzazioni necessarie per l’utilizzo di Gestione pacchetti permissions-needed-for-using-the-package-manager
Per concedere agli utenti il diritto di creare, modificare, caricare e installare pacchetti, devi assegnare loro le autorizzazioni appropriate nelle seguenti posizioni:
- /etc/packages (diritti completi, esclusa la cancellazione)
- il nodo che contiene il contenuto del pacchetto
Vedi Impostazione delle autorizzazioni per istruzioni sulla modifica delle autorizzazioni.
Creazione di un nuovo pacchetto creating-a-new-package
Per creare una nuova definizione di pacchetto:
-
Nella schermata di benvenuto AEM, fai clic su Pacchetti o dal Strumenti console fare doppio clic su Pacchetti).
-
Quindi seleziona Gestione pacchetti.
-
Fai clic su Crea pacchetto.
note note NOTE Se l’istanza dispone di molti pacchetti, potrebbe essere presente una struttura di cartelle, in modo da poter passare alla cartella di destinazione richiesta prima di creare il nuovo pacchetto. -
Nella finestra di dialogo:
Inserisci:
-
Nome gruppo
Nome del gruppo di destinazione (o della cartella). I gruppi sono destinati ad essere utilizzati per organizzare i pacchetti.
Se non esiste già, verrà creata una cartella per il gruppo. Se lasci vuoto il nome del gruppo, verrà creato il pacchetto nell'elenco dei pacchetti principali (Home > Pacchetti).
-
Nome pacchetto
Nome del nuovo pacchetto. Seleziona un nome descrittivo per identificare facilmente il contenuto del pacchetto.
-
Versione
Campo di testo per indicare una versione. Questo verrà aggiunto al nome del pacchetto per formare il nome del file zip.
Fai clic su OK per creare il pacchetto.
-
-
AEM elenca il nuovo pacchetto nella cartella di gruppo appropriata.
Fai clic sull'icona o sul nome del pacchetto da aprire.
note note NOTE Se necessario, puoi tornare a questa pagina in un secondo momento. -
Fai clic su Modifica per modificare impostazioni del pacchetto.
Qui puoi aggiungere informazioni e/o definire determinate impostazioni; ad esempio, includono una descrizione, il icona, bug correlati e aggiungere dettagli sul provider.
Fai clic su OK al termine della modifica delle impostazioni.
-
Aggiungi Schermate al pacchetto come necessario. È disponibile un’istanza quando il pacchetto viene creato, aggiungi di più se necessario utilizzando Schermata del pacchetto dalla barra laterale.
Aggiungi l’immagine effettiva facendo doppio clic sul componente immagine nel Schermate area, aggiunta di un’immagine e clic OK.
-
Definisci la Filtri del pacchetto trascinando le istanze Definizione del filtro dalla barra laterale, fate doppio clic per aprire la modifica:
Specifica:
-
Percorso radice
il contenuto da imballare; può essere la radice di un sottoalbero. -
Regole
Le regole sono facoltative; per le semplici definizioni dei pacchetti, non è necessario specificare regole di inclusione o esclusione.Se necessario, puoi definire Includi o Escludi regole per definire esattamente il contenuto del pacchetto.
Aggiungi regole utilizzando + simbolo, in alternativa rimuovere le regole utilizzando - simbolo. Le regole vengono applicate in base al loro ordine in modo da posizionarle come richiesto utilizzando Su e Giù pulsanti.
Quindi fai clic su OK per salvare il filtro.
note note NOTE È possibile utilizzare tutte le definizioni di filtro necessarie, anche se è necessario fare attenzione a non creare conflitti. Utilizzo Anteprima per confermare quale sarà il contenuto del pacchetto. -
-
Per confermare ciò che il pacchetto contiene, puoi utilizzare Anteprima. Questo esegue una prova del processo di compilazione ed elenca tutti gli elementi che verranno aggiunti al pacchetto quando viene effettivamente generato.
-
Ora puoi Crea il tuo pacchetto.
note note NOTE Non è obbligatorio costruire il pacchetto a questo punto, può essere fatto in un momento successivo.
Creazione di un pacchetto building-a-package
Un pacchetto viene spesso generato contemporaneamente a te crea la definizione del pacchetto, ma puoi tornare in un secondo momento per generare o ricreare il pacchetto. Questo può essere utile se il contenuto all’interno dell’archivio è stato modificato.
-
Apri la definizione del pacchetto da Gestione pacchetti (fai clic sull'icona o sul nome del pacchetto).
-
Fai clic su Crea. Una finestra di dialogo richiede la conferma che desideri creare il pacchetto.
note note NOTE Questo è di particolare importanza quando si sta ricostruendo un pacchetto in quanto il contenuto del pacchetto verrà sovrascritto. -
Fai clic su OK. AEM il pacchetto, elencando tutti i contenuti aggiunti al pacchetto così come lo fa. Quando completato AEM visualizza una conferma della generazione del pacchetto e (quando chiudi la finestra di dialogo) aggiorna le informazioni sull’elenco dei pacchetti.
Ritorno a capo di un pacchetto rewrapping-a-package
Una volta costruito un pacchetto, è possibile riavvolgerlo, se necessario.
Il rewrapping modifica le informazioni del pacchetto - senza modifica del contenuto del pacchetto. Le informazioni sul pacchetto sono la miniatura, la descrizione, ecc., in altre parole tutto ciò che è possibile modificare con il Impostazioni pacchetto (per aprire questo clic) Modifica).
Un caso d'uso importante per il ritorno a capo è quando si prepara un pacchetto per la condivisione del pacchetto. Ad esempio, potresti avere un pacchetto esistente e decidere di condividerlo con altri. Per aggiungere una miniatura e una descrizione. Invece di ricreare l'intero pacchetto con tutte le sue funzionalità (che potrebbero richiedere un po' di tempo e correre il rischio che il pacchetto non sia più identico all'originale) puoi racchiuderlo e aggiungere semplicemente la miniatura e la descrizione.
-
Apri la definizione del pacchetto da Gestione pacchetti (fai clic sull'icona o sul nome del pacchetto).
-
Fai clic su Modifica e aggiorna Impostazioni pacchetto se necessario. Fai clic su OK da salvare.
-
Fai clic su Riavvolgere, viene visualizzata una finestra di dialogo che richiede una conferma.
Visualizzazione e modifica delle informazioni sui pacchetti viewing-and-editing-package-information
Per visualizzare o modificare le informazioni sulla definizione di un pacchetto:
-
In Gestione pacchetti individua il pacchetto da visualizzare.
-
Fai clic sull’icona del pacchetto che desideri visualizzare. Verrà aperta la pagina del pacchetto in cui sono elencate le informazioni sulla definizione del pacchetto:
note note NOTE Puoi anche modificare ed eseguire determinate azioni sul pacchetto da questa pagina. I pulsanti disponibili dipendono dal fatto che il pacchetto sia già stato creato o meno. -
Se il pacchetto è già stato generato, fai clic su Contenuto, viene aperta una finestra in cui sono elencati tutti i contenuti del pacchetto:
Visualizzazione del contenuto del pacchetto e verifica dell’installazione viewing-package-contents-and-testing-installation
Dopo aver creato un pacchetto puoi visualizzarne il contenuto:
-
In Gestione pacchetti individua il pacchetto da visualizzare.
-
Fai clic sull’icona del pacchetto che desideri visualizzare. Verrà aperta la pagina del pacchetto contenente informazioni sulla definizione del pacchetto.
-
Per visualizzare il contenuto, fai clic su Contenuto, viene aperta una finestra in cui sono elencati tutti i contenuti del pacchetto:
-
Per eseguire una prova dell'installazione, fare clic su Installazione di prova. Dopo aver confermato l’azione, viene aperta una finestra in cui sono elencati i risultati come se l’installazione fosse stata eseguita:
Download dei pacchetti nel file system downloading-packages-to-your-file-system
Questa sezione descrive come scaricare un pacchetto da AEM al file system utilizzando Gestione pacchetti.
-
scarica pacchetti da Condivisione pacchetti direttamente nell’istanza AEM locale.
Al momento del download, il pacchetto viene importato nell’archivio, dopodiché puoi installarlo immediatamente nell’istanza locale utilizzando Gestione pacchetti. Questi pacchetti includono hotfix e altri pacchetti condivisi. -
scarica pacchetti da Condivisione pacchetti nel file system.
-
Nella schermata di benvenuto AEM, fai clic su Pacchetti, quindi seleziona Gestione pacchetti.
-
Passa al pacchetto da scaricare.
-
Fare clic sul collegamento formato dal nome del file zip (sottolineato) per il pacchetto che si desidera scaricare; per esempio
export-for-offline.zip.AEM scaricare il pacchetto sul computer (utilizzando una finestra di dialogo standard per il download del browser).
Caricamento dei pacchetti dal file system uploading-packages-from-your-file-system
Il caricamento di un pacchetto consente di caricare un pacchetto dal file system in Gestione pacchetti AEM.
Per caricare un pacchetto:
-
Passa a Gestione pacchetti. Quindi nella cartella del gruppo in cui desideri caricare il pacchetto.
-
Fai clic su Carica pacchetto.
-
File
È possibile digitare direttamente il nome del file oppure utilizzare il Sfoglia… finestra di dialogo per selezionare il pacchetto richiesto dal file system locale (dopo la selezione fare clic su OK).
-
Forza caricamento
Se esiste già un pacchetto con questo nome, puoi fare clic su di esso per forzare il caricamento (e sovrascrivere il pacchetto esistente).
Fai clic su OK in modo che il nuovo pacchetto venga caricato ed elencato nell’elenco Gestione pacchetti .
note note NOTE Per rendere il contenuto disponibile a AEM, assicurati di: installa il pacchetto. -
Convalida dei pacchetti validating-packages
Prima di installare un pacchetto, potrebbe essere utile verificarne il contenuto. Perché i pacchetti possono modificare i file sovrapposti sotto /apps e/o aggiungere, modificare e rimuovere ACL, spesso è utile convalidare queste modifiche prima dell'installazione.
Opzioni di convalida validation-options
Il meccanismo di convalida può controllare le seguenti caratteristiche del pacchetto:
- Importazioni dei pacchetti OSGi
- Sovrapposizioni
- ACL
Queste opzioni sono descritte di seguito.
-
Convalida importazioni di pacchetti OSGi
Elementi controllati
Questa convalida esamina il pacchetto per tutti i file JAR (bundle OSGi), ne estrae
manifest.xml(che contiene le dipendenze con versione su cui si basa il bundle OSGi) e verifica le esportazioni dell'istanza AEM con le versioni corrette.Come viene segnalato
Tutte le dipendenze con versione che non possono essere soddisfatte dall'istanza AEM sono elencate nella Registro attività della Gestione pacchetti.
Stati di errore
Se le dipendenze non sono soddisfatte, i bundle OSGi nel pacchetto con quelle dipendenze non si avvieranno. Questo si traduce in un'implementazione non funzionante, in quanto tutto ciò che si basa sul bundle OSGi non avviato non funzionerà a sua volta correttamente.
Risoluzione degli errori
Per risolvere gli errori dovuti ai bundle OSGi non soddisfatti, è necessario modificare la versione della dipendenza nel bundle con importazioni non soddisfatte.
-
Convalida sovrapposizioni
Elementi controllati
Questa convalida determina se il pacchetto installato contiene un file già sovrapposto nell'istanza AEM di destinazione.
Ad esempio, se hai impostato una sovrapposizione esistente in
/apps/sling/servlet/errorhandler/404.jsp, un pacchetto che contiene/libs/sling/servlet/errorhandler/404.jsp, in modo da modificare il file esistente in/libs/sling/servlet/errorhandler/404.jsp.Come viene segnalato
Tali sovrapposizioni sono descritte nella sezione Registro attività della 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 sostituite (e quindi "nascoste") dalla sovrapposizione e non avranno effetto.
Risoluzione degli errori
Per risolvere questo problema, il gestore del del file di sovrapposizione in
/appsdeve esaminare le modifiche apportate al file sovrapposto in/libse incorpora le modifiche necessarie nella sovrapposizione (/apps) e ridistribuisci il file sovrapposto.note note NOTE Il meccanismo di convalida non consente di eseguire la riconciliazione se il contenuto sovrapposto è stato correttamente incorporato nel file di sovrapposizione. Pertanto questa convalida continuerà a segnalare i conflitti anche dopo aver apportato le modifiche necessarie. -
Convalida ACL
Elementi controllati
Questa convalida verifica quali autorizzazioni vengono aggiunte, come verranno gestite (unione/sostituzione) e se le autorizzazioni correnti saranno interessate.
Come viene segnalato
Le autorizzazioni sono descritte nella sezione Registro attività della Gestione pacchetti.
Stati di errore
Non è possibile fornire errori espliciti. La convalida indica semplicemente se eventuali nuove autorizzazioni ACL verranno aggiunte o influenzate dall'installazione del pacchetto.
Risoluzione degli errori
Utilizzando le informazioni fornite dalla convalida, i nodi interessati possono essere rivisti in CRXDE e le ACL possono essere regolate nel pacchetto come necessario.
note caution CAUTION Come best practice, si consiglia di non influenzare gli ACL forniti da AEM, in quanto ciò potrebbe causare un comportamento imprevisto del prodotto.
Esecuzione della convalida performing-validation
La convalida dei pacchetti può essere eseguita in due modi diversi:
- Tramite l’interfaccia utente di Gestione pacchetti
- Tramite richiesta HTTP POST, ad esempio con cURL
Convalida del pacchetto tramite Gestione pacchetti
-
Apri Gestione pacchetti in
https://<server>:<port>/crx/packmgr -
Seleziona il pacchetto nell’elenco, quindi seleziona Altro dall’intestazione e quindi Convalida dal menu a discesa.
note note NOTE Questa operazione deve essere eseguita dopo il caricamento del pacchetto di contenuti, ma prima di installare il pacchetto. -
Nella finestra di dialogo modale visualizzata, utilizzare le caselle di controllo per selezionare i tipi di convalida e iniziare la convalida facendo clic su Convalida. In alternativa, fai clic su Annulla.
-
Vengono quindi eseguite le convalide selezionate. I risultati vengono visualizzati nel registro attività di Gestione pacchetti.
Convalida Del Pacchetto Tramite Richiesta HTTP POST
La richiesta di POST si presenta come segue.
https://<host>:<port>/crx/packmgr/service.jsp?cmd=validate&type=osgiPackageImports,overlays,acls
type può essere un qualsiasi elenco non ordinato separato da virgole composto da:osgiPackageImportsoverlaysacls
type impostazioni predefinite osgiPackageImports se non è passato.Di seguito è riportato un esempio di utilizzo di cURL per eseguire una convalida del pacchetto.
-
Se utilizzi cURL, esegui un’istruzione simile alla seguente:
code language-shell 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' -
La convalida richiesta viene eseguita e la risposta viene inviata nuovamente come oggetto JSON.
Installazione dei pacchetti installing-packages
Dopo aver caricato un pacchetto, devi installare il contenuto. Per avere installato e funzionante il contenuto del pacchetto, è necessario che sia:
-
caricato in AEM (o caricato dal file system o scaricato da Package Share)
-
installato
-
Esegui un'installazione di prova del pacchetto senza modificare nessuno dei contenuti:
Apri il pacchetto (fai clic sull'icona o sul nome del pacchetto) e fai clic su Test installazione. -
Vedi un elenco dei contenuti del pacchetto:
Apri il pacchetto e fai clic su Contenuto.
-
Per prima cosa, disattiva WorkflowLauncher.
Per disattivare, utilizza l’opzione di menu Componenti della console OSGicom.day.cq.workflow.launcher.impl.WorkflowLauncherImpl. -
Al termine dell’installazione, riattiva WorkflowLauncher.
-
In Gestione pacchetti individua il pacchetto da installare.
Un Installa viene visualizzato sul lato dei pacchetti non ancora installati.
note note NOTE In alternativa, puoi aprire il pacchetto facendo clic sulla relativa icona per accedere al Installa pulsante lì. -
Fai clic su Installa per avviare l'installazione. Viene visualizzata una finestra di dialogo per richiedere conferma ed elencare tutte le modifiche in corso. Al termine, fai clic su Chiudi nella finestra di dialogo.
La parola Installato viene visualizzato accanto al pacchetto dopo l'installazione.
Caricamento e installazione basati su file system file-system-based-upload-and-installation
Esiste un modo alternativo per caricare e installare i pacchetti nell’istanza. Nel tuo file system hai crx-quicksart accanto al tuo jar e license.properties file. È necessario creare una cartella denominata install sotto crx-quickstart. Avrete quindi qualcosa come questo: <aem_home>/crx-quickstart/install
In questa cartella di installazione, puoi aggiungere direttamente i tuoi pacchetti. Vengono caricati e installati automaticamente nell’istanza. Al termine, puoi visualizzare i pacchetti in Gestione pacchetti.
Se l'istanza è in esecuzione, aggiungi un pacchetto al install avvierà direttamente il caricamento e l’installazione sull’istanza. Se la tua istanza non è in esecuzione, i pacchetti inseriti nella install La cartella verrà installata all'avvio in ordine alfabetico.
crx-quickstart creare manualmente la cartella install sotto la cartella e mettere i pacchetti lì. Quindi, quando avvii la tua istanza per la prima volta, i pacchetti verranno installati in ordine alfabetico.Disinstallazione dei pacchetti uninstalling-packages
AEM consente di disinstallare i pacchetti. Questa azione ripristina il contenuto dell’archivio interessato allo snapshot effettuato immediatamente prima dell’installazione del pacchetto.
- In Gestione pacchetti individua il pacchetto da disinstallare.
- Fai clic sull'icona del pacchetto da disinstallare.
- Fai clic su Disinstalla per rimuovere il contenuto di questo pacchetto dall'archivio. Viene visualizzata una finestra di dialogo per richiedere conferma ed elencare tutte le modifiche in corso. Al termine, fai clic su Chiudi nella finestra di dialogo.
Eliminazione dei pacchetti deleting-packages
Per eliminare un pacchetto dall’elenco Gestione pacchetti:
-
In Strumenti espandi la console Pacchetti per visualizzare il pacchetto nel riquadro di destra.
-
Fai clic sul pacchetto da eliminare in modo che sia evidenziato e quindi:
- Fai clic su Elimina nel menu della barra degli strumenti.
- Fai clic con il pulsante destro del mouse e seleziona Elimina.
-
AEM richiede la conferma di voler eliminare il pacchetto. Fai clic su OK per confermare l’eliminazione.
Replica dei pacchetti replicating-packages
Replicare il contenuto di un pacchetto per installarlo nell'istanza di pubblicazione:
-
In Gestione pacchetti, individua il pacchetto da replicare.
-
Fai clic sull’icona o sul nome del pacchetto da replicare per espanderlo.
-
In Altro menu a discesa sulla barra degli strumenti, seleziona Replicare.
Condivisione pacchetti package-share
Package Share era un server centralizzato reso disponibile pubblicamente per la condivisione di pacchetti di contenuti.
È stato sostituito da Distribuzione di software.
Distribuzione di software software-distribution
Distribuzione di software è la nuova interfaccia utente progettata per semplificare la ricerca e il download di pacchetti AEM.
Per ulteriori informazioni, consulta la sezione Documentazione sulla distribuzione software.