Ondersteunde configuraties
De volgende lijst biedt een uitvoerige lijst van dergelijke configuraties met verbindingen aan specifieke documentatie die zijn verschillende configuratiesyntaxis en andere informatie beschrijft.
| Type | YAML kind Waarde | Beschrijving |
|---|---|---|
| Regels van de Filter van het Verkeer, met inbegrip van WAF | CDN | Declareer regels om kwaadwillig verkeer te blokkeren |
| Transformaties van het Verzoek | CDN | Declareer regels om de vorm van het verkeersverzoek om te zetten |
| Transformaties van de Reactie | CDN | Declareer regels om de vorm van de reactie voor een bepaald verzoek om te zetten |
| Server-kant richtopnieuw | CDN | Declareer serveromleidingen van 301/302 stijl |
| de Selecteurs van de Oorsprong | CDN | Declareer regels om verkeer aan verschillende achtergronden, met inbegrip van toepassingen te leiden niet Adobe |
| CDN foutenpagina's | CDN | Overschrijf de standaardfoutpagina als de AEM-oorsprong niet kan worden bereikt. Hierbij wordt verwezen naar de locatie van zelfgehoste statische inhoud in het configuratiebestand |
| CDN zuiveren | CDN | Declareer de Leegmaken API-sleutels die worden gebruikt om de CDN op te lossen |
| Klantbeheerd het teken van HTTP CDN | CDN | Declareer de waarde van de x-AEM-Edge-Sleutel nodig om Adobe CDN van een CDN van de Klant te roepen |
| Basisauthentificatie | CDN | Declareer de gebruikersnamen en de wachtwoorden voor een basisautwiedialoog die bepaalde URLs beschermen. |
| Taak van het Onderhoud van de Opruiming van de Versie | MaintenanceTasks | Optimaliseer de AEM-opslagplaats door regels te declareren over het tijdstip waarop versies van inhoud moeten worden gewist |
| Taak van het Onderhoud van de Aanzuivering van het Logboek van de Controle | MaintenanceTasks | Optimaliseer het AEM controlelogboek voor verhoogde prestaties door regels rond te verklaren wanneer het logboek zou moeten worden gezuiverd |
| Logboek door:sturen | LogForwarding | Vorm de eindpunten en de geloofsbrieven voor het door:sturen van logboeken aan diverse bestemmingen, met inbegrip van Azure Blob Storage, Datadog, HTTPS, Elasticsearch, Splunk |
| registrerend een identiteitskaart van de Cliënt | API | Bereik Adobe Developer Console API-projecten voor een specifieke AEM-omgeving door de client-id te registreren. Dit is nodig voor gebruik van op OpenAPI gebaseerde API's die verificatie vereisen |
Config-pijplijnen maken en beheren
Voor informatie over om pijpleidingen tot stand te brengen en te vormen, zie CI/CD Pijpleidingen.
Wanneer het creëren van een config pijpleiding in Cloud Manager, ben zeker om a gerichte Plaatsing eerder dan Volledige Code van de Stapel te selecteren wanneer het vormen van de pijpleiding.
Zoals vroeger genoteerd, wordt de configuratie voor RDEs opgesteld gebruikend het hulpmiddel van de bevellijneerder dan een pijpleiding.
Algemene syntaxis
Elk configuratiebestand begint met eigenschappen die op het volgende voorbeeldfragment lijken:
kind: "LogForwarding"
version: "1"
metadata:
envTypes: ["dev"]
| Eigenschap | Beschrijving | Standaard |
|---|---|---|
kind | Een koord dat bepaalt welk type van configuratie, zoals logboek het door:sturen, de regels van de verkeersfilter, of verzoektransformaties | Vereist, geen standaard |
version | Een tekenreeks die de schemaversie vertegenwoordigt | Vereist, geen standaard |
envTypes | Deze array van tekenreeksen is een onderliggende eigenschap van het knooppunt metadata . Mogelijke waarden zijn dev, stage, prod of een willekeurige combinatie en het bepaalt voor welke omgevingstypen de configuratie wordt verwerkt. Als de array bijvoorbeeld alleen dev bevat, wordt de configuratie niet geladen in werkgebied- of prodomgevingen, zelfs niet als de configuratie daar wordt geïmplementeerd. | Alle omgevingstypen (dev, stage, prod) |
U kunt het hulpprogramma yq gebruiken om de YAML-opmaak van uw configuratiebestand lokaal te valideren (bijvoorbeeld yq cdn.yaml ).
Mapstructuur
Een map met de naam /config of een vergelijkbare map moet zich boven aan de structuur bevinden, met nog een YAML-bestand ergens in een boomstructuur eronder.
Bijvoorbeeld:
/config
cdn.yaml
of
/config
/dev
cdn.yaml
De mapnamen en bestandsnamen onder /config zijn willekeurig. Het YAML-bestand moet echter een geldige kind eigenschapswaardebevatten.
Configuraties worden doorgaans in alle omgevingen geïmplementeerd. Als alle bezitswaarden voor elk milieu identiek zijn, zal één enkel dossier YAML voldoende zijn. Het is echter gebruikelijk dat eigenschapswaarden verschillen tussen omgevingen, bijvoorbeeld tijdens het testen van een lagere omgeving.
In de volgende secties ziet u enkele strategieën voor het structureren van uw bestanden.
Eén configuratiebestand voor alle omgevingen
De bestandsstructuur lijkt op het volgende:
/config
cdn.yaml
logForwarding.yaml
Gebruik deze structuur wanneer de zelfde configuratie voor alle milieu's en voor alle types van configuratie (CDN, logboek het door:sturen, etc.) voldoende is. In dit scenario zou de array-eigenschap envTypes alle omgevingstypen bevatten.
kind: "cdn"
version: "1"
metadata:
envTypes: ["dev", "stage", "prod"]
Gebruikend geheim-type milieuvariabelen, is het mogelijk voor geheime eigenschappenper milieu te variëren, zoals die door de ${{SPLUNK_TOKEN}} verwijzing wordt geïllustreerd
kind: "LogForwarding"
version: "1"
metadata:
envTypes: ["dev"]
data:
splunk:
default:
enabled: true
host: "splunk-host.example.com"
token: "${{SPLUNK_TOKEN}}"
index: "AEMaaCS"