El administrador de paquetes

Los paquetes permiten importar y exportar el contenido del repositorio. Puede utilizar paquetes para instalar contenido nuevo, transferir contenido entre instancias y realizar copias de seguridad del contenido del repositorio.

AEM Con el Administrador de paquetes, puede transferir paquetes entre la instancia de y el sistema de archivos local para fines de desarrollo.

¿Qué son los paquetes?

Un paquete es un archivo zip que contiene contenido del repositorio en forma de serialización del sistema de archivos, denominada serialización de Vault, lo que proporciona una representación fácil de usar y editar de archivos y carpetas. El contenido incluido en el paquete se define mediante filtros.

Un paquete también contiene metainformación de Vault, incluidas las definiciones de filtros 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 de contenido adicionales son para el consumidor del paquete de contenido y solo con fines informativos.

AEM Paquetes en as a Cloud Service

AEM Los paquetes de contenido creados para aplicaciones as a Cloud Service de la deben tener una separación limpia entre el contenido inmutable y el mutable. Por lo tanto, el Administrador de paquetes solo se puede utilizar para administrar paquetes que contengan contenido. Cualquier código debe implementarse mediante Cloud Manager.

Para obtener más información sobre cómo administrar paquetes para AEMaaCS, consulte AEM Implementación en el as a Cloud Service de en la guía de usuario sobre implementación.

Tamaño del paquete

Adobe recomienda no crear paquetes grandes. Esto sirve para evitar problemas de tiempo de espera al cargar y descargar paquetes.

Como regla general, un paquete debe transmitirse en su totalidad en un plazo de 60 segundos. Esto proporciona la siguiente fórmula como guía.

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

Dado que el tráfico de red es variable y siempre es menor que el valor teórico máximo anunciado, intente utilizar una herramienta de prueba de velocidad de conexión a Internet en línea.

Las velocidades de Internet son casi siempre diferentes para las cargas y descargas. Suponiendo que debe cargar y descargar paquetes, debe utilizar el valor más bajo (normalmente velocidad de carga) en el cálculo.

Ejemplos

Utilizando una herramienta de prueba de velocidad de Internet, veo que mi velocidad de carga actual es de unos 100 Mbps.

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

Por lo tanto, cualquier paquete que cree debe ser menor que 750 MB.

El administrador de paquetes

AEM El Administrador de paquetes administra los paquetes en la instalación de la. Después de que tenga ha asignado los permisos necesarios puede utilizar el Administrador de paquetes para realizar diversas acciones, como configurar, crear, descargar e instalar paquetes.

Permisos necesarios

Para crear, modificar, cargar e instalar paquetes, los usuarios deben tener los permisos adecuados en los siguientes nodos:

• Derechos completos excluyendo eliminación en /etc/packages
• El nodo que contiene el contenido del paquete

Acceso al Administrador de paquetes

Puede acceder al Administrador de paquetes de tres formas:

1. AEM En el menú principal de la > Herramientas > Implementación > Paquetes
2. Desde CRXDE Lite uso de la barra superior del conmutador
3. Directamente accediendo a http://<host>:<port>/crx/packmgr/

IU del Administrador de paquetes

El Administrador de paquetes se divide en cuatro áreas funcionales principales:

• Panel de navegación izquierdo : Este panel le permite filtrar y ordenar la lista de paquetes.
• Lista de paquetes : Esta es la lista de paquetes de la instancia filtrados y ordenados por selecciones en el panel de navegación izquierdo.
• Registro de actividad : Este panel se minimiza al principio y se expande para detallar la actividad del Administrador de paquetes, como cuando se crea o instala un paquete. Hay botones adicionales en la pestaña Registro de actividad para:
  • Borrar registro
  • Mostrar / Ocultar
• Barra de herramientas : La barra de herramientas contiene botones de actualización para el panel de navegación izquierdo y la lista de paquetes, así como botones para buscar, crear y cargar paquetes.

Al hacer clic en una opción del panel de navegación izquierdo, se filtra inmediatamente la lista de paquetes.

Al hacer clic en el nombre de un paquete, se expande la entrada en la Lista de paquetes para mostrar más detalles sobre el paquete.

Existen varias acciones que se pueden realizar en un paquete a través de los botones de la barra de herramientas disponibles cuando se expanden los detalles del paquete.

• Editar
• Compilación
• Reinstalar
• Descargar

Más acciones están disponibles debajo de la Más botón.

• Eliminar
• Cobertura
• Contenido
• Volver a empaquetar
• Otras versiones
• Desinstalar
• Probar instalación
• Validate
• Replicar

Estado del paquete

Cada entrada en la lista de paquetes tiene un indicador de estado para permitirle conocer de un vistazo el estado del paquete. Al pasar el ratón por encima del estado, se muestra información del objeto con el detalle del estado.

Si el paquete se ha cambiado o nunca se ha creado, el estado se presenta como un vínculo para realizar acciones rápidas para reconstruir o instalar el paquete.

Configuración de paquetes

Un paquete es esencialmente un conjunto de filtros y los datos del repositorio basados en esos filtros. Con la interfaz de usuario del administrador de paquetes, puede hacer clic en un paquete y luego en el icono Editar para ver los detalles de un paquete, incluida la siguiente configuración.

• Configuración general
• Filtros de paquetes
• Dependencias del paquete
• Configuración avanzada
• Capturas de pantalla de paquetes

Configuración general

Puede editar una variedad de configuraciones de paquetes para definir información como la descripción del paquete, las dependencias y los detalles del proveedor.

El Configuración de paquetes está disponible a través de la Editar botón cuando creación o edición un paquete. Una vez realizados los cambios, haga clic en Guardar.

Filtros de paquetes

Los filtros identifican los nodos del repositorio que se van a incluir en el paquete. A Definición de filtro especifica la siguiente información:

• El Ruta raíz del contenido que desea incluir
• Reglas que incluyen o excluyen nodos específicos debajo de la ruta raíz

Añadir reglas mediante el + botón. Elimine las reglas con la variable - botón.

Las reglas se aplican según su orden, por lo que las coloca según sea necesario utilizando la variable Arriba y Abajo botones de flecha.

Los filtros pueden incluir cero o más reglas. Cuando no se define ninguna regla, el paquete contiene todo el contenido por 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.

Al crear filtros, puede definir una ruta o utilizar una expresión regular para especificar todos los nodos que desee incluir o excluir.

Los filtros de paquetes se definen con mayor frecuencia la primera vez que cree el paquete. Sin embargo, también se pueden editar más adelante, después de lo cual el paquete debe volver a crearse para actualizar su contenido en función de las nuevas definiciones de filtro.

Dependencias

Configuración avanzada

Capturas de pantalla de paquetes

Puede adjuntar varias capturas de pantalla al paquete para proporcionar una representación visual del aspecto del contenido.

Acciones de paquete

Se pueden realizar muchas acciones en un paquete.

Creación de un paquete

1. Acceda al Administrador de paquetes.

2. Haga clic en Crear paquete.

   SUGERENCIA

   Si la instancia tiene muchos paquetes, puede haber una estructura de carpetas configurada. En estos casos, es más fácil navegar a la carpeta de destino requerida antes de crear el nuevo paquete.

3. En el Nuevo paquete , introduzca los campos siguientes:

   

   • Nombre del paquete - Seleccione un nombre descriptivo para ayudarle (y a otros) a identificar fácilmente el contenido del paquete.

   • Versión - Este es un campo de texto para que usted indique una versión. Se anexa al nombre del paquete para formar el nombre del archivo zip.

   • Grupo : nombre del grupo de destino (o carpeta). Los grupos le ayudan a organizar sus paquetes. Se crea una carpeta para el grupo si aún no existe. Si deja el nombre del grupo en blanco, se creará el paquete en la lista de paquetes principal.

4. Clic OK para crear el paquete.

5. AEM La lista de paquetes nuevos se encuentra en la parte superior de la lista de paquetes.

   

6. Clic Editar para definir el contenido del paquete. Clic Guardar cuando haya terminado de editar la configuración.

7. Ahora puede Generar su paquete.

No es obligatorio crear inmediatamente el paquete después de crearlo. Un paquete sin compilar no contiene contenido y consiste únicamente en los datos de filtro y otros metadatos del paquete.

Creación de un paquete

A menudo, los paquetes se crean al mismo tiempo que usted creación del paquete, pero puede volver más tarde para compilar o volver a compilar el paquete. Esto puede resultar útil si el contenido del repositorio ha cambiado o los filtros del paquete han cambiado.

1. Acceda al Administrador de paquetes.

2. Abra los detalles del paquete en la lista de paquetes haciendo clic en el nombre del paquete.

3. Clic Generar. Un cuadro de diálogo le pedirá que confirme que desea crear el paquete, ya que se sobrescribirá el contenido existente.

4. Haga clic en Aceptar. AEM crea el paquete, enumerando todo el contenido añadido al paquete tal y como lo hace en la lista de actividad. AEM Cuando se completa, muestra una confirmación de que el paquete se ha creado y (al cerrar el cuadro de diálogo) actualiza la información de la lista de paquetes.

Edición de un paquete

AEM Una vez cargado un paquete en el repositorio de, puede modificar su configuración.

1. Acceda al Administrador de paquetes.

2. Abra los detalles del paquete en la lista de paquetes haciendo clic en el nombre del paquete.

3. Clic Editar y actualice el Configuración de paquetes según sea necesario.

4. Clic Guardar para guardar.

Es posible que tenga que reconstruir el paquete para actualizar su contenido en función de los cambios realizados.

Reajuste de un paquete

Una vez que se ha creado un paquete, se puede volver a empaquetar. Al volver a ajustar, se cambia la información del paquete sin incluir miniaturas, descripciones, etc., sin cambiar el contenido del paquete.

1. Acceda al Administrador de paquetes.

2. Abra los detalles del paquete en la lista de paquetes haciendo clic en el nombre del paquete.

3. Clic Editar y actualice el Configuración de paquetes según sea necesario.

4. Clic Guardar para guardar.

5. Clic Más > Reajustar y un cuadro de diálogo le pedirá confirmación.

Visualización de otras versiones de paquetes

Dado que cada versión de un paquete aparece en la lista como cualquier otro paquete, el Administrador de paquetes puede encontrar otras versiones de un paquete seleccionado.

1. Acceda al Administrador de paquetes.

2. Abra los detalles del paquete en la lista de paquetes haciendo clic en el nombre del paquete.

3. Clic Más > Otras versiones y se abre un cuadro de diálogo con una lista de otras versiones del mismo paquete con información de estado.

Visualización del contenido del paquete y prueba de la instalación

Una vez creado un paquete, puede ver su contenido.

1. Acceda al Administrador de paquetes.

2. Abra los detalles del paquete en la lista de paquetes haciendo clic en el nombre del paquete.

3. Para ver el contenido, haga clic en Más > Contenido y Administrador de paquetes muestra todo el contenido del paquete en el registro de actividades.

   

4. Para realizar una ejecución en seco de la instalación, haga clic en Más > Probar instalación y el Administrador de paquetes registran los resultados como si se hubiera realizado la instalación.

   

Descarga de paquetes en el sistema de archivos

1. Acceda al Administrador de paquetes.

2. Abra los detalles del paquete en la lista de paquetes haciendo clic en el nombre del paquete.

3. Haga clic en Descargar o el nombre de archivo vinculado del paquete en el área de detalles del paquete.

4. AEM Descarga el paquete en su equipo.

Carga de paquetes desde el sistema de archivos

1. Acceda al Administrador de paquetes.

2. Seleccione la carpeta del grupo en la que desea cargar el paquete.

3. Haga clic en Cargar paquete botón.

4. Proporcione la información necesaria sobre el paquete cargado.

   

   • Paquete - Utilice el Examinar… para seleccionar el paquete necesario del sistema de archivos local.
   • Forzar carga : Si ya existe un paquete con este nombre, esta opción fuerza la carga y sobrescribe el paquete existente.

5. Clic OK y el paquete seleccionado se carga y la lista de paquetes se actualiza en consecuencia.

AEM El contenido del paquete ahora existe en la, pero para que el contenido esté disponible para su uso, asegúrese de lo siguiente instalar el paquete.

Validación de paquetes

Dado que los paquetes pueden modificar el contenido existente, a menudo resulta útil validar estos cambios antes de instalar.

Opciones de validación

El Administrador de paquetes puede realizar las siguientes validaciones:

• Importaciones de paquetes OSGi
• Superposiciones
• ACL

Validar importaciones de paquetes OSGi

Qué se ha comprobado

Esta validación inspecciona el paquete para todos los archivos JAR (paquetes OSGi) y extrae su manifest.xml AEM (que contiene las dependencias con versiones en las que se basa dicho paquete OSGi) y verifica la instancia de la exporta dichas dependencias con las versiones correctas.

Cómo se informa

AEM Cualquier dependencia con versiones que la instancia de la instancia de la aplicación no pueda satisfacer se enumera en el registro de actividad 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 resulta en una implementación de aplicación dañada, ya que todo lo que dependa del paquete OSGi no iniciado a su vez no funcionará correctamente.

Resolución de errores

Para resolver errores debido a paquetes OSGi no satisfechos, se debe ajustar la versión de dependencia en el paquete con importaciones no satisfechas.

Validar capas

Qué se ha comprobado

AEM Esta validación determina si el paquete que se está instalando contiene un archivo que ya se superpone en la instancia de destino de la.

Por ejemplo, dada una superposición existente en /apps/sling/servlet/errorhandler/404.jsp, un paquete que contiene /libs/sling/servlet/errorhandler/404.jsp, de forma que cambie el archivo existente en /libs/sling/servlet/errorhandler/404.jsp.

Cómo se informa

Cualquier superposición de este tipo se describe en el registro de actividad del administrador de paquetes.

Estados de error

Un estado de error significa que el paquete intenta implementar un archivo que ya está superpuesto, por lo que los cambios en el paquete se anularán (y, por lo tanto, "ocultarán") por la superposición y no surtirán efecto.

Resolución de errores

Para resolver este problema, el responsable del archivo de superposición en /apps debe revisar los cambios en el archivo superpuesto en /libs e incorporar los cambios según sea necesario en la superposición ( /apps) y vuelva a implementar el archivo superpuesto.

Validar ACL

Qué se ha comprobado

Esta validación comprueba qué permisos se agregan, cómo se administran (combinar/reemplazar) y si los permisos actuales se ven afectados.

Cómo se informa

Los permisos se describen en el registro de actividad del administrador de paquetes.

Estados de error

No se pueden proporcionar errores explícitos. La validación simplemente indica si se agregan o afectan nuevos permisos ACL al instalar el paquete.

Resolución de errores

Con la información proporcionada por la validación, los nodos afectados se pueden revisar en CRXDE y las ACL se pueden ajustar en el paquete según sea necesario.

Realización de validación

La validación de paquetes se puede realizar de dos formas diferentes:

• A través de la IU del Administrador de paquetes
• Mediante una solicitud del POST HTTP como con cURL

La validación siempre debe producirse después de cargar el paquete, pero antes de instalarlo.

Validación De Paquetes Mediante El Administrador De Paquetes

1. Acceda al Administrador de paquetes.

2. Abra los detalles del paquete en la lista de paquetes haciendo clic en el nombre del paquete.

3. Para validar el paquete, haga clic en Más > Validate,

4. 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 Validate.

5. Las validaciones seleccionadas se ejecutan y los resultados se muestran en el registro de actividad del administrador de paquetes.

Validación de paquetes mediante solicitud de POST HTTP

La solicitud del POST tiene la siguiente forma.

https://<host>:<port>/crx/packmgr/service.jsp?cmd=validate&type=osgiPackageImports,overlays,acls

El type puede ser cualquier lista sin ordenar, separada por comas, que consta de:

• osgiPackageImports
• overlays
• acls

El valor de type el valor predeterminado es osgiPackageImports si no se pasa explícitamente.

Cuando utilice cURL, ejecute una instrucción similar a la siguiente:

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'

Al validar mediante una solicitud de POST, la respuesta se devuelve como un objeto JSON.

Visualización de cobertura del paquete

Los paquetes se definen mediante sus filtros. Puede hacer que el Administrador de paquetes aplique filtros de un paquete al contenido del repositorio existente para mostrar qué contenido del repositorio está cubierto por la definición del filtro del paquete.

1. Acceda al Administrador de paquetes.

2. Abra los detalles del paquete en la lista de paquetes haciendo clic en el nombre del paquete.

3. Clic Más > Cobertura.

4. Los detalles de cobertura se enumeran en el registro de actividad.

Instalación de paquetes

Al cargar un paquete, solo se añade el contenido del paquete al repositorio, pero no se puede acceder a él. Debe instalar el paquete cargado para utilizar el contenido del paquete.

Antes de la instalación del paquete, el Administrador de paquetes crea automáticamente un paquete de instantáneas que contiene el contenido que se sobrescribe. Esta instantánea se vuelve a instalar si desinstala el paquete.

1. Acceda al Administrador de paquetes.

2. Abra los detalles del paquete que desee instalar en la lista de paquetes haciendo clic en el nombre del paquete.

3. Haga clic en Instalar en los detalles del elemento o en el Instalar en el estado del paquete.

4. Un cuadro de diálogo solicitará confirmación y permitirá que se especifiquen opciones adicionales.

   • Extraer solo : extraiga el paquete solo para que no se cree ninguna instantánea y, por lo tanto, no sea posible la desinstalación
   • Guardar umbral : Número de nodos transitorios hasta que se activa el guardado automático (aumento si se producen excepciones de modificación simultáneas)
   • Extraer subpaquetes - Habilitar la extracción automática de subpaquetes
   • Administración de control de acceso - Especifica cómo se gestiona la información de control de acceso definida en el paquete cuando se instala el paquete (las opciones son las mismas que las configuración avanzada de paquetes)
   • Administración de dependencias - Especificar cómo se gestionan las dependencias durante la instalación

5. Clic Instalar.

6. El registro de actividad detalla el progreso de la instalación.

Una vez finalizada y correcta la instalación, se actualiza la lista de paquetes y se añade la palabra Instalado aparece en el estado del paquete.

Reinstalación de paquetes

La reinstalación de paquetes realiza los mismos pasos en un paquete ya instalado que se procesan cuando instalar inicialmente el paquete.

Carga e instalación basadas en el sistema de archivos

Puede renunciar por completo al Administrador de paquetes al instalar paquetes. AEM Puede detectar paquetes colocados en una ubicación específica del sistema de archivos local del equipo host y cargarlos e instalarlos automáticamente.

1. AEM En la carpeta de instalación de la, hay un crx-quicksart carpeta junto al frasco y license.properties archivo. Cree una carpeta llamada install bajo crx-quickstart que genera la ruta <aem-home>/crx-quickstart/install.

2. En esta carpeta, añada los paquetes. Se cargarán e instalarán automáticamente en su instancia.

3. Una vez completada la carga y la instalación, puede ver los paquetes en el Administrador de paquetes como si hubiera utilizado la interfaz de usuario del Administrador de paquetes para instalarlos.

Si la instancia se está ejecutando, la carga y la instalación comienzan inmediatamente cuando la añade al paquete en install carpeta

Si la instancia no se está ejecutando, los paquetes se colocan en la variable install Las carpetas se instalan al inicio en orden alfabético.

Desinstalación de paquetes

Al desinstalar un paquete, el contenido del repositorio se revierte a la instantánea realizada automáticamente por el Administrador de paquetes antes de la instalación.

1. Acceda al Administrador de paquetes.

2. Abra los detalles del paquete que desee desinstalar de la lista de paquetes haciendo clic en el nombre del paquete.

3. Clic Más > Desinstalar, para eliminar el contenido de este paquete del repositorio.

4. Un cuadro de diálogo solicitará confirmación y enumerará todos los cambios que se realizan.

5. El paquete se elimina y se aplica la instantánea. El progreso del proceso se muestra en el registro de actividad.

Eliminación de paquetes

Al eliminar un paquete, solo se eliminan sus detalles del Administrador de paquetes. Si este paquete ya estaba instalado, el contenido instalado no se eliminará.

1. Acceda al Administrador de paquetes.

2. Abra los detalles del paquete que desee eliminar de la lista de paquetes haciendo clic en el nombre del paquete.

3. AEM La solicita confirmación para eliminar el paquete. Clic OK para confirmar la eliminación.

4. La información del paquete se elimina y los detalles se incluyen en el registro de actividad.

Duplicación de paquetes

Repita el contenido de un paquete para instalarlo en la instancia de publicación.

1. Acceda al Administrador de paquetes.

2. Abra los detalles del paquete que desee duplicar desde la lista de paquetes haciendo clic en el nombre del paquete.

3. Clic Más > Replicar.

4. El paquete se duplica y los detalles se incluyen en el registro de actividad.

Distribución de software

AEM Los paquetes de se pueden utilizar para crear y compartir contenido en entornos AEMaaCS.

Distribución de software AEM AEM proporciona paquetes de datos para su uso en el SDK local de la aplicación de desarrollo de la aplicación (SDK). AEM Los paquetes proporcionados en la distribución de software no deben instalarse en entornos de nube AEMaaCS a menos que el soporte de Adobe los apruebe expresamente.

Para obtener más información, consulte la Documentación de distribución de software.