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 la Panoramica della configurazione dei servizi di runtime.
Informazioni sul file delle sostituzioni
La prima volta che installi il runtime ibrido in un cluster, devi Crea un file di configurazione che sostituisce il file. Questo file consente di eseguire l'override della configurazione predefinita i valori in base alle esigenze, configurare gli ambienti, fare riferimento ai certificati TLS e al servizio dell'account, assegnare a Kubernetes pool di nodi a specifici componenti ibridi e così via.
I passaggi di installazione dell'architettura ibrida illustrano la procedura di creazione di un file di override e di applicazione della configurazione a un cluster. Se vuoi modificare la configurazione in un secondo momento, modifica il file degli override creato e applicarlo di nuovo.
Apportare una modifica alla configurazione
Per apportare una modifica alla configurazione di un componente del piano di runtime ibrido,
modificare il file di override
applica le modifiche con apigeectl
.
Ad esempio, per modificare il numero di repliche sul Processore di messaggi, segui questi passaggi:
- Apri il file YAML delle sostituzioni. Assicurati di utilizzare lo stesso file di override utilizzato per installare il runtime ibrido nel cluster.
- Individua l'elemento
runtime
nel 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
apigeectl
per applicare la modifica al cluster:apigeectl apply -f ./my_overrides.yaml --org --env env-name
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 tenti di modificare una proprietà che non è riferimento, la modifica viene ignorata.
Come utilizzare il riferimento alla configurazione
Il riferimento alla proprietà di configurazione utilizza la notazione a punti 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 delle sostituzioni, le proprietà sono formattate in YAML corretto. Nell'esempio riportato sopra,
l'elemento authz
di primo livello è rientrato a sinistra
e le proprietà degli elementi secondari sono rientrate sotto. Inoltre, YAML richiede due punti alla fine di ogni elemento e sottoelemento.
Ad esempio, per impostare la proprietà authz.image.pullPolicy
su Always
, individua questa stanza YAML nel file delle sostituzioni e impostala:
authz: image: pullPolicy: Always
Un altro esempio è la proprietà cassandra.auth.admin.password
(indicata nel Riferimento per le proprietà di configurazione) che viene utilizzata per impostare la password di amministratore di Cassandra. Per modificarlo, individua il seguente YAML nel file degli override e imposta
Questo:
cassandra: auth: admin: password: abc123
Ricorda che il Riferimento proprietà di configurazione descrive tutte le proprietà che puoi impostare. sui componenti del piano di runtime ibrido. Segui lo schema spiegato sopra per modificare questi elementi nel file delle sostituzioni prima di applicare le modifiche al cluster.
L'utilizzo di un esempio predefinito esegue l'override dei file
Quando installi per la prima volta il runtime ibrida, Apigee consiglia di utilizzare uno dei file di override di esempio preconfigurati. Questi esempi forniscono un insieme completo proprietà per scenari di installazione specifici, come la configurazione di un'installazione di produzione o di test. Devi solo fornire i valori appropriati per le proprietà e applica il file degli override al cluster. Per ulteriori informazioni, consulta Creare un file di override.
Informazioni sulle impostazioni predefinite di configurazione
Apigee mantiene 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 l'ambiente Kubernetes completo
e la configurazione del cluster. Vedi anche Output
la configurazione unita.
Il seguente codice mostra la configurazione predefinita per il componente mart
come
rilevato in values.yaml
. Nota
alcuni valori hanno valori predefiniti, mentre altri, come sslCertPath
e
sslKeyPath
no. Devi indicare questi valori mancanti nei
di override, come spiegato nella procedura di installazione.
Se vuoi modificare uno dei valori predefiniti, assicurati che siano modificabili controllandoli nel riferimento alla 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 il componente non è già presente nel file delle sostituzioni, puoi copiare il relativo file YAML da values.yaml
nel file delle sostituzioni e modificarlo lì.
File di override di esempio
Apigee fornisce un set di file di esempio per gli override ti guideranno nella configurazione del deployment ibrido. È buona prassi copiare e modificare il file delle sostituzioni 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 esempio è ideale per iniziare rapidamente. Utilizza l'impronta minima consigliata per avviare i componenti runtime ibrida. 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 più elevato di risorse per gestire il traffico aggiuntivo. Cassandra utilizza dischi SSD per migliorare le prestazioni. In questo ambiente, è consigliabile che gli utenti installino stateful e stateless 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 le proprietà per l'impostazione chiavi di crittografia, password e altro. I singoli componenti hanno un minimo di due repliche. |
Visualizza la configurazione unita
Puoi utilizzare il flag--dry-run
con apigeectl
per generare l'unione
di configurazione senza applicarlo effettivamente al cluster. Questa opzione è utile per il debug di un
problema di installazione perché ti mostra esattamente cosa verrà applicato al cluster.
È inoltre buona norma generare l'output della configurazione e archiviarla nel controllo dei file 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 tue esigenze
Puoi creare tutti i file di override che vuoi, ognuno dei quali pubblica una specifica requisito. Ad esempio, potresti avere un file di override che ottimizza il cluster per produzione e un altro per la creazione di un cluster di test. Puoi quindi gestire questi file nel tuo sistema di controllo dei file 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 di hybrid
Per eliminare dal cluster i componenti del piano di runtime specifici per ibrido, utilizza
Comando apigeectl delete
. Questi componenti includono
sincronizzatore, mart,
runtime, Cassandra e udca. Assicurati di specificare lo stesso file delle sostituzioni utilizzato per installare i componenti di runtime:
Ad esempio:
apigeectl delete -f ./my_overrides.yaml
Puoi utilizzare il comando apigeectl apply
per ricreare un componente specifico oppure
componenti:
apigeectl apply --org --env env-name -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 delle sostituzioni utilizzato per installare i componenti di runtime.
Ad esempio, per eliminare il componente Sincronizzatore, utilizza questo comando:
apigeectl delete --org --env env-name -f ./my_overrides.yaml
Puoi quindi utilizzare il comando apigeectl apply
per ricreare il componente:
apigeectl apply --org --env env-name -f ./my_overrides.yaml
Per ulteriori informazioni, vedi apigeectl
.
Elimina tutti i componenti
Per eliminare tutti i componenti ibrida del cluster, inclusi quelli creati dal comando apigeectl init
, utilizza il comando apigeectl delete
con il flag --all
. Assicurati di specificare lo stesso file delle sostituzioni utilizzato per installare i componenti di runtime:
Ad esempio:
apigeectl delete -f ./my_overrides.yaml --all
Per ulteriori informazioni, vedi apigeectl
.