Cómo trabajar con paquetes how-to-work-with-packages
Los paquetes permiten importar y exportar el contenido del repositorio. Por ejemplo, puede utilizar paquetes para instalar nueva funcionalidad, transferir contenido entre instancias y hacer una copia de seguridad del contenido del repositorio.
Se puede acceder a los paquetes o mantenerlos desde las siguientes páginas:
-
Administrador de paquetes, que utiliza para administrar los paquetes en la instancia de AEM local.
-
Uso compartido de paquetes, un servidor centralizado que contiene paquetes disponibles al público y los privados para su empresa. Los paquetes públicos pueden contener revisiones, nuevas funciones, documentación, etc.
Puede transferir paquetes entre el Administrador de paquetes, el Uso compartido de paquetes y el sistema de archivos.
¿Qué son los paquetes? what-are-packages
Un paquete es un archivo zip que contiene contenido del repositorio en forma de serialización del sistema de archivos (llamada serialización "vault"). Esto proporciona una representación fácil de usar y editar de archivos y carpetas.
Los paquetes incluyen contenido, tanto contenido de página como contenido relacionado con el proyecto, seleccionado mediante filtros.
Un paquete también contiene información meta de vault, incluidas las definiciones de filtro y la información de configuración de importación. En el paquete se pueden incluir propiedades de contenido adicionales (que no se utilizan para la extracción de paquetes), como una descripción, una imagen visual o un icono; estas propiedades son para el consumidor del paquete de contenido y solo para fines informativos.
Puede realizar las siguientes acciones con o con paquetes:
- Crear nuevos paquetes; definir la configuración y los filtros del paquete según sea necesario
- Vista previa del contenido del paquete (antes de la compilación)
- Generar paquetes
- Ver información del paquete
- Ver el contenido del paquete (después de la compilación)
- Modificación de la definición de paquetes existentes
- Reconstruir paquetes existentes
- Volver a ajustar paquetes
- Descargue paquetes de AEM a su sistema de archivos
- Cargue paquetes desde el sistema de archivos a la instancia AEM local
- Validar el contenido del paquete antes de la instalación
- Realizar una instalación de simulación
- Instale paquetes (AEM no instala paquetes automáticamente después de cargarlos)
- Eliminar paquetes
- Descargue paquetes, como revisiones, de la biblioteca Uso compartido de paquetes
- Cargar paquetes a la sección interna de la empresa de la biblioteca Uso compartido de paquetes
Información del paquete package-information
Una definición de paquete consta de varios tipos de información:
Configuración de paquetes package-settings
Puede editar una variedad de Configuración del paquete para definir aspectos como la descripción del paquete, errores relacionados, dependencias e información del proveedor.
La variable Configuración de paquetes El cuadro de diálogo está disponible a través de la Editar botón cuando creación o editar un paquete y proporciona tres pestañas para la configuración. Después de realizar los cambios, haga clic en OK para guardarlos.
Filtros del paquete package-filters
Los filtros identifican los nodos del repositorio que se incluyen en el paquete. A Definición del filtro especifica la siguiente información:
- La variable Ruta raíz del contenido que se va a incluir.
- Reglas que incluyen o excluyen nodos específicos debajo de la ruta raíz.
Los filtros pueden incluir cero o más reglas. Cuando no se definen reglas, el paquete contiene todo el contenido debajo de la ruta raíz.
Puede definir una o más definiciones de filtro para un paquete. Utilice más de un filtro para incluir contenido de varias rutas raíz.
La tabla siguiente describe estas reglas y proporciona ejemplos:
Los filtros de paquetes se definen con mayor frecuencia al principio crear el paquete, pero también se pueden editar en un momento posterior (después del cual se debe reconstruir el paquete).
Capturas de pantalla del paquete package-screenshots
Puede adjuntar capturas de pantalla al paquete para proporcionar una representación visual del aspecto del contenido; por ejemplo, proporcionando capturas de pantalla de la nueva funcionalidad.
Iconos de paquete package-icons
También puede adjuntar un icono al paquete para proporcionar una representación visual de referencia rápida de lo que contiene el paquete. Esto se muestra en la lista de paquetes y puede ayudarle a identificar fácilmente el paquete o la clase del paquete.
Como un paquete puede contener un icono, las siguientes convenciones se utilizan para los paquetes oficiales:
Paquete de correcciones oficial:
Paquete oficial AEM Instalación o extensión:
Paquetes de funciones oficiales:
el administrador de paquetes package-manager
El Administrador de paquetes administra los paquetes en la instalación AEM local. Después de se han asignado los permisos necesarios puede utilizar el Administrador de paquetes para diversas acciones, como configurar, crear, descargar e instalar sus paquetes. Los elementos clave que se deben configurar son:
Permisos necesarios para utilizar el Administrador de paquetes permissions-needed-for-using-the-package-manager
Para conceder a los usuarios el derecho de crear, modificar, cargar e instalar paquetes, debe darles los permisos adecuados en las siguientes ubicaciones:
- /etc/packages (derechos completos, excluida la supresión)
- el nodo que contiene el contenido del paquete
Consulte Configuración de permisos para obtener instrucciones sobre cómo cambiar permisos.
Creación de un nuevo paquete creating-a-new-package
Para crear una nueva definición de paquete:
-
En la pantalla de bienvenida de AEM, haga clic en Paquetes (o desde el Herramientas doble clic en la consola Paquetes).
-
A continuación, seleccione Administrador de paquetes.
-
Haga clic en Crear paquete.
note note NOTE Si la instancia tiene muchos paquetes, puede haber una estructura de carpetas en su lugar, por lo que puede navegar a la carpeta de destino necesaria antes de crear el nuevo paquete. -
En el cuadro de diálogo:
Introduzca el:
-
Nombre del grupo
El nombre del grupo de destino (o carpeta). Los grupos están pensados para ayudarle a organizar sus paquetes.
Se creará una carpeta para el grupo si aún no existe. Si deja en blanco el nombre del grupo, se creará el paquete en la lista de paquetes principal (Inicio > Paquetes).
-
Nombre del paquete
El nombre del nuevo paquete. Seleccione un nombre descriptivo para ayudarle (y a otros) a identificar fácilmente el contenido del paquete.
-
Versión
Campo de texto para indicar una versión. Esto se añadirá al nombre del paquete para formar el nombre del archivo zip.
Haga clic en OK para crear el paquete.
-
-
AEM enumera el nuevo paquete en la carpeta de grupo correspondiente.
Haga clic en el icono o el nombre del paquete para abrirlo.
note note NOTE Si es necesario, puede volver a esta página en una etapa posterior. -
Haga clic en Editar para editar el configuración de paquetes.
Aquí puede añadir información o definir determinadas configuraciones; por ejemplo, estas incluyen una descripción, la variable icono, errores relacionados y añadir detalles del proveedor.
Haga clic en OK una vez que haya terminado de editar la configuración.
-
Agregar Capturas de pantalla al paquete según sea necesario. Una instancia está disponible cuando se crea el paquete, y añada más si es necesario utilizando Captura de pantalla del paquete de la barra de tareas.
Agregue la imagen real haciendo doble clic en el componente de imagen en la variable Capturas de pantalla área, agregar una imagen y hacer clic en OK.
-
Defina el Filtros del paquete arrastrando instancias de Definición del filtro en la barra de tareas y, a continuación, haga doble clic para abrir y editar:
Especifique:
-
Ruta raíz
El contenido que se va a empaquetar; puede ser la raíz de un subárbol. -
Reglas
Las reglas son opcionales; para definiciones de paquetes simples, no es necesario especificar reglas de inclusión o exclusión.Si es necesario, puede definir Incluir o Excluir reglas para definir exactamente el contenido del paquete.
Agregar reglas usando la variable + , elimine las reglas usando la función - símbolo. Las reglas se aplican según su orden, de modo que se posicionan según sea necesario mediante la variable Up y Down botones.
A continuación, haga clic en OK para guardar el filtro.
note note NOTE Puede utilizar tantas definiciones de filtro como necesite, aunque debe asegurarse de que no entren en conflicto. Uso Vista previa para confirmar cuál será el contenido del paquete. -
-
Para confirmar lo que contendrá el paquete, puede utilizar Vista previa. Esto realiza una ejecución en seco del proceso de compilación y enumera todo lo que se agregará al paquete cuando realmente se haya creado.
-
Ahora puede Generar su paquete.
note note NOTE No es obligatorio construir el paquete en este momento, puede hacerse en un momento posterior.
Creación de un paquete building-a-package
Un paquete se crea a menudo al mismo tiempo que usted crear la definición del paquete, pero puede volver más tarde a la compilación o a la reconstrucción del paquete. Esto puede resultar útil si el contenido del repositorio ha cambiado.
-
Abra la definición del paquete desde Administrador de paquetes (haga clic en el icono o nombre del paquete).
-
Haga clic en Generar. Un cuadro de diálogo solicita confirmación de que desea crear el paquete.
note note NOTE Esto es de especial importancia cuando está reconstruyendo un paquete, ya que el contenido del paquete se sobrescribirá. -
Haga clic en Aceptar. AEM compilará el paquete, enumerando todo el contenido agregado al paquete tal como lo hace. Cuando se completa AEM muestra una confirmación de que el paquete se creó y (cuando cierra el cuadro de diálogo) actualiza la información de la lista de paquetes.
Ajustar un paquete rewrapping-a-package
Una vez que se ha creado un paquete, se puede volver a ajustar, si es necesario.
Al volver a ajustar se cambia la información del paquete: without cambiar el contenido del paquete. La información del paquete es la miniatura, la descripción, etc., es decir, todo lo que puede editar con el Configuración de paquetes para abrir este clic Editar).
Un caso de uso importante para el reajuste es al preparar un paquete para el paquete compartido. Por ejemplo, puede tener un paquete existente y decidir compartirlo con otros. Para ello, desea agregar una miniatura y una descripción. En lugar de recrear todo el paquete con toda su funcionalidad (que puede tardar algún tiempo y corre el riesgo de que el paquete ya no sea idéntico al original), puede volver a envolverlo y simplemente añadir la miniatura y la descripción.
-
Abra la definición del paquete desde Administrador de paquetes (haga clic en el icono o nombre del paquete).
-
Haga clic en Editar y actualice la variable Configuración de paquetes según sea necesario. Haga clic en OK para guardar.
-
Haga clic en Ajustar, aparecerá un cuadro de diálogo en el que se solicitará confirmación.
Visualización y edición de la información del paquete viewing-and-editing-package-information
Para ver o editar información sobre una definición de paquete:
-
En el Administrador de paquetes, vaya al paquete que desee ver.
-
Haga clic en el icono del paquete que desee ver. Se abrirá la página del paquete que enumera información sobre la definición del paquete:
note note NOTE También puede editar y realizar ciertas acciones en el paquete desde esta página. Los botones disponibles dependerán de si el paquete ya se ha creado o no. -
Si el paquete ya se ha creado, haga clic en Contenido, se abrirá una ventana que muestra todo el contenido del paquete:
Visualización del contenido del paquete y prueba de la instalación viewing-package-contents-and-testing-installation
Después de crear un paquete, puede ver el contenido:
-
En el Administrador de paquetes, vaya al paquete que desee ver.
-
Haga clic en el icono del paquete que desee ver. Esto abrirá la página del paquete que enumera información sobre la definición del paquete.
-
Para ver el contenido, haga clic en Contenido, se abrirá una ventana que muestra todo el contenido del paquete:
-
Para realizar una ejecución en seco de la instalación, haga clic en Probar la instalación. Después de confirmar la acción, se abrirá una ventana y se enumerarán los resultados como si la instalación se hubiera realizado:
Descarga de paquetes en el sistema de archivos downloading-packages-to-your-file-system
En esta sección se describe cómo descargar un paquete de AEM a su sistema de archivos utilizando Administrador de paquetes.
-
descargar paquetes de Uso compartido de paquetes directamente en la instancia de AEM local.
Tras la descarga, el paquete se importa en el repositorio, tras lo cual puede instalarlo inmediatamente en la instancia local mediante la función Administrador de paquetes. Estos paquetes incluyen revisiones y otros paquetes compartidos. -
descargar paquetes de Uso compartido de paquetes en el sistema de archivos.
-
En la pantalla de bienvenida de AEM, haga clic en Paquetes y, a continuación, seleccione Administrador de paquetes.
-
Vaya al paquete que desee descargar.
-
Haga clic en el enlace formado por el nombre del archivo zip (subrayado) para el paquete que desee descargar; por ejemplo
export-for-offline.zip.AEM descarga el paquete en el equipo (mediante un cuadro de diálogo de descarga estándar del explorador).
Carga de paquetes desde el sistema de archivos uploading-packages-from-your-file-system
La carga de paquetes permite cargar paquetes desde el sistema de archivos en el Administrador de paquetes de AEM.
Para cargar un paquete:
-
Vaya a la Administrador de paquetes. A continuación, en la carpeta del grupo en la que desea que se cargue el paquete.
-
Haga clic en Cargar paquete.
-
Archivo
Puede escribir el nombre del archivo directamente o usar la variable Examinar… para seleccionar el paquete necesario del sistema de archivos local (después de seleccionar, haga clic en OK).
-
Forzar carga
Si ya existe un paquete con este nombre, puede hacer clic en esto para forzar la carga (y sobrescribir el paquete existente).
Haga clic en OK de modo que el nuevo paquete se cargue y se muestre en la lista del Administrador de paquetes.
note note NOTE Para que el contenido esté disponible para AEM, asegúrese de instalar el paquete. -
Validación de paquetes validating-packages
Antes de instalar un paquete, es posible que desee verificar su contenido. Porque los paquetes pueden modificar los archivos superpuestos en /apps y/o añadir, modificar y eliminar ACL, a menudo resulta útil validar estos cambios antes de instalar.
Opciones de validación validation-options
El mecanismo de validación puede comprobar las siguientes características del paquete:
- Importaciones de paquetes OSGi
- Superposiciones
- ACL
Estas opciones se detallan a continuación.
-
Validar importaciones de paquetes OSGi
Qué se ha marcado
Esta validación inspecciona el paquete para todos los archivos JAR (paquetes OSGi), extrae sus
manifest.xml(que contiene las dependencias versionadas en las que se basa dicho paquete OSGi) y verifica las AEM de exportación de instancias de dichas dependencias con las versiones correctas.Cómo se informa
Las dependencias con versiones que la instancia de AEM no pueda satisfacer se enumeran en la Registro de actividades del Administrador de paquetes.
Estados de error
Si las dependencias no están satisfechas, los paquetes OSGi del paquete con esas dependencias no se iniciarán. Esto da como resultado una implementación de aplicación rota, ya que todo lo que dependa del paquete no iniciado OSGi a su vez no funcionará correctamente.
Resolución de errores
Para resolver errores debido a paquetes OSGi insatisfechos, es necesario ajustar la versión de dependencia del paquete con importaciones insatisfechas.
-
Validar capas
Qué se ha marcado
Esta validación determina si el paquete que se está instalando contiene un archivo que ya está superpuesto en la instancia de AEM de destino.
Por ejemplo, si se da una superposición existente en
/apps/sling/servlet/errorhandler/404.jsp, un paquete que contenga/libs/sling/servlet/errorhandler/404.jsp, de modo que cambie el archivo existente en/libs/sling/servlet/errorhandler/404.jsp.Cómo se informa
Estas superposiciones se describen en la sección Registro de actividades del Administrador de paquetes.
Estados de error
Un estado de error significa que el paquete está intentando implementar un archivo que ya está superpuesto, por lo que los cambios en el paquete serán anulados (y por lo tanto "ocultos") por la superposición y no tendrán efecto.
Resolución de errores
Para resolver este problema, el mantenedor del del archivo de superposición en
/appsdebe revisar los cambios en el archivo superpuesto en/libse incorpore los cambios según sea necesario en la superposición (/apps) y vuelva a implementar el archivo superpuesto.note note NOTE Tenga en cuenta que el mecanismo de validación no tiene forma de cuadrarse si el contenido superpuesto se ha incorporado correctamente en el archivo de superposición. Por lo tanto, esta validación seguirá informando sobre los conflictos incluso después de realizar los cambios necesarios. -
Validar ACL
Qué se ha marcado
Esta validación comprueba qué permisos se están agregando, cómo se gestionarán (combinar/reemplazar) y si los permisos actuales se verán afectados.
Cómo se informa
Los permisos se describen en la sección Registro de actividades del Administrador de paquetes.
Estados de error
No se pueden proporcionar errores explícitos. La validación simplemente indica si se agregarán o afectarán nuevos permisos ACL al instalar el paquete.
Resolución de errores
Utilizando la información proporcionada por la validación, los nodos afectados pueden revisarse en CRXDE y las ACL pueden estar ajustándose en el paquete según sea necesario.
note caution CAUTION Se recomienda que los paquetes no afecten a las ACL proporcionadas por AEM, ya que esto puede provocar un comportamiento inesperado del producto.
Realización de la validación performing-validation
La validación de los paquetes puede realizarse de dos maneras diferentes:
- A través de la interfaz de usuario del Administrador de paquetes
- A través de una solicitud de POST HTTP como con cURL
Validación de paquetes mediante el administrador de paquetes
-
Abra el Administrador de paquetes en
https://<server>:<port>/crx/packmgr -
Seleccione el paquete en la lista y, a continuación, seleccione Más menú desplegable del encabezado y, a continuación, Validar en el menú desplegable.
note note NOTE Esto debe hacerse después de cargar el paquete de contenido, pero antes de instalar el paquete. -
En el cuadro de diálogo modal que aparece a continuación, utilice las casillas de verificación para seleccionar los tipos de validación y comenzar la validación haciendo clic en Validar. También puede hacer clic en Cancelar.
-
A continuación, se ejecutan las validaciones seleccionadas. Los resultados se muestran en el registro de actividades del Administrador de paquetes.
Validación de paquetes mediante solicitud de POST HTTP
La solicitud del POST adopta el siguiente formulario.
https://<host>:<port>/crx/packmgr/service.jsp?cmd=validate&type=osgiPackageImports,overlays,acls
type puede ser cualquier lista sin ordenar separada por comas que consista en:osgiPackageImportsoverlaysacls
type toma como valor predeterminado osgiPackageImports si no se pasa.A continuación se muestra un ejemplo de cómo utilizar cURL para ejecutar una validación de paquete.
-
Si utiliza cURL, ejecute una instrucción similar a la siguiente:
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 validación solicitada se ejecuta y la respuesta se devuelve como un objeto JSON.
Instalación de paquetes installing-packages
Después de cargar un paquete, debe instalar el contenido. Para que el contenido del paquete esté instalado y funcione, debe ser de ambos:
-
cargado en AEM (puede cargado desde el sistema de archivos o descargado del paquete compartido)
-
instalado
-
Realice una instalación de prueba del paquete sin modificar ninguno de los contenidos:
Abra el paquete (haga clic en el icono o nombre del paquete) y haga clic en Probar instalación. -
Consulte la lista de contenido del paquete:
Abra el paquete y haga clic en Contenido.
-
En primer lugar, desactive WorkflowLauncher.
Utilice la opción de menú Componentes de la consola OSGi para desactivarcom.day.cq.workflow.launcher.impl.WorkflowLauncherImpl. -
A continuación, cuando se complete la instalación, reactive WorkflowLauncher.
-
En el Administrador de paquetes, vaya al paquete que desee instalar.
Un Instalar se muestra al lado de Paquetes que aún no se han instalado.
note note NOTE Como alternativa, puede abrir el paquete haciendo clic en su icono para acceder al Instalar en la barra de herramientas. -
Haga clic en Instalar para iniciar la instalación. Un cuadro de diálogo solicitará confirmación y enumerará todos los cambios que se realicen. Cuando termine, haga clic en Cerrar en el cuadro de diálogo.
La palabra Installed aparece junto al paquete una vez que se ha instalado.
Carga e instalación basadas en el sistema de archivos file-system-based-upload-and-installation
Hay una forma alternativa de cargar e instalar paquetes en su instancia. En su sistema de archivos, tiene un crx-quicksart carpeta junto con su jar y license.properties archivo. Debe crear una carpeta con el nombre install under crx-quickstart. Entonces tendrá algo así: <aem_home>/crx-quickstart/install
En esta carpeta de instalación, puede añadir directamente sus paquetes. Se cargarán automáticamente y se instalarán en su instancia. Cuando haya terminado, podrá ver los paquetes en el Administrador de paquetes.
Si la instancia se está ejecutando, agregue un paquete a la variable install se inicia directamente en la carga y en la instalación de la instancia. Si la instancia no se está ejecutando, los paquetes que ponga en la variable install se instalará al inicio en orden alfabético.
crx-quickstart carpeta manualmente, cree la install carpeta debajo de ella y ponga sus paquetes allí. A continuación, cuando inicie la instancia por primera vez, los paquetes se instalarán en orden alfabético.Desinstalación de paquetes uninstalling-packages
AEM permite desinstalar paquetes. Esta acción revierte el contenido del repositorio que se ve afectado a la instantánea realizada inmediatamente antes de la instalación del paquete.
- En el Administrador de paquetes, vaya al paquete que desea desinstalar.
- Haga clic en el icono del paquete que desea desinstalar.
- Haga clic en Desinstalar para eliminar el contenido de este paquete del repositorio. Un cuadro de diálogo solicitará confirmación y enumerará todos los cambios que se realicen. Cuando termine, haga clic en Cerrar en el cuadro de diálogo.
Eliminación de paquetes deleting-packages
Para eliminar un paquete de la lista del Administrador de paquetes:
-
En el Herramientas consola, expanda el Paquetes para mostrar el paquete en el panel derecho.
-
Haga clic en el paquete que desee eliminar para que quede resaltado y:
- Haga clic en Eliminar en el menú de la barra de herramientas.
- Haga clic con el botón derecho y seleccione Eliminar.
-
AEM solicita confirmación de que desea eliminar el paquete. Haga clic en OK para confirmar la eliminación.
Duplicación de paquetes replicating-packages
Repita el contenido de un paquete para instalarlo en la instancia de publicación:
-
En el Administrador de paquetes, vaya al paquete que desee duplicar.
-
Haga clic en el icono o en el nombre del paquete que desee duplicar para expandirlo.
-
En el Más menú desplegable de la barra de herramientas, seleccione Replicar.
Uso compartido de paquetes package-share
Package Share era un servidor centralizado al que se podía acceder públicamente para compartir paquetes de contenido.
Se ha reemplazado por Distribución de software.
Distribución de software software-distribution
Distribución de software es la nueva interfaz de usuario diseñada para simplificar la búsqueda y descarga de paquetes AEM.
Para obtener más información, consulte la Documentación de distribución de software.