Cómo trabajar con paquetes

Los paquetes permiten importar y exportar el contenido del repositorio. Por ejemplo, puede utilizar paquetes para instalar nueva funcionalidad, transferir contenido entre instancias y realizar una copia de seguridad del contenido del repositorio.

Se puede acceder a los paquetes y/o mantenerlos desde las páginas siguientes:

  • Administrador de paquetes, que se utiliza para administrar los paquetes en la instancia de AEM local.

  • Package Share, un servidor centralizado que contiene tanto los paquetes disponibles públicamente como los privados para su compañía. Los paquetes públicos pueden contener revisiones, nuevas funcionalidades, documentación, etc.

Puede transferir paquetes entre el Administrador de paquetes, Uso compartido de paquetes y el sistema de archivos.

¿Qué son los paquetes?

Un paquete es un archivo zip que contiene el 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 el contenido, tanto de la página como del proyecto, seleccionado con filtros.

Un paquete también contiene información meta de vault, incluidas las definiciones de filtros y la información de configuración de importación. Se pueden incluir en el paquete 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.

NOTA

Los paquetes representan la versión actual del contenido en el momento en que se crea el paquete. No incluyen ninguna versión anterior del contenido que AEM en el repositorio.

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
  • Contenido del paquete de previsualización (antes de la compilación)
  • Compilación de paquetes
  • Información del paquete de vista
  • Contenido del paquete de vista (después de la compilación)
  • Modificar la definición de los paquetes existentes
  • Reconstruir paquetes existentes
  • Volver a ajustar paquetes
  • Descargue paquetes de AEM a su sistema de archivos
  • Cargar paquetes del sistema de archivos en la instancia de AEM local
  • Validar el contenido del paquete antes de la instalación
  • Realizar una instalación de ejecución en seco
  • Instalación de paquetes (AEM no instala automáticamente los paquetes después de cargarlos)
  • Eliminar paquetes
  • Descargar paquetes, como revisiones, de la biblioteca Package Share
  • Carga de paquetes en la sección interna de la compañía de la biblioteca Package Share

Información del paquete

Una definición de paquete se compone de varios tipos de información:

Configuración del paquete

Puede editar una variedad de opciones de configuración de paquete para definir aspectos como la descripción del paquete, los errores relacionados, las dependencias y la información del proveedor.

El cuadro de diálogo Configuración del paquete está disponible mediante el botón Editar cuando crea o edita un paquete y proporciona tres fichas para la configuración. Una vez realizados los cambios, haga clic en Aceptar para guardarlos.

packagesedit

Campo Descripción
Nombre El nombre del paquete.
Agrupar Nombre del grupo al que se va a agregar el paquete, para organizar los paquetes. Escriba el nombre de un grupo nuevo o seleccione un grupo existente.
Versión Texto que se usará para la versión personalizada.
Descripción Breve descripción del paquete. El formato se puede usar con formato HTML.
Miniatura El icono que aparece con la lista de paquetes. Haga clic en Examinar para seleccionar un archivo local.

chlimage_1-344

Campo Descripción Formato/Ejemplo
Nombre El nombre del proveedor. Geometrixx AEM
URL Dirección URL del proveedor. https://www.aem-geometrixx.com
Vínculo Vínculo específico del paquete a una página de proveedor. https://www.aem-geometrixx.com/mypackage.html
Requiere
  • Administrador: Seleccione cuándo el paquete solo puede instalarse mediante una cuenta con privilegios de administrador.
  • Restart: Seleccione cuándo debe reiniciarse el servidor después de instalar el paquete.
Administración de AC

Especifique cómo se gestiona la información de control de acceso definida en el paquete al importarlo:

  • Ignorar
  • Sobrescribir
  • Combinar
  • Borrar
  • MergePreserve

El valor predeterminado es Omitir.

  • Omitir : conservar las ACL en el repositorio
  • Sobrescribir : sobrescribir ACL en el repositorio
  • Combinar : combinar ambos conjuntos de ACL
  • ACL claras y claras
  • CombinarConservar - combinar control de acceso en el contenido con el proporcionado con el paquete agregando las entradas de control de acceso de entidades principales que no están presentes en el contenido

packagesdependencias

Campo Descripción Formato/Ejemplo
Probado con El nombre del producto y la versión de este paquete son compatibles o están dirigidos a ellos. AEM 6
Problemas/errores solucionados Campo de texto que permite lista de detalles de errores corregidos con este paquete. Lista cada error en una línea separada. resumen de error-nr
Depende de Lista la información de dependencia que debe respetarse siempre que se necesiten otros paquetes para permitir que el paquete actual se ejecute según lo esperado. Este campo es importante cuando se utilizan revisiones. groupId:nombre:versión
Reemplaza Una lista de paquetes obsoletos que este paquete reemplaza. Antes de realizar la instalación, compruebe que este paquete incluye todo el contenido necesario de los paquetes obsoletos para que no se sobrescriba ningún contenido. groupId:nombre:versión

Filtros de paquete

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

  • La Ruta de 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 hay reglas definidas, el paquete contiene todo el contenido debajo de la ruta raíz.

Puede definir una o varias definiciones de filtro para un paquete. Utilice más de un filtro para incluir contenido de varias rutas raíz.

chlimage_1-345

En la tabla siguiente se describen estas reglas y se proporcionan ejemplos:

Tipo de regla Descripción Ejemplo
incluir Puede definir una ruta o utilizar una expresión normal para especificar todos los nodos que desee incluir.

Si se incluye un directorio:
  • incluya ese directorio y todos los archivos y carpetas de ese directorio (es decir, todo el subárbol)
  • no incluir otros archivos o carpetas de la ruta raíz especificada
/libs/sling/install(/.*?lang=es)?
excluir Puede especificar una ruta o utilizar una expresión normal para especificar todos los nodos que desea excluir.

Excluir un directorio excluirá ese directorio y todos los archivos y carpetas de ese directorio (es decir, todo el subárbol).
/libs/wcm/foundation/components(/.*?lang=es)?
NOTA

Un paquete puede contener varias definiciones de filtro, de modo que los nodos de diferentes ubicaciones se pueden combinar fácilmente en un paquete.

Los filtros del paquete se definen con mayor frecuencia cuando crea el paquete por primera vez, pero también se pueden editar posteriormente (después de lo cual se debe volver a crear el paquete).

Capturas de pantalla del paquete

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

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 del paquete y puede ayudarle a identificar fácilmente el paquete o la clase del paquete.

Como un paquete puede contener un icono, se utilizan las siguientes convenciones para los paquetes oficiales:

NOTA

Para evitar confusiones, utilice un icono descriptivo para el paquete y no utilice uno de los iconos oficiales.

Paquete de revisión oficial:

Paquete oficial AEM instalación o extensión:

Paquete de funciones oficiales:

el administrador de paquetes

El Administrador de paquetes administra los paquetes de la instalación AEM local. Después de asignar los permisos necesarios, puede utilizar el Administrador de paquetes para diversas acciones, como configurar, crear, descargar e instalar los paquetes. Los elementos clave que se deben configurar son:

Permisos necesarios para utilizar el Administrador de paquetes

Para otorgar 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 excluyendo delete)
  • el nodo que contiene el contenido del paquete

Consulte Configuración de permisos para obtener instrucciones sobre cómo cambiar los permisos.

Creación de un nuevo paquete

Para crear una nueva definición de paquete:

  1. En la pantalla de bienvenida de AEM, haga clic en Paquetes (o en el doble Herramientas de la consola, haga clic en Paquetes).

  2. A continuación, seleccione Administrador de paquetes.

  3. Haga clic en Crear paquete.

    NOTA

    Si la instancia tiene muchos paquetes, puede haber una estructura de carpetas en su lugar, por lo que puede desplazarse a la carpeta de destinatario requerida antes de crear el nuevo paquete.

  4. En el cuadro de diálogo:

    packagesnew

    Introduzca el valor:

    • Nombre del grupo

      Nombre del grupo destinatario (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 el nombre del grupo en blanco, creará el paquete en la lista del paquete 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 agregará al nombre del paquete para formar el nombre del archivo zip.
      Haga clic en Aceptar para crear el paquete.

  5. AEM lista el nuevo paquete en la carpeta de grupo correspondiente.

    packagesitem

    Haga clic en el icono o el nombre del paquete para abrirlo.

    packagesitemclicked

    NOTA

    Si es necesario, puede volver a esta página más adelante.

  6. Haga clic en Editar para editar la configuración del paquete.

    Aquí puede agregar información y/o definir determinadas opciones de configuración; por ejemplo: una descripción, el icono, errores relacionados y agregar detalles del proveedor.

    Haga clic en Aceptar una vez que haya terminado de editar la configuración.

  7. Añada Capturas de pantalla en el paquete según sea necesario. Una instancia está disponible cuando se crea el paquete, agregue más si es necesario mediante Captura de pantalla del paquete desde la barra de tareas.

    Añada la imagen real haciendo clic con el doble en el componente de imagen en el área Capturas de pantalla, agregando una imagen y haciendo clic en Aceptar.

  8. Defina los Filtros de paquete arrastrando las instancias de Definición de filtro desde la barra de tareas y, a continuación, haciendo clic con el doble para abrir y editar:

    packagesfilter

    Especifique:

    • Ruta de
      raízEl contenido que se va a empaquetar; puede ser la raíz de un subárbol.


    • RulesRules 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.

      Añada las reglas con el símbolo +, o bien elimine las reglas con el símbolo -. Las reglas se aplican según su orden, por lo que se colocan según sea necesario con los botones Arriba y Abajo.
      A continuación, haga clic en Aceptar para guardar el filtro.

    NOTA

    Puede utilizar tantas definiciones de filtro como necesite, aunque debe asegurarse de que no entran en conflicto. Use Previsualización para confirmar cuál será el contenido del paquete.

  9. Para confirmar lo que contendrá el paquete, puede utilizar Previsualización. Esto realiza una ejecución seca del proceso de compilación y lista todo lo que se agregará al paquete cuando se cree realmente.

  10. Ahora puede compilar su paquete.

    NOTA

    No es obligatorio construir el paquete en este momento, puede hacerse en un momento posterior.

Generación de un paquete

A menudo, un paquete se crea al mismo tiempo que crea la definición del paquete, pero puede volver más adelante para crear o volver a compilar el paquete. Esto puede resultar útil si el contenido del repositorio ha cambiado.

NOTA

Antes de crear el paquete, puede resultar útil la previsualización del contenido del mismo. Para ello, haga clic en Previsualización.

  1. Abra la definición del paquete desde Administrador de paquetes (haga clic en el icono o nombre del paquete).

  2. Haga clic en Generar. Un cuadro de diálogo solicita confirmación de que desea crear el paquete.

    NOTA

    Esto es de especial importancia cuando está reconstruyendo un paquete, ya que se sobrescribirá su contenido.

  3. Haga clic en Aceptar. AEM creará el paquete, enumerando todo el contenido agregado al paquete tal como lo hace. Cuando se completa la AEM, se muestra una confirmación de que el paquete se creó y (al cerrar el cuadro de diálogo) se actualiza la información de la lista del paquete.

Reajuste de un paquete

Una vez creado el paquete, se puede volver a ajustar, si es necesario.

Al volver a ajustar se cambia la información del paquete: sin cambiar el contenido del paquete. La información del paquete es la miniatura, la descripción, etc., en otras palabras todo lo que puede editar con el cuadro de diálogo Configuración del paquete (para abrir este clic Editar).

Un caso de uso importante para volver a ajustar es cuando se prepara un paquete para el recurso compartido de paquetes. 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 (lo que puede llevar cierto tiempo y asumir el riesgo de que el paquete ya no sea idéntico al original), puede volver a ajustarlo y simplemente agregar la miniatura y la descripción.

  1. Abra la definición del paquete desde Administrador de paquetes (haga clic en el icono o nombre del paquete).

  2. Haga clic en Editar y actualice la Configuración del paquete según sea necesario. Haga clic en Aceptar para guardar.

  3. Haga clic en Volver a ajustar, un cuadro de diálogo solicitará confirmación.

Visualización y edición de la información del paquete

Para vista o edición de información sobre una definición de paquete:

  1. En el Administrador de paquetes, navegue hasta el paquete que desee vista.

  2. Haga clic en el icono de paquete del paquete que desee vista. Esto abrirá la página del paquete con información sobre la definición del paquete:

    packagesitemclicked-1

    NOTA

    También puede editar y realizar determinadas acciones en el paquete desde esta página.

    Los botones disponibles dependerán de si el paquete ya se ha creado o no.

  3. Si el paquete ya se ha creado, haga clic en Contenido, se abrirá una ventana y se lista todo el contenido del paquete:

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

Después de crear un paquete, puede realizar la vista del contenido:

  1. En el Administrador de paquetes, navegue hasta el paquete que desee vista.

  2. Haga clic en el icono de paquete del paquete que desee vista. Esto abrirá la página del paquete con información sobre la definición del paquete.

  3. Para vista del contenido, haga clic en Contenido, se abrirá una ventana y se realizará una lista de todo el contenido del paquete:

    packgescontents

  4. Para realizar una ejecución seca de la instalación, haga clic en Probar instalación. Después de confirmar la acción, se abrirá una ventana y se lista el resultado como si la instalación se hubiera realizado:

    packagestestinstall

Descarga de paquetes en el sistema de archivos

En esta sección se describe cómo descargar un paquete de AEM a su sistema de archivos mediante Administrador de paquetes.

NOTA

Consulte Uso compartido de paquetes para obtener información sobre la descarga de revisiones, paquetes de funciones y paquetes del área pública y del área interna de uso compartido de paquetes de su compañía.

Desde Package Share puede:

  1. En la pantalla de bienvenida de AEM, haga clic en Paquetes y, a continuación, seleccione Administrador de paquetes.

  2. Vaya al paquete que desee descargar.

    packagesdownload

  3. Haga clic en el vínculo formado por el nombre del archivo zip (subrayado) del paquete que desea 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

La carga de paquetes permite cargar un paquete desde el sistema de archivos en el Administrador de paquetes de AEM.

NOTA

Consulte Carga de paquetes en la compañía interna Uso compartido de paquetes para cargar un paquete en el área privada de Uso compartido de paquetes de su compañía.

Para cargar un paquete:

  1. Vaya al Administrador de paquetes. A continuación, vaya a la carpeta de grupo en la que desea que se cargue el paquete.

    packagesupload, botón

  2. Haga clic en Cargar paquete.

    packagesupload addialog

    • Archivo

      Puede escribir el nombre del archivo directamente o utilizar el Examinar… para seleccionar el paquete requerido del sistema de archivos local (después de seleccionar Aceptar).

    • Forzar carga

      Si ya existe un paquete con este nombre, puede hacer clic en él para forzar la carga (y sobrescribir el paquete existente).
      Haga clic en Aceptar para que el nuevo paquete se cargue y aparezca en la lista del Administrador de paquetes.

    NOTA

    Para que el contenido esté disponible para AEM, asegúrese de instalar el paquete.

Validación de paquetes

Antes de instalar un paquete, es posible que desee comprobar su contenido. Dado que los paquetes pueden modificar archivos superpuestos en /apps y/o agregar, modificar y eliminar ACL, a menudo resulta útil validar estos cambios antes de instalarlos.

Opciones de validación

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é está marcado

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

    Cómo se informa

    Todas las dependencias con versiones que no puedan ser satisfechas por la instancia de AEM se enumeran en el 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 inicio. Esto resulta en una implementación de aplicación dañada, ya que todo lo que dependa del paquete OSGi no iniciado 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é está 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, dado un overlay existente en /apps/sling/servlet/errorhandler/404.jsp, un paquete que contiene /libs/sling/servlet/errorhandler/404.jsp, de manera que cambiará el archivo existente en /libs/sling/servlet/errorhandler/404.jsp.

    Cómo se informa

    Estas superposiciones se describen en el 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 surtirán efecto.

    Resolución de errores

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

    NOTA

    Tenga en cuenta que el mecanismo de validación no tiene forma de conciliar 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 que se hayan realizado los cambios necesarios.

  • Validar ACL

    Qué está marcado

    Esta validación comprueba qué permisos se agregan, 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 el 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 se verán afectados los 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 ajustarse en el paquete según sea necesario.

    ATENCIÓN

    Como práctica recomendada, se recomienda que los paquetes no afecten a las ACL proporcionadas por AEM, ya que esto puede provocar un comportamiento inesperado del producto.

Realizando validación

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

  • Mediante la interfaz de usuario del administrador de paquetes
  • A través de una solicitud de POST HTTP como con cURL
NOTA

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

Validación de paquetes mediante el administrador de paquetes

  1. Abra el Administrador de paquetes en https://<server>:<port>/crx/packmgr

  2. Seleccione el paquete en la lista y, a continuación, seleccione la lista desplegable Más en el encabezado y, a continuación, Validar en el menú desplegable.

    NOTA

    Esto debe hacerse después de cargar el paquete de contenido, pero antes de instalarlo.

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

  4. Las validaciones elegidas se ejecutan. Los resultados se muestran en el registro de actividades del Administrador de paquetes.

Validación del paquete mediante solicitud de POST HTTP

La solicitud de POST tiene el siguiente formato.

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

El parámetro type puede ser cualquier lista sin ordenar separada por comas que consista en:

  • osgiPackageImports
  • overlays
  • acls

El valor de type tiene el valor predeterminado osgiPackageImports si no se pasa.

El siguiente es un ejemplo de uso de cURL para ejecutar una validación de paquete.

  1. Si utiliza 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'
    
  2. La validación solicitada se ejecuta y la respuesta se devuelve como un objeto JSON.

NOTA

La respuesta a una solicitud de POST HTTP de validación será un objeto JSON con los resultados de la validación.

Instalación de paquetes

Después de cargar un paquete, debe instalar el contenido. Para que el contenido del paquete esté instalado y en funcionamiento, es necesario que:

ATENCIÓN

La instalación de un paquete puede sobrescribir o eliminar el contenido existente. Cargue un paquete únicamente si está seguro de que no elimina o sobrescribe el contenido que necesita.

Para ver el contenido o el impacto de un paquete, puede:

  • Realice una instalación de prueba del paquete sin modificar ningún contenido:
    Abra el paquete (haga clic en el icono o nombre del paquete) y haga clic en Probar instalación.

  • Ver una lista del contenido del paquete:
    Abra el paquete y haga clic en Contenido.

NOTA

Inmediatamente antes de la instalación del paquete, se crea un paquete de instantánea para que contenga el contenido que se sobrescribirá.

Esta instantánea se reinstalará si desinstala el paquete.

ATENCIÓN

Si va a instalar recursos digitales, debe:

  • En primer lugar, desactive WorkflowLauncher.
    Utilice la opción de menú Componentes de la consola OSGi para desactivar com.day.cq.workflow.launcher.impl.WorkflowLauncherImpl.

  • A continuación, cuando se complete la instalación, reactive WorkflowLauncher.

Al desactivar WorkflowLauncher se garantiza que el marco del importador de recursos no manipule los recursos durante la instalación (de forma involuntaria).

  1. En el Administrador de paquetes, navegue hasta el paquete que desee instalar.

    Se muestra un botón Install en el lado de Packages que todavía no se han instalado.

    NOTA

    También puede abrir el paquete haciendo clic en su icono para acceder al botón Instalar que se encuentra allí.

  2. Haga clic en Instalar para inicio de la instalación. Un cuadro de diálogo solicitará confirmación y lista de 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 después de que se haya instalado.

Carga e instalación basadas en el sistema de archivos

Hay una forma alternativa de cargar e instalar paquetes en su instancia. En el sistema de archivos, tiene una carpeta crx-quicksart junto con el archivo jar y license.properties. Debe crear una carpeta con el nombre install en crx-quickstart. Tendrás algo así: <aem_home>/crx-quickstart/install

En esta carpeta de instalación, puede agregar directamente los paquetes. Se cargarán e instalarán automáticamente en su instancia. Cuando haya terminado, podrá ver los paquetes en el Administrador de paquetes.

Si la instancia se está ejecutando, al agregar un paquete a la carpeta install se iniciará directamente la carga y la instalación en la instancia. Si su instancia no se está ejecutando, los paquetes que haya colocado en la carpeta install se instalarán al inicio en orden alfabético.

NOTA

También puede hacerlo antes incluso de iniciar la instancia por primera vez. Para ello, debe crear la carpeta crx-quickstart manualmente, crear la carpeta install y colocar los 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

AEM le permite desinstalar paquetes. Esta acción revierte el contenido del repositorio que se ve afectado por la instantánea realizada inmediatamente antes de la instalación del paquete.

NOTA

Tras la instalación, se crea un paquete de instantánea que contiene el contenido que se sobrescribirá.

Este paquete se reinstalará cuando desinstale el paquete.

  1. En el Administrador de paquetes, desplácese hasta el paquete que desee desinstalar.
  2. Haga clic en el icono de paquete del paquete que desee desinstalar.
  3. Haga clic en Desinstalar para eliminar el contenido de este paquete del repositorio. Un cuadro de diálogo solicitará confirmación y lista de todos los cambios que se realicen. Cuando termine, haga clic en Cerrar en el cuadro de diálogo.

Eliminando paquetes

Para eliminar un paquete de las listas del Administrador de paquetes:

NOTA

Los archivos/nodos instalados del paquete se no eliminan.

  1. En la consola Tools, expanda la carpeta Packages para mostrar el paquete en el panel derecho.

  2. Haga clic en el paquete que desee eliminar para resaltarlo y, a continuación:

    • Haga clic en Eliminar en el menú de la barra de herramientas.
    • Haga clic con el botón derecho y seleccione Eliminar.

    empaquetesdelete

  3. AEM solicita confirmación de que desea eliminar el paquete. Haga clic en Aceptar para confirmar la eliminación.

ATENCIÓN

Si este paquete ya se ha instalado, se eliminará el contenido instalado no.

Replicar paquetes

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

  1. En el Administrador de paquetes, navegue al paquete que desee replicar.

  2. Haga clic en el icono o en el nombre del paquete que desee replicar para expandirlo.

  3. En el menú desplegable Más de la barra de herramientas, seleccione Replicar.

Uso compartido de paquetes

Package Share es un servidor centralizado que se pone a disposición del público para compartir Content-Packages.

Con Package Share, puede descargar estos paquetes, que pueden incluir revisiones oficiales, conjuntos de funciones, actualizaciones o contenido de muestra generado por otros usuarios.

También puede cargar y compartir paquetes dentro de su compañía.

Acceso a Package Share

No hay acceso anónimo al Uso compartido de paquetes; es decir, solo los usuarios registrados pueden realizar vistas, descargar y cargar paquetes.

El acceso al Uso compartido de paquetes está disponible para nuestros socios y clientes. Los datos de registro deben enviarse para que se asignen derechos de acceso.

Para obtener acceso a Package Share:

NOTA

Cualquier usuario de Package Share que no se haya asignado a un cliente debe unirse a una comunidad para ver esos recursos haciendo clic en Unirse al lado del inicio de sesión de Package Share.

Inicio de sesión en Package Share

  1. En la pantalla de bienvenida de AEM, haga clic en Herramientas -> Implementación

  2. A continuación, seleccione Uso compartido de paquetes. Deberá:

    NOTA

    La primera vez que inicie sesión con su Adobe ID, debe completar la validación de su dirección de correo electrónico.

    NOTA

    Si ha olvidado su contraseña, utilice Problemas al iniciar sesión? en el cuadro de diálogo de inicio de sesión.

Validación del Adobe ID

La primera vez que inicie sesión en Package Share con su Adobe ID, se validará su dirección de correo electrónico.

  1. Recibirá un correo electrónico con un vínculo.

  2. Debe hacer clic en este vínculo.

  3. Se abrirá una página web.

    La acción de abrir esta página web se toma como validación.

  4. El inicio de sesión continuará.

  5. Recibirá un correo electrónico con un vínculo.

  6. Debe hacer clic en este vínculo.

  7. Se abrirá una página web. La acción de abrir esta página web se toma como validación.

  8. El inicio de sesión continuará.

Registro para Uso compartido de paquetes

Si necesita acceder a Package Share, deberá registrarse en un Adobe ID:

Se puede crear un Adobe ID proporcionando:

  • su dirección de correo electrónico
  • una contraseña de su elección
  • información adicional como su nombre y país de residencia

Cuenta de Package Share

La validez de la aplicación se comprobará antes de:

  • Su cuenta de usuario se crea con los permisos requeridos o permitidos.
  • Su cuenta se agrega al grupo de su compañía.
NOTA

Un usuario de una de nuestras compañías asociadas también puede ser miembro de sus grupos de clientes.

Consideraciones de red

IPv6

Es posible que tenga problemas al intentar acceder al Uso compartido de paquetes desde un entorno IPv6 puro.

Esto se debe a que el uso compartido de paquetes es un servicio alojado en un servidor, lo que significa que la conexión se realiza a través de varias redes en Internet. No se puede garantizar que todas las redes de conexión admitan IPv6; si no es así, la conexión podría fallar.

Para evitar este problema, puede acceder a Package Share desde una red IPv4, descargar el paquete y luego cargarlo en el entorno IPv6.

Proxy HTTP

Uso compartido de paquetes no está disponible en este momento si la compañía ejecuta un proxy http que requiere autenticación.

Uso compartido de paquetes solo está disponible cuando el servidor de AEM tiene acceso a Internet sin necesidad de autenticación. Para configurar el proxy para todos los servicios que utilizan el cliente http (incluido el recurso compartido de paquetes), utilice la configuración OSGi del paquete Day Commons HTTP Client 3.1.

Uso compartido del paquete interno

En Package Share, los paquetes se organizan en tres subárboles:

  • Paquetes de Adobe proporcionados por Adobe.
  • Paquetes compartidos que han sido proporcionados por otras compañías y que han sido publicados por Adobe.
  • Los paquetes de compañía que son privados.

chlimage_1-346

Búsqueda y filtrado de paquetes

Uso compartido de paquetes oferta una barra de búsqueda que puede utilizar para buscar palabras clave o etiquetas específicas. Tanto las palabras clave como las etiquetas admiten varios valores.

  • Para buscar varias palabras clave, debe separar cada palabra clave por un espacio.
  • Para buscar varias etiquetas, debe seleccionar cada una en los árboles de paquetes.

También puede cambiar el operador condicional de O a Y en la parte derecha de la barra de resumen del filtro.

Descarga E Instalación De Paquetes Desde Package Share

Para descargar paquetes desde Package Share e instalarlos en la instancia local, es más fácil acceder a Package Share desde la instancia de AEM. Esto descargará el paquete y lo registrará inmediatamente en el administrador de paquetes, desde donde se puede instalar.

  1. En la pantalla de bienvenida de AEM, haga clic en Herramientas y seleccione Uso compartido de paquetes para abrir la página Uso compartido de paquetes.

  2. Con los detalles de su cuenta, inicie sesión en Uso compartido de paquetes. Se muestra la página de aterrizaje, que enumera la carpeta Adobe, la carpeta compartida y una carpeta específica de su compañía.

    NOTA

    Antes de empezar a descargar paquetes desde Package Share, asegúrese de tener el acceso necesario.

  3. Vaya al paquete que desee descargar y haga clic en Descargar.

  4. Vuelva atrás o vaya al Administrador de paquetes de la instancia de AEM. Luego navegue al paquete que acaba de descargar.

    NOTA

    Para encontrar el paquete descargado, siga la misma ruta que en Uso compartido de paquetes. Por ejemplo, si ha descargado un paquete de la siguiente ruta en Uso compartido de paquetes:

    Paquetes > Público > Revisiones
    A continuación, en el Administrador de paquetes de la instancia local, el paquete también aparecerá en:
    Paquetes > Público > Revisiones

  5. Haga clic en Instalar para instalar el paquete en la instalación AEM local.

    NOTA

    Si el paquete ya se ha instalado en su instancia, aparece el indicador Instalado junto al paquete en lugar del botón Instalar.

    ATENCIÓN

    La instalación de un paquete puede sobrescribir el contenido existente en el repositorio. Por lo tanto, le recomendamos que realice primero una instalación de prueba. Esto le permite inspeccionar si el contenido que contiene el paquete entra en conflicto con el contenido existente.

Descarga de paquetes en el sistema de archivos desde Package Share

La descarga e instalación es muy práctica, pero si es necesario también puede descargar el paquete y guardarlo en el sistema de archivos local:

  1. En Uso compartido de paquetes, haga clic en el icono o el nombre del paquete.
  2. Haga clic en la ficha Recursos.
  3. Haga clic en Descargar en disco.

Carga de un paquete

Con Package Share, puede cargar paquetes en el área interna de compañía de Package Share. Esto hace que estén disponibles para compartirlas dentro de la compañía.

Estos paquetes están no disponibles para la comunidad AEM general, pero están disponibles para todos los usuarios registrados en su compañía.

Para cargar paquetes, utilice la compañía interna Uso compartido de paquetes:

ATENCIÓN

Para cargar un paquete en Package Share, primero debe crear una carpeta de grupo con el nombre de su compañía en el administrador de paquetes local. Por ejemplo, geometrixx. Todos los paquetes que se van a cargar para compartir deben colocarse en esta carpeta de grupo.
Los paquetes de la lista principal del Administrador de paquetes o de otras carpetas no se pueden compartir.

  1. Abra el Administrador de paquetes y vaya al paquete que desee cargar.

  2. Haga clic en el icono del paquete para abrirlo.

  3. Haga clic en Compartir para abrir el cuadro de diálogo y cargar el paquete en Uso compartido de paquetes.

  4. Si aún no ha iniciado sesión en Package Share, deberá introducir sus credenciales de inicio de sesión.

    Cuando haya iniciado sesión, AEM mostrará detalles sobre el paquete que se va a cargar:

    chlimage_1-347

  5. Haga clic en Compartir para cargar el paquete en el Uso compartido de paquetes interno de su compañía.

    AEM muestra el estado e indica cuándo terminó de cargarse el paquete, después de lo cual puede hacer clic en la x (esquina superior derecha) para salir de la ventana Compartir paquete.

  6. Una vez completada la carga, puede desplazarse a la carpeta interna de la compañía para ver el paquete que acaba de compartir.

NOTA

Para modificar un paquete disponible en Uso compartido de paquetes, debe descargarlo, volver a compilarlo y cargarlo de nuevo en Uso compartido de paquetes.

Eliminación De Un Paquete

Sólo puede eliminar los paquetes que haya cargado mediante el procedimiento siguiente:

  1. En el árbol de compañías, compruebe el grupo de paquetes que contiene el paquete.

  2. Haga clic en el paquete.

  3. Haga clic en el botón Eliminar.

  4. Haga clic en Eliminar para confirmar que desea eliminar el paquete.

Paquetes semiprivados

Puede compartir paquetes fuera de su organización, pero no públicamente. Estos paquetes se considerarían semiprivados. Para compartir estos paquetes semiprivados, necesitará ayuda de la asistencia técnica de Adobe. Para ello, abra un ticket con la asistencia técnica de Adobe para solicitar que un paquete esté disponible fuera de su organización. Le pedirán una lista de Adobe ID que desea otorgar acceso a sus paquetes.

En esta página