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 ha 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 il
/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 dell’AEM > Strumenti > Distribuzione > Pacchetti
- Da CRXDE Liti utilizzo della barra del commutatore superiore
- Direttamente accedendo a
http://<host>:<port>/crx/packmgr/
Interfaccia utente di Gestione pacchetti ui
Gestione pacchetti è suddiviso in quattro aree funzionali principali:
-
Pannello di navigazione sinistro - Questo pannello consente di filtrare e ordinare l’elenco dei pacchetti.
-
Elenco pacchetti : elenco dei pacchetti nell’istanza filtrati e ordinati per selezioni nel pannello di navigazione a sinistra.
-
Registro attività : questo pannello viene ridotto a icona in un primo momento ed espande per descrivere nel 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 Altro pulsante.
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 per la gestione dei pacchetti, puoi fare clic su un pacchetto e quindi 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.
Il Impostazioni pacchetto è disponibile tramite il Modifica quando creazione o modifica un pacchetto. Dopo aver apportato eventuali modifiche, fai 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. A Definizione filtro specifica le informazioni seguenti:
- Il Percorso directory principale del contenuto da includere
- Regole che includono o escludono nodi specifici sotto il percorso principale
Aggiungere regole utilizzando + pulsante. Rimuovere le regole utilizzando - pulsante.
Le regole vengono applicate in base al loro ordine, in modo da posizionarle come richiesto utilizzando Su e Giù pulsanti freccia.
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 dei filtri, puoi definire un percorso o utilizzare un’espressione regolare per specificare tutti i nodi che desideri includere o escludere.
I filtri dei pacchetti vengono spesso definiti al momento della prima crea il pacchetto. Tuttavia, possono anche essere modificate 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 - AEM deve essere riavviato dopo l’installazione del pacchetto
Sovrascrivere - Sovrascrivi ACL nell’archivio
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
-
Clic 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. -
In Nuovo pacchetto immetti i campi seguenti:
-
Nome pacchetto - Seleziona un nome descrittivo per aiutarti (e altri) a identificare facilmente il contenuto del pacchetto.
-
Versione - Questo è un campo di testo per indicare una versione. Viene aggiunto al nome del pacchetto per formare il nome del file zip.
-
Gruppo : nome del gruppo target (o cartella). 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.
-
-
Clic OK per creare il pacchetto.
-
L’AEM elenca il nuovo pacchetto all’inizio dell’elenco.
-
Clic Modifica per definire contenuto del pacchetto. Clic Salva al termine della modifica delle impostazioni.
-
Ora puoi Genera il tuo pacco.
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 a creare il pacchetto, ma puoi tornare in un secondo momento a 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.
-
Clic Genera. Una finestra di dialogo richiede la conferma che desideri creare il pacchetto poiché tutti i contenuti del pacchetto esistenti verranno sovrascritti.
-
Clic 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.
-
Clic Modifica e aggiorna Impostazioni pacchetto secondo necessità.
-
Clic Salva per salvare.
Potrebbe essere necessario rigenerare 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.
-
Clic Modifica e aggiorna Impostazioni pacchetto secondo necessità.
-
Clic Salva per salvare.
-
Clic Altro > Ripeti adattamento e una finestra di dialogo chiederà 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.
-
Clic Altro > Altre versioni e viene visualizzata 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, fai clic su Altro > Sommario, e Gestione pacchetti elenca l’intero contenuto del pacchetto nel registro attività.
-
Per eseguire l'esecuzione dell'installazione, fare clic su Altro > Installazione di prova e Gestione pacchetti segnalano nel registro attività i risultati 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.
-
Fai clic su Scarica o il 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 Distribuzione di software 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.
-
Fai clic su Carica pacchetto pulsante.
-
Fornisci le informazioni necessarie sul pacchetto caricato.
- Pacchetto - Utilizza il 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.
-
Clic OK e il pacchetto selezionato viene caricato e l’elenco dei pacchetti viene aggiornato di conseguenza.
Il contenuto del pacchetto ora esiste sull’AEM, ma per renderlo disponibile all’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 analizza il pacchetto per tutti i file JAR (bundle OSGi), estrae i manifest.xml (che contiene le dipendenze con versione su cui si basa il bundle OSGi) e verifica che l’istanza AEM esporti tali dipendenze con le versioni corrette.
Come viene segnalato
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 degli errori
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 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 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 degli errori
Per risolvere questo problema, il gestore del file di sovrapposizione in /apps deve rivedere le modifiche apportate al file sovrapposto in /libs e incorpora le modifiche necessarie nella sovrapposizione ( /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.
Come viene segnalato
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 degli errori
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, fai clic su Altro > Convalida,
-
Nella finestra di dialogo modale visualizzata, utilizza 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 type Il parametro può essere qualsiasi elenco non ordinato separato da virgole costituito da:
osgiPackageImportsoverlaysacls
Il valore di type impostazione predefinita 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.
-
Clic 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.
-
Fai clic su Installa nei dettagli dell'elemento o nella Installa nello stato del pacchetto.
-
Una finestra di dialogo richiede conferma e consente di specificare opzioni aggiuntive.
- Solo estrazione - Estrarre il pacchetto solo in modo che non venga creata alcuna istantanea e che quindi non sia possibile disinstallare
- Soglia salvataggio - Numero di nodi transitori fino all'attivazione del salvataggio automatico (aumenta se si verificano eccezioni di modifica simultanea)
- Estrai pacchetti secondari - Abilita estrazione automatica dei pacchetti secondari
- Gestione del controllo degli accessi - Specifica la modalità di gestione delle informazioni di controllo di accesso definite nel pacchetto durante l'installazione del pacchetto (le opzioni sono le stesse del impostazioni avanzate del pacchetto)
- Gestione dipendenze - Specificare come gestire le dipendenze durante l'installazione
-
Clic Installa.
-
Il registro attività descrive l’avanzamento dell’installazione.
Una volta completata e completata l’installazione, l’elenco dei pacchetti viene aggiornato e la parola Installato viene visualizzato nello stato del pacchetto.
Reinstallazione dei pacchetti reinstalling-packages
La reinstallazione dei pacchetti esegue gli stessi passaggi su un pacchetto già installato che vengono elaborati quando 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 dell’AEM è presente
crx-quicksartcartella accanto al file jar elicense.propertiesfile. Crea una cartella denominatainstallincrx-quickstartrisultante nel 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 lo aggiungi al pacchetto install cartella
Se l’istanza non è in esecuzione, i pacchetti inseriti nella install 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.
-
Clic Altro > Disinstalla, per rimuovere il contenuto del pacchetto dall'archivio.
-
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. Clic 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.
-
Clic 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.
Distribuzione di software è un servizio centralizzato progettato per semplificare la ricerca e il download di pacchetti AEM.
Per ulteriori informazioni, vedere Documentazione di Software Distribution.