Underhållsaktiviteter i AEM as a Cloud Service maintenance-tasks-in-aem-as-a-cloud-service

Underhållsåtgärder är processer som körs enligt ett schema för att optimera databasen. Med AEM as a Cloud Service är behovet av att kunderna konfigurerar driftsegenskaperna för underhållsåtgärder minimal. Kunderna kan fokusera sina resurser på frågor som rör applikationsnivå och lämna infrastrukturåtgärderna åt Adobe.

Konfigurera underhållsåtgärder maintenance-tasks-configuring

I tidigare versioner av AEM kunde du konfigurera underhållsåtgärder med underhållskortet (Verktyg > Åtgärder > Underhåll). Underhållskortet för AEM as a Cloud Service är inte längre tillgängligt, så konfigurationer bör implementeras för källkontroll och driftsättas med Cloud Manager. Adobe hanterar de underhållsåtgärder som har inställningar som inte kan konfigureras av kunder (till exempel Datastore Garbage Collection). Andra underhållsuppgifter kan konfigureras av kunder, vilket beskrivs i tabellen nedan.

CAUTION
Adobe förbehåller sig rätten att åsidosätta en kunds konfigurationsinställningar för underhållsaktiviteter för att minska problem som prestandaförsämringar.

Följande tabell visar vilka underhållsuppgifter som är tillgängliga.

Underhållsaktivitet
Vem äger konfigurationen
Konfigurera (valfritt)
Skräpsamling för datastaarkiv
Adobe
Ej tillämpligt - ägs till fullo av Adobe
Rensa version
Kund
Borttagning av version är för närvarande inaktiverat som standard, men principen kan konfigureras enligt beskrivningen i avsnittet Rensa och Rensa granskningslogg.

Rensning kommer snart att vara aktiverat som standard, med dessa värden åsidosatta.
Rensa granskningslogg
Kund
Rensa granskningslogg är för närvarande inaktiverat som standard, men principen kan konfigureras enligt beskrivningen i avsnittet Rensa version och Rensa granskningslogg - underhållsaktiviteter.

Rensning kommer snart att vara aktiverat som standard, med dessa värden åsidosatta.
Lucene Binaries Cleanup
Adobe
Oanvänd och därför inaktiverad av Adobe.
Ad hoc-aktivitetsrensning
Kund

Måste göras i git. Åsidosätt den körklara konfigurationsnoden för underhållsfönstret under /libs genom att skapa egenskaper under mappen /apps/settings/granite/operations/maintenance/granite_weekly, granite_daily eller granite_monthly.

Se tabellen i underhållsfönstret nedan för ytterligare konfigurationsinformation. Aktivera underhållsaktiviteten genom att lägga till en annan nod under noden ovan. Ge den namnet granite_TaskPurgeTask, med attributet sling:resourceType inställt på granite/operations/components/maintenance/task och attributet granite.maintenance.name inställt på TaskPurge. Konfigurera OSGI-egenskaperna, se com.adobe.granite.taskmanagement.impl.purge.TaskPurgeMaintenanceTask för en lista över egenskaper.

Rensa arbetsflöde
Kund

Måste göras i git. Åsidosätt den körklara konfigurationsnoden för underhållsfönstret under /libs genom att skapa egenskaper under mappen /apps/settings/granite/operations/maintenance/granite_weekly, granite_daily eller granite_monthly. Se tabellen i underhållsfönstret nedan för ytterligare konfigurationsinformation.

Aktivera underhållsaktiviteten genom att lägga till en annan nod under noden ovan (namnge den granite_WorkflowPurgeTask) med lämpliga egenskaper. Konfigurera OSGI-egenskaperna i AEM 6.5-underhållsaktivitetens dokumentation.

Rensa projekt
Kund

Måste göras i git. Åsidosätt den körklara konfigurationsnoden för underhållsfönstret under /libs genom att skapa egenskaper under mappen /apps/settings/granite/operations/maintenance/granite_weekly, granite_daily eller granite_monthly. Se tabellen i underhållsfönstret nedan för ytterligare konfigurationsinformation.

Aktivera underhållsaktiviteten genom att lägga till en annan nod under noden ovan (namnge den granite_ProjectPurgeTask) med lämpliga egenskaper. Se listan över OSGi-egenskaper för Adobe Projects Renge Configuration .

Konfiguration av underhållsfönster
Vem äger konfigurationen
Konfigurationstyp
Parametrar
Dagligen
Kund
JCR-noddefinition

windowSchedule=day (det här värdet ska inte ändras)

windowStartTime=HH:MM använder som 24-timmars klocka. Definierar när underhållsaktiviteterna som är kopplade till fönstret Dagligt underhåll ska börja köras.

windowEndTime=HH:MM använder som 24-timmars klocka. Definierar när underhållsaktiviteterna som är kopplade till fönstret Dagligt underhåll ska sluta köras om de inte redan har slutförts.

En underhållsaktivitet kan inte utföras mer än en gång under den här tidsramen.

Vecka
Kund
JCR-noddefinition

windowSchedule=week (det här värdet ska inte ändras)

windowStartTime=HH:MM använder som 24-timmars klocka. Definierar när underhållsaktiviteterna som är kopplade till veckounderhållet ska börja köras.

windowEndTime=HH:MM använder som 24-timmars klocka. Definierar när underhållsaktiviteterna som är kopplade till veckounderhållet ska sluta köras om de inte redan har slutförts.

En underhållsaktivitet kan inte utföras mer än en gång under den här tidsramen.

windowScheduleWeekdays= Array med två värden från 1-7 (till exempel [5,5]) Det första värdet i arrayen är startdagen när jobbet schemaläggs och det andra värdet är slutdagen när jobbet stoppas. Den exakta tiden för start och slut styrs av windowStartTime respektive windowEndTime.

Månadsvis
Kund
JCR-noddefinition

windowSchedule=monthly (det här värdet ska inte ändras)

windowStartTime=HH:MM använder som 24-timmars klocka. Definierar när underhållsaktiviteterna som är kopplade till fönstret för månatligt underhåll ska börja köras.

windowEndTime=HH:MM använder som 24-timmars klocka. Definierar när underhållsaktiviteterna som är kopplade till fönstret för månatligt underhåll ska sluta köras om de inte redan har slutförts.

En underhållsaktivitet kan inte utföras mer än en gång under den här tidsramen.

windowScheduleWeekdays=Array med två värden från 1-7 (till exempel [5,5]) Det första värdet i arrayen är startdagen när jobbet schemaläggs och det andra värdet är slutdagen när jobbet stoppas. Den exakta tiden för start och slut styrs av windowStartTime respektive windowEndTime.

windowFirstLastStartDay= 0/1 0 att schemalägga den första veckan i månaden eller 1 att schemalägga den sista veckan i månaden. Om ett värde saknas schemaläggs jobben effektivt på den dag som styrs av windowScheduleWeekdays (varje månad).

Platser:

  • Dagligen - /apps/settings/granite/operations/intenance/granite_day
  • Varje vecka - /apps/settings/granite/operations/intenance/granite_week
  • Månadsvis - /apps/settings/granite/operations/intenance/granite_monthly

Kodexempel:

Kodexempel 1 (dagligen)

<?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"
 />

Kodexempel 2 (varje vecka)

<?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"/>

Kodexempel 3 (månadsvis)

<?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"/>

Underhållsaktiviteter vid rensning av version och granskningslogg purge-tasks

När du rensar versioner och granskningsloggen minskas storleken på databasen, och i vissa scenarier kan prestandan förbättras.

NOTE
AEM Guides-kunder bör inte konfigurera version Rensa.

Standardvärden defaults

Rensa är för närvarande inte aktiverat som standard, men det kommer att ändras i framtiden. Miljöer som skapades innan standardrensningen aktiverades får ett mer konservativt tröskelvärde så att rensning inte inträffar oväntat. Se avsnitten Rensa och Rensa granskningslogg för version nedan för mer information om standardprincipen för rensning.

Standardvärdena för tömning kan åsidosättas genom att en konfigurationsfil deklareras och distribueras enligt beskrivningen nedan.

Använda en konfiguration configure-purge

Deklarera en konfigurationsfil och distribuera den enligt anvisningarna i följande steg.

NOTE
När du har distribuerat noden för versionsrensning i konfigurationsfilen måste du behålla den deklarerad och inte ta bort den. Konfigurationsflödet misslyckas om du försöker göra det.
På samma sätt måste du behålla granskningsloggens deklarerade nod och inte ta bort den när du distribuerar granskningsloggens tömningsnod i konfigurationsfilen.

1 - skapa följande mapp- och filstruktur i mappen på den översta nivån i ditt projekt i Git:

config/
     mt.yaml

2 - Deklarera egenskaper i konfigurationsfilen, som innehåller:

  • en"kind"-egenskap med värdet"MaintenanceTasks".
  • en "version"-egenskap (för närvarande är vi i version 1).
  • ett valfritt metadataobjekt med egenskapen envTypes med en kommaavgränsad lista över den miljötyp (dev, stage, prod) som den här konfigurationen är giltig för. Om inget metadataobjekt har deklarerats är konfigurationen giltig för alla miljötyper.
  • ett dataobjekt med både versionPurge och auditLogPurge objekt.

Se definitioner och syntax för objekten versionPurge och auditLogPurge nedan.

Du bör strukturera konfigurationen på liknande sätt som i följande exempel:

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"]

Kom ihåg att för att konfigurationen ska vara giltig:

  • alla egenskaper måste definieras. Det finns inga ärvda standardvärden.
  • Typerna (heltal, strängar, booleska värden etc.) i egenskapstabellen nedan måste respekteras.
NOTE
Du kan använda yq för att lokalt validera YAML-formateringen i konfigurationsfilen (till exempel yq mt.yaml).

3 - Konfigurera pipelines för icke-produktion och produktionskonfiguration.

Snabba utvecklingsmiljöer (RDE) har inte stöd för tömning. För andra miljötyper i produktionsprogram (icke-sandlådeprogram) skapar du en riktad distributionskonfigurationspipeline i Cloud Manager.

Mer information finns i konfigurera produktionspipelines och konfigurera icke-produktionspipelines.

Rensa version version-purge

NOTE
AEM Guides-kunder bör inte konfigurera version Rensa.

Standard för rensning av version version-purge-defaults

Rensa är för närvarande inte aktiverat som standard, men det kommer att ändras i framtiden.

Miljöer som skapades när standardrensningen är aktiverad får följande standardvärden:

  • Versioner äldre än 30 dagar tas bort.
  • De senaste fem versionerna de senaste 30 dagarna bevaras.
  • Oavsett reglerna ovan bevaras den senaste versionen (utöver den aktuella filen).

Miljöer som skapades innan standardrensningen är aktiverad kommer att ha standardvärdena som listas nedan, men vi rekommenderar att du sänker dessa värden för att optimera prestanda.

  • Versioner äldre än 7 år tas bort.
  • Alla versioner de senaste sju åren sparas.
  • Efter 7 år tas andra versioner än den senaste versionen (utöver den aktuella filen) bort.

Egenskaper för versionsrensning version-purge-properties

Tillåtna egenskaper visas nedan.

Kolumnerna som indikerar standard anger standardvärdena i framtiden, när standardvärden används. TBD visar ett miljö-ID som fortfarande inte har bestämts.

Egenskaper
framtida standard för envs>TBD
framtida standard för envs<=TBD
obligatoriskt
type
Värden
banor
[/content ]
[/content ]
Ja
array med strängar
Anger under vilka sökvägar versioner ska rensas när nya versioner skapas. Kunder måste deklarera den här egenskapen, men det enda tillåtna värdet är /content.
maximumAgeDays
30
2557 (7 år + 2 skottdagar)
Ja
Heltal
Alla versioner som är äldre än det konfigurerade värdet tas bort. Om värdet är 0 utförs inte rensning baserat på versionens ålder.
maximumVersions
5
0 (ingen gräns)
Ja
Heltal
Alla versioner som är äldre än den n:te nyaste versionen tas bort. Om värdet är 0 utförs inte rensning baserat på antalet versioner.
minimumVersions
1
1
Ja
Heltal
Det minsta antalet versioner som behålls oavsett ålder. Observera att minst en version alltid behålls. Värdet måste vara 1 eller högre.
keepLabelledVersioned
false
false
Ja
boolesk
Avgör om explicit märkta versioner ska exkluderas från rensningen. För bättre databasoptimering rekommenderar vi att du anger värdet till false.

Egenskapsinteraktioner

Följande exempel visar hur egenskaper interagerar när de kombineras.

Exempel:

maximumAgeDays = 30
maximumVersions = 10
minimumVersions = 2

Om det finns 11 versioner dag 23, kommer den äldsta versionen att rensas nästa gång underhållsaktiviteten rensas, eftersom egenskapen maximumVersions är inställd på 10.

Om det finns 5 versioner på dag 31 kommer endast 3 att rensas eftersom egenskapen minimumVersions är inställd på 2.

Exempel:

maximumAgeDays = 30
maximumVersions = 0
minimumVersions = 1

Inga versioner som är senare än 30 dagar rensas eftersom egenskapen maximumVersions är inställd på 0.

En version som är äldre än 30 dagar behålls.

Rensa granskningslogg audit-purge

Granska rensningsstandardinställningar för logg audit-purge-defaults

Rensa är för närvarande inte aktiverat som standard, men det kommer att ändras i framtiden.

Miljöer som skapades när standardrensningen är aktiverad får följande standardvärden:

  • Replikerings-, DAM- och sidgranskningsloggar som är äldre än 7 dagar tas bort.
  • Alla möjliga händelser loggas.

Miljöer som skapades innan standardrensningen är aktiverad kommer att ha standardvärdena som listas nedan, men vi rekommenderar att du sänker dessa värden för att optimera prestanda.

  • Replikerings-, DAM- och sidgranskningsloggar som är äldre än 7 år tas bort.
  • Alla möjliga händelser loggas.
NOTE
Vi rekommenderar att kunder som har lagstadgade krav på att skapa icke redigerbara granskningsloggar integreras med specialiserade externa tjänster.

Rensa egenskaper för granskningslogg audit-purge-properties

Tillåtna egenskaper visas nedan.

Kolumnerna som indikerar standard anger standardvärdena i framtiden, när standardvärden används. TBD visar ett miljö-ID som fortfarande inte har bestämts.

Egenskaper
framtida standard för envs>TBD
framtida standard för envs<=TBD
obligatoriskt
type
Värden
regler
-
-
Ja
Objekt
En eller flera av följande noder: replikering, sidor, dam. Var och en av dessa noder definierar regler, med egenskaperna nedan. Alla egenskaper måste deklareras.
maximumAgeDays
7 dagar
för alla, 2557 (7 år + 2 skottdagar)
Ja
heltal
För replikering, sidor eller damm: antalet dagar som granskningsloggarna sparas. Granskningsloggar som är äldre än det konfigurerade värdet rensas.
contentPath
"/content"
"/content"
Ja
Sträng
Sökvägen som granskningsloggarna rensas under, för den relaterade typen. Måste vara inställt på /content.
typer
alla värden
alla värden
Ja
Uppräkningsmatris
De uppräknade värdena för replikering är: Aktivera, Inaktivera, Ta bort, Testa, Invertera, Intern omröstning. För sidor är de uppräknade värdena: PageCreated, PageModified, PageMoved, PageDeleted, VersionCreated, PageRestated, PageRolled Out, PageValid, PageInvalid. De uppräknade värdena för dam är: 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_TION HÄMTAD, AVVISAD.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab