Configurazioni supportate
La tabella seguente offre un elenco completo di tali configurazioni, con collegamenti alla documentazione dedicata che descrive la sintassi di configurazione specifica e altre informazioni.
| Tipo | Valore kind YAML | Descrizione |
|---|---|---|
| Regole filtro traffico, incluso WAF | CDN | Dichiarare le regole per bloccare il traffico dannoso |
| Richiedi trasformazioni | CDN | Dichiarare le regole per trasformare la forma della richiesta di traffico |
| Trasformazioni risposta | CDN | Dichiarare le regole per trasformare la forma della risposta per una determinata richiesta |
| Reindirizzamenti lato client | CDN | Dichiara reindirizzamenti lato client 301/302 |
| Selettori origine | CDN | Dichiarare le regole per indirizzare il traffico a diversi backend, incluse le applicazioni non Adobe |
| Pagine errore CDN | CDN | Sostituisci la pagina di errore predefinita se non è possibile raggiungere l’origine AEM, facendo riferimento alla posizione del contenuto statico con hosting autonomo nel file di configurazione |
| Rimozione CDN | CDN | Dichiara le chiavi API di rimozione utilizzate per rimuovere la rete CDN |
| Token HTTP CDN gestito dal cliente | CDN | Dichiara il valore della chiave X-AEM-Edge necessaria per chiamare la rete CDN di Adobe da una rete CDN del cliente |
| Autenticazione di base | CDN | Dichiara i nomi utente e le password per una finestra di dialogo di autenticazione di base che protegge alcuni URL. |
| Attività di manutenzione Pulizia versione | MaintenanceTasks | Ottimizza l’archivio AEM dichiarando le regole per determinare quando le versioni dei contenuti devono essere eliminate |
| Attività di manutenzione eliminazione registro di controllo | MaintenanceTasks | Ottimizza il registro di audit dell’AEM per migliorare le prestazioni dichiarando regole su quando eliminare i registri |
| Inoltro registro | LogForwarding | Configurare gli endpoint e le credenziali per l’inoltro dei registri a varie destinazioni, tra cui Archiviazione BLOB di Azure, Datadog, HTTPS, Elasticsearch, Splunk) |
Creazione e gestione delle pipeline di configurazione
Per informazioni su come creare e configurare le pipeline, consulta Pipeline CI/CD.
Durante la creazione di una pipeline di configurazione in Cloud Manager, assicurati di selezionare una distribuzione di destinazione anziché codice full stack durante la configurazione della pipeline.
Come indicato in precedenza, la configurazione per gli RDE viene distribuita utilizzando strumenti della riga di comando anziché una pipeline.
Sintassi comune
Ogni file di configurazione inizia con proprietà simili al seguente snippet di esempio:
kind: "LogForwarding"
version: "1"
metadata:
envTypes: ["dev"]
| Proprietà | Descrizione | Predefiniti |
|---|---|---|
kind | Stringa che determina il tipo di configurazione, ad esempio inoltro registro, regole del filtro del traffico o trasformazioni richieste | Obbligatorio, nessun valore predefinito |
version | Stringa che rappresenta la versione dello schema | Obbligatorio, nessun valore predefinito |
envTypes | Questa matrice di stringhe è una proprietà figlio del nodo metadata. I valori possibili sono dev, stage, prod o qualsiasi combinazione e determinano per quali tipi di ambiente verrà elaborata la configurazione. Ad esempio, se l'array include solo dev, la configurazione non verrà caricata negli ambienti di staging o di produzione, anche se la configurazione è distribuita lì. | Tutti i tipi di ambiente (dev, stage, prod) |
È possibile utilizzare l'utilità yq per convalidare localmente la formattazione YAML del file di configurazione (ad esempio, yq cdn.yaml).
Struttura delle cartelle
Una cartella denominata /config o simile deve trovarsi nella parte superiore della struttura, con uno o più file YAML in una struttura al di sotto di essa.
Ad esempio:
/config
cdn.yaml
oppure
/config
/dev
cdn.yaml
I nomi delle cartelle e dei file sotto /config sono arbitrari. Il file YAML, tuttavia, deve includere un valore di proprietà kind valido.
In genere, le configurazioni vengono distribuite in tutti gli ambienti. Se tutti i valori delle proprietà sono identici per ogni ambiente, è sufficiente un singolo file YAML. Tuttavia, è comune che i valori delle proprietà differiscano tra gli ambienti, ad esempio durante il test di un ambiente inferiore.
Le sezioni seguenti illustrano alcune strategie per strutturare i file.
Un singolo file di configurazione per tutti gli ambienti
La struttura del file sarà simile alla seguente:
/config
cdn.yaml
logForwarding.yaml
Utilizza questa struttura quando la stessa configurazione è sufficiente per tutti gli ambienti e per tutti i tipi di configurazione (CDN, inoltro registro e così via). In questo scenario, la proprietà dell'array envTypes includerebbe tutti i tipi di ambiente.
kind: "cdn"
version: "1"
metadata:
envTypes: ["dev", "stage", "prod"]
Utilizzando variabili di ambiente di tipo segreto, è possibile che proprietà segrete varino in base all'ambiente, come illustrato dal riferimento a ${{SPLUNK_TOKEN}}
kind: "LogForwarding"
version: "1"
metadata:
envTypes: ["dev"]
data:
splunk:
default:
enabled: true
host: "splunk-host.example.com"
token: "${{SPLUNK_TOKEN}}"
index: "AEMaaCS"