Questo argomento spiega come configurare e gestire i componenti del piano di runtime di Apigee hybrid. Per un elenco dei componenti del piano di runtime che puoi configurare, consulta Panoramica della configurazione dei servizi di runtime.
Informazioni sul file di override
La prima volta che installi il runtime ibrido in un cluster, devi creare un file di override della configurazione. Questo file ti consente di sostituire i valori di configurazione predefiniti in base alle esigenze, configurare gli ambienti, fare riferimento ai certificati TLS e alle chiavi dell'account di servizio, assegnare i pool di nodi Kubernetes a componenti ibridi specifici e così via.
I passaggi di installazione ibrida descrivono il processo di creazione di un file di override e l'applicazione della configurazione a un cluster. Se vuoi modificare la configurazione in un secondo momento, modifica il file di override che hai creato e applicalo di nuovo.
Modifica di una configurazione
Per apportare una modifica alla configurazione di un componente del piano di runtime ibrido,
modifica il file di override e
applica le modifiche con apigeectl.
Ad esempio, per modificare il conteggio delle repliche nel processore di messaggi, segui questi passaggi:
- Apri il file YAML di override. Assicurati di utilizzare lo stesso file di override utilizzato per installare il runtime ibrido nel cluster.
- Individua l'elemento
runtimenel file. Ad esempio:... runtime: nodeSelector: key: cloud.google.com/gke-nodepool value: apigee-runtime replicaCountMin: 1 replicaCountMax: 2 ... -
Modifica le proprietà del conteggio delle repliche in base alle esigenze. Ad esempio:
... runtime: nodeSelector: key: cloud.google.com/gke-nodepool value: apigee-runtime replicaCountMin: 2 replicaCountMax: 4 ... - Utilizza
apigeectlper applicare la modifica al cluster:apigeectl apply -f ./my_overrides.yaml -c runtime
Quali proprietà di configurazione puoi modificare?
Puoi trovare l'elenco completo delle proprietà configurabili nel Riferimento per le proprietà di configurazione. Il riferimento elenca solo le proprietà che puoi modificare. Se provi a modificare una proprietà non presente nel riferimento, la modifica viene ignorata.
Come utilizzare il riferimento alla configurazione
Il riferimento alla proprietà di configurazione utilizza la notazione con il punto per descrivere gli elementi di configurazione, dove il primo elemento è il nome dell'elemento di primo livello seguito da proprietà e proprietà secondarie. Ad esempio:
authz.image.pullPolicy
Nel file di override, la proprietà è formattata in formato YAML corretto. Per l'esempio precedente,
l'elemento authz di primo livello è rientrato a sinistra
e le proprietà dei sottoelementi sono rientrate al suo interno. Inoltre, YAML richiede i due punti alla fine di ogni elemento e sottoelemento.
Ad esempio, per impostare la proprietà authz.image.pullPolicy su Always, individua
questa sezione YAML nel file di override e impostala:
authz:
image:
pullPolicy: AlwaysPer un altro esempio, la proprietà cassandra.auth.admin.password (come
è elencata nel riferimento per le proprietà di configurazione) viene utilizzata per impostare la password
di amministrazione di Cassandra. Per modificarlo, individua il seguente codice YAML nel file di override e impostalo:
cassandra:
auth:
admin:
password: abc123Ricorda che il riferimento per le proprietà di configurazione descrive tutte le proprietà che puoi impostare sui componenti del piano di runtime ibrido. Segui il pattern spiegato sopra per modificare questi elementi nel file di override prima di applicare le modifiche al cluster.
Utilizzo di file di override di esempi predefiniti
Quando installi per la prima volta l'ambiente di runtime ibrido, Apigee consiglia di utilizzare uno dei file di override di esempio preconfigurati. Questi esempi forniscono un insieme completo di proprietà di configurazione per scenari di installazione specifici, ad esempio per la configurazione di un'installazione di produzione o di test. Tutto ciò che devi fare è fornire valori appropriati per le proprietà e applicare il file di override al cluster. Per saperne di più, consulta Creare un file di override.
Informazioni sui valori predefiniti di configurazione
Apigee gestisce la configurazione predefinita dei componenti nel file
hybrid_root_dir/config/values.yaml. I file di override seguono la stessa struttura YAML
di values.yaml.
Un file di override in genere include solo un sottoinsieme delle proprietà di configurazione presenti in
values.yaml. Ricorda che non
tutte le proprietà sono modificabili. Quando applichi una configurazione
a un cluster, gli override vengono uniti ai valori predefiniti per creare la configurazione completa del cluster Kubernetes. Vedi anche Output
della configurazione unita.
Il seguente codice mostra la configurazione predefinita del componente mart come
si trova in values.yaml. Tieni presente
che alcuni valori hanno valori predefiniti, mentre altri come sslCertPath e
sslKeyPath no. Devi fornire questi valori mancanti nel file di override, come spiegato nella procedura di installazione.
Se vuoi modificare uno dei valori predefiniti, assicurati che
siano modificabili controllando la Guida di riferimento alle proprietà di configurazione.
...
mart:
replicaCountMin: 2
replicaCountMax: 4
targetCPUUtilizationPercentage: 75
terminationGracePeriodSeconds: 30
sslCertPath:
sslKeyPath:
hostAlias:
nodeSelector:
key:
value:
revision: blue
image:
url: "google/apigee-mart-server"
tag: "1.0.0"
pullPolicy: IfNotPresent
resources:
requests:
cpu: 500m
memory: 512Mi
initCheckCF:
resources:
requests:
cpu: 10m
livenessProbe:
timeoutSeconds: 1
failureThreshold: 12
periodSeconds: 5
initialDelaySeconds: 15
readinessProbe:
timeoutSeconds: 1
successThreshold: 1
failureThreshold: 2
periodSeconds: 5
initialDelaySeconds: 15
metricsURL: "/v1/server/metrics"
cwcAppend: |
...Se vuoi modificare i valori predefiniti di un componente e questo non è già presente nel file di override, puoi copiarne il codice YAML da values.yaml nel file di override e modificarlo lì.
File di override di esempio
Apigee fornisce un insieme di file di override di esempio per aiutarti a configurare la tua implementazione ibrida. È consigliabile copiare e modificare il file di override che corrisponde maggiormente ai requisiti di installazione.
I seguenti esempi sono inclusi nella
directory hybrid_root_dir/examples:
| File di override di esempio | Descrizione |
|---|---|
overrides-small.yaml |
Questo campione è ideale per iniziare rapidamente. Utilizza l'impronta minima consigliata per avviare i componenti runtime ibridi. Questa configurazione di esempio si basa il più possibile su impostazioni e valori predefiniti. Tutte le repliche minime sono impostate su 1. |
overrides-medium.yaml |
Questo esempio è un buon punto di partenza per gli ambienti di test e QA. Ai singoli componenti è stato concesso un livello di risorse più elevato per gestire il traffico aggiuntivo. Cassandra utilizza dischi SSD per le prestazioni. In questo ambiente, è consigliabile che gli utenti installino componenti con stato e senza stato su nodi separati. Consulta Configurare i nodi dedicati. |
overrides-large.yaml |
Questo esempio è un buon punto di partenza per ambienti ad alte prestazioni come pre-produzione e produzione. L'esempio include proprietà per l'impostazione di chiavi di crittografia, password e altro ancora. I singoli componenti hanno un minimo di due repliche. |
Output della configurazione unita
Puoi utilizzare il flag--dry-run con apigeectl per generare l'output del file di configurazione unito senza applicarlo effettivamente al cluster. Questa opzione è utile per il debug di un problema di installazione perché mostra esattamente cosa verrà applicato al cluster.
È anche consigliabile generare l'output della configurazione e archiviarlo nel
controllo del codice sorgente in modo da avere un riferimento delle risorse installate
e configurate nel cluster.
Ad esempio:
apigeectl apply -f ./my_overrides.yaml --dry-run --print-yaml > apigee-hybrid.yaml
Per ulteriori informazioni, vedi apigeectl.
Crea più file di override in base alle esigenze
Puoi creare tutti i file di override che vuoi, ognuno dei quali soddisfa un requisito specifico. Ad esempio, potresti avere un file di override che ottimizza il cluster per la produzione e un altro per la creazione di un cluster di test. Puoi quindi gestire questi file nel tuo sistema di controllo del codice sorgente.
Utilizza l'opzione -f con apigeectl per specificare la posizione e il nome
di un file di override. Ad esempio:
apigeectl apply -f ./test_env_override.yaml
Per ulteriori informazioni, vedi apigeectl.
Eliminare i componenti del piano di runtime specifici per hybrid
Per eliminare i componenti del piano di runtime specifici per l'ibrido dal cluster, utilizza il
comando apigeectl delete. Questi componenti includono sincronizzatore, mart,
runtime, cassandra e udca. Assicurati di specificare lo stesso file di override che
hai utilizzato per installare i componenti runtime:
Ad esempio:
apigeectl delete -f ./my_overrides.yaml
Puoi utilizzare il comando apigeectl apply per ricreare un componente o
componenti specifici:
apigeectl apply -c synchronizer -f ./my_overrides.yaml
Per ulteriori informazioni, vedi apigeectl.
Eliminare un componente specifico
Se vuoi eliminare solo un componente specifico, utilizza l'opzione
-c con apigeectl delete. Assicurati di specificare lo stesso file di override che hai utilizzato per installare i componenti runtime.
Ad esempio, per eliminare il componente Synchronizer, utilizza questo comando:
apigeectl delete -c synchronizer -f ./my_overrides.yaml
Puoi quindi utilizzare il comando apigeectl apply per ricreare il componente:
apigeectl apply -c synchronizer -f ./my_overrides.yaml
Per ulteriori informazioni, vedi apigeectl.
Elimina tutti i componenti
Per eliminare tutti i componenti ibridi del cluster, inclusi quelli creati dal
comando apigeectl init, utilizza il
comando apigeectl delete con il flag --all. Assicurati
di specificare lo stesso file di override che
hai utilizzato per installare i componenti runtime:
Ad esempio:
apigeectl delete -f ./my_overrides.yaml --all
Per ulteriori informazioni, vedi apigeectl.