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, 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.

Pacchetti in AEM as a Cloud Service aemaacs-packages

I pacchetti di contenuti creati per le applicazioni AEM as a Cloud Service devono avere una netta separazione tra contenuto immutabile e contenuto mutabile. Pertanto Gestione pacchetti può essere utilizzato solo per gestire i pacchetti contenenti contenuto. Qualsiasi codice deve essere distribuito tramite Cloud Manager.

Per ulteriori dettagli su come gestire i pacchetti per AEMaaCS, vedi Distribuzione in AEM as a Cloud Service nella guida utente per la distribuzione.

Dimensione pacchetto package-size

L’Adobe consiglia di non creare pacchetti di grandi dimensioni. In questo modo si evitano problemi di timeout durante il caricamento e il download dei pacchetti.

Come regola generale, un pacchetto deve essere trasmesso per intero entro 60 secondi. In questo modo viene fornita la formula seguente come guida.

MaxPackageSize (in MB) = ConnectionSpeed (in MB/s) * 60 s

Poiché il traffico di rete è variabile ed è sempre inferiore al valore teorico massimo annunciato, provare a utilizzare uno strumento di prova della velocità della connessione Internet in linea.

La velocità di Internet è quasi sempre diversa per caricamenti e download. Supponendo che sia necessario caricare e scaricare i pacchetti, nel calcolo devi utilizzare il valore più basso (solitamente la velocità di caricamento).

Esempio example

Utilizzando uno strumento di test della velocità Internet, vedo che la mia attuale velocità di caricamento è di circa 100 Mbps.

100 Mbps = 12.5 MB/s
12.5 MB/s * 60 s = 750 MB

Quindi tutti i pacchetti che creo dovrebbero essere più piccoli di 750 MB.

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:

Accesso a Gestione pacchetti accessing

È possibile accedere a Gestione pacchetti in tre modi:

Interfaccia utente di Gestione pacchetti ui

Gestione pacchetti è suddiviso in quattro aree funzionali principali:

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.

Filtri per pacchetti package-filters

I filtri identificano i nodi dell’archivio da includere nel pacchetto. Una definizione filtro specifica le informazioni seguenti:

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

Impostazioni avanzate advanced-settings

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

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.

Modifica di un pacchetto edit-package

Una volta caricato un pacchetto in AEM, puoi modificarne le impostazioni.

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.

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.

Visualizzazione del contenuto del pacchetto e verifica dell’installazione viewing-package-contents-and-testing-installation

Dopo aver generato un pacchetto, puoi visualizzarne il contenuto.

Download dei pacchetti nel file system downloading-packages-to-your-file-system

Caricamento di pacchetti dal file system uploading-packages-from-your-file-system

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 vengono gestite (unione/sostituzione) e se sono interessate le autorizzazioni correnti.

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 comporta l’aggiunta o l’impatto di 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

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:

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.

Installazione dei pacchetti installing-packages

Il caricamento di un pacchetto aggiunge solo il contenuto del pacchetto all’archivio, ma non è accessibile. Per utilizzare il contenuto del pacchetto è necessario installare il pacchetto caricato.

Prima dell’installazione del pacchetto, Gestione pacchetti crea automaticamente un pacchetto di istantanee contenente il contenuto sovrascritto. Questa istantanea viene reinstallata se si disinstalla il pacchetto.

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.

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.

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.

Replica dei pacchetti replicating-packages

Replica il contenuto di un pacchetto per installarlo nell’istanza Publish.

Distribuzione di software software-distribution

I pacchetti AEM possono essere utilizzati per creare e condividere contenuti tra ambienti AEMaaCS.

Distribuzione software fornisce pacchetti AEM da utilizzare nell'SDK AEM per lo sviluppo locale. I pacchetti AEM forniti nella Distribuzione di software non devono essere installati in ambienti cloud AEMaaCS a meno che non siano espressamente approvati dal Supporto Adobe.

Per ulteriori informazioni, vedere la documentazione sulla distribuzione software.