Konfigurationer som stöds

I följande tabell finns en omfattande lista över sådana konfigurationer med länkar till dedikerad dokumentation som beskriver dess distinkta konfigurationssyntax och annan information.

TypYAML kind-värdeBeskrivning
Trafikfilterregler, inklusive WAFCDNDeklarera regler för att blockera skadlig trafik
Begär omformningarCDNDeklarera regler för att omforma formen på trafikförfrågan
SvarsomvandlingarCDNDeklarera regler för att omforma formen på svaret för en given begäran
Omdirigeringar på klientsidanCDNDeklarera 301/302-liknande omdirigeringar på klientsidan
Väljare för ursprungCDNDeklarera regler för att dirigera trafik till olika backend-system, inklusive program utanför Adobe
CDN-felsidorCDNÅsidosätt standardfelsidan om AEM inte kan nås och refererar till platsen för statiskt innehåll som lagras automatiskt i konfigurationsfilen
CDN-rensningCDNDeklarera de rensnings-API-nycklar som används för att rensa CDN
Kundhanterad CDN HTTP-tokenCDNDeklarera värdet på den X-AEM-Edge-nyckel som behövs för att anropa Adobe CDN från en kundens CDN
Grundläggande autentiseringCDNDeklarera användarnamn och lösenord för en grundläggande autentiseringsdialogruta som skyddar vissa URL:er.
Underhållsaktivitet för versionsrensningMaintenanceTasksOptimera AEM genom att deklarera regler runt när innehållsversioner ska rensas
Granskningslogg Rensa underhållsaktivitetMaintenanceTasksOptimera AEM granskningslogg för bättre prestanda genom att deklarera regler runt när loggar ska rensas
LoggvidarebefordranLogForwardingKonfigurera slutpunkterna och autentiseringsuppgifterna för vidarebefordran av loggar till olika mål, inklusive Azure Blob Storage, DataDig, HTTPS, Elasticsearch, Splunk)

Skapa och hantera konfigurationsförlopp

Mer information om hur du skapar och konfigurerar rörledningar finns i dokumentet CI/CD Pipelines.

När du skapar en konfigurationspipeline i Cloud Manager måste du välja en riktad distribution i stället för fullständig stackkod när du konfigurerar pipeline.

Som tidigare nämnts distribueras konfigurationen för RDE med kommandoradsverktyg i stället för en pipeline.

Vanlig syntax

Varje konfigurationsfil börjar med egenskaper som liknar följande exempelkodfragment:

  kind: "LogForwarding"
  version: "1"
  metadata:
    envTypes: ["dev"]
EgenskapBeskrivningStandard
kindEn sträng som avgör vilken typ av konfiguration, till exempel vidarebefordran av loggfiler, trafikfilterregler eller begäranomvandlingarObligatoriskt, ingen standard
versionEn sträng som representerar schemaversionenObligatoriskt, ingen standard
envTypesDen här strängmatrisen är en underordnad egenskap för noden metadata. Möjliga värden är dev, stage, prod eller valfri kombination och avgör för vilka miljötyper konfigurationen ska bearbetas. Om matrisen till exempel bara innehåller dev läses konfigurationen inte in i scen- eller produktmiljöer, även om konfigurationen distribueras där.Alla miljötyper (dev, stage, prod)

Du kan använda verktyget yq för att lokalt validera YAML-formateringen av konfigurationsfilen (till exempel yq cdn.yaml).

Mappstruktur

En mapp med namnet /config eller liknande bör finnas högst upp i trädet, med en eller flera YAML-filer någonstans i ett träd nedanför.

Till exempel:

/config
  cdn.yaml

eller

/config
  /dev
    cdn.yaml

Mappnamnen och filnamnen under /config är godtyckliga. YAML-filen måste dock innehålla ett giltigt kind-egenskapsvärde.

Konfigurationer distribueras vanligtvis till alla miljöer. Om alla egenskapsvärden är identiska för varje miljö räcker det med en YAML-fil. Det är dock vanligt att egenskapsvärden skiljer sig åt mellan olika miljöer, till exempel när en lägre miljö testas.

I följande avsnitt visas några strategier för hur du strukturerar filer.

En enda konfigurationsfil för alla miljöer

Filstrukturen ser ut ungefär så här:

/config
  cdn.yaml
  logForwarding.yaml

Använd den här strukturen när samma konfiguration räcker för alla miljöer och för alla typer av konfigurationer (CDN, loggvidarebefordran osv.). I det här scenariot skulle matrisegenskapen envTypes innehålla alla miljötyper.

   kind: "cdn"
   version: "1"
   metadata:
     envTypes: ["dev", "stage", "prod"]

Om du använder miljövariabler av hemlig typ kan hemliga egenskaper variera per miljö, vilket visas i referensen ${{SPLUNK_TOKEN}}

kind: "LogForwarding"
version: "1"
metadata:
  envTypes: ["dev"]
data:
  splunk:
    default:
      enabled: true
      host: "splunk-host.example.com"
      token: "${{SPLUNK_TOKEN}}"
      index: "AEMaaCS"