Tareas de mantenimiento en AEM as a Cloud Service maintenance-tasks-in-aem-as-a-cloud-service

Las tareas de mantenimiento son procesos que se ejecutan según una programación para optimizar el repositorio. Con AEM as a Cloud Service, la necesidad de que los clientes configuren las propiedades operativas de las tareas de mantenimiento es mínima. Los clientes pueden enfocar sus recursos en preocupaciones del nivel de la aplicación y dejar que Adobe se encargue de las operaciones de infraestructura.

Configuración de tareas de mantenimiento maintenance-tasks-configuring

En versiones anteriores de AEM, se podían configurar tareas de mantenimiento mediante la tarjeta de mantenimiento (Herramientas > Operaciones > Mantenimiento). La tarjeta de mantenimiento ya no está disponible para AEM as a Cloud Service, por lo que las configuraciones deben enviarse al control de origen e implementarse mediante Cloud Manager. Adobe administra las tareas de mantenimiento que tienen configuraciones que los clientes no pueden configurar (por ejemplo, Recopilación de elementos no utilizados del almacén de datos). Los clientes pueden configurar otras tareas de mantenimiento, como se describe en la tabla siguiente.

CAUTION
Adobe se reserva el derecho de anular los ajustes de configuración de tareas de mantenimiento de un cliente para mitigar problemas como la degradación del rendimiento.

En la tabla siguiente se ilustran las tareas de mantenimiento disponibles.

Tarea de mantenimiento
Quién posee la configuración
Cómo se configura (opcional)
Recopilación de residuos del almacén de datos
Adobe
N/D: propiedad total de Adobe
Depuración de la versión
Cliente
La depuración de versiones está deshabilitada de manera predeterminada, pero la directiva se puede configurar, tal como se describe en la sección Tareas de mantenimiento de purga de versiones y depuración de registros de auditoría.

La depuración se habilitará pronto de manera predeterminada, con estos valores reemplazables.
Purga del registro de auditoría
Cliente
La depuración del registro de auditoría está deshabilitada de manera predeterminada, pero la directiva se puede configurar, tal como se describe en la sección Tareas de mantenimiento de purga de versiones y depuración del registro de auditoría.

La depuración se habilitará pronto de manera predeterminada, con estos valores reemplazables.
Limpieza de archivos binarios de Lucene
Adobe
No se utiliza y, por lo tanto, Adobe lo ha desactivado.
Purga de la tarea ad hoc
Cliente

Debe hacerse en Git. Anule el nodo de configuración de la ventana de mantenimiento predeterminado en /libs creando propiedades en la carpeta /apps/settings/granite/operations/maintenance/granite_weekly, granite_daily o granite_monthly.

Consulte la tabla Ventana de mantenimiento a continuación para obtener más información sobre la configuración. Habilite la tarea de mantenimiento añadiendo otro nodo bajo el nodo de arriba. Asígnele el nombre granite_TaskPurgeTask, con el atributo sling:resourceType establecido en granite/operations/components/maintenance/task y el atributo granite.maintenance.name establecido en TaskPurge. Configure las propiedades de OSGI; consulte com.adobe.granite.taskmanagement.impl.purge.TaskPurgeMaintenanceTask para ver la lista de propiedades.

Depuración de flujo de trabajo
Cliente

Debe hacerse en Git. Anule el nodo de configuración de la ventana de mantenimiento predeterminado en /libs creando propiedades en la carpeta /apps/settings/granite/operations/maintenance/granite_weekly, granite_daily o granite_monthly. Consulte la tabla Ventana de mantenimiento a continuación para obtener más información sobre la configuración.

Habilite la tarea de mantenimiento añadiendo otro nodo bajo el anterior (asígnele el nombre granite_WorkflowPurgeTask) con las propiedades adecuadas. Configure las propiedades de OSGI. Consulte Documentación de la tarea de mantenimiento de la versión 6.5 de AEM.

Depuración del proyecto
Cliente

Debe hacerse en Git. Anule el nodo de configuración de la ventana de mantenimiento predeterminado en /libs creando propiedades en la carpeta /apps/settings/granite/operations/maintenance/granite_weekly, granite_daily o granite_monthly. Consulte la tabla Ventana de mantenimiento a continuación para obtener más información sobre la configuración.

Habilite la tarea de mantenimiento añadiendo otro nodo bajo el anterior (asígnele el nombre granite_ProjectPurgeTask) con las propiedades adecuadas. Consulte la lista de propiedades de OSGI en "Configuración de depuración de proyectos de Adobe".

Configuración de la ventana de mantenimiento
Quién posee la configuración
Tipo de configuración
Parámetros
Cada día
Cliente
Definición del nodo JCR

windowSchedule=daily (este valor no debe cambiarse)

windowStartTime=HH:MM como reloj de 24 horas. Define cuándo deben comenzar a ejecutarse las tareas de mantenimiento asociadas con la ventana de mantenimiento diario.

windowEndTime=HH:MM como reloj de 24 horas. Define cuándo deben dejar de ejecutarse las tareas de mantenimiento asociadas con la ventana de mantenimiento diario si aún no se han completado.

Una tarea de mantenimiento no se puede ejecutar más de una vez durante este periodo de tiempo.

Cada semana
Cliente
Definición del nodo JCR

windowSchedule=weekly (este valor no debe cambiarse)

windowStartTime=HH:MM como reloj de 24 horas. Define cuándo deben comenzar a ejecutarse las tareas de mantenimiento asociadas con la ventana de mantenimiento semanal.

windowEndTime=HH:MM como reloj de 24 horas. Define cuándo deben dejar de ejecutarse las tareas de mantenimiento asociadas con la ventana de mantenimiento semanal si aún no se han completado.

Una tarea de mantenimiento no se puede ejecutar más de una vez durante este periodo de tiempo.

windowScheduleWeekdays= Matriz de dos valores entre 1 y 7 (por ejemplo, [5,5]) El primer valor de la matriz es el día de inicio, cuando se programa el trabajo, y el segundo es el día de finalización, cuando se detiene el trabajo. La hora exacta del inicio y la finalización se rige por windowStartTime y windowEndTime respectivamente.

Mensual
Cliente
Definición del nodo JCR

windowSchedule=month (este valor no debe cambiarse)

windowStartTime=HH:MM como reloj de 24 horas. Define cuándo deben comenzar a ejecutarse las tareas de mantenimiento asociadas con la ventana de mantenimiento mensual.

windowEndTime=HH:MM como reloj de 24 horas. Define cuándo deben dejar de ejecutarse las tareas de mantenimiento asociadas con la ventana de mantenimiento mensual si aún no se han completado.

Una tarea de mantenimiento no se puede ejecutar más de una vez durante este periodo de tiempo.

windowScheduleWeekdays=Matriz de dos valores entre 1 y 7 (por ejemplo, [5,5]) El primer valor de la matriz es el día de inicio, cuando se programa el trabajo, y el segundo es el día de finalización, cuando se detiene el trabajo. La hora exacta del inicio y la finalización se rige por windowStartTime y windowEndTime respectivamente.

windowFirstLastStartDay= 0/1 0 para programar en la primera semana del mes o 1 para programar en la última semana del mes. La ausencia de un valor programaría los trabajos en el día regido por windowScheduleWeekdays (cada mes).

Ubicaciones:

  • Diario: /apps/settings/granite/operations/maintenance/granite_daily
  • Semanal: /apps/settings/granite/operations/maintenance/granite_weekly
  • Mensual: /apps/settings/granite/operations/maintenance/granite_monthly

Muestras de código:

Muestra de código 1 (diario)

<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:sling="http://sling.apache.org/jcr/sling/1.0"
  xmlns:jcr="http://www.jcp.org/jcr/1.0"
  jcr:primaryType="sling:Folder"
  sling:configCollectionInherit="true"
  sling:configPropertyInherit="true"
  windowSchedule="daily"
  windowStartTime="03:00"
  windowEndTime="05:00"
 />

Muestra de código 2 (semanal)

<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:sling="http://sling.apache.org/jcr/sling/1.0"
   xmlns:jcr="http://www.jcp.org/jcr/1.0"
   jcr:primaryType="sling:Folder"
   sling:configCollectionInherit="true"
   sling:configPropertyInherit="true"
   windowEndTime="15:30"
   windowSchedule="weekly"
   windowScheduleWeekdays="[5,5]"
   windowStartTime="14:30"/>

Muestra de código 3 (mensual)

<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:sling="http://sling.apache.org/jcr/sling/1.0"
   xmlns:jcr="http://www.jcp.org/jcr/1.0"
   jcr:primaryType="sling:Folder"
   sling:configCollectionInherit="true"
   sling:configPropertyInherit="true"
   windowEndTime="15:30"
   windowSchedule="monthly"
   windowFirstLastStartDay=0
   windowScheduleWeekdays="[5,5]"
   windowStartTime="14:30"/>

Tareas de mantenimiento de purga de versiones y depuración de registros de auditoría purge-tasks

La depuración de versiones y del registro de auditoría reduce el tamaño del repositorio y, en algunos casos, puede mejorar el rendimiento.

NOTE
Los clientes de AEM Guides no deben configurar la depuración de versiones.

Valores predeterminados defaults

Actualmente, la depuración no está habilitada de forma predeterminada, pero esto cambiará en el futuro. Los entornos que se crearon antes de habilitar la depuración predeterminada tendrán un umbral más conservador para que la depuración no se produzca de forma inesperada. Consulte las secciones Depuración de versiones y Depuración del registro de auditoría a continuación para obtener más detalles sobre la política de depuración predeterminada.

Los valores de depuración predeterminados se pueden sobrescribir declarando un archivo de configuración e implementándolo como se describe a continuación.

Aplicación de una configuración configure-purge

Declare un archivo de configuración e impleméntelo como se describe en los pasos siguientes.

NOTE
Una vez implementado el nodo de depuración de versiones en el archivo de configuración, debe mantenerlo declarado y no eliminarlo. La canalización de configuración fallará si intenta hacerlo.
Del mismo modo, una vez que implemente el nodo de depuración del registro de auditoría en el archivo de configuración, debe mantenerlo declarado y no eliminarlo.

1 - cree la siguiente carpeta y estructura de archivos en la carpeta de nivel superior de su proyecto en Git:

config/
     mt.yaml

2 - Declarar propiedades en el archivo de configuración, que incluyen:

  • una propiedad "kind" con el valor "MaintenanceTasks".
  • una propiedad "version" (actualmente estamos en la versión 1).
  • un objeto "metadata" opcional con la propiedad envTypes con una lista separada por comas del tipo de entorno (dev, stage, prod) para el cual esta configuración es válida. Si no se declara ningún objeto de metadatos, la configuración es válida para todos los tipos de entorno.
  • un objeto de datos con versionPurge y auditLogPurge objetos.

Vea las definiciones y sintaxis de los objetos versionPurge y auditLogPurge a continuación.

La configuración debe estructurarse de forma similar al siguiente ejemplo:

kind: "MaintenanceTasks"
version: "1"
metadata:
  envTypes: ["dev"]
data:
  versionPurge:
    maximumVersions: 15
    maximumAgeDays: 20
    paths: ["/content"]
    minimumVersions: 1
    retainLabelledVersions: false
  auditLogPurge:
    rules:
      - replication:
          maximumAgeDays: 15
          contentPath: "/content"
          types: ["Activate", "Deactivate", "Delete", "Test", "Reverse", "Internal Poll"]
      - pages:
          maximumAgeDays: 15
          contentPath: "/content"
          types: ["PageCreated", "PageModified", "PageMoved", "PageDeleted", "VersionCreated", "PageRestored", "PageValid", "PageInvalid"]
      - dam:
          maximumAgeDays: 15
          contentPath: "/content"
          types: ["ASSET_EXPIRING", "METADATA_UPDATED", "ASSET_EXPIRED", "ASSET_REMOVED", "RESTORED", "ASSET_MOVED", "ASSET_VIEWED", "PROJECT_VIEWED", "PUBLISHED_EXTERNAL", "COLLECTION_VIEWED", "VERSIONED", "ADDED_COMMENT", "RENDITION_UPDATED", "ACCEPTED", "DOWNLOADED", "SUBASSET_UPDATED", "SUBASSET_REMOVED", "ASSET_CREATED", "ASSET_SHARED", "RENDITION_REMOVED", "ASSET_PUBLISHED", "ORIGINAL_UPDATED", "RENDITION_DOWNLOADED", "REJECTED"]

Tenga en cuenta que para que la configuración sea válida:

  • todas las propiedades deben estar definidas. No hay valores predeterminados heredados.
  • se deben respetar los tipos (enteros, cadenas, booleanos, etc.) de las tablas de propiedades siguientes.
NOTE
Puede usar yq para validar localmente el formato YAML del archivo de configuración (por ejemplo, yq mt.yaml).

3: configure las canalizaciones de configuración de no producción y producción.

Los entornos de desarrollo rápido (RDE) no admiten la depuración. Para otros tipos de entornos en programas de producción (que no sean de zona protegida), cree una canalización de configuración de implementación de destino en Cloud Manager.

Consulte configuración de canalizaciones de producción y configuración de canalizaciones que no son de producción para obtener más información.

Depuración de la versión version-purge

NOTE
Los clientes de AEM Guides no deben configurar la depuración de versiones.

Valores predeterminados de depuración de versión version-purge-defaults

Actualmente, la depuración no está habilitada de forma predeterminada, pero esto cambiará en el futuro.

Los entornos que se crearon después de habilitar la depuración predeterminada tendrán los siguientes valores predeterminados:

  • Se eliminan las versiones con más de 30 días.
  • Se conservan las cinco versiones más recientes de los últimos 30 días.
  • Independientemente de las reglas anteriores, se conserva la versión más reciente (además del archivo actual).

Los entornos que se crearon antes de habilitar la depuración predeterminada tendrán los valores predeterminados que se enumeran a continuación, pero se recomienda reducir esos valores para optimizar el rendimiento.

  • Se eliminan las versiones anteriores a 7 años.
  • Se conservan todas las versiones de los últimos 7 años.
  • Después de 7 años, se eliminan otras versiones que no sean la más reciente (además del archivo actual).

Propiedades de purga de versiones version-purge-properties

Las propiedades permitidas se enumeran a continuación.

Las columnas que indican default indican los valores predeterminados en el futuro, cuando se apliquen los valores predeterminados; TBD refleja un identificador de entorno que aún no se ha determinado.

Propiedades
valor predeterminado futuro para envs>TBD
valor predeterminado futuro para envs<=TBD
Requerido
tipo
Valores
rutas
["/content"]
["/content"]
matriz de cadenas
Especifica en qué rutas purgar versiones cuando se crean nuevas versiones. Los clientes deben declarar esta propiedad, pero el único valor permitido es "/content".
maximumAgeDays
30
2557 (7 años + 2 días bisiestos)
Entero
Se elimina cualquier versión anterior al valor configurado. Si el valor es 0, la depuración no se realiza según la antigüedad de la versión.
maximumVersions
5
0 (sin límite)
Entero
Se elimina cualquier versión anterior a la n-ª versión más reciente. Si el valor es 0, la depuración no se realiza según el número de versiones.
minimumVersions
1
1
Entero
El número mínimo de versiones que se conservan independientemente de la edad. Tenga en cuenta que siempre se conserva al menos 1 versión; su valor debe ser 1 o superior.
keepLabelsVersioned
false
false
booleano
Determina si se excluirán de la depuración las versiones etiquetadas explícitamente. Para mejorar la optimización del repositorio, se recomienda establecer este valor en false.

Interacciones de propiedades

Los siguientes ejemplos ilustran cómo interactúan las propiedades al combinarse.

Ejemplo:

maximumAgeDays = 30
maximumVersions = 10
minimumVersions = 2

Si hay 11 versiones el día 23, la versión más antigua se purgará la próxima vez que se ejecute la tarea de mantenimiento de purga, ya que la propiedad maximumVersions está establecida en 10.

Si hay 5 versiones en el día 31, solo se purgarán 3, ya que la propiedad minimumVersions está establecida en 2.

Ejemplo:

maximumAgeDays = 30
maximumVersions = 0
minimumVersions = 1

No se purgarán versiones posteriores a los 30 días debido a que la propiedad maximumVersions está establecida en 0.

Se conservará una versión con más de 30 días.

Purga del registro de auditoría audit-purge

Valores predeterminados de purga del registro de auditoría audit-purge-defaults

Actualmente, la depuración no está habilitada de forma predeterminada, pero esto cambiará en el futuro.

Los entornos que se crearon después de habilitar la depuración predeterminada tendrán los siguientes valores predeterminados:

  • Se eliminan los registros de replicación, DAM y auditoría de página anteriores a 7 días.
  • Se registran todos los eventos posibles.

Los entornos que se crearon antes de habilitar la depuración predeterminada tendrán los valores predeterminados que se enumeran a continuación, pero se recomienda reducir esos valores para optimizar el rendimiento.

  • Se eliminan los registros de replicación, DAM y auditoría de página anteriores a 7 años.
  • Se registran todos los eventos posibles.
NOTE
Se recomienda que los clientes, que tienen requisitos regulatorios para producir registros de auditoría no editables, se integren con servicios externos especializados.

Propiedades de purga del registro de auditoría audit-purge-properties

Las propiedades permitidas se enumeran a continuación.

Las columnas que indican default indican los valores predeterminados en el futuro, cuando se apliquen los valores predeterminados; TBD refleja un identificador de entorno que aún no se ha determinado.

Propiedades
valor predeterminado futuro para envs>TBD
valor predeterminado futuro para envs<=TBD
Requerido
tipo
Valores
reglas
-
-
Objeto
Uno o más de los siguientes nodos: replicación, páginas, DAM. Cada uno de estos nodos define reglas, con las propiedades a continuación. Todas las propiedades deben declararse.
maximumAgeDays
7 días
para todos, 2557 (7 años + 2 días bisiestos)
integer
Para replicación, páginas o dam: número de días que se guardan los registros de auditoría. Los registros de auditoría anteriores al valor configurado se depuran.
contentPath
"/content"
"/content"
Cadena
Ruta de acceso en la que se purgarán los registros de auditoría, para el tipo relacionado. Debe establecerse en "/content".
tipos
todos los valores
todos los valores
Matriz de enumeración
Para replication, los valores enumerados son: Activate, Deactivate, Delete, Test, Reverse, Internal Poll. Para páginas, los valores enumerados son: PageCreated, PageModified, PageMoved, PageDeleted, VersionCreated, PageRestored, PageRolled Out, PageValid, PageInvalid. Para dam, los valores enumerados son: ASSET_EXPIRING, METADATA_UPDATED, ASSET_EXPIRED, ASSET_REMOVED, RESTORED, ASSET_MOVED, ASSET_VIEWED, PROJECT_VIEWED, PUBLISHED_EXTERNAL, COLLECTION_VIEWED, VERSIONED, ADDED_COMMENT, RENDITION_UPDATED, ACCEPTED, DOWNLOADED, SUBASSET_UPDATED , SUBASSET_REMOVED, ASSET_CREATED, ASSET_SHARED, RENDITION_REMOVED, ASSET_PUBLISHED, ORIGINAL_UPDATED, RENDITION_DOWNLOADED, REJECTED.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab