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.
Typ | YAML kind -värde | Beskrivning |
---|---|---|
Trafikfilterregler, inklusive WAF | CDN | Deklarera regler för att blockera skadlig trafik |
Begär omformningar | CDN | Deklarera regler för att omforma formen på trafikförfrågan |
Svarsomvandlingar | CDN | Deklarera regler för att omforma formen på svaret för en given begäran |
Omdirigeringar på klientsidan | CDN | Deklarera 301/302-liknande omdirigeringar på klientsidan |
Väljare för ursprung | CDN | Deklarera regler för att dirigera trafik till olika backend-system, inklusive program utanför Adobe |
CDN-felsidor | CDN | Åsidosätt standardfelsidan om AEM inte kan nås och refererar till platsen för statiskt innehåll som lagras automatiskt i konfigurationsfilen |
CDN-rensning | CDN | Deklarera de rensnings-API-nycklar som används för att rensa CDN |
Kundhanterad CDN HTTP-token | CDN | Deklarera värdet på den X-AEM-Edge-nyckel som behövs för att anropa Adobe CDN från en kundens CDN |
Grundläggande autentisering | CDN | Deklarera användarnamn och lösenord för en grundläggande autentiseringsdialogruta som skyddar vissa URL:er. |
Underhållsaktivitet för versionsrensning | MaintenanceTasks | Optimera AEM genom att deklarera regler runt när innehållsversioner ska rensas |
Granskningslogg Rensa underhållsaktivitet | MaintenanceTasks | Optimera AEM granskningslogg för bättre prestanda genom att deklarera regler runt när loggar ska rensas |
Loggvidarebefordran | LogForwarding | Konfigurera 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"]
Egenskap | Beskrivning | Standard |
---|---|---|
kind | En sträng som avgör vilken typ av konfiguration, till exempel vidarebefordran av loggfiler, trafikfilterregler eller begäranomvandlingar | Obligatoriskt, ingen standard |
version | En sträng som representerar schemaversionen | Obligatoriskt, ingen standard |
envTypes | Den 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"