Riferimento per le proprietà di configurazione

Questa sezione elenca tutte le proprietà di configurazione che puoi utilizzare per personalizzare il piano di runtime del deployment ibrido di Apigee.

Filtra questa pagina

Per filtrare le proprietà visualizzate in questa pagina, seleziona Di base (le proprietà più comuni) o Avanzate (le proprietà che raramente devono essere modificate):

Display   proprietà di configurazione in questa pagina.

Proprietà di primo livello

La tabella seguente descrive le proprietà di primo livello nel file overrides.yaml. Queste sono proprietà che non appartengono a un altro oggetto e si applicano a livello di organizzazione o ambiente:

Proprietà Tipo Descrizione
axHashSalt Avanzato

Introdotto nella versione: 1.3.0

Valore predefinito: iloveapis123

Grafico: apigee-org

Optional

Il nome di un secret Kubernetes che contiene un sale utilizzato per il calcolo degli hash per offuscare i dati utente prima che vengano inviati ad Apigee Analytics. Se non specifichi un valore salt, viene utilizzato iloveapis123 per impostazione predefinita. Crea il secret con il valore salt come input. Puoi utilizzare lo stesso sale in più cluster per garantire risultati di hashing coerenti tra i cluster.

Apigee utilizza SHA512 per eseguire l'hashing del valore originale prima di inviare i dati dal piano di runtime al piano di controllo.

Vedi: Offuscare i dati utente per Analytics.

contractProvider Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: https://apigee.googleapis.com

Grafico: apigee-operator, apigee-datastore, apigee-telemetry, apigee-redis, apigee-ingress-manager, apigee-org, apigee-env, apigee-virtualhost

Definisce il percorso API per tutte le API nell'installazione.

Obbligatorio se l'installazione ibrida utilizza la residenza dei dati nel seguente formato:

contractProvider: https://CONTROL_PLANE_LOCATION-apigee.googleapis.com

Dove CONTROL_PLANE_LOCATION è la posizione in cui vengono archiviati i dati del control plane, come i bundle proxy. Per un elenco, consulta Regioni del control plane dell'API Apigee disponibili.

Ad esempio:

contractProvider: https://us-apigee.googleapis.com
customAutoscaling.enabled Base Introdotto nella versione: 1.14.0

Valore predefinito: true

Grafico: apigee-telemetry

Attiva la scalabilità automatica basata sulle metriche di Apigee quando è impostato su true (valore predefinito). Imposta su false per disattivare la scalabilità automatica personalizzata.

Applica le modifiche a customAutoscaling.enabled aggiornando il grafico apigee-telemetry.

enhanceProxyLimits Avanzato Introdotto nella versione: 1.14.0

Valore predefinito: false

Grafico: apigee-org, apigee-virtualhost

Obbligatorio

enhanceProxyLimits è necessario per la funzionalità Limiti proxy avanzati per ambiente di Apigee. Imposta questo valore su enhanceProxyLimits: true se la tua organizzazione ibrida ha diritto a limiti proxy avanzati per ambiente.

Vedi:

L'impostazione enhanceProxyLimits: true è obbligatoria per il concatenamento di proxy, endpoint e ServiceCallout. Per informazioni, vedi:

Applica modifiche a enhanceProxyLimits aggiornando il grafico apigee-org e il grafico apigee-virtualhost per ogni gruppo di ambienti.

gcpProjectID Avanzato Deprecated: Per la versione 1.2.0 e successive, utilizza gcp.projectID.

Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-telemetry, apigee-org

Obbligatorio

L'ID del tuo progetto Google Cloud. Funziona con k8sClusterName (ritirato) e gcpRegion (ritirato) per identificare il progetto e determinare dove apigee-logger e apigee-metrics inviano i propri dati.

gcpRegion Avanzato Deprecated: Per la versione 1.2.0 e successive, utilizza gcp.region.

Introdotto nella versione: 1.0.0

Valore predefinito: us-central1

Grafico: apigee-telemetry, apigee-org

Obbligatorio

La regione o la zona Google Cloud più vicina del tuo cluster Kubernetes. Funziona con gcpProjectID (ritirato) e k8sClusterName (ritirato) per identificare il progetto e determinare dove apigee-logger e apigee-metrics inviano i dati.

hub Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: nessuno

Grafico: apigee-operator, apigee-datastore, apigee-telemetry, apigee-redis, apigee-ingress-manager, apigee-org, apigee-env, apigee-virtualhost

L'URL di un repository di container di immagini privato utilizzato per estrarre le immagini per tutti i componenti Apigee da un repository privato.

hub fornisce un percorso predefinito per tutti i componenti di Apigee hybrid. Se utilizzi un repository privato, utilizza hub per impostare l'URL del repository per tutti i componenti anziché utilizzare la proprietà image.url individuale per ogni componente. Configura i singoli URL solo se utilizzi un repository separato per un componente specifico.

Il percorso dell'immagine per ogni singolo componente sarà il valore di hub più il nome e il tag dell'immagine per il componente.

Ad esempio, se il valore di hub è private-docker-host.example.com, i singoli componenti risolveranno automaticamente il percorso dell'immagine:

hub: private-docker-host.example.com

come:

containers:
- name: apigee-udca
  image: private-docker-host.example.com/apigee-udca:1.16.10
  imagePullPolicy: IfNotPresent

Gli altri componenti seguiranno un pattern simile.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository corrente per tutti i componenti.

Consulta Utilizzare un repository di immagini privato con Apigee hybrid.

Puoi ignorare l'URL dell'immagine per i singoli componenti con le seguenti proprietà:

imagePullSecrets[].name Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-operator, apigee-redis, apigee-org, apigee-env

Nome del secret Kubernetes configurato come tipo docker-registry; utilizzato per eseguire il pull delle immagini dal repository privato.

instanceID Base Introdotto nella versione: 1.3.0

Valore predefinito: nessuno

Grafico: apigee-org

Obbligatorio

Un identificatore univoco per questa installazione.

Una stringa univoca per identificare questa istanza. Può essere qualsiasi combinazione di lettere e numeri fino a 63 caratteri.

kmsEncryptionKey Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: defaults.org.kmsEncryptionKey

Grafico: apigee-org, apigee-env

(Facoltativo) Utilizza solo uno dei seguenti valori: kmsEncryptionKey, kmsEncryptionPath o kmsEncryptionSecret.

Il percorso del file system locale per la chiave di crittografia dei dati KMS di Apigee.

kmsEncryptionPath Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-org, apigee-env

(Facoltativo) Utilizza solo uno dei seguenti valori: kmsEncryptionKey, kmsEncryptionPath o kmsEncryptionSecret.

Il percorso di un file contenente una chiave di crittografia con codifica Base64. Consulta Crittografia dei dati.

kmsEncryptionSecret.key Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-org, apigee-env

(Facoltativo) Utilizza solo uno dei seguenti valori: kmsEncryptionKey, kmsEncryptionPath o kmsEncryptionSecret.

La chiave di un secret Kubernetes contenente una chiave di crittografia con codifica Base64. Consulta Crittografia dei dati.

kmsEncryptionSecret.name Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-org, apigee-env

(Facoltativo) Utilizza solo uno dei seguenti valori: kmsEncryptionKey, kmsEncryptionPath o kmsEncryptionSecret.

Il nome di un secret Kubernetes contenente una chiave di crittografia con codifica Base64. Consulta Crittografia dei dati.

kvmEncryptionKey Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: defaults.org.kmsEncryptionKey

Grafico: apigee-org, apigee-env

(Facoltativo) Utilizza solo uno dei seguenti campi: kvmEncryptionKey, kvmEncryptionPath o kvmEncryptionSecret.

Percorso del file system locale per la chiave di crittografia dei dati KVM di Apigee.

kvmEncryptionPath Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-org, apigee-env

(Facoltativo) Utilizza solo uno dei seguenti campi: kvmEncryptionKey, kvmEncryptionPath o kvmEncryptionSecret.

Il percorso di un file contenente una chiave di crittografia con codifica Base64. Consulta Crittografia dei dati.

kvmEncryptionSecret.key Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-org, apigee-env

(Facoltativo) Utilizza solo uno dei seguenti campi: kvmEncryptionKey, kvmEncryptionPath o kvmEncryptionSecret.

La chiave di un secret Kubernetes contenente una chiave di crittografia con codifica Base64. Consulta Crittografia dei dati.

kvmEncryptionSecret.name Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-org, apigee-env

(Facoltativo) Utilizza solo uno dei seguenti campi: kvmEncryptionKey, kvmEncryptionPath o kvmEncryptionSecret.

Il nome di un secret Kubernetes contenente una chiave di crittografia con codifica Base64. Consulta Crittografia dei dati.

multiOrgCluster Avanzato Introdotto nella versione: 1.10.0

Valore predefinito: false

Grafico: apigee-telemetry

Per i cluster multi-organizzazione, questa proprietà consente di esportare le metriche dell'organizzazione nel progetto elencato nella proprietà gcp.projectID. Applica questa impostazione nel file di override per ogni organizzazione in un cluster multi-organizzazione. Per maggiori informazioni, consulta Aggiungere più organizzazioni ibride a un cluster.

namespace Base Introdotto nella versione: 1.0.0

Valore predefinito: apigee

Grafico: apigee-datastore, apigee-env, apigee-ingress-manager, apigee-operator, apigee-org, apigee-redis, apigee-telemetry, apigee-virtualhost

Lo spazio dei nomi del cluster Kubernetes in cui verranno installati i componenti Apigee.

org Base

Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-operator, apigee-telemetry, apigee-org, apigee-env, apigee-virtualhost

Obbligatorio

L'organizzazione abilitata per l'ibrido di cui è stato eseguito il provisioning per te da Apigee durante l'installazione ibrida. Un'organizzazione è il container di primo livello in Apigee. Contiene tutti i proxy API e le risorse correlate. Se il valore è vuoto, devi aggiornarlo con il nome dell'organizzazione una volta creata.

revision Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: "11610" (la tua versione di Apigee hybrid senza punti). Ad esempio, per la versione 1.12.0, il valore predefinito è "1120".)

Grafico: apigee-operator

Apigee hybrid supporta gli aggiornamenti in sequenza di Kubernetes, che consentono di eseguire gli aggiornamenti del deployment senza tempi di inattività aggiornando in modo incrementale le istanze pod con quelle nuove.

Quando aggiorni determinati override YAML che comportano una modifica PodTemplateSpec di Kubernetes sottostante, anche la proprietà di override revision deve essere modificata nel override.yaml del cliente. Questo è necessario affinché il controller Kubernetes ApigeeDeployment (AD) sottostante esegua un aggiornamento in sequenza sicuro dalla versione precedente alla nuova versione. Puoi utilizzare qualsiasi valore di testo in minuscolo, ad es. blue, a, 1.0.0

Quando la proprietà revision viene modificata e applicata, si verifica un aggiornamento in sequenza per tutti i componenti

Le modifiche alle proprietà dei seguenti oggetti richiedono un aggiornamento di revision:

Per ulteriori informazioni, vedi Aggiornamenti in sequenza.

serviceAccountSecretProviderClass Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: nessuno

Grafico: apigee-datastore, apigee-env, apigee-org, apigee-telemetry

Il nome della classe del fornitore di secret specifico dell'organizzazione (SecretProviderClass) utilizzato per archiviare le chiavi del account di servizio in Vault.

Consulta Memorizzazione delle chiavi del account di servizio in Hashicorp Vault.

tolerations.effect Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: nessuno

Grafico: apigee-datastore, apigee-env, apigee-ingress-manager, apigee-operator, apigee-org, apigee-redis, apigee-telemetry, apigee-virtualhost

Imposta un valore predefinito globale per la funzionalità Taints and Tolerations di Kubernetes nei componenti di Apigee hybrid.

effect specifica l'effetto della corrispondenza di una tolleranza con un taint. I valori per effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per i dettagli, consulta Tolleranze e taint: concetti.

tolerations.key Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: nessuno

Grafico: apigee-datastore, apigee-env, apigee-ingress-manager, apigee-operator, apigee-org, apigee-redis, apigee-telemetry, apigee-virtualhost

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

key identifica i pod a cui può essere applicata la tolleranza.

Per i dettagli, consulta Tolleranze e taint: concetti.

tolerations.operator Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: "Equal"

Grafico: apigee-datastore, apigee-env, apigee-ingress-manager, apigee-operator, apigee-org, apigee-redis, apigee-telemetry, apigee-virtualhost

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

operator specifica l'operazione utilizzata per attivare effect. I valori per operator possono essere:

  • Equal corrisponde al valore impostato in value.
  • Exists ignora il valore impostato in value.

Per i dettagli, consulta Tolleranze e taint: concetti.

tolerations.tolerationSeconds Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: nessuno

Grafico: apigee-datastore, apigee-env, apigee-ingress-manager, apigee-operator, apigee-org, apigee-redis, apigee-telemetry, apigee-virtualhost

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

tolerationSeconds definisce in secondi per quanto tempo un pod rimane associato a un nodo non riuscito o che non risponde.

Per i dettagli, consulta Tolleranze e taint: concetti.

tolerations.value Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: nessuno

Grafico: apigee-datastore, apigee-env, apigee-ingress-manager, apigee-operator, apigee-org, apigee-redis, apigee-telemetry, apigee-virtualhost

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

value è il valore che attiva effect quando operator è impostato su Equal.

Per i dettagli, consulta Tolleranze e taint: concetti.

ao

Apigee Operators (AO) crea e aggiorna risorse Kubernetes e Istio di basso livello necessarie per eseguire il deployment e la manutenzione di un componente. Ad esempio, il controller esegue il rilascio dei processori di messaggi.

La tabella seguente descrive le proprietà dell'oggetto apigee-operators ao:

Proprietà Tipo Descrizione
ao.args.disableIstioConfigInAPIServer Avanzato Introdotto nella versione: 1.8.0

Valore predefinito: true

Grafico: apigee-ingress-manager

Impedisce ad Apigee di fornire la configurazione a Cloud Service Mesh installato dal cliente.

  • Imposta su true per le installazioni ibride che utilizzano il gateway in entrata Apigee.
  • Imposta su false per le installazioni ibride che utilizzano Cloud Service Mesh (Apigee hybrid versioni 1.8 e precedenti).
ao.args.disableManagedClusterRoles Avanzato Introdotto nella versione: 1.10.0

Valore predefinito: true

Grafico: apigee-operator

Quando true (il valore predefinito), Apigee Hybrid non gestisce direttamente Kubernetes ClusterRole e ClursterRoleBinding. Se hai una procedura che richiede la gestione di queste risorse, la procedura deve essere eseguita da un utente con le autorizzazioni corrette per farlo.

ao.image.pullPolicy Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: IfNotPresent

Grafico: apigee-operator, apigee-ingress-manager

Determina quando kubelet esegue il pull dell'immagine Docker del pod. I valori possibili sono:

  • IfNotPresent: non estrarre una nuova immagine se esiste già.
  • Always: esegue sempre il pull dell'immagine, indipendentemente dal fatto che esista già.

Per saperne di più, vedi Aggiornamento delle immagini.

ao.image.tag Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: 1.16.10

Grafico: apigee-operator, apigee-ingress-manager

L'etichetta della versione per l'immagine Docker di questo servizio.

ao.image.url Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-operator, apigee-ingress-manager

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository corrente per questo componente.

ao.resources.limits.cpu Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: 250m

Grafico: apigee-operator, apigee-ingress-manager

Il limite della CPU per la risorsa in un container Kubernetes, in millicore.

ao.resources.limits.memory Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: 256Mi

Grafico: apigee-operator, apigee-ingress-manager

Il limite di memoria per la risorsa in un container Kubernetes, in mebibyte.

ao.resources.requests.cpu Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: 250m

Grafico: apigee-operator, apigee-ingress-manager

La CPU necessaria per il normale funzionamento della risorsa in un contenitore Kubernetes, in millicore.

ao.resources.requests.memory Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: 256Mi

Grafico: apigee-operator, apigee-ingress-manager

La memoria necessaria per il normale funzionamento della risorsa in un container Kubernetes, in mebibyte.

ao.tolerations.effect Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-operator

Obbligatorio per utilizzare la funzionalità Taints and Tolerations di Kubernetes.

effect specifica l'effetto della corrispondenza di una tolleranza con un taint. I valori per effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per i dettagli, consulta Taints e tolleranze: concetti.

ao.tolerations.key Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-operator

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

key identifica i pod a cui può essere applicata la tolleranza.

Per i dettagli, consulta Tolleranze e taint: concetti.

ao.tolerations.operator Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: "Equal"

Grafico: apigee-operator

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

operator specifica l'operazione utilizzata per attivare effect. I valori per operator possono essere:

  • Equal corrisponde al valore impostato in value.
  • Exists ignora il valore impostato in value.

Per i dettagli, consulta Tolleranze e taint: concetti.

ao.tolerations.tolerationSeconds Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-operator

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

tolerationSeconds definisce in secondi per quanto tempo un pod rimane associato a un nodo non riuscito o che non risponde.

Per i dettagli, consulta Tolleranze e taint: concetti.

ao.tolerations.value Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-operator

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

value è il valore che attiva effect quando operator è impostato su Equal.

Per i dettagli, consulta Tolleranze e taint: concetti.

apigeeIngressGateway

Configura il gateway in entrata Apigee per Apigee Hybrid. Utilizza le proprietà apigeeIngressGateway per applicare la configurazione comune a tutte le istanze del gateway in entrata Apigee.

Consulta ingressGateways per configurare le singole istanze in modo univoco.

Applica le modifiche alle proprietà di apigeeIngressGateway con il grafico apigee-org.

La tabella seguente descrive le proprietà dell'oggetto apigeeIngressGateway:

Proprietà Tipo Descrizione
apigeeIngressGateway.image.pullPolicy Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: IfNotPresent

Grafico: apigee-org

Determina quando kubelet esegue il pull dell'immagine Docker del pod. I valori possibili sono:

  • IfNotPresent: non estrarre una nuova immagine se esiste già.
  • Always: estrae sempre l'immagine, indipendentemente dal fatto che esista già.

Per saperne di più, vedi Aggiornamento delle immagini.

apigeeIngressGateway.image.tag Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 1.16.10

Grafico: apigee-org

L'etichetta della versione per l'immagine Docker di questo servizio.

apigeeIngressGateway.image.url Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: nessuno

Grafico: apigee-org

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository corrente per questo componente.

apigeeIngressGateway.nodeSelector.key Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: nessuno

Grafico: apigee-org

Obbligatorio

Chiave di etichetta del selettore di nodi utilizzata per scegliere come target i nodi Kubernetes dedicati per i servizi gateway in entrata.

Consulta la sezione Configurazione di pool di nodi dedicati.

apigeeIngressGateway.nodeSelector.value Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: nessuno

Grafico: apigee-org

Valore dell'etichetta del selettore di nodi facoltativo utilizzato per scegliere come target i nodi Kubernetes dedicati per i servizi del gateway in entrata e sostituire le impostazioni nodeSelector.apigeeData.

Vedi nodeSelector.

apigeeIngressGateway.podDisruptionBudget.minAvailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-org

Il numero minimo di pod del gateway in entrata Apigee che devono rimanere disponibili durante un'interruzione volontaria, ad esempio durante un upgrade del pool di nodi o uno svuotamento dei nodi. Questo campo imposta il campo minAvailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%").

minAvailable e maxUnavailable si escludono a vicenda; imposta solo uno dei due. L'operatore Apigee rifiuta l'impostazione di entrambi contemporaneamente. Se non imposti nessuno dei due campi, l'operatore Apigee genera comunque un PodDisruptionBudget per questi pod, utilizzando maxUnavailable: 1 per impostazione predefinita. Per impostare un budget diverso per un gateway specifico, utilizza ingressGateways[].podDisruptionBudget.minAvailable.

Ad esempio, in overrides.yaml:

apigeeIngressGateway:
  podDisruptionBudget:
    minAvailable: "50%"
apigeeIngressGateway.podDisruptionBudget.maxUnavailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-org

Il numero massimo di pod del gateway in entrata Apigee che possono non essere disponibili durante un'interruzione volontaria, ad esempio durante un upgrade del pool di nodi o uno svuotamento dei nodi. Questo campo imposta il campo maxUnavailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%").

maxUnavailable e minAvailable si escludono a vicenda; imposta solo uno dei due. L'operatore Apigee rifiuta l'impostazione di entrambi contemporaneamente. Se non imposti nessuno dei due campi, l'operatore Apigee genera comunque un PodDisruptionBudget per questi pod, utilizzando maxUnavailable: 1 per impostazione predefinita. Per impostare un budget diverso per un gateway specifico, utilizza ingressGateways[].podDisruptionBudget.maxUnavailable.

Ad esempio, in overrides.yaml:

apigeeIngressGateway:
  podDisruptionBudget:
    maxUnavailable: 1
apigeeIngressGateway.proxyProtocol.mode Avanzato

Introdotto nella versione: 1.16.6

Valore predefinito: disable

Grafico: apigee-org

Imposta il valore predefinito globale per l'analisi del protocollo PROXY di HAProxy su tutti i componenti del gateway in entrata. I valori consentiti sono strict, permissive o disable.

Puoi eseguire l'override di questa impostazione predefinita globale per ogni gateway utilizzando ingressGateways[].proxyProtocol.mode.

apigeeIngressGateway.replicaCountMax Base Introdotto nella versione: 1.11.0

Valore predefinito: 4

Grafico: apigee-org

Il numero massimo di pod che ibrido può aggiungere automaticamente per il gateway in entrata disponibile per la scalabilità automatica.

apigeeIngressGateway.replicaCountMin Base Introdotto nella versione: 1.11.0

Valore predefinito: 2

Grafico: apigee-org

Il numero minimo di pod per il gateway in entrata disponibili per la scalabilità automatica.

apigeeIngressGateway.targetCPUUtilizationPercentage Avanzato Introdotto nella versione: 1.10.5, 1.11.2, 1.12.1

Valore predefinito: 75

Grafico: apigee-org

La soglia di utilizzo della CPU per scalare il numero di pod nel ReplicaSet, come percentuale delle risorse CPU totali disponibili.

Quando l'utilizzo della CPU supera questo valore, l'ibrido aumenterà gradualmente il numero di pod nel ReplicaSet fino a apigeeIngressGateway.replicaCountMax.

Per ulteriori informazioni sulla scalabilità in Kubernetes, consulta Scalabilità automatica orizzontale dei pod nella documentazione di Kubernetes.

apigeeIngressGateway.tolerations.effect Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: nessuno

Grafico: apigee-org

Obbligatorio per utilizzare la funzionalità Taints and Tolerations di Kubernetes.

effect specifica l'effetto della corrispondenza di una tolleranza con un taint. I valori per effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per i dettagli, consulta Taints e tolleranze: concetti.

apigeeIngressGateway.tolerations.key Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: nessuno

Grafico: apigee-org

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

key identifica i pod a cui può essere applicata la tolleranza.

Per i dettagli, consulta Tolleranze e taint: concetti.

apigeeIngressGateway.tolerations.operator Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: "Equal"

Grafico: apigee-org

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

operator specifica l'operazione utilizzata per attivare effect. I valori per operator possono essere:

  • Equal corrisponde al valore impostato in value.
  • Exists ignora il valore impostato in value.

Per i dettagli, consulta Tolleranze e taint: concetti.

apigeeIngressGateway.tolerations.tolerationSeconds Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: nessuno

Grafico: apigee-org

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

tolerationSeconds definisce in secondi per quanto tempo un pod rimane associato a un nodo non riuscito o che non risponde.

Per i dettagli, consulta Tolleranze e taint: concetti.

apigeeIngressGateway.tolerations.value Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: nessuno

Grafico: apigee-org

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

value è il valore che attiva effect quando operator è impostato su Equal.

Per i dettagli, consulta Tolleranze e taint: concetti.

cassandra

Definisce il servizio ibrido che gestisce il repository di dati di runtime. Questo repository archivia le configurazioni delle applicazioni, i contatori delle quote distribuite, le chiavi API e i token OAuth per le applicazioni in esecuzione sul gateway.

Per saperne di più, consulta Configurazione di StorageClass.

La tabella seguente descrive le proprietà dell'oggetto cassandra:

Proprietà Tipo Descrizione
cassandra.annotations Avanzato Introdotto nella versione: 1.5.0

Valore predefinito: nessuno

Grafico: apigee-datastore

Mappa chiave/valore facoltativa utilizzata per annotare i pod. Per ulteriori informazioni, consulta Annotazioni personalizzate.

cassandra.auth.admin.password Base Introdotto nella versione: 1.0.0

Valore predefinito: iloveapis123

Grafico: apigee-datastore

Obbligatorio

Password dell'amministratore di Cassandra. L'utente amministratore viene utilizzato per qualsiasi attività amministrativa eseguita sul cluster Cassandra, ad esempio backup e ripristino.

cassandra.auth.ddl.password Base Introdotto nella versione: 1.0.0

Valore predefinito: iloveapis123

Grafico: apigee-datastore

Obbligatorio

Password per l'utente Cassandra Data Definition Language (DDL). Utilizzato da MART per qualsiasi attività di definizione dei dati, come la creazione, l'aggiornamento e l'eliminazione di keyspace.

cassandra.auth.default.password Base Introdotto nella versione: 1.0.0

Valore predefinito: iloveapis123

Grafico: apigee-datastore

Obbligatorio

La password per l'utente Cassandra predefinito creato quando l'autenticazione è abilitata. Questa password deve essere reimpostata durante la configurazione dell'autenticazione Cassandra. Consulta Configurazione di TLS per Cassandra.

cassandra.auth.dml.password Base Introdotto nella versione: 1.0.0

Valore predefinito: iloveapis123

Grafico: apigee-datastore

Obbligatorio

Password per l'utente Cassandra Data Manipulation Language (DML). L'utente DML viene utilizzato dalla comunicazione client per leggere e scrivere dati in Cassandra.

cassandra.auth.image.pullPolicy Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: IfNotPresent

Grafico: apigee-datastore, apigee-org

Determina quando kubelet esegue il pull dell'immagine Docker del pod. I valori possibili sono:

  • IfNotPresent: non estrarre una nuova immagine se esiste già.
  • Always: esegue sempre il pull dell'immagine, indipendentemente dal fatto che esista già.

Per saperne di più, vedi Aggiornamento delle immagini.

cassandra.auth.image.tag Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1.16.10

Grafico: apigee-datastore, apigee-org

L'etichetta della versione per l'immagine Docker di questo servizio.

cassandra.auth.image.url Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-datastore, apigee-org

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository corrente per questo componente.

cassandra.auth.jmx.password Base Introdotto nella versione: 1.4.0

Valore predefinito: iloveapis123

Grafico: apigee-datastore

Obbligatorio

Password per l'utente delle operazioni JMX di Cassandra. Utilizzato per l'autenticazione e la comunicazione con l'interfaccia JMX di Cassandra.

cassandra.auth.jmx.username Base Introdotto nella versione: 1.4.0

Valore predefinito: jmxuser

Grafico: apigee-datastore

Obbligatorio

Nome utente per l'utente delle operazioni JMX di Cassandra. Utilizzato per l'autenticazione e la comunicazione con l'interfaccia JMX di Cassandra.

cassandra.auth.jolokia.password Base Introdotto nella versione: 1.4.0

Valore predefinito: iloveapis123

Grafico: apigee-datastore

Obbligatorio

Password per l'utente delle operazioni JMX di Cassandra Jolokia. Utilizzato per autenticare e comunicare con l'API Cassandra JMX.

cassandra.auth.jolokia.username Base Introdotto nella versione: 1.4.0

Valore predefinito: apigee

Grafico: apigee-datastore

Obbligatorio

Nome utente per l'utente delle operazioni JMX di Cassandra Jolokia. Utilizzato per autenticare e comunicare con l'API Cassandra JMX.

cassandra.auth.secret Base Introdotto nella versione: 1.3.3

Valore predefinito: nessuno

Grafico: apigee-datastore

Il nome del file archiviato in un secret Kubernetes contenente gli utenti e le password di Cassandra. Puoi creare il secret seguendo queste istruzioni: Crea il secret.

Vedi anche:

cassandra.auth.secretProviderClass Avanzato Introdotto nella versione: 1.10.3

Valore predefinito: nessuno

Grafico: apigee-datastore, apigee-operator

La policy di archiviazione dei secret di Cassandra. Se impostato, deve corrispondere a SecretProviderClass che fa riferimento al provider di secret esterno, come Hashicorp Vault. Se non è impostato, Apigee Hybrid utilizza i nomi utente e le password archiviati in:

o il secret Kubernetes archiviato in:

Consulta Memorizzazione dei secret di Cassandra in Hashicorp Vault per istruzioni su come creare la policy.

cassandra.backup.cloudProvider Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: GCP

Grafico: apigee-datastore

Il nome di un fornitore di backup. Valori supportati: GCP, HYBRID e CSI. Imposta il valore su:

  • GCP per archiviare gli archivi di backup su Google Cloud Storage.
  • HYBRID per archiviare gli archivi di backup su un server SSH remoto.
  • CSI (opzione consigliata) per utilizzare gli snapshot dei volumi CSI di Kubernetes per il backup. Per informazioni su backup e ripristino di CSI per piattaforme cloud come Google Cloud, AWS e Azure, consulta Backup e ripristino CSI.
cassandra.backup.dbStorageBucket Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-datastore

Obbligatorio se il backup è attivo e cassandra.backup.cloudProvider è impostato su GCP.

Il nome di un bucket Google Cloud Storage esistente che verrà utilizzato per archiviare i backup. Consulta Creazione di bucket se devi crearne uno.

cassandra.backup.enabled Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: false

Grafico: apigee-datastore

Il backup dei dati non è abilitato per impostazione predefinita. Per abilitare l'opzione, imposta il valore su true.

Consulta Backup e ripristino di Cassandra.

cassandra.backup.gsa Avanzato Introdotto nella versione: 1.10.0

Valore predefinito: nessuno

Grafico: apigee-datastore

Solo Helm: l'indirizzo email del account di servizio Google IAM apigee-cassandra da associare al account di servizio Kubernetes di backup di Cassandra quando si abilita Workload Identity sui cluster GKE. Imposta questo valore quando hai impostato gcp.workloadIdentity.enabled su true e cassandra.backup.enabled su true.

Gli indirizzi email GSA hanno in genere il formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

apigee-cassandra@my-hybrid-project.iam.gserviceaccount.com

Consulta Abilitazione della federazione delle identità per i workload su GKE.

cassandra.backup.image.pullPolicy Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: IfNotPresent

Grafico: apigee-datastore

Determina quando kubelet esegue il pull dell'immagine Docker del pod. I valori possibili sono:

  • IfNotPresent: non estrarre una nuova immagine se esiste già.
  • Always: esegue sempre il pull dell'immagine, indipendentemente dal fatto che esista già.

Per saperne di più, vedi Aggiornamento delle immagini.

cassandra.backup.image.tag Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1.16.10

Grafico: apigee-datastore

L'etichetta della versione per l'immagine Docker di questo servizio.

cassandra.backup.image.url Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-datastore

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository corrente per questo componente.

cassandra.backup.keyfile Avanzato Introdotto nella versione: 1.3.0

Valore predefinito: nessuno

Grafico: apigee-datastore

Obbligatorio se il backup è attivo e cassandra.backup.cloudProvider è impostato su HYBRID.

Il percorso nel file system locale del file della chiave privata SSH.

cassandra.backup.schedule Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 0 2 * * *

Grafico: apigee-datastore

La pianificazione del cron job di backup.

Consulta Backup e ripristino di Cassandra.

cassandra.backup.server Avanzato Introdotto nella versione: 1.3.0

Valore predefinito: nessuno

Grafico: apigee-datastore

Obbligatorio se il backup è attivo e cassandra.backup.cloudProvider è impostato su HYBRID.

L'indirizzo IP del server di backup SSH remoto.

cassandra.backup.serviceAccountPath Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-datastore

Percorso di un file di chiave Google Service Account con il ruolo Amministratore oggetti Storage (roles/storage.objectAdmin). Questo service account Google verrà utilizzato per caricare gli archivi di backup in un cassandra.backup.dbStorageBucket specificato.

Se il backup è abilitato e cassandra.backup.cloudProvider è impostato su GCP, è necessario uno dei seguenti elementi per garantire che Apigee Hybrid possa accedere al bucket Google Cloud Storage per caricare gli archivi di backup:

cassandra.backup.serviceAccountRef Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-datastore

Il nome di un secret Kubernetes esistente che archivia i contenuti di un file della chiave di un service account Google con il ruolo Amministratore oggetti Storage (roles/storage.objectAdmin). Questo service account Google verrà utilizzato per caricare gli archivi di backup in un cassandra.backup.dbStorageBucket specificato.

Se il backup è abilitato e cassandra.backup.cloudProvider è impostato su GCP, è necessario uno dei seguenti elementi per garantire che Apigee Hybrid possa accedere al bucket Google Cloud Storage per caricare gli archivi di backup:

cassandra.backup.storageDirectory Avanzato Introdotto nella versione: 1.3.0

Valore predefinito: nessuno

Grafico: apigee-datastore

Obbligatorio se il backup è attivo e cassandra.backup.cloudProvider è impostato su HYBRID.

Può essere un percorso assoluto o relativo alla directory home dell'utente apigee.

Il nome della directory di backup sul server SSH di backup.

cassandra.clusterName Base Introdotto nella versione: 1.0.0

Valore predefinito: apigeecluster

Grafico: apigee-datastore

Specifica il nome del cluster Cassandra.

cassandra.datacenter Base Introdotto nella versione: 1.0.0

Valore predefinito: dc-1

Grafico: apigee-datastore

Specifica il data center del nodo Cassandra.

cassandra.dnsPolicy Base Introdotto nella versione: 1.1.1

Valore predefinito: nessuno

Grafico: apigee-datastore

Quando imposti hostNetwork su true, il criterio DNS viene impostato su ClusterFirstWithHostNet.

cassandra.externalSeedHost Base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-datastore

Nome host o IP di un nodo del cluster Cassandra. Se non impostato, viene utilizzato il servizio locale Kubernetes.

cassandra.heapNewSize Base Introdotto nella versione: 1.0.0

Valore predefinito: 100M

Grafico: apigee-datastore

La quantità di memoria di sistema JVM allocata agli oggetti più recenti, in megabyte.

cassandra.hostNetwork Base Introdotto nella versione: 1.1.1

Valore predefinito: false

Grafico: apigee-datastore

Attiva la funzionalità hostNetwork di Kubernetes. Apigee utilizza questa funzionalità nelle installazioni multiregionali per comunicare tra i pod se lo spazio dei nomi di rete dei pod non ha connettività tra i cluster (i cluster vengono eseguiti in "modalità di rete isolata"), che è il caso predefinito nelle installazioni non GKE, inclusi Google Distributed Cloud su VMware o bare metal, AKS, EKS e OpenShift.

Imposta cassandra.hostNetwork su false per installazioni a singola regione e installazioni multiregionali con connettività tra pod in cluster diversi, ad esempio installazioni GKE.

Imposta cassandra.hostNetwork su true per installazioni multiregionali senza comunicazione tra i pod in cluster diversi, ad esempio installazioni di Google Distributed Cloud su VMware o bare metal, AKS, EKS e OpenShift. Consulta Deployment multiregionale: prerequisiti.

Quando true, il criterio DNS viene impostato automaticamente su ClusterFirstWithHostNet.

cassandra.image.pullPolicy Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: IfNotPresent

Grafico: apigee-datastore

Determina quando kubelet esegue il pull dell'immagine Docker del pod. I valori possibili sono:

  • IfNotPresent: non estrarre una nuova immagine se esiste già.
  • Always: estrae sempre l'immagine, indipendentemente dal fatto che esista già.

Per saperne di più, vedi Aggiornamento delle immagini.

cassandra.image.tag Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1.16.10

Grafico: apigee-datastore

L'etichetta della versione per l'immagine Docker di questo servizio.

cassandra.image.url Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-datastore

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository corrente per questo componente.

cassandra.maxHeapSize Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 512M

Grafico: apigee-datastore

Il limite superiore della memoria di sistema JVM disponibile per le operazioni Cassandra, in megabyte.

cassandra.multiRegionSeedHost Base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-datastore

Indirizzo IP di un cluster Cassandra esistente utilizzato per espandere il cluster esistente a una nuova regione. Consulta Configurare l'host seed multiregionale.

cassandra.nodeSelector.key Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-datastore

Obbligatorio

Chiave di etichetta del selettore di nodi utilizzata per scegliere come target i nodi Kubernetes dedicati per i servizi di dati cassandra.

Consulta la sezione Configurazione di pool di nodi dedicati.

cassandra.nodeSelector.value Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-datastore

Valore dell'etichetta del selettore di nodi facoltativo utilizzato per scegliere come target i nodi Kubernetes dedicati per i servizi di dati cassandra e ignorare le impostazioni nodeSelector.apigeeData.

Vedi nodeSelector.

cassandra.podDisruptionBudget.minAvailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-datastore

Il numero minimo di pod Cassandra che devono rimanere disponibili durante un'interruzione volontaria, ad esempio durante un upgrade pool di nodi o un'eliminazione dei nodi. Questo campo imposta il campo minAvailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%"). minAvailable e maxUnavailable si escludono a vicenda; imposta solo uno dei due. L'impostazione di entrambi contemporaneamente viene rifiutata dall'operatore Apigee. Se non imposti nessuno dei due campi, l'operatore Apigee genera comunque un PodDisruptionBudget per questi pod, utilizzando maxUnavailable: 1 per impostazione predefinita.

Ad esempio, in overrides.yaml:

cassandra:
  podDisruptionBudget:
    minAvailable: "50%"
cassandra.podDisruptionBudget.maxUnavailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-datastore

Il numero massimo di pod Cassandra che possono essere non disponibili durante un'interruzione volontaria, ad esempio durante un upgrade pool di nodi o un'evacuazione dei nodi. Questo campo imposta il campo maxUnavailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%"). maxUnavailable e minAvailable si escludono a vicenda; imposta solo uno dei due. L'impostazione di entrambi contemporaneamente viene rifiutata dall'operatore Apigee. Se non imposti nessuno dei due campi, l'operatore Apigee genera comunque un PodDisruptionBudget per questi pod, utilizzando maxUnavailable: 1 per impostazione predefinita.

Ad esempio, in overrides.yaml:

cassandra:
  podDisruptionBudget:
    maxUnavailable: 1
cassandra.port Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 9042

Grafico: apigee-datastore

Numero di porta utilizzato per connettersi a Cassandra.

cassandra.rack Base Introdotto nella versione: 1.0.0

Valore predefinito: ra-1

Grafico: apigee-datastore

Specifica il rack del nodo Cassandra.

cassandra.readinessProbe.failureThreshold Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 2

Grafico: apigee-datastore

Il numero di volte in cui Kubernetes verificherà che i probe di idoneità non sono riusciti prima di contrassegnare il pod come non pronto. Il valore minimo è 1.

cassandra.readinessProbe.initialDelaySeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 0

Grafico: apigee-datastore

Il numero di secondi dopo l'avvio di un container prima dell'avvio di un probe di idoneità.

cassandra.readinessProbe.periodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 10

Grafico: apigee-datastore

Determina la frequenza di esecuzione di un probe di prontezza, in secondi. Il valore minimo è 1.

cassandra.readinessProbe.successThreshold Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1

Grafico: apigee-datastore

Il numero minimo di successi consecutivi necessari affinché un probe di idoneità venga considerato riuscito dopo un errore. Il valore minimo è 1.

cassandra.readinessProbe.timeoutSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 5

Grafico: apigee-datastore

Il numero di secondi dopo i quali un probe di attività va in timeout. Il valore minimo è 1.

cassandra.replicaCount Base Introdotto nella versione: 1.0.0

Valore predefinito: 1

Grafico: apigee-datastore

Cassandra è un database replicato. Questa proprietà specifica il numero di nodi Cassandra utilizzati come StatefulSet.

cassandra.resources.requests.cpu Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 500m

Grafico: apigee-datastore

La CPU necessaria per il normale funzionamento della risorsa in un contenitore Kubernetes, in millicore.

cassandra.resources.requests.memory Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1Gi

Grafico: apigee-datastore

La memoria necessaria per il normale funzionamento della risorsa in un container Kubernetes, in mebibyte.

cassandra.restore.cloudProvider Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: GCP

Grafico: apigee-datastore

Il nome di un fornitore di ripristino. Valori supportati: GCP, HYBRID e CSI. Imposta il valore su:

  • GCP per ripristinare i dati da un backup archiviato su Google Cloud Storage.
  • HYBRID per ripristinare i dati da un backup archiviato su un server SSH remoto.
  • CSI (opzione consigliata) per utilizzare gli snapshot dei volumi CSI di Kubernetes per il ripristino. Per informazioni su backup e ripristino di CSI per piattaforme cloud come Google Cloud, AWS e Azure, consulta Backup e ripristino CSI.
cassandra.restore.dbStorageBucket Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-datastore

Obbligatorio se il ripristino è abilitato e cassandra.restore.cloudProvider è impostato su GCP.

Il nome di un bucket Google Cloud Storage che archivia gli archivi di backup da utilizzare per il ripristino dei dati.

cassandra.restore.enabled Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: false

Grafico: apigee-datastore, apigee-org

Il ripristino dei dati non è abilitato per impostazione predefinita. Per abilitare l'opzione, imposta il valore su true.

Consulta Backup e ripristino di Cassandra.

cassandra.restore.gsa Avanzato Introdotto nella versione: 1.10.0

Valore predefinito: nessuno

Grafico: apigee-datastore

Solo Helm: l'indirizzo email del account di servizio Google IAM apigee-cassandra da associare al account di servizio Kubernetes di ripristino di Cassandra quando si abilita Workload Identity sui cluster GKE. Imposta questo valore quando hai impostato gcp.workloadIdentity.enabled su true e cassandra.restore.enabled su true.

Gli indirizzi email GSA hanno in genere il formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

apigee-cassandra@my-hybrid-project.iam.gserviceaccount.com

Consulta Abilitare Workload Identity Federation su GKE.

cassandra.restore.image.pullPolicy Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: IfNotPresent

Grafico: apigee-datastore

Determina quando kubelet esegue il pull dell'immagine Docker del pod. I valori possibili sono:

  • IfNotPresent: non estrarre una nuova immagine se esiste già.
  • Always: estrae sempre l'immagine, indipendentemente dal fatto che esista già.

Per saperne di più, vedi Aggiornamento delle immagini.

cassandra.restore.image.tag Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1.16.10

Grafico: apigee-datastore

L'etichetta della versione per l'immagine Docker di questo servizio.

cassandra.restore.image.url Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-datastore

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository corrente per questo componente.

cassandra.restore.serviceAccountPath Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-datastore

Percorso di un file di chiave Google Service Account con il ruolo Amministratore oggetti Storage (roles/storage.objectAdmin). Questo service account Google verrà utilizzato per scaricare gli archivi di backup da un cassandra.restore.dbStorageBucket specificato.

Se il ripristino è abilitato e cassandra.restore.cloudProvider è impostato su GCP, è necessario uno dei seguenti elementi per garantire che Apigee Hybrid possa accedere al bucket Google Cloud Storage per scaricare gli archivi di backup per il ripristino:

cassandra.restore.serviceAccountRef Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-datastore

Il nome di un secret Kubernetes esistente che archivia i contenuti di un file della chiave di un service account Google con il ruolo Amministratore oggetti Storage (roles/storage.objectAdmin). Questo service account Google verrà utilizzato per scaricare gli archivi di backup da un cassandra.restore.dbStorageBucket specificato.

Se il ripristino è abilitato e cassandra.restore.cloudProvider è impostato su GCP, è necessario uno dei seguenti elementi per garantire che Apigee Hybrid possa accedere al bucket Google Cloud Storage per scaricare gli archivi di backup per il ripristino:

cassandra.restore.snapshotTimestamp Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-datastore

Obbligatorio se il ripristino è abilitato.

Timestamp del backup da ripristinare.

cassandra.securityContext.seccompProfile.type Avanzato

Introdotto nella versione: 1.16.0

Valore predefinito: nessuno

Grafico: apigee-datastore

Specifica il tipo di profilo Seccomp da applicare al contesto di sicurezza del pod. I valori consentiti sono RuntimeDefault (per utilizzare il profilo predefinito del runtime del container) o Unconfined (per non applicare restrizioni Seccomp). Se non specificato, Apigee non applica alcun profilo.

Consulta Configurare i profili Seccomp per la sicurezza dei pod.

cassandra.storage.capacity Base Introdotto nella versione: 1.0.0

Valore predefinito: 10Gi

Grafico: apigee-datastore

Obbligatorio se è specificato storage.storageclass

Specifica le dimensioni del disco richieste, in mebibyte (Mi) o gibibyte (Gi).

cassandra.storage.storageclass Base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-datastore

Specifica la classe di spazio di archiviazione on-premise in uso.

cassandra.storage.storageSize Base Introdotto nella versione: 1.0.0

Valore predefinito: 10Gi

Grafico: apigee-datastore

Obbligatorio se è specificato storage.storageclass

Specifica le dimensioni del disco richieste, in mebibyte (Mi) o gibibyte (Gi).

cassandra.terminationGracePeriodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 300

Grafico: apigee-datastore

Il tempo massimo tra una richiesta di eliminazione del pod e il momento in cui il pod viene terminato, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop e tutti i processi in esecuzione verranno terminati in modo controllato. Il pod verrà terminato quando tutti i processi in esecuzione saranno terminati o al termine del periodo di tolleranza, a seconda dell'evento che si verifica per primo. Se non sono in esecuzione processi, il pod verrà terminato immediatamente.

cassandra.tolerations.effect Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-datastore

Obbligatorio per utilizzare la funzionalità Taints and Tolerations di Kubernetes.

effect specifica l'effetto della corrispondenza di una tolleranza con un taint. I valori per effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per i dettagli, consulta Taints e tolleranze: concetti.

cassandra.tolerations.key Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-datastore

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

key identifica i pod a cui può essere applicata la tolleranza.

Per i dettagli, consulta Tolleranze e taint: concetti.

cassandra.tolerations.operator Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: "Equal"

Grafico: apigee-datastore

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

operator specifica l'operazione utilizzata per attivare effect. I valori per operator possono essere:

  • Equal corrisponde al valore impostato in value.
  • Exists ignora il valore impostato in value.

Per i dettagli, consulta Tolleranze e taint: concetti.

cassandra.tolerations.tolerationSeconds Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-datastore

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

tolerationSeconds definisce in secondi per quanto tempo un pod rimane associato a un nodo non riuscito o che non risponde.

Per i dettagli, consulta Tolleranze e taint: concetti.

cassandra.tolerations.value Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-datastore

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

value è il valore che attiva effect quando operator è impostato su Equal.

Per i dettagli, consulta Tolleranze e taint: concetti.

certManager

Apigee utilizza cert-manager per la convalida dei certificati.

La tabella seguente descrive le proprietà dell'oggetto certManager:

Proprietà Tipo Descrizione
certManager.securityContext.seccompProfile.type Avanzato

Introdotto nella versione: 1.16.0

Valore predefinito: nessuno

Grafico: apigee-operator

Specifica il tipo di profilo Seccomp da applicare al contesto di sicurezza del pod. I valori consentiti sono RuntimeDefault (per utilizzare il profilo predefinito del runtime del container) o Unconfined (per non applicare restrizioni Seccomp). Se non specificato, Apigee non applica alcun profilo.

Consulta Configurare i profili Seccomp per la sicurezza dei pod.

certManager.namespace Avanzato Introdotto nella versione: 1.9.0

Valore predefinito: cert-manager

Grafico: apigee-operator

Lo spazio dei nomi per cert-manager.

Consulta la sezione Esecuzione di cert-manager in uno spazio dei nomi personalizzato.

connectAgent

Apigee Connect consente al piano di gestione di Apigee hybrid di connettersi in modo sicuro al servizio MART nel piano di runtime senza richiedere l'esposizione dell'endpoint MART su internet.

La tabella seguente descrive le proprietà dell'oggetto connectAgent:

Proprietà Tipo Descrizione
connectAgent.securityContext.seccompProfile.type Avanzato

Introdotto nella versione: 1.16.0

Valore predefinito: nessuno

Grafico: apigee-org

Specifica il tipo di profilo Seccomp da applicare al contesto di sicurezza del pod. I valori consentiti sono RuntimeDefault (per utilizzare il profilo predefinito del runtime del container) o Unconfined (per non applicare restrizioni Seccomp). Se non specificato, Apigee non applica alcun profilo.

Consulta Configurare i profili Seccomp per la sicurezza dei pod.

connectAgent.annotations Avanzato Introdotto nella versione: 1.5.0

Valore predefinito: nessuno

Grafico: apigee-org

Mappa chiave/valore facoltativa utilizzata per annotare i pod. Per ulteriori informazioni, consulta Annotazioni personalizzate.

connectAgent.gsa Avanzato Introdotto nella versione: 1.10.0

Valore predefinito: nessuno

Grafico: apigee-org

Solo Helm: l'indirizzo email del account di servizio Google IAM (GSA) per connectAgent da associare al account di servizio Kubernetes corrispondente quando si abilita Workload Identity sui cluster GKE utilizzando i grafici Helm. Imposta questo valore quando hai impostato gcp.workloadIdentity.enabled su true.

Gli indirizzi email GSA hanno in genere il formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

apigee-mart@my-hybrid-project.iam.gserviceaccount.com

Consulta Abilitare Workload Identity su GKE o Abilitare la federazione delle identità per i workload su AKS ed EKS.

connectAgent.logLevel Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: INFO

Grafico: apigee-org

Il livello di segnalazione dei log. I valori possibili sono:

  • INFO: Messaggi informativi oltre a messaggi di avviso, errore e fatali. Più utile per il debug.
  • WARNING: avvisi non irreversibili oltre a messaggi di errore e irreversibili.
  • ERROR: errori interni ed errori che non vengono restituiti all'utente, oltre ai messaggi irreversibili.
  • FATAL: errori ed eventi non recuperabili che causano l'arresto anomalo di Apigee Connect.
connectAgent.image.pullPolicy Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: IfNotPresent

Grafico: apigee-org

Determina quando kubelet esegue il pull dell'immagine Docker del pod. I valori possibili sono:

  • IfNotPresent: non estrarre una nuova immagine se esiste già.
  • Always: estrae sempre l'immagine, indipendentemente dal fatto che esista già.

Per saperne di più, vedi Aggiornamento delle immagini.

connectAgent.image.tag Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: 1.16.10

Grafico: apigee-org

L'etichetta della versione per l'immagine Docker di questo servizio.

connectAgent.image.url Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-org

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository corrente per questo componente.

connectAgent.podDisruptionBudget.minAvailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-org

Il numero minimo di pod dell'agente Apigee Connect che devono rimanere disponibili durante un'interruzione volontaria, ad esempio durante un upgrade del pool di nodi o uno svuotamento dei nodi. Questo campo imposta il campo minAvailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%"). minAvailable e maxUnavailable si escludono a vicenda; imposta solo uno dei due. L'impostazione di entrambi contemporaneamente viene rifiutata dall'operatore Apigee. Se non imposti nessuno dei due campi, l'operatore Apigee genera comunque un PodDisruptionBudget per questi pod, utilizzando maxUnavailable: 1 per impostazione predefinita.

Ad esempio, in overrides.yaml:

connectAgent:
  podDisruptionBudget:
    minAvailable: "50%"
connectAgent.podDisruptionBudget.maxUnavailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-org

Il numero massimo di pod dell'agente Apigee Connect che possono non essere disponibili durante un'interruzione volontaria, ad esempio durante un upgrade del pool di nodi o uno svuotamento dei nodi. Questo campo imposta il campo maxUnavailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%"). maxUnavailable e minAvailable si escludono a vicenda; imposta solo uno dei due. L'impostazione di entrambi contemporaneamente viene rifiutata dall'operatore Apigee. Se non imposti nessuno dei due campi, l'operatore Apigee genera comunque un PodDisruptionBudget per questi pod, utilizzando maxUnavailable: 1 per impostazione predefinita.

Ad esempio, in overrides.yaml:

connectAgent:
  podDisruptionBudget:
    maxUnavailable: 1
connectAgent.replicaCountMax Base Introdotto nella versione: 1.2.0

Valore predefinito: 5

Grafico: apigee-org

Numero massimo di repliche disponibili per la scalabilità automatica.

connectAgent.replicaCountMin Base Introdotto nella versione: 1.2.0

Valore predefinito: 1

Grafico: apigee-org

Numero minimo di repliche disponibili per la scalabilità automatica.

In produzione, potresti voler aumentare replicaCountMin a 1 per avere un numero maggiore di connessioni al control plane per affidabilità e scalabilità.

connectAgent.resources.limits.cpu Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 512m

Grafico: apigee-org

Il limite della CPU per la risorsa in un container Kubernetes, in millicore.

connectAgent.resources.limits.memory Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 512Mi

Grafico: apigee-org

Il limite di memoria per la risorsa in un container Kubernetes, in mebibyte.

connectAgent.resources.requests.cpu Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 100m

Grafico: apigee-org

La CPU necessaria per il normale funzionamento della risorsa in un contenitore Kubernetes, in millicore.

connectAgent.resources.requests.memory Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: 30Mi

Grafico: apigee-org

La memoria necessaria per il normale funzionamento della risorsa in un container Kubernetes, in mebibyte.

connectAgent.server Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: apigeeconnect.googleapis.com:443

Grafico: apigee-org

La posizione del server e della porta per questo servizio.

connectAgent.serviceAccountPath Base Introdotto nella versione: 1.1.1

Valore predefinito: nessuno

Grafico: apigee-org

È obbligatorio specificare serviceAccountPath o serviceAccountRef.

Percorso del file della chiave del service account Google per il account di servizio apigee-mart.

Nella maggior parte delle installazioni, il valore di connectAgent.serviceAccountPath deve corrispondere al valore di mart.serviceAccountPath.

connectAgent.serviceAccountRef Base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-org

È obbligatorio specificare serviceAccountPath o serviceAccountRef.

Un riferimento al secret Kubernetes a un file della chiave del service account Google. Consulta Memorizzazione delle chiavi dei account di servizio nei secret Kubernetes.

Nella maggior parte delle installazioni, il valore di connectAgent.serviceAccountRef deve corrispondere al valore di mart.serviceAccountRef.

connectAgent.targetCPUUtilizationPercentage Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: 75

Grafico: apigee-org

Utilizzo CPU target per l'agente Apigee Connect sul pod. Il valore di questo campo consente ad Apigee Connect di scalare automaticamente quando l'utilizzo della CPU raggiunge questo valore, fino a replicaCountMax.

connectAgent.terminationGracePeriodSeconds Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: 600

Grafico: apigee-org

Il tempo massimo tra una richiesta di eliminazione del pod e il momento in cui il pod viene terminato, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop e tutti i processi in esecuzione verranno terminati in modo controllato. Il pod verrà terminato quando tutti i processi in esecuzione saranno terminati o al termine del periodo di tolleranza, a seconda dell'evento che si verifica per primo. Se non sono in esecuzione processi, il pod verrà terminato immediatamente.

connectAgent.tolerations.effect Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-org

Obbligatorio per utilizzare la funzionalità Taints and Tolerations di Kubernetes.

effect specifica l'effetto della corrispondenza di una tolleranza con un taint. I valori per effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per i dettagli, consulta Taints e tolleranze: concetti.

connectAgent.tolerations.key Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-org

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

key identifica i pod a cui può essere applicata la tolleranza.

Per i dettagli, consulta Tolleranze e taint: concetti.

connectAgent.tolerations.operator Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: "Equal"

Grafico: apigee-org

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

operator specifica l'operazione utilizzata per attivare effect. I valori per operator possono essere:

  • Equal corrisponde al valore impostato in value.
  • Exists ignora il valore impostato in value.

Per i dettagli, consulta Tolleranze e taint: concetti.

connectAgent.tolerations.tolerationSeconds Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-org

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

tolerationSeconds definisce in secondi per quanto tempo un pod rimane associato a un nodo non riuscito o che non risponde.

Per i dettagli, consulta Tolleranze e taint: concetti.

connectAgent.tolerations.value Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-org

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

value è il valore che attiva effect quando operator è impostato su Equal.

Per i dettagli, consulta Tolleranze e taint: concetti.

defaults

Le chiavi di crittografia predefinite per l'installazione di Apigee hybrid.

La tabella seguente descrive le proprietà dell'oggetto defaults:

Proprietà Tipo Descrizione
defaults.org.kmsEncryptionKey Base Introdotto nella versione: 1.0.0

Valore predefinito: aWxvdmVhcGlzMTIzNDU2Nw==

Grafico: apigee-org, apigee-env

Chiave di crittografia predefinita per l'organizzazione in KMS.

defaults.org.kvmEncryptionKey Base Introdotto nella versione: 1.0.0

Valore predefinito: aWxvdmVhcGlzMTIzNDU2Nw==

Grafico: apigee-org, apigee-env

Chiave di crittografia predefinita per l'organizzazione in KVM.

defaults.env.kmsEncryptionKey Base Introdotto nella versione: 1.0.0

Valore predefinito: aWxvdmVhcGlzMTIzNDU2Nw==

Grafico: apigee-env

Chiave di crittografia predefinita per l'ambiente (env) in KMS.

defaults.env.kvmEncryptionKey Base Introdotto nella versione: 1.0.0

Valore predefinito: aWxvdmVhcGlzMTIzNDU2Nw==

Grafico: apigee-env

Chiave di crittografia predefinita per l'ambiente (env) in KVM.

defaults.env.cacheEncryptionKey Base Introdotto nella versione: 1.0.0

Valore predefinito: aWxvdmVhcGlzMTIzNDU2Nw==

Grafico: apigee-env

Chiave di crittografia della cache predefinita per l'ambiente (env).

envs

Definisce un array di ambienti in cui puoi eseguire il deployment dei proxy API. Ogni ambiente fornisce un contesto isolato o una sandbox per l'esecuzione dei proxy API.

La tua organizzazione abilitata all'ibrido deve avere almeno un ambiente.

Per saperne di più, consulta Informazioni sugli ambienti.

La tabella seguente descrive le proprietà dell'oggetto envs:

Proprietà Tipo Descrizione
envs[].cacheEncryptionKey Base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-env

È obbligatorio specificare uno dei valori cacheEncryptionKey, cacheEncryptionPath o cacheEncryptionSecret.

Una chiave di crittografia con codifica Base64. Consulta Crittografia dei dati.

envs[].cacheEncryptionPath Base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-env

È obbligatorio specificare uno dei valori cacheEncryptionKey, cacheEncryptionPath o cacheEncryptionSecret.

Il percorso di un file contenente una chiave di crittografia con codifica Base64. Consulta Crittografia dei dati.

envs[].cacheEncryptionSecret.key Base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-env

È obbligatorio specificare uno dei valori cacheEncryptionKey, cacheEncryptionPath o cacheEncryptionSecret.

La chiave di un secret Kubernetes contenente una chiave di crittografia con codifica Base64. Consulta Crittografia dei dati.

envs[].cacheEncryptionSecret.name Base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-env

È obbligatorio specificare cacheEncryptionKey, cacheEncryptionPath o cacheEncryptionSecret.

Il nome di un secret Kubernetes contenente una chiave di crittografia con codifica Base64. Consulta Crittografia dei dati.

envs[].components.runtime.podDisruptionBudget.minAvailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-env

Il numero minimo di pod di runtime in questo ambiente che devono rimanere disponibili durante un'interruzione volontaria, ad esempio durante un upgrade del pool di nodi o un'evacuazione dei nodi. Override runtime.podDisruptionBudget.minAvailable. Questo campo imposta il campo minAvailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%").

minAvailable e maxUnavailable si escludono a vicenda; imposta solo uno dei due. L'operatore Apigee rifiuta l'impostazione di entrambi contemporaneamente. Se non imposti nessuno dei due campi, questo ambiente utilizza runtime.podDisruptionBudget.minAvailable o runtime.podDisruptionBudget.maxUnavailable; se nessuno dei due è impostato, l'operatore Apigee applica il valore predefinito maxUnavailable: 1.

Ad esempio, in overrides.yaml:

envs:
  - name: test
    components:
      runtime:
        podDisruptionBudget:
          minAvailable: "50%"
envs[].components.runtime.podDisruptionBudget.maxUnavailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-env

Il numero massimo di pod di runtime in questo ambiente che possono non essere disponibili durante un'interruzione volontaria, ad esempio durante un upgrade pool di nodi o un'eliminazione dei nodi. Override runtime.podDisruptionBudget.maxUnavailable. Questo campo imposta il campo maxUnavailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%").

maxUnavailable e minAvailable si escludono a vicenda; imposta solo uno dei due. L'operatore Apigee rifiuta l'impostazione di entrambi contemporaneamente. Se non imposti nessuno dei due campi, questo ambiente utilizza runtime.podDisruptionBudget.minAvailable o runtime.podDisruptionBudget.maxUnavailable; se nessuno dei due è impostato, l'operatore Apigee applica il valore predefinito maxUnavailable: 1.

Ad esempio, in overrides.yaml:

envs:
  - name: test
    components:
      runtime:
        podDisruptionBudget:
          maxUnavailable: 1
envs[].components.runtime.replicaCountMax Base Introdotto nella versione: 1.9.3

Valore predefinito: 4

Grafico: apigee-env

Numero massimo di repliche per la scalabilità automatica. Esegue l'override di runtime.replicaCountMax se specificato.

envs[].components.runtime.replicaCountMin Base Introdotto nella versione: 1.9.3

Valore predefinito: 1

Grafico: apigee-env

Numero minimo di repliche per la scalabilità automatica. Esegue l'override di runtime.replicaCountMin se specificato.

envs[].components.runtime.resources.limits.memory Avanzato Introdotto nella versione: 1.15.0

Valore predefinito: nessuno

Grafico: apigee-env

Il limite di memoria per la risorsa in un container Kubernetes, in mebibyte (Mi) o gibibyte (Gi).

envs[].components.runtime.resources.requests.memory Avanzato Introdotto nella versione: 1.15.0

Valore predefinito: nessuno

Grafico: apigee-env

La memoria necessaria per il normale funzionamento della risorsa in un container Kubernetes, in mebibyte (Mi) o gibibyte (Gi).

envs[].components.synchronizer.podDisruptionBudget.minAvailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-env

Il numero minimo di pod sincronizzatori in questo ambiente che devono rimanere disponibili durante un'interruzione volontaria, ad esempio durante un upgrade del pool di nodi o un'evacuazione dei nodi. Override synchronizer.podDisruptionBudget.minAvailable. Questo campo imposta il campo minAvailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%").

minAvailable e maxUnavailable si escludono a vicenda; imposta solo uno dei due. L'operatore Apigee rifiuta l'impostazione di entrambi contemporaneamente. Se non imposti nessuno dei due campi, questo ambiente utilizza synchronizer.podDisruptionBudget.minAvailable o synchronizer.podDisruptionBudget.maxUnavailable; se nessuno dei due è impostato, l'operatore Apigee applica il valore predefinito maxUnavailable: 1.

Ad esempio, in overrides.yaml:

envs:
  - name: test
    components:
      synchronizer:
        podDisruptionBudget:
          minAvailable: "50%"
envs[].components.synchronizer.podDisruptionBudget.maxUnavailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-env

Il numero massimo di pod sincronizzatori in questo ambiente che possono essere non disponibili durante un'interruzione volontaria, ad esempio durante un upgrade del pool di nodi o un'evacuazione dei nodi. Override synchronizer.podDisruptionBudget.maxUnavailable. Questo campo imposta il campo maxUnavailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%").

maxUnavailable e minAvailable si escludono a vicenda; imposta solo uno dei due. L'operatore Apigee rifiuta l'impostazione di entrambi contemporaneamente. Se non imposti nessuno dei due campi, questo ambiente utilizza synchronizer.podDisruptionBudget.minAvailable o synchronizer.podDisruptionBudget.maxUnavailable; se nessuno dei due è impostato, l'operatore Apigee applica il valore predefinito maxUnavailable: 1.

Ad esempio, in overrides.yaml:

envs:
  - name: test
    components:
      synchronizer:
        podDisruptionBudget:
          maxUnavailable: 1
envs[].components.synchronizer.replicaCountMax Base Introdotto nella versione: 1.9.3

Valore predefinito: 4

Grafico: apigee-env

Numero massimo di repliche per la scalabilità automatica. Esegue l'override di synchronizer.replicaCountMax se specificato.

envs[].components.synchronizer.replicaCountMin Base Introdotto nella versione: 1.9.3

Valore predefinito: 1

Grafico: apigee-env

Numero minimo di repliche per la scalabilità automatica. Esegue l'override di synchronizer.replicaCountMin se specificato.

envs[].gsa.runtime Avanzato Introdotto nella versione: 1.10.0

Valore predefinito: nessuno

Grafico: apigee-env

Solo Helm: l'indirizzo email del account di servizio Google IAM di runtime da associare al account di servizio Kubernetes corrispondente quando si abilita Workload Identity sui cluster GKE utilizzando i grafici Helm.

Consulta Abilitare Workload Identity su GKE o Abilitare la federazione delle identità per i workload su AKS ed EKS.

envs[].gsa.synchronizer Avanzato Introdotto nella versione: 1.10.0

Valore predefinito: nessuno

Grafico: apigee-env

Solo Helm: l'indirizzo email del account di servizio Google IAM del sincronizzatore da associare al account di servizio Kubernetes corrispondente quando si abilita Workload Identity sui cluster GKE utilizzando i grafici Helm.

Consulta Abilitare Workload Identity su GKE o Abilitare la federazione delle identità per i workload su AKS ed EKS.

envs[].httpProxy.host Base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-env

Specifica il nome host o l'indirizzo IP in cui è in esecuzione il proxy HTTP.

Elenca le proprietà httpProxy nell'ordine scheme, host, port. Ad esempio:

envs:
  - name: test
    httpProxy:
      scheme: HTTP
      host: 10.12.0.47
      port: 3128
      ...

Vedi anche: Configurare l'inoltro del proxy per i proxy API.

envs[].httpProxy.port Base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-env

Specifica la porta su cui è in esecuzione il proxy HTTP. Se questa proprietà viene omessa, per impostazione predefinita utilizza la porta 80 per HTTP e la porta 443 per HTTPS.

envs[].httpProxy.scheme Base Introdotto nella versione: 1.2.0

Valore predefinito: HTTPS

Grafico: apigee-env

Specifica il tipo di proxy HTTP come HTTP o HTTPS. Per impostazione predefinita, utilizza HTTPS.

envs[].httpProxy.username Base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-env

Se il proxy HTTP richiede l'autenticazione di base, utilizza questa proprietà per fornire un nome utente.

envs[].httpProxy.password Base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-env

Se il proxy HTTP richiede l'autenticazione di base, utilizza questa proprietà per fornire una password.

envs[].managementCallsSkipProxy Avanzato Introdotto nella versione: 1.15.1

Valore predefinito: false

Grafico: apigee-env

Se impostato su true per il proxy di inoltro a livello di ambiente, la traccia e l'analisi (che utilizzano googleapis.com) salteranno il proxy di inoltro. I target nel proxy (incluso googleapis.com) verranno indirizzati tramite il proxy di inoltro. Questa impostazione non può essere utilizzata insieme a useForRuntimeManagement.

envs[].name Base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-env

Obbligatorio

Nome dell'ambiente Apigee da sincronizzare.

envs[].pollInterval Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-env

Intervallo utilizzato per il polling delle modifiche alla sincronizzazione dell'organizzazione e dell'ambiente, in secondi.

envs[].port Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-env

Numero di porta TCP per il traffico HTTPS.

envs[].securityContext.seccompProfile.type Avanzato

Introdotto nella versione: 1.16.0

Valore predefinito: nessuno

Grafico: apigee-env

Specifica il tipo di profilo Seccomp da applicare al contesto di sicurezza del pod. I valori consentiti sono RuntimeDefault (per utilizzare il profilo predefinito del runtime del container) o Unconfined (per non applicare restrizioni Seccomp). Se non specificato, Apigee non applica alcun profilo.

Consulta Configurare i profili Seccomp per la sicurezza dei pod.

envs[].serviceAccountPaths.runtime Base Introdotto nella versione: 1.4.0

Valore predefinito: nessuno

Grafico: apigee-env

Percorso del file sul sistema locale di una chiave del service account Google con il ruolo Agente Cloud Trace, in genere il account di servizio apigee-runtime. Consulta la sezione Informazioni sui service account per i nomi predefiniti dei service account e i ruoli assegnati.

envs[].serviceAccountPaths.synchronizer Base Introdotto nella versione: 1.0

Valore predefinito: nessuno

Grafico: apigee-env

Percorso del file sul sistema locale di una chiave dell'account di servizio Google con il ruolo Gestore sincronizzatore Apigee.

envs[].serviceAccountSecretProviderClass Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: nessuno

Grafico: apigee-env

Il nome della classe del fornitore di secret specifico dell'ambiente (SecretProviderClass) utilizzato per archiviare le chiavi del account di servizio in Vault.

Consulta Memorizzazione delle chiavi del account di servizio in Hashicorp Vault.

envs[].serviceAccountSecretRefs.runtime Base Introdotto nella versione: 1.4.0

Valore predefinito: nessuno

Grafico: apigee-env

Il nome di un secret Kubernetes. Devi creare il secret utilizzando una chiave del service account Google con il ruolo Agente Cloud Trace come input.

envs[].serviceAccountSecretRefs.synchronizer Base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-env

Il nome di un secret Kubernetes. Devi creare il secret utilizzando una chiave dell'account di servizio Google con il ruolo Gestore sincronizzatore Apigee come input.

gcp

Identifica l'ID progetto Google Cloud (obbligatorio per tutte le installazioni ibride), le configurazioni di Workload Identity e di federazione delle identità per i workload e la regione in cui apigee-logger e apigee-metrics inviano i dati.

La tabella seguente descrive le proprietà dell'oggetto gcp:

Proprietà Tipo Descrizione
gcp.federatedWorkloadIdentity.audience Base Introdotto nella versione: 1.12.0

Valore predefinito: nessuno

Grafico: apigee-datastore, apigee-telemetry, apigee-org, apigee-env

Il pubblico consentito del provider di identità del workload su piattaforme non GKE. Utilizzato quando gcp.federatedWorkloadIdentity.type è kubernetes.

Consulta Attivazione della federazione delle identità per i workload su AKS ed EKS.

gcp.federatedWorkloadIdentity.credentialSourceFile Base Introdotto nella versione: 1.12.0

Valore predefinito: nessuno

Grafico: apigee-datastore, apigee-telemetry, apigee-org, apigee-env

Il nome file e il percorso del file di origine delle credenziali utilizzato dalla federazione delle identità per i workload per ottenere le credenziali per i service account. Questo è il valore che fornisci per credential-source-file quando configuri la federazione delle identità per i workload con il comando create-cred-config. Utilizzato quando gcp.federatedWorkloadIdentity.type è kubernetes.

Consulta Attivazione della federazione delle identità per i workload su AKS ed EKS.

gcp.federatedWorkloadIdentity.enabled Base Introdotto nella versione: 1.12.0

Valore predefinito: false

Grafico: apigee-datastore, apigee-telemetry, apigee-org, apigee-env

Attiva la federazione delle identità per i workload su piattaforme non GKE. Non deve essere impostato true se gcp.workloadIdentity.enabled è impostato su true nello stesso cluster.

Consulta Attivazione della federazione delle identità per i workload su AKS ed EKS.

gcp.federatedWorkloadIdentity.sidecarSpec.annotations Avanzato Introdotto nella versione: 1.16.2

Valore predefinito: nessuno

Grafico: apigee-datastore, apigee-telemetry, apigee-org, apigee-env

Una mappa di annotazioni da applicare ai pod ibridi quando gcp.federatedWorkloadIdentity.type è sidecar. Queste possono essere integrate o sostituite da annotazioni a livello di componente, ad esempio runtime.annotations.

Consulta Utilizzare l'autenticazione sidecar per la federazione delle identità per i workload su AKS ed EKS.

gcp.federatedWorkloadIdentity.sidecarSpec.container Avanzato Introdotto nella versione: 1.16.2

Valore predefinito: nessuno

Grafico: apigee-datastore, apigee-telemetry, apigee-org, apigee-env

Una mappa delle specifiche del container Kubernetes per il container sidecar, ad esempio image, imagePullPolicy, name e così via. Per maggiori informazioni, consulta la documentazione sui container Kubernetes. Devi fornire qui l'immagine container personalizzata. Obbligatorio quando gcp.federatedWorkloadIdentity.type è sidecar.

Consulta Utilizzare l'autenticazione sidecar per la federazione delle identità per i workload su AKS ed EKS.

gcp.federatedWorkloadIdentity.sidecarSpec.container.env Avanzato Introdotto nella versione: 1.16.2

Valore predefinito: nessuno

Grafico: apigee-datastore, apigee-telemetry, apigee-org, apigee-env

Un elenco di variabili di ambiente da impostare per il container sidecar. Per saperne di più, consulta la documentazione sui container Kubernetes.

Consulta Utilizzare l'autenticazione sidecar per la federazione delle identità per i workload su AKS ed EKS.

gcp.federatedWorkloadIdentity.sidecarSpec.container.startupProbe Avanzato Introdotto nella versione: 1.16.2

Valore predefinito: nessuno

Grafico: apigee-datastore, apigee-telemetry, apigee-org, apigee-env

Definisce un probe di avvio Kubernetes per il container sidecar. Per saperne di più, consulta la documentazione sui container Kubernetes.

Consulta Utilizzare l'autenticazione sidecar per la federazione delle identità per i workload su AKS ed EKS.

gcp.federatedWorkloadIdentity.sidecarSpec.container.volumeMounts Avanzato Introdotto nella versione: 1.16.2

Valore predefinito: nessuno

Grafico: apigee-datastore, apigee-telemetry, apigee-org, apigee-env

Un elenco di montaggi di volumi Kubernetes aggiuntivi per il container sidecar nei pod ibridi quando gcp.federatedWorkloadIdentity.type è sidecar.

Consulta Utilizzare l'autenticazione sidecar per la federazione delle identità per i workload su AKS ed EKS.

gcp.federatedWorkloadIdentity.sidecarSpec.volumes Avanzato Introdotto nella versione: 1.16.2

Valore predefinito: nessuno

Grafico: apigee-datastore, apigee-telemetry, apigee-org, apigee-env

Un elenco di volumi Kubernetes aggiuntivi da montare sui pod ibridi quando gcp.federatedWorkloadIdentity.type è sidecar.

Consulta Utilizzare l'autenticazione sidecar per la federazione delle identità per i workload su AKS ed EKS.

gcp.federatedWorkloadIdentity.tokenExpiration Base Introdotto nella versione: 1.12.0

Valore predefinito: 3600

Grafico: apigee-datastore, apigee-telemetry, apigee-org, apigee-env

La durata del token in secondi. Utilizzato quando gcp.federatedWorkloadIdentity.type è kubernetes.

Consulta Attivazione della federazione delle identità per i workload su AKS ed EKS.

gcp.federatedWorkloadIdentity.type Avanzato Introdotto nella versione: 1.16.2

Valore predefinito: kubernetes

Grafico: apigee-datastore, apigee-telemetry, apigee-org, apigee-env

Il metodo utilizzato per ottenere i token della federazione delle identità per i workload. I valori supportati sono:

gcp.projectID Base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-operator, apigee-telemetry, apigee-org

Obbligatorio

Identifica il progetto Google Cloud in cui apigee-logger e apigee-metrics inviano i propri dati.

gcp.region Base Introdotto nella versione: 1.2.0

Valore predefinito: us-central1

Grafico: apigee-env, apigee-org

Obbligatorio

Identifica la regione di Google Cloud in cui apigee-logger e apigee-metrics inviano i dati.

gcp.workloadIdentity.enabled Base Introdotto nella versione: 1.10.0

Valore predefinito:false

Grafico: apigee-operator, apigee-datastore, apigee-telemetry, apigee-org, apigee-env

Consente di utilizzare Workload Identity Federation for GKE. In questo modo, i carichi di lavoro nei cluster GKE possono impersonare i service account IAM (Identity and Access Management) per accedere ai servizi Google Cloud.

Non deve essere impostato true se gcp.federatedWorkloadIdentity.enabled è impostato su true nello stesso cluster.

Quando enabled è false, il valore predefinito, Apigee utilizza diversi metodi di autenticazione delaccount di serviziot, come file di chiavi delaccount di serviziot, secret Kubernetes, Vault o federazione delle identità per i workload su altre piattaforme. Consulta Metodi di autenticazione del service account in Apigee hybrid.

Quando workloadIdentityEnabled è true, Apigee utilizza i service account Kubernetes e li mappa ai service account IAM appropriati per ogni componente. Specifica i service account IAM da mappare ai service account Kubernetes con:

gcp.workloadIdentity.gsa Avanzato Introdotto nella versione: 1.10.0

Valore predefinito: nessuno

Grafico: apigee-datastore, apigee-telemetry, apigee-org, apigee-env

L'indirizzo email del account di servizio Google IAM (GSA) per tutti i componenti da associare al account di servizio Kubernetes corrispondente quando si abilita Workload Identity sui cluster GKE utilizzando i grafici Helm. Imposta questo valore quando hai impostato gcp.workloadIdentity.enabled su true.

gcp.workloadIdentity.gsa si applica a tutti i componenti ibridi. Se specifichi un valore per gcp.workloadIdentity.gsa, non devi fornire un GSA per i singoli componenti ibridi. Se fornisci un GSA per un singolo componente, il GSA di quel componente sostituisce gcp.workloadIdentity.gsa solo per quel componente.

Gli indirizzi email GSA hanno in genere il formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

apigee-non-prod@my-hybrid-project.iam.gserviceaccount.com

Vedi Enabling Workload Identity on GKE.

guardrails

Identifica il account di servizio Google (GSA) e il file della chiave utilizzati dal servizio Apigee Guardrails. Il servizio Apigee Guardrails consente al pod guardrails nel grafico apigee-operator di verificare se le API richieste sono abilitate nel progetto per l'installazione corretta di Apigee hybrid, come descritto in Diagnosi dei problemi relativi ai guardrail e Installazione e upgrade del runtime ibrido.

La tabella seguente descrive le proprietà dell'oggetto guardrails:

Proprietà Tipo Descrizione
guardrails.image.pullPolicy Avanzato Introdotto nella versione: 1.16.0

Valore predefinito: IfNotPresent

Grafico: apigee-org

Determina quando kubelet esegue il pull dell'immagine Docker del pod. I valori possibili sono:

  • IfNotPresent: non estrarre una nuova immagine se esiste già.
  • Always: estrae sempre l'immagine, indipendentemente dal fatto che esista già.

Per saperne di più, vedi Aggiornamento delle immagini.

guardrails.image.tag Avanzato Introdotto nella versione: 1.16.0

Valore predefinito: 1.16.10

Grafico: apigee-org

L'etichetta della versione per l'immagine Docker di questo servizio.

guardrails.image.url Avanzato Introdotto nella versione: 1.16.0

Valore predefinito: nessuno

Grafico: apigee-org

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository corrente per questo componente.

guardrails.gsa Avanzato Introdotto nella versione: 1.16.0

Valore predefinito: nessuno

Grafico: apigee-operator

L'indirizzo email del account di servizio Google IAM apigee-guardrails da associare al account di servizio Kubernetes corrispondente quando abiliti Workload Identity sui cluster GKE. Imposta questo valore quando hai impostato gcp.workloadIdentity.enabled su true.

Gli indirizzi email GSA hanno in genere il formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

apigee-guardrails@my-hybrid-project.iam.gserviceaccount.com

Consulta Abilitare Workload Identity su GKE o Abilitare la federazione delle identità per i workload su AKS ed EKS.

guardrails.serviceAccountPath Base Introdotto nella versione: 1.16.0

Valore predefinito: nessuno

Grafico: apigee-operator

A meno che non utilizzi Workload Identity, è necessario uno tra serviceAccountPath o serviceAccountRef.

Il percorso del file della chiave dell'account di servizio Google con il ruolo Visualizzatore utilizzo servizio.

guardrails.serviceAccountRef Avanzato Introdotto nella versione: 1.16.0

Valore predefinito: nessuno

Grafico: apigee-operator

A meno che non utilizzi Workload Identity, è necessario uno tra serviceAccountPath o serviceAccountRef.

Un riferimento segreto di Kubernetes a un file della chiave del account di servizio Google. Consulta Memorizzazione delle chiavi dei account di servizio nei secret Kubernetes.

guardrails.tolerations.effect Avanzato Introdotto nella versione: 1.16.0

Valore predefinito: nessuno

Grafico: apigee-operator

Obbligatorio per utilizzare la funzionalità Taints and Tolerations di Kubernetes.

effect specifica l'effetto della corrispondenza di una tolleranza con un taint. I valori per effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per i dettagli, consulta Taints e tolleranze: concetti.

guardrails.tolerations.key Avanzato Introdotto nella versione: 1.16.0

Valore predefinito: nessuno

Grafico: apigee-operator

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

key identifica i pod a cui può essere applicata la tolleranza.

Per i dettagli, consulta Tolleranze e taint: concetti.

guardrails.tolerations.operator Avanzato Introdotto nella versione: 1.16.0

Valore predefinito: "Equal"

Grafico: apigee-operator

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

operator specifica l'operazione utilizzata per attivare effect. I valori per operator possono essere:

  • Equal corrisponde al valore impostato in value.
  • Exists ignora il valore impostato in value.

Per i dettagli, consulta Tolleranze e taint: concetti.

guardrails.tolerations.tolerationSeconds Avanzato Introdotto nella versione: 1.16.0

Valore predefinito: nessuno

Grafico: apigee-operator

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

tolerationSeconds definisce in secondi per quanto tempo un pod rimane associato a un nodo non riuscito o che non risponde.

Per i dettagli, consulta Tolleranze e taint: concetti.

guardrails.tolerations.value Avanzato Introdotto nella versione: 1.16.0

Valore predefinito: nessuno

Grafico: apigee-operator

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

value è il valore che attiva effect quando operator è impostato su Equal.

Per i dettagli, consulta Tolleranze e taint: concetti.

httpProxy

httpProxy fornisce parametri di configurazione per un server proxy di inoltro HTTP. Se configurato in overrides.yaml, tutte le comunicazioni internet per i componenti Apigee Connect, Logger, MART, Metrics, Synchronizer e UDCA passano attraverso il server proxy.

Vedi anche: connectAgent, logger, mart, metrics, e synchronizer.

La tabella seguente descrive le proprietà dell'oggetto httpProxy:

Proprietà Tipo Descrizione
httpProxy.host Base Introdotto nella versione: 1.1.1

Valore predefinito: nessuno

Grafico: apigee-operator, apigee-datastore, apigee-telemetry, apigee-ingress-manager, apigee-org, apigee-env, apigee-virtualhost

Il nome host del proxy HTTP.

httpProxy.password Base Introdotto nella versione: 1.1.1

Valore predefinito: nessuno

Grafico: apigee-operator, apigee-datastore, apigee-telemetry, apigee-ingress-manager, apigee-org, apigee-env, apigee-virtualhost

Se il proxy HTTP richiede l'autenticazione di base, utilizza questa proprietà per fornire una password.

httpProxy.port Base Introdotto nella versione: 1.1.1

Valore predefinito: nessuno

Grafico: apigee-operator, apigee-datastore, apigee-telemetry, apigee-ingress-manager, apigee-org, apigee-env, apigee-virtualhost

La porta del proxy HTTP.

httpProxy.scheme Base Introdotto nella versione: 1.1.1

Valore predefinito: HTTPS

Grafico: apigee-operator, apigee-datastore, apigee-telemetry, apigee-ingress-manager, apigee-org, apigee-env, apigee-virtualhost

Lo schema utilizzato dal proxy. I valori possono essere HTTP o HTTPS. I valori devono essere solo in maiuscolo.

httpProxy.useForRuntimeManagement Avanzato Introdotto nella versione: 1.15.1

Valore predefinito: nessuno

Grafico: apigee-org

Se useForRuntimeManagement è impostato su true, i dati di debug o di analisi vengono instradati dal runtime utilizzando questo proxy di inoltro. Puoi impostare questo flag anche se il runtime ha una propria configurazione proxy per il suo ambiente. In questo caso, i dati di debug o di analisi del runtime utilizzeranno il proxy condiviso a livello di organizzazione, mentre il traffico di backend/proxy continuerà a utilizzare il proxy a livello di ambiente (inclusi anche i call a googleapis.com).

httpProxy.username Base Introdotto nella versione: 1.1.1

Valore predefinito: nessuno

Grafico: apigee-operator, apigee-datastore, apigee-telemetry, apigee-ingress-manager, apigee-org, apigee-env, apigee-virtualhost

Se il proxy HTTP richiede l'autenticazione di base, utilizza questa proprietà per fornire un nome utente.

ingressGateways

Configura ogni singola istanza del gateway in entrata Apigee. Utilizza queste proprietà quando vuoi gestire separatamente le singole istanze in base a ingressGateways[].name.

Consulta apigeeIngressGateway per applicare una configurazione comune a tutte le istanze del gateway in entrata Apigee.

Applica le modifiche alle proprietà di ingressGateways con il grafico apigee-org.

La tabella seguente descrive le proprietà dell'oggetto ingressGateways:

Proprietà Tipo Descrizione
ingressGateways[].name Base Introdotto nella versione: 1.8.0

Valore predefinito: nessuno

Grafico: apigee-org

Obbligatorio

Il nome del gateway in entrata. Altri servizi utilizzeranno questo nome per indirizzare il traffico al gateway. Il nome deve soddisfare i seguenti requisiti:

  • avere una lunghezza massima di 17 caratteri
  • contenere solo caratteri alfanumerici minuscoli, '-' o '.'
  • iniziare con un carattere alfanumerico
  • terminare con un carattere alfanumerico

Per saperne di più, consulta DNS Subdomain Names nella documentazione di Kubernetes.

ingressGateways[].podDisruptionBudget.minAvailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-org

Il numero minimo di pod per questo gateway in entrata che devono rimanere disponibili durante un'interruzione volontaria, ad esempio durante un upgrade del pool di nodi o un nodo di svuotamento. Override apigeeIngressGateway.podDisruptionBudget.minAvailable. Questo campo imposta il campo minAvailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%").

minAvailable e maxUnavailable si escludono a vicenda; imposta solo uno dei due. L'operatore Apigee rifiuta l'impostazione di entrambi contemporaneamente. Se non imposti nessuno dei due campi, questo gateway utilizza apigeeIngressGateway.podDisruptionBudget.minAvailable o apigeeIngressGateway.podDisruptionBudget.maxUnavailable; se nessuno dei due è impostato, l'operatore Apigee applica il valore predefinito di maxUnavailable: 1.

Ad esempio, in overrides.yaml:

ingressGateways:
  - name: my-gateway
    podDisruptionBudget:
      minAvailable: "50%"
ingressGateways[].podDisruptionBudget.maxUnavailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-org

Il numero massimo di pod per questo gateway in entrata che possono essere non disponibili durante un'interruzione volontaria, ad esempio durante un upgrade del pool di nodi o uno svuotamento dei nodi. Override apigeeIngressGateway.podDisruptionBudget.maxUnavailable. Questo campo imposta il campo maxUnavailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%").

maxUnavailable e minAvailable si escludono a vicenda; imposta solo uno dei due. L'operatore Apigee rifiuta l'impostazione di entrambi contemporaneamente. Se non imposti nessuno dei due campi, questo gateway utilizza apigeeIngressGateway.podDisruptionBudget.minAvailable o apigeeIngressGateway.podDisruptionBudget.maxUnavailable; se nessuno dei due è impostato, l'operatore Apigee applica il valore predefinito di maxUnavailable: 1.

Ad esempio, in overrides.yaml:

ingressGateways:
  - name: my-gateway
    podDisruptionBudget:
      maxUnavailable: 1
ingressGateways[].proxyProtocol.mode Avanzato

Introdotto nella versione: 1.16.6

Valore predefinito: disable

Grafico: apigee-org

Attiva l'analisi del protocollo PROXY HAProxy nel componente del gateway in entrata. I valori consentiti sono strict, permissive o disable.

Se impostato, questo valore per gateway sostituisce il valore predefinito globale configurato in apigeeIngressGateway.proxyProtocol.mode.

ingressGateways[].replicaCountMax Base Introdotto nella versione: 1.8.0

Valore predefinito: 10

Grafico: apigee-org

Il numero massimo di pod che ibrido può aggiungere automaticamente per il gateway in entrata disponibile per la scalabilità automatica.

ingressGateways[].replicaCountMin Base Introdotto nella versione: 1.8.0

Valore predefinito: 2

Grafico: apigee-org

Il numero minimo di pod per il gateway in entrata disponibili per la scalabilità automatica.

ingressGateways[].resources.limits.cpu Avanzato Introdotto nella versione: 1.8.0

Valore predefinito: 2000m

Grafico: apigee-org

Il limite CPU per la risorsa, in millicore.

ingressGateways[].resources.limits.memory Avanzato Introdotto nella versione: 1.8.0

Valore predefinito: 1Gi

Grafico: apigee-org

Il limite di memoria per la risorsa, in mebibyte.

ingressGateways[].resources.requests.cpu Avanzato Introdotto nella versione: 1.8.0

Valore predefinito: 300m

Grafico: apigee-org

La CPU necessaria per il normale funzionamento della risorsa, in millicore.

ingressGateways[].resources.requests.memory Avanzato Introdotto nella versione: 1.8.0

Valore predefinito: 128Mi

Grafico: apigee-org

La memoria necessaria per il normale funzionamento della risorsa, in mebibyte.

ingressGateways[].securityContext.seccompProfile.type Avanzato

Introdotto nella versione: 1.16.0

Valore predefinito: nessuno

Grafico: apigee-org

Specifica il tipo di profilo Seccomp da applicare al contesto di sicurezza del pod. I valori consentiti sono RuntimeDefault (per utilizzare il profilo predefinito del runtime del container) o Unconfined (per non applicare restrizioni Seccomp). Se non specificato, Apigee non applica alcun profilo.

Consulta Configurare i profili Seccomp per la sicurezza dei pod.

ingressGateways[].svcAnnotations Base Introdotto nella versione: 1.8.0

Valore predefinito: nessuno

Grafico: apigee-org

Mappa chiave/valore facoltativa utilizzata per annotare il gateway in entrata sulle piattaforme che supportano l'annotazione. Ad esempio:

ingressGateways:
  svcAnnotations:
    networking.gke.io/load-balancer-type: "Internal"
ingressGateways[].svcLoadBalancerIP Base Introdotto nella versione: 1.8.0

Valore predefinito: nessuno

Grafico: apigee-org

Sulle piattaforme che supportano la specifica dell'indirizzo IP del bilanciatore del carico, quest'ultimo verrà creato con questo indirizzo IP. Sulle piattaforme che non consentono di specificare l'indirizzo IP del bilanciatore del carico, questa proprietà viene ignorata.

ingressGateways[].svcType Base Introdotto nella versione: 1.8.1

Valore predefinito: LoadBalancer

Grafico: apigee-org

Utilizzato per modificare il tipo di servizio k8s predefinito per il deployment in entrata. Imposta il valore su ClusterIP se vuoi disattivare la creazione del bilanciatore del carico predefinito. Valori possibili:

  • ClusterIP
  • LoadBalancer
ingressGateways[].targetCPUUtilizationPercentage Avanzato Introdotto nella versione: 1.10.5, 1.11.2, 1.12.1

Valore predefinito: 75

Grafico: apigee-org

La soglia di utilizzo della CPU per scalare il numero di pod nel ReplicaSet, come percentuale delle risorse CPU totali disponibili.

Quando l'utilizzo della CPU supera questo valore, l'ibrido aumenterà gradualmente il numero di pod nel ReplicaSet fino a ingressGateways[].replicaCountMax.

Per ulteriori informazioni sulla scalabilità in Kubernetes, consulta Scalabilità automatica orizzontale dei pod nella documentazione di Kubernetes.

ingressGateways[].tolerations.effect Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-operator

Obbligatorio per utilizzare la funzionalità Taints and Tolerations di Kubernetes.

effect specifica l'effetto della corrispondenza di una tolleranza con un taint. I valori per effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per i dettagli, consulta Taints e tolleranze: concetti.

ingressGateways[].tolerations.key Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-operator

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

key identifica i pod a cui può essere applicata la tolleranza.

Per i dettagli, consulta Tolleranze e taint: concetti.

ingressGateways[].tolerations.operator Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: "Equal"

Grafico: apigee-operator

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

operator specifica l'operazione utilizzata per attivare effect. I valori per operator possono essere:

  • Equal corrisponde al valore impostato in value.
  • Exists ignora il valore impostato in value.

Per i dettagli, consulta Tolleranze e taint: concetti.

ingressGateways[].tolerations.tolerationSeconds Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-operator

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

tolerationSeconds definisce in secondi per quanto tempo un pod rimane associato a un nodo non riuscito o che non risponde.

Per i dettagli, consulta Tolleranze e taint: concetti.

ingressGateways[].tolerations.value Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-operator

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

value è il valore che attiva effect quando operator è impostato su Equal.

Per i dettagli, consulta Tolleranze e taint: concetti.

istiod

Configura l'ingresso Apigee.

La tabella seguente descrive le proprietà dell'oggetto istiod:

Proprietà Tipo Descrizione
istiod.accessLogFile Avanzato Introdotto nella versione: 1.8.0

Valore predefinito: /dev/stdout

Grafico: apigee-ingress-manager

L'indirizzo del file per il log di accesso in entrata, ad esempio /dev/stdout.

Se questo valore non è definito, il logging degli accessi viene disattivato.

istiod.accessLogFormat Avanzato Introdotto nella versione: 1.8.0

Grafico: apigee-ingress-manager

Il formato del log degli accessi in entrata.

Se questo valore non viene definito, viene utilizzato il formato predefinito del log di accesso del proxy.

Formato predefinito del log degli accessi:

'{"start_time":"%START_TIME%","remote_address":"%DOWNSTREAM_DIRECT_REMOTE_ADDRESS%","user_agent":"%REQ(USER-AGENT)%","host":"%REQ(:AUTHORITY)%","request":"%REQ(:METHOD)% %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%","request_time":"%DURATION%","status":"%RESPONSE_CODE%","status_details":"%RESPONSE_CODE_DETAILS%","bytes_received":"%BYTES_RECEIVED%","bytes_sent":"%BYTES_SENT%","upstream_address":"%UPSTREAM_HOST%","upstream_response_flags":"%RESPONSE_FLAGS%","upstream_response_time":"%RESPONSE_DURATION%","upstream_service_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%","upstream_cluster":"%UPSTREAM_CLUSTER%","x_forwarded_for":"%REQ(X-FORWARDED-FOR)%","request_method":"%REQ(:METHOD)%","request_path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%","request_protocol":"%PROTOCOL%","tls_protocol":"%DOWNSTREAM_TLS_VERSION%","request_id":"%REQ(X-REQUEST-ID)%","sni_host":"%REQUESTED_SERVER_NAME%","apigee_dynamic_data":"%DYNAMIC_METADATA(envoy.lua)%"}'

Di seguito è riportata una copia del formato predefinito del log di accesso con interruzioni di riga aggiunte per una maggiore leggibilità.

'{"start_time":"%START_TIME%",
  "remote_address":"%DOWNSTREAM_DIRECT_REMOTE_ADDRESS%",
  "user_agent":"%REQ(USER-AGENT)%",
  "host":"%REQ(:AUTHORITY)%",
  "request":"%REQ(:METHOD)% %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%",
  "request_time":"%DURATION%",
  "status":"%RESPONSE_CODE%",
  "status_details":"%RESPONSE_CODE_DETAILS%",
  "bytes_received":"%BYTES_RECEIVED%",
  "bytes_sent":"%BYTES_SENT%",
  "upstream_address":"%UPSTREAM_HOST%",
  "upstream_response_flags":"%RESPONSE_FLAGS%",
  "upstream_response_time":"%RESPONSE_DURATION%",
  "upstream_service_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%",
  "upstream_cluster":"%UPSTREAM_CLUSTER%",
  "x_forwarded_for":"%REQ(X-FORWARDED-FOR)%",
  "request_method":"%REQ(:METHOD)%",
  "request_path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%",
  "request_protocol":"%PROTOCOL%",
  "tls_protocol":"%DOWNSTREAM_TLS_VERSION%",
  "request_id":"%REQ(X-REQUEST-ID)%",
  "sni_host":"%REQUESTED_SERVER_NAME%",
  "apigee_dynamic_data":"%DYNAMIC_METADATA(envoy.lua)%"}'
istiod.forwardClientCertDetails Avanzato Introdotto nella versione: 1.9.2

Valore predefinito: SANITIZE_SET

Grafico: apigee-ingress-manager

Determina il modo in cui il proxy Envoy (per il gateway di ingresso Apigee) gestisce l'intestazione HTTP x-forwarded-client-cert (XFCC).

I valori possibili sono:

  • SANITIZE_SET (impostazione predefinita) Quando la connessione client è mTLS, reimposta l'intestazione XFCC con le informazioni sul certificato client e inviala all'hop successivo.
  • FORWARD_ONLY Quando la connessione client è mTLS (Mutual TLS), inoltra solo l'intestazione XFCC nella richiesta.
  • APPEND_FORWARD Quando la connessione client è mTLS, aggiungi le informazioni del certificato client all'intestazione XFCC della richiesta e inoltrala.
  • SANITIZE Non inoltrare l'intestazione XFCC.
  • ALWAYS_FORWARD_ONLY Inoltra sempre l'intestazione XFCC nella richiesta, indipendentemente dal fatto che la connessione client sia mTLS.

Per ulteriori informazioni su questi valori, consulta la documentazione di Envoy per Enum extensions.filters.network.http_connection_manager.v3.HttpConnectionManager.ForwardClientCertDetails.

Se modifichi questa impostazione dopo aver installato Hybrid, applicala con apigeectl init e poi riavvia i pod del gateway in entrata Apigee.

istiod.healthCheckUserAgents Avanzato Introdotto nella versione: 1.12.0

Valori predefiniti:

- "GoogleStackdriverMonitoring-UptimeChecks(https://cloud.google.com/monitoring)"
- "Edge Health Probe"

Grafico: apigee-ingress-manager

Consente ai bilanciatori del carico nonGoogle Cloud di controllare gli endpoint del controllo di integrità del gateway in entrata (/healthz/ingress e /healthz) ignorando la lista consentita user-agent predefinita in modalità ibrida.

Per eseguire l'override degli user agent predefiniti specificati, utilizza la seguente sintassi, inserendo gli user agent personalizzati:

istiod:
  healthCheckUserAgents:
  - "CUSTOM_USER_AGENT_1"
  - "CUSTOM_USER_AGENT_2"

Per rimuovere il requisito dello user agent, utilizza quanto segue:

istiod:
  healthCheckUserAgents: []

istiod.image.pullPolicy Avanzato Introdotto nella versione: 1.8.0

Valore predefinito: IfNotPresent

Grafico: apigee-ingress-manager

Determina quando kubelet esegue il pull dell'immagine Docker del pod. I valori possibili sono:

  • IfNotPresent: non estrarre una nuova immagine se esiste già.
  • Always: esegue sempre il pull dell'immagine, indipendentemente dal fatto che esista già.

Per saperne di più, vedi Aggiornamento delle immagini.

istiod.image.tag Avanzato Introdotto nella versione: 1.8.0

Valore predefinito: 1.16.10

Grafico: apigee-ingress-manager

L'etichetta della versione per l'immagine Docker di questo servizio.

istiod.image.url Avanzato Introdotto nella versione: 1.8.0

Valore predefinito: nessuno

Grafico: apigee-ingress-manager

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository corrente per questo componente.

istiod.tolerations.effect Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-ingress-manager

Obbligatorio per utilizzare la funzionalità Taints and Tolerations di Kubernetes.

effect specifica l'effetto della corrispondenza di una tolleranza con un taint. I valori per effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per i dettagli, consulta Taints e tolleranze: concetti.

istiod.tolerations.key Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-ingress-manager

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

key identifica i pod a cui può essere applicata la tolleranza.

Per i dettagli, consulta Tolleranze e taint: concetti.

istiod.tolerations.operator Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: "Equal"

Grafico: apigee-ingress-manager

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

operator specifica l'operazione utilizzata per attivare effect. I valori per operator possono essere:

  • Equal corrisponde al valore impostato in value.
  • Exists ignora il valore impostato in value.

Per i dettagli, consulta Tolleranze e taint: concetti.

istiod.tolerations.tolerationSeconds Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-ingress-manager

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

tolerationSeconds definisce in secondi per quanto tempo un pod rimane associato a un nodo non riuscito o che non risponde.

Per i dettagli, consulta Tolleranze e taint: concetti.

istiod.tolerations.value Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-ingress-manager

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

value è il valore che attiva effect quando operator è impostato su Equal.

Per i dettagli, consulta Tolleranze e taint: concetti.

k8sCluster

Identifica il cluster Kubernetes in cui è installato l'ambiente di runtime ibrido.

La tabella seguente descrive le proprietà dell'oggetto k8sCluster:

Proprietà Tipo Descrizione
k8sCluster.name Base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-telemetry, apigee-org

Il nome del cluster Kubernetes in cui è installato il runtime ibrido.

k8sCluster.region Base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-telemetry, apigee-org

Identifica la regione Google Cloud in cui è stato creato il cluster Kubernetes.

kubeRBACProxy

Identifica dove Apigee deve cercare i controlli dell'accesso basati sui ruoli di Kubernetes.

La tabella seguente descrive le proprietà dell'oggetto kubeRBACProxy:

Proprietà Tipo Descrizione
kubeRBACProxy.image.pullPolicy Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: IfNotPresent

Grafico: apigee-operator, apigee-ingress-manager

Determina quando kubelet esegue il pull dell'immagine Docker del pod. I valori possibili sono:

  • IfNotPresent: non estrarre una nuova immagine se esiste già.
  • Always: estrae sempre l'immagine, indipendentemente dal fatto che esista già.

Per saperne di più, vedi Aggiornamento delle immagini.

kubeRBACProxy.image.tag Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: 1.16.10

Grafico: apigee-operator, apigee-ingress-manager

L'etichetta della versione per l'immagine Docker di questo servizio.

kubeRBACProxy.image.url Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-operator, apigee-ingress-manager

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository corrente per questo componente.

kubeRBACProxy.resources.limits.cpu Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 500m

Grafico: apigee-operator, apigee-ingress-manager

Il limite della CPU per la risorsa in un container Kubernetes, in millicore.

kubeRBACProxy.resources.limits.memory Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 128Mi

Grafico: apigee-operator, apigee-ingress-manager

Il limite di memoria per la risorsa in un container Kubernetes, in mebibyte.

kubeRBACProxy.resources.requests.cpu Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 5m

Grafico: apigee-operator, apigee-ingress-manager

La CPU necessaria per il normale funzionamento della risorsa in un contenitore Kubernetes, in millicore.

kubeRBACProxy.resources.requests.memory Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 64Mi

Grafico: apigee-operator, apigee-ingress-manager

La memoria necessaria per il normale funzionamento della risorsa in un container Kubernetes, in mebibyte.

logger

Definisce il servizio che gestisce i log operativi. Tutti i servizi Apigee hybrid in esecuzione nel cluster Kubernetes restituiscono queste informazioni.

Per saperne di più, consulta la panoramica di Logging.

La tabella seguente descrive le proprietà dell'oggetto logger:

Proprietà Tipo Descrizione
logger.securityContext.seccompProfile.type Avanzato

Introdotto nella versione: 1.16.0

Valore predefinito: nessuno

Grafico: apigee-telemetry

Specifica il tipo di profilo Seccomp da applicare al contesto di sicurezza del pod. I valori consentiti sono RuntimeDefault (per utilizzare il profilo predefinito del runtime del container) o Unconfined (per non applicare restrizioni Seccomp). Se non specificato, Apigee non applica alcun profilo.

Consulta Configurare i profili Seccomp per la sicurezza dei pod.

logger.annotations Avanzato Introdotto nella versione: 1.5.0

Valore predefinito: nessuno

Grafico: apigee-telemetry

Mappa chiave/valore facoltativa utilizzata per annotare i pod. Per ulteriori informazioni, consulta Annotazioni personalizzate.

logger.bufferChunkSize Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 256k

Grafico: apigee-telemetry

La dimensione iniziale del buffer per leggere i file di log.

logger.bufferMaxSize Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 104857600

Grafico: apigee-telemetry

Il limite delle dimensioni del buffer per file monitorato. I file che superano questo limite vengono rimossi dall'elenco dei file monitorati.

logger.bufferMemoryLimit Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 150 MB

Grafico: apigee-telemetry

Il limite di memoria che il logger può consumare. Se viene raggiunto, il logger interromperà momentaneamente la lettura di altri dati finché quelli esistenti non vengono svuotati dalla memoria.

logger.enabled Base Introdotto nella versione: 1.0.0

Valore predefinito: false

Grafico: apigee-telemetry

Attiva o disattiva la registrazione sul cluster. Per GKE non impostato su true, per GKE su Google Cloud o Google Distributed Cloud impostato su false.

logger.envVars Base Introdotto nella versione: 1.8.5

Valore predefinito: nessuno

Grafico: apigee-telemetry

Consente di includere la variabile di ambiente NO_PROXY Fluent Bit, che specifica gli URL per i quali il traffico non viene instradato tramite il proxy HTTP. La variabile NO_PROXY deve essere definita come una stringa di nomi host separati da virgole, nel formato:

logger:
  ...
  envVars:
    NO_PROXY: '<comma-separated-values>'

ad esempio:

  envVars:
    NO_PROXY: 'kubernetes.default.svc,oauth2.googleapis.com,logging.googleapis.com'

Utilizza envVars: NO_PROXY facoltativamente quando hai abilitato il proxy di inoltro HTTP.

Consulta NO_PROXY nella documentazione di Fluent Bit.

logger.flushInterval Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 1

Grafico: apigee-telemetry

L'intervallo di attesa prima di richiamare il buffer successivo svuotato, in secondi.

logger.gsa Avanzato Introdotto nella versione: 1.10.0

Valore predefinito: nessuno

Grafico: apigee-telemetry

Solo Helm: l'indirizzo email del account di servizio Google IAM apigee-logger da associare al account di servizio Kubernetes corrispondente quando si abilita Workload Identity sui cluster GKE utilizzando i grafici Helm. Imposta questa opzione quando hai impostato gcp.workloadIdentity.enabled su true.

Gli indirizzi email GSA hanno in genere il formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

apigee-logger@my-hybrid-project.iam.gserviceaccount.com

Consulta Abilitare Workload Identity su GKE o Abilitare la federazione delle identità per i workload su AKS ed EKS.

logger.image.pullPolicy Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: IfNotPresent

Grafico: apigee-telemetry

Determina quando kubelet esegue il pull dell'immagine Docker del pod. I valori possibili sono:

  • IfNotPresent: non estrarre una nuova immagine se esiste già.
  • Always: esegue sempre il pull dell'immagine, indipendentemente dal fatto che esista già.

Per saperne di più, vedi Aggiornamento delle immagini.

logger.image.tag Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1.16.10

Grafico: apigee-telemetry

L'etichetta della versione per l'immagine Docker di questo servizio.

logger.image.url Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-telemetry

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository corrente per questo componente.

logger.livenessProbe.failureThreshold Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 3

Grafico: apigee-telemetry

Il numero di volte in cui Kubernetes verificherà che i probe di attività non siano riusciti prima di riavviare il container. Il valore minimo è 1.

logger.livenessProbe.initialDelaySeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 0

Grafico: apigee-telemetry

Il numero di secondi dopo l'avvio di un container prima dell'avvio di un probe di attività.

logger.livenessProbe.periodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 60

Grafico: apigee-telemetry

Determina la frequenza di esecuzione di un probe di attività, in secondi. Il valore minimo è 1.

logger.livenessProbe.successThreshold Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1

Grafico: apigee-telemetry

Il numero minimo di successi consecutivi necessari affinché un probe di attività venga considerato riuscito dopo un errore. Il valore minimo è 1.

logger.livenessProbe.timeoutSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1

Grafico: apigee-telemetry

Il numero di secondi dopo i quali un probe di attività va in timeout. Il valore minimo è 1.

logger.nodeSelector.key Base Introdotto nella versione: 1.0.0

Valore predefinito: apigee.cloud.google.com/apigee-logger-enabled

Grafico: apigee-telemetry

Obbligatorio

Chiave dell'etichetta del selettore di nodi utilizzata per scegliere come target i nodi Kubernetes dedicati per i servizi di runtime logger.

Consulta la sezione Configurazione di pool di nodi dedicati.

logger.nodeSelector.value Base Introdotto nella versione: 1.0.0

Valore predefinito: true

Grafico: apigee-telemetry

Obbligatorio

Valore dell'etichetta del selettore di nodi utilizzato per scegliere come target i nodi Kubernetes dedicati per i servizi di runtime logger.

Consulta la sezione Configurazione di pool di nodi dedicati.

logger.resources.limits.cpu Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 200m

Grafico: apigee-telemetry

Il limite della CPU per la risorsa in un container Kubernetes, in millicore.

logger.resources.limits.memory Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 500Mi

Grafico: apigee-telemetry

Il limite di memoria per la risorsa in un container Kubernetes, in mebibyte.

logger.resources.requests.cpu Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 100m

Grafico: apigee-telemetry

La CPU necessaria per il normale funzionamento della risorsa in un contenitore Kubernetes, in millicore.

logger.resources.requests.memory Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 250Mi

Grafico: apigee-telemetry

La memoria necessaria per il normale funzionamento della risorsa in un container Kubernetes, in mebibyte.

logger.serviceAccountPath Base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-telemetry

È obbligatorio specificare un valore per serviceAccountPath o serviceAccountRef.

Percorso del file della chiave del service account Google con il ruolo Scrittore log.

logger.serviceAccountRef Base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-telemetry

È obbligatorio specificare un valore per serviceAccountPath o serviceAccountRef.

Un riferimento al secret Kubernetes a un file della chiave del service account Google. Consulta Memorizzazione delle chiavi dei account di servizio nei secret Kubernetes.

logger.storageMaxChunks Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 128

Grafico: apigee-telemetry

Il numero massimo di blocchi che possono essere caricati in memoria. I chunk che superano il limite verranno salvati nel file system.

logger.terminationGracePeriodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 30

Grafico: apigee-telemetry

Il tempo massimo tra una richiesta di eliminazione del pod e il momento in cui il pod viene terminato, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop e tutti i processi in esecuzione verranno terminati in modo controllato. Il pod verrà terminato quando tutti i processi in esecuzione saranno terminati o al termine del periodo di tolleranza, a seconda dell'evento che si verifica per primo. Se non sono in esecuzione processi, il pod verrà terminato immediatamente.

logger.tolerations.effect Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-telemetry

Obbligatorio per utilizzare la funzionalità Taints and Tolerations di Kubernetes.

effect specifica l'effetto della corrispondenza di una tolleranza con un taint. I valori per effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per i dettagli, consulta Taints e tolleranze: concetti.

logger.tolerations.key Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-telemetry

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

key identifica i pod a cui può essere applicata la tolleranza.

Per i dettagli, consulta Tolleranze e taint: concetti.

logger.tolerations.operator Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: "Equal"

Grafico: apigee-telemetry

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

operator specifica l'operazione utilizzata per attivare effect. I valori per operator possono essere:

  • Equal corrisponde al valore impostato in value.
  • Exists ignora il valore impostato in value.

Per i dettagli, consulta Tolleranze e taint: concetti.

logger.tolerations.tolerationSeconds Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-telemetry

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

tolerationSeconds definisce in secondi per quanto tempo un pod rimane associato a un nodo non riuscito o che non risponde.

Per i dettagli, consulta Tolleranze e taint: concetti.

logger.tolerations.value Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-telemetry

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

value è il valore che attiva effect quando operator è impostato su Equal.

Per i dettagli, consulta Tolleranze e taint: concetti.

mart

Definisce il servizio MART (Management API for RunTime data), che funge da fornitore di API per le API Apigee pubbliche, in modo da poter accedere e gestire entità di dati di runtime come KMS (chiavi API e token OAuth), KVM, quota e prodotti API.

La tabella seguente descrive le proprietà dell'oggetto mart:

Proprietà Tipo Descrizione
mart.securityContext.seccompProfile.type Avanzato

Introdotto nella versione: 1.16.0

Valore predefinito: nessuno

Grafico: apigee-org

Specifica il tipo di profilo Seccomp da applicare al contesto di sicurezza del pod. I valori consentiti sono RuntimeDefault (per utilizzare il profilo predefinito del runtime del container) o Unconfined (per non applicare restrizioni Seccomp). Se non specificato, Apigee non applica alcun profilo.

Consulta Configurare i profili Seccomp per la sicurezza dei pod.

mart.annotations Avanzato Introdotto nella versione: 1.5.0

Valore predefinito: nessuno

Grafico: apigee-org

Mappa chiave/valore facoltativa utilizzata per annotare i pod. Per ulteriori informazioni, consulta Annotazioni personalizzate.

mart.gsa Avanzato Introdotto nella versione: 1.10.0

Valore predefinito: nessuno

Grafico: apigee-org

Solo Helm: l'indirizzo email del account di servizio Google IAM apigee-mart da associare al account di servizio Kubernetes corrispondente quando si abilita Workload Identity sui cluster GKE utilizzando i grafici Helm. Imposta questo valore quando hai impostato gcp.workloadIdentity.enabled su true.

Gli indirizzi email GSA hanno in genere il formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

apigee-mart@my-hybrid-project.iam.gserviceaccount.com

Consulta Abilitare Workload Identity su GKE o Abilitare la federazione delle identità per i workload su AKS ed EKS.

mart.hostAlias Base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-org

L'alias host che punta all'oggetto MART. Puoi impostare questa proprietà su * o un nome di dominio completo.

mart.image.pullPolicy Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: IfNotPresent

Grafico: apigee-org, apigee-env

Determina quando kubelet esegue il pull dell'immagine Docker del pod. I valori possibili sono:

  • IfNotPresent: non estrarre una nuova immagine se esiste già.
  • Always: estrae sempre l'immagine, indipendentemente dal fatto che esista già.

Per saperne di più, vedi Aggiornamento delle immagini.

mart.image.tag Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1.16.10

Grafico: apigee-org, apigee-env

L'etichetta della versione per l'immagine Docker di questo servizio.

mart.image.url Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-org, apigee-env

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository corrente per questo componente.

mart.initCheckCF.resources.requests.cpu Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 10m

Grafico: apigee-org

La quantità di risorse della CPU allocate al controllo di inizializzazione del processo Cloud Foundry.

mart.livenessProbe.failureThreshold Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 12

Grafico: apigee-org

Il numero di volte in cui Kubernetes verificherà che i probe di attività non siano riusciti prima di riavviare il container. Il valore minimo è 1.

mart.livenessProbe.initialDelaySeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 15

Grafico: apigee-org

Il numero di secondi dopo l'avvio di un container prima dell'avvio di un probe di attività.

mart.livenessProbe.periodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 5

Grafico: apigee-org

Determina la frequenza di esecuzione di un probe di attività, in secondi. Il valore minimo è 1.

mart.livenessProbe.timeoutSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1

Grafico: apigee-org

Il numero di secondi dopo i quali un probe di attività va in timeout. Il valore minimo è 1.

mart.metricsURL Base Introdotto nella versione: 1.0.0

Valore predefinito: /v1/server/metrics

Grafico: apigee-org

mart.nodeSelector.key Base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-org

Chiave dell'etichetta del selettore di nodi facoltativa per il targeting dei nodi Kubernetes per i servizi di runtime mart. Se non specifichi una chiave per mart.nodeselector, il runtime utilizza il nodo specificato nell'oggetto nodeSelector.

Consulta la sezione Configurazione di pool di nodi dedicati.

mart.nodeSelector.value Base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-org

Valore dell'etichetta del selettore di nodi facoltativo per il targeting dei nodi Kubernetes per i servizi di runtime mart. Vedi anche l'oggetto nodeSelector.

Consulta la sezione Configurazione di pool di nodi dedicati.

mart.podDisruptionBudget.minAvailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-org

Il numero minimo di pod MART che devono rimanere disponibili durante un'interruzione volontaria, ad esempio durante un upgrade del pool di nodi o un'eliminazione dei nodi. Questo campo imposta il campo minAvailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%"). minAvailable e maxUnavailable si escludono a vicenda; imposta solo uno dei due. L'impostazione di entrambi contemporaneamente viene rifiutata dall'operatore Apigee. Se non imposti nessuno dei due campi, l'operatore Apigee genera comunque un PodDisruptionBudget per questi pod, utilizzando maxUnavailable: 1 per impostazione predefinita.

Ad esempio, in overrides.yaml:

mart:
  podDisruptionBudget:
    minAvailable: "50%"
mart.podDisruptionBudget.maxUnavailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-org

Il numero massimo di pod MART che possono essere non disponibili durante un'interruzione volontaria, ad esempio durante un upgrade pool di nodi o un'eliminazione dei nodi. Questo campo imposta il campo maxUnavailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%"). maxUnavailable e minAvailable si escludono a vicenda; imposta solo uno dei due. L'impostazione di entrambi contemporaneamente viene rifiutata dall'operatore Apigee. Se non imposti nessuno dei due campi, l'operatore Apigee genera comunque un PodDisruptionBudget per questi pod, utilizzando maxUnavailable: 1 per impostazione predefinita.

Ad esempio, in overrides.yaml:

mart:
  podDisruptionBudget:
    maxUnavailable: 1
mart.readinessProbe.failureThreshold Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 2

Grafico: apigee-org

Il numero di volte in cui Kubernetes verificherà che i probe di idoneità non sono riusciti prima di contrassegnare il pod come non pronto. Il valore minimo è 1.

mart.readinessProbe.initialDelaySeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 15

Grafico: apigee-org

Il numero di secondi dopo l'avvio di un container prima dell'avvio di un probe di idoneità.

mart.readinessProbe.periodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 5

Grafico: apigee-org

Determina la frequenza di esecuzione di un probe di prontezza, in secondi. Il valore minimo è 1.

mart.readinessProbe.successThreshold Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1

Grafico: apigee-org

Il numero minimo di successi consecutivi necessari affinché un probe di idoneità venga considerato riuscito dopo un errore. Il valore minimo è 1.

mart.readinessProbe.timeoutSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1

Grafico: apigee-org

Il numero di secondi dopo i quali un probe di attività va in timeout. Il valore minimo è 1.

mart.replicaCountMax Base Introdotto nella versione: 1.0.0

Valore predefinito: 5

Grafico: apigee-org

Numero massimo di repliche disponibili per la scalabilità automatica.

mart.replicaCountMin Base Introdotto nella versione: 1.0.0

Valore predefinito: 1

Grafico: apigee-org

Numero minimo di repliche disponibili per la scalabilità automatica.

mart.resources.limits.cpu Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 2000m

Grafico: apigee-org

Il limite della CPU per la risorsa in un container Kubernetes, in millicore.

mart.resources.limits.memory Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 5Gi

Grafico: apigee-org

Il limite di memoria per la risorsa in un container Kubernetes, in mebibyte.

mart.resources.requests.cpu Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 500m

Grafico: apigee-org

La CPU necessaria per il normale funzionamento della risorsa in un contenitore Kubernetes, in millicore.

mart.resources.requests.memory Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 512Mi

Grafico: apigee-org

La memoria necessaria per il normale funzionamento della risorsa in un container Kubernetes, in mebibyte.

mart.serviceAccountPath Base Introdotto nella versione: 1.1.1

Valore predefinito: nessuno

Grafico: apigee-org

È obbligatorio specificare serviceAccountPath o serviceAccountRef.

Percorso del file della chiave del service account Google senza ruolo.

mart.serviceAccountRef Base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-org

È obbligatorio specificare serviceAccountPath o serviceAccountRef.

Un riferimento al secret Kubernetes a un file della chiave del service account Google. Consulta Memorizzazione delle chiavi dei account di servizio nei secret Kubernetes.

mart.sslCertPath Base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-org

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

Percorso del file system locale per caricare e codificare il certificato SSL in un secret.

mart.sslKeyPath Base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-org

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

Percorso del file system locale per caricare e codificare la chiave SSL in un secret.

mart.sslSecret Base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-org

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

Il nome di un file archiviato in un secret Kubernetes che contiene il certificato TLS e la chiave privata. Devi creare il secret utilizzando i dati della chiave e del certificato TLS come input.

Vedi anche:

mart.targetCPUUtilizationPercentage Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 75

Grafico: apigee-org

Utilizzo CPU target per il processo MART sul pod. Il valore di questo campo consente a MART di scalare automaticamente quando l'utilizzo della CPU raggiunge questo valore, fino a replicaCountMax.

mart.terminationGracePeriodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 30

Grafico: apigee-org

Il tempo massimo tra una richiesta di eliminazione del pod e il momento in cui il pod viene terminato, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop e tutti i processi in esecuzione verranno terminati in modo controllato. Il pod verrà terminato quando tutti i processi in esecuzione saranno terminati o al termine del periodo di tolleranza, a seconda dell'evento che si verifica per primo. Se non sono in esecuzione processi, il pod verrà terminato immediatamente.

mart.tolerations.effect Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-org

Obbligatorio per utilizzare la funzionalità Taints and Tolerations di Kubernetes.

effect specifica l'effetto della corrispondenza di una tolleranza con un taint. I valori per effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per i dettagli, consulta Taints e tolleranze: concetti.

mart.tolerations.key Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-org

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

key identifica i pod a cui può essere applicata la tolleranza.

Per i dettagli, consulta Tolleranze e taint: concetti.

mart.tolerations.operator Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: "Equal"

Grafico: apigee-org

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

operator specifica l'operazione utilizzata per attivare effect. I valori per operator possono essere:

  • Equal corrisponde al valore impostato in value.
  • Exists ignora il valore impostato in value.

Per i dettagli, consulta Tolleranze e taint: concetti.

mart.tolerations.tolerationSeconds Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-org

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

tolerationSeconds definisce in secondi per quanto tempo un pod rimane associato a un nodo non riuscito o che non risponde.

Per i dettagli, consulta Tolleranze e taint: concetti.

mart.tolerations.value Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-org

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

value è il valore che attiva effect quando operator è impostato su Equal.

Per i dettagli, consulta Tolleranze e taint: concetti.

metrics

Definisce il servizio che raccoglie le metriche delle operazioni. Puoi utilizzare i dati delle metriche per monitorare lo stato dei servizi ibridi, configurare avvisi e così via.

Per saperne di più, consulta la panoramica della raccolta delle metriche.

La tabella seguente descrive le proprietà dell'oggetto metrics:

Proprietà Tipo Descrizione
metrics.securityContext.seccompProfile.type Avanzato

Introdotto nella versione: 1.16.0

Valore predefinito: nessuno

Grafico: apigee-telemetry

Specifica il tipo di profilo Seccomp da applicare al contesto di sicurezza del pod. I valori consentiti sono RuntimeDefault (per utilizzare il profilo predefinito del runtime del container) o Unconfined (per non applicare restrizioni Seccomp). Se non specificato, Apigee non applica alcun profilo.

Consulta Configurare i profili Seccomp per la sicurezza dei pod.

metrics.adapter.image.pullPolicy Avanzato Introdotto nella versione: 1.8.1

Valore predefinito: IfNotPresent

Grafico: apigee-telemetry

Determina quando kubelet esegue il pull dell'immagine Docker del pod. I valori possibili sono:

  • IfNotPresent: non estrarre una nuova immagine se esiste già.
  • Always: esegue sempre il pull dell'immagine, indipendentemente dal fatto che esista già.

Per saperne di più, vedi Aggiornamento delle immagini.

metrics.adapter.image.tag Avanzato Introdotto nella versione: 1.8.1

Valore predefinito: 1.16.10

Grafico: apigee-telemetry

L'etichetta della versione per l'immagine Docker di questo servizio.

metrics.adapter.image.url Avanzato Introdotto nella versione: 1.8.1

Valore predefinito: nessuno

Grafico: apigee-telemetry

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository corrente per questo componente.

metrics.adapter.podDisruptionBudget.minAvailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-telemetry

Il numero minimo di pod dell'adattatore delle metriche che devono rimanere disponibili durante un'interruzione volontaria, ad esempio durante un upgrade pool di nodi o un nodo di svuotamento. Questo campo imposta il campo minAvailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%"). minAvailable e maxUnavailable si escludono a vicenda; imposta solo uno dei due. L'impostazione di entrambi contemporaneamente viene rifiutata dall'operatore Apigee. Se non imposti nessuno dei due campi, l'operatore Apigee genera comunque un PodDisruptionBudget per questi pod, utilizzando maxUnavailable: 1 per impostazione predefinita.

Ad esempio, in overrides.yaml:

metrics:
  adapter:
    podDisruptionBudget:
      minAvailable: "50%"
metrics.adapter.podDisruptionBudget.maxUnavailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-telemetry

Il numero massimo di pod dell'adattatore delle metriche che possono non essere disponibili durante un'interruzione volontaria, ad esempio durante un upgrade pool di nodi o un'evacuazione dei nodi. Questo campo imposta il campo maxUnavailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%"). maxUnavailable e minAvailable si escludono a vicenda; imposta solo uno dei due. L'impostazione di entrambi contemporaneamente viene rifiutata dall'operatore Apigee. Se non imposti nessuno dei due campi, l'operatore Apigee genera comunque un PodDisruptionBudget per questi pod, utilizzando maxUnavailable: 1 per impostazione predefinita.

Ad esempio, in overrides.yaml:

metrics:
  adapter:
    podDisruptionBudget:
      maxUnavailable: 1
metrics.adapter.resources.limits.cpu Avanzato Introdotto nella versione: 1.14.1

Valore predefinito: 500m

Grafico: apigee-telemetry

Il limite della CPU per la risorsa dell'adattatore in un container Kubernetes, in millicore.

metrics.adapter.resources.limits.memory Avanzato Introdotto nella versione: 1.14.1

Valore predefinito: 4Gi

Grafico: apigee-telemetry

Il limite di memoria per la risorsa dell'adattatore in un container Kubernetes, in gibibyte.

metrics.adapter.resources.requests.cpu Avanzato Introdotto nella versione: 1.14.1

Valore predefinito: 100m

Grafico: apigee-telemetry

La CPU necessaria per il normale funzionamento dell'adattatore in un container Kubernetes, in millicore.

metrics.adapter.resources.requests.memory Avanzato Introdotto nella versione: 1.14.1

Valore predefinito: 128Mi

Grafico: apigee-telemetry

La memoria necessaria per il normale funzionamento dell'adattatore in un container Kubernetes, in mebibyte.

metrics.aggregator.resources.requests.cpu Avanzato Introdotto nella versione: 1.4.0

Valore predefinito: 500m

Grafico: apigee-telemetry

La CPU necessaria per il normale funzionamento dell'aggregatore in un container Kubernetes, in millicore.

metrics.aggregator.resources.requests.memory Avanzato Introdotto nella versione: 1.4.0

Valore predefinito: 512Mi

Grafico: apigee-telemetry

La memoria necessaria per il normale funzionamento dell'aggregatore in un container Kubernetes, in mebibyte.

metrics.aggregator.resources.limits.cpu Avanzato Introdotto nella versione: 1.4.0

Valore predefinito: 500m

Grafico: apigee-telemetry

Il limite della CPU per la risorsa dell'aggregatore in un container Kubernetes, in millicore.

metrics.aggregator.resources.limits.memory Avanzato Introdotto nella versione: 1.4.0

Valore predefinito: 3Gi

Grafico: apigee-telemetry

Il limite di memoria per la risorsa dell'aggregatore in un container Kubernetes, in gibibyte.

metrics.annotations Avanzato Introdotto nella versione: 1.5.0

Valore predefinito: nessuno

Grafico: apigee-telemetry

Mappa chiave/valore facoltativa utilizzata per annotare i pod. Per ulteriori informazioni, consulta Annotazioni personalizzate.

metrics.app.resources.requests.cpu Avanzato Introdotto nella versione: 1.4.0

Valore predefinito: 500m

Grafico: apigee-telemetry

La CPU necessaria per il normale funzionamento dell'app in un container Kubernetes, in millicore.

metrics.app.resources.requests.memory Avanzato Introdotto nella versione: 1.4.0

Valore predefinito: 512Mi

Grafico: apigee-telemetry

La memoria necessaria per il normale funzionamento dell'app in un container Kubernetes, in mebibyte.

metrics.app.resources.limits.cpu Avanzato Introdotto nella versione: 1.4.0

Valore predefinito: 500m

Grafico: apigee-telemetry

Il limite di CPU per la risorsa app in un container Kubernetes, in millicore.

metrics.app.resources.limits.memory Avanzato Introdotto nella versione: 1.4.0

Valore predefinito: 1Gi

Grafico: apigee-telemetry

Il limite di memoria per la risorsa app in un container Kubernetes, in gibibyte.

metrics.appStackdriverExporter.podDisruptionBudget.minAvailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-telemetry

Il numero minimo di pod appStackdriverExporter che deve rimanere disponibile durante un'interruzione volontaria, ad esempio durante un upgrade del node pool o uno svuotamento dei nodi. Questo campo imposta il campo minAvailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%").

minAvailable e maxUnavailable si escludono a vicenda; imposta solo uno dei due. L'operatore Apigee rifiuta l'impostazione di entrambi contemporaneamente. Se non imposti nessuno dei due campi, l'operatore Apigee genera comunque un PodDisruptionBudget per questi pod, utilizzando maxUnavailable: 1 per impostazione predefinita.

Ad esempio, in overrides.yaml:

metrics:
  appStackdriverExporter:
    podDisruptionBudget:
      minAvailable: "50%"
metrics.appStackdriverExporter.podDisruptionBudget.maxUnavailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-telemetry

Il numero massimo di pod appStackdriverExporter che possono non essere disponibili durante un'interruzione volontaria, ad esempio durante un upgrade del pool di nodi o uno svuotamento dei nodi. Questo campo imposta il campo maxUnavailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%").

maxUnavailable e minAvailable si escludono a vicenda; imposta solo uno dei due. L'operatore Apigee rifiuta l'impostazione di entrambi contemporaneamente. Se non imposti nessuno dei due campi, l'operatore Apigee genera comunque un PodDisruptionBudget per questi pod, utilizzando maxUnavailable: 1 per impostazione predefinita.

Ad esempio, in overrides.yaml:

metrics:
  appStackdriverExporter:
    podDisruptionBudget:
      maxUnavailable: 1
metrics.appStackdriverExporter.resources.limits.cpu Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 500m

Grafico: apigee-telemetry

Il limite della CPU per la risorsa stackdriverExporter in un container Kubernetes, in millicore.

metrics.appStackdriverExporter.resources.limits.memory Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 1Gi

Grafico: apigee-telemetry

Il limite di memoria per la risorsa stackdriverExporter in un container Kubernetes, in gibibyte.

metrics.appStackdriverExporter.resources.requests.cpu Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 128m

Grafico: apigee-telemetry

La CPU necessaria per il normale funzionamento di stackdriverExporter in un container Kubernetes, in millicore.

metrics.appStackdriverExporter.resources.requests.memory Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 512Mi

Grafico: apigee-telemetry

La memoria necessaria per il normale funzionamento di stackdriverExporter in un container Kubernetes, in mebibyte.

metrics.collector.envVars Base Introdotto nella versione: 1.13

Valore predefinito: nessuno

Grafico: apigee-telemetry

Consente di passare e sostituire le variabili di ambiente in OpenTelemetry. Ad esempio, puoi definire HTTP_PROXY, HTTPS_PROXY o NO_PROXY in modo che le relative richieste passino attraverso il server proxy.

La variabile HTTP_PROXY può essere definita come una stringa contenente il nome host, nel formato:

metrics:
...
  envVars:
    HTTP_PROXY: '<host-name>'

ad esempio:

  envVars:
    HTTP_PROXY: 'http://1.1.1.1:80'

La variabile HTTPS_PROXY può essere definita come una stringa contenente il nome host, nel formato:

metrics:
...
  envVars:
    HTTPS_PROXY: '<host-name>'

ad esempio:

  envVars:
    HTTPS_PROXY: 'https://1.1.1.1:80'

La variabile NO_PROXY deve essere definita come una stringa di nomi host separati da virgole, nel formato:

metrics:
...
envVars:
  NO_PROXY: '<comma-separated-values>'

ad esempio:

envVars:
  NO_PROXY: 'https://1.1.1.1:80, https://1.1.1.1:81'

Utilizza envVars: HTTP_PROXY, envVars: HTTPS_PROXY o envVars: NO_PROXY facoltativamente quando hai abilitato il proxy di inoltro HTTP.

Consulta Supporto proxy nella documentazione di OpenTelemetry.

metrics.collector.imagePullPolicy Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: IfNotPresent

Grafico: apigee-telemetry

Determina quando kubelet esegue il pull dell'immagine Docker del pod. I valori possibili sono:

  • IfNotPresent: non estrarre una nuova immagine se esiste già.
  • Always: esegue sempre il pull dell'immagine, indipendentemente dal fatto che esista già.

Per saperne di più, consulta Utilizzare un repository di immagini privato con Apigee hybrid .

metrics.collector.image.tag Base Introdotto nella versione: 1.12.0

Valore predefinito: 1.16.10

Grafico: apigee-telemetry

L'etichetta della versione per l'immagine Docker di questo servizio.

metrics.collector.image.url Base Introdotto nella versione: 1.12.0

Valore predefinito: nessuno

Grafico: apigee-telemetry

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository corrente per questo componente.

metrics.collector.podDisruptionBudget.minAvailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-telemetry

Il numero minimo di pod del raccoglitore di metriche che devono rimanere disponibili durante un'interruzione volontaria, ad esempio durante un upgrade pool di nodi o un'eliminazione dei nodi. Questo campo imposta il campo minAvailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%"). minAvailable e maxUnavailable si escludono a vicenda; imposta solo uno dei due. L'impostazione di entrambi contemporaneamente viene rifiutata dall'operatore Apigee. Se non imposti nessuno dei due campi, l'operatore Apigee genera comunque un PodDisruptionBudget per questi pod. Poiché il raccoglitore viene eseguito come DaemonSet, il valore predefinito imposta minAvailable all'80% dei pod raccoglitore (arrotondato per difetto) anziché utilizzare maxUnavailable: 1.

Ad esempio, in overrides.yaml:

metrics:
  collector:
    podDisruptionBudget:
      minAvailable: "50%"
metrics.collector.podDisruptionBudget.maxUnavailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-telemetry

Il numero massimo di pod di raccolta delle metriche che possono essere non disponibili durante un'interruzione volontaria, ad esempio durante un upgrade del pool di nodi o un'eliminazione dei nodi. Questo campo imposta il campo maxUnavailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%"). maxUnavailable e minAvailable si escludono a vicenda; imposta solo uno dei due. L'impostazione di entrambi contemporaneamente viene rifiutata dall'operatore Apigee. Se non imposti nessuno dei due campi, l'operatore Apigee genera comunque un PodDisruptionBudget per questi pod. Poiché il raccoglitore viene eseguito come DaemonSet, il valore predefinito imposta minAvailable all'80% dei pod raccoglitore (arrotondato per difetto) anziché utilizzare maxUnavailable: 1.

Ad esempio, in overrides.yaml:

metrics:
  collector:
    podDisruptionBudget:
      maxUnavailable: 1
metrics.collector.resources.requests.cpu Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 500m

Grafico: apigee-telemetry

La CPU necessaria per il normale funzionamento dell'app in un container Kubernetes, in millicore.

metrics.collector.resources.requests.memory Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 512Mi

Grafico: apigee-telemetry

La memoria necessaria per il normale funzionamento dell'app in un container Kubernetes, in mebibyte.

metrics.collector.resources.limits.cpu Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 500m

Grafico: apigee-telemetry

Il limite di CPU per la risorsa app in un container Kubernetes, in millicore.

metrics.collector.resources.limits.memory Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 1Gi

Grafico: apigee-telemetry

Il limite di memoria per la risorsa app in un container Kubernetes, in gibibyte.

metrics.collector.livenessProbe.failureThreshold Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 5

Grafico: apigee-telemetry

Il numero di volte in cui Kubernetes verificherà che i probe di attività non sono riusciti prima di riavviare il container. Il valore minimo è 1.

metrics.collector.livenessProbe.initialDelaySeconds Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 30

Grafico: apigee-telemetry

Il numero di secondi dopo l'avvio di un container prima dell'avvio di un probe di attività.

metrics.collector.livenessProbe.periodSeconds Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 10

Grafico: apigee-telemetry

Determina la frequenza di esecuzione di un probe di attività, in secondi. Il valore minimo è 1.

metrics.collector.livenessProbe.successThreshold Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 1

Grafico: apigee-telemetry

Il numero minimo di successi consecutivi necessari affinché un probe di attività venga considerato riuscito dopo un errore. Il valore minimo è 1.

metrics.collector.livenessProbe.timeoutSeconds Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 5

Grafico: apigee-telemetry

Il numero di secondi dopo i quali un probe di attività va in timeout. Il valore minimo è 1.

metrics.collector.readinessProbe.failureThreshold Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 3

Grafico: apigee-telemetry

Il numero di volte in cui Kubernetes verificherà che i probe di idoneità non sono riusciti prima di contrassegnare il pod come non pronto. Il valore minimo è 1.

metrics.collector.readinessProbe.initialDelaySeconds Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 30

Grafico: apigee-telemetry

Il numero di secondi dopo l'avvio di un container prima dell'avvio di un probe di idoneità.

metrics.collector.readinessProbe.periodSeconds Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 10

Grafico: apigee-telemetry

Determina la frequenza di esecuzione di un probe di prontezza, in secondi. Il valore minimo è 1.

metrics.collector.readinessProbe.successThreshold Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 1

Grafico: apigee-telemetry

Il numero minimo di successi consecutivi necessari affinché un probe di idoneità venga considerato riuscito dopo un errore. Il valore minimo è 1.

metrics.collector.readinessProbe.timeoutSeconds Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 5

Grafico: apigee-telemetry

Il numero di secondi dopo i quali un probe di attività va in timeout. Il valore minimo è 1.

metrics.disablePrometheusPipeline Base Introdotto nella versione: 1.12.0

Valore predefinito: true

Grafico: apigee-telemetry

Le metriche per le risorse monitorate ProxyV2 e TargetV2 non vengono emesse quando sono impostate su true. Utilizza invece le metriche per le risorse monitorate Proxy e Target.

metrics.enabled Base Introdotto nella versione: 1.0.0

Valore predefinito: true

Grafico: apigee-telemetry

Abilita le metriche Apigee. Imposta su true per abilitare le metriche. Imposta su false per disattivare le metriche.

metrics.gsa Avanzato Introdotto nella versione: 1.10.0

Valore predefinito: nessuno

Grafico: apigee-telemetry

Solo Helm: l'indirizzo email del account di servizio Google IAM apigee-metrics da associare al account di servizio Kubernetes corrispondente quando si abilita Workload Identity sui cluster GKE utilizzando i grafici Helm. Imposta questo valore quando hai impostato gcp.workloadIdentity.enabled su true.

Gli indirizzi email GSA hanno in genere il formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

apigee-metrics@my-hybrid-project.iam.gserviceaccount.com

Consulta Abilitare Workload Identity su GKE o Abilitare la federazione delle identità per i workload su AKS ed EKS.

metrics.nodeSelector.key Base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-telemetry

Obbligatorio

Chiave dell'etichetta del selettore di nodi utilizzata per scegliere come target i nodi Kubernetes dedicati per i servizi di runtime metrics.

Consulta la sezione Configurazione di pool di nodi dedicati.

metrics.nodeSelector.value Base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-telemetry

Obbligatorio

Valore dell'etichetta del selettore di nodi utilizzato per scegliere come target i nodi Kubernetes dedicati per i servizi di runtime metrics.

Consulta la sezione Configurazione di pool di nodi dedicati.

metrics.prometheus.containerPort Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 9090

Grafico: apigee-telemetry

La porta per connettersi al servizio di metriche Prometheus.

metrics.prometheus.image.pullPolicy Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: IfNotPresent

Grafico: apigee-telemetry

Determina quando kubelet esegue il pull dell'immagine Docker del pod. I valori possibili sono:

  • IfNotPresent: non estrarre una nuova immagine se esiste già.
  • Always: esegue sempre il pull dell'immagine, indipendentemente dal fatto che esista già.

Per saperne di più, vedi Aggiornamento delle immagini.

metrics.prometheus.image.tag Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1.16.10

Grafico: apigee-telemetry

L'etichetta della versione per l'immagine Docker di questo servizio.

metrics.prometheus.image.url Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-telemetry

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository corrente per questo componente.

metrics.prometheus.livenessProbe.failureThreshold Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 6

Grafico: apigee-telemetry

Il numero di volte in cui Kubernetes verificherà che i probe di attività non siano riusciti prima di riavviare il container. Il valore minimo è 1.

metrics.prometheus.livenessProbe.periodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 5

Grafico: apigee-telemetry

Determina la frequenza di esecuzione di un probe di attività, in secondi. Il valore minimo è 1.

metrics.prometheus.livenessProbe.timeoutSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 3

Grafico: apigee-telemetry

Il numero di secondi dopo i quali un probe di attività va in timeout. Il valore minimo è 1.

metrics.prometheus.readinessProbe.failureThreshold Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 120

Grafico: apigee-telemetry

Il numero di volte in cui Kubernetes verificherà che i probe di idoneità non sono riusciti prima di contrassegnare il pod come non pronto. Il valore minimo è 1.

metrics.prometheus.readinessProbe.periodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 5

Grafico: apigee-telemetry

Determina la frequenza di esecuzione di un probe di prontezza, in secondi. Il valore minimo è 1.

metrics.prometheus.readinessProbe.timeoutSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 3

Grafico: apigee-telemetry

Il numero di secondi dopo i quali un probe di attività va in timeout. Il valore minimo è 1.

metrics.prometheus.resources.limits.cpu Avanzato Introdotto nella versione: 1.14.1

Valore predefinito: 500m

Grafico: apigee-telemetry

Il limite della CPU per la risorsa Prometheus in un container Kubernetes, in millicore.

metrics.prometheus.resources.limits.memory Avanzato Introdotto nella versione: 1.14.1

Valore predefinito: 4Gi

Grafico: apigee-telemetry

Il limite di memoria per la risorsa Prometheus in un container Kubernetes, in gibibyte.

metrics.prometheus.resources.requests.cpu Avanzato Introdotto nella versione: 1.14.1

Valore predefinito: 128m

Grafico: apigee-telemetry

La CPU necessaria per il normale funzionamento di Prometheus in un container Kubernetes, in millicore.

metrics.prometheus.resources.requests.memory Avanzato Introdotto nella versione: 1.14.1

Valore predefinito: 512Mi

Grafico: apigee-telemetry

La memoria necessaria per il normale funzionamento di Prometheus in un container Kubernetes, in mebibyte.

metrics.prometheus.sslCertPath Base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-telemetry

Obbligatorio

Percorso del certificato SSL per il processo di raccolta delle metriche Prometheus. Prometheus è uno strumento che Apigee può utilizzare per raccogliere ed elaborare le metriche.

Vedi:

metrics.prometheus.sslKeyPath Base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-telemetry

Obbligatorio

Percorso della chiave SSL per il processo di raccolta delle metriche di Prometheus. Prometheus è uno strumento che Apigee può utilizzare per raccogliere ed elaborare le metriche.

Vedi:

metrics.proxy.resources.requests.cpu Avanzato Introdotto nella versione: 1.4.0

Valore predefinito: 500m

Grafico: apigee-telemetry

La CPU necessaria per il normale funzionamento del proxy in un container Kubernetes, in millicore.

metrics.proxy.resources.requests.memory Avanzato Introdotto nella versione: 1.4.0

Valore predefinito: 512Mi

Grafico: apigee-telemetry

La memoria necessaria per il normale funzionamento del proxy in un container Kubernetes, in mebibyte.

metrics.proxy.resources.limits.cpu Avanzato Introdotto nella versione: 1.4.0

Valore predefinito: 500m

Grafico: apigee-telemetry

Il limite della CPU per la risorsa proxy in un container Kubernetes, in millicore.

metrics.proxy.resources.limits.memory Avanzato Introdotto nella versione: 1.4.0

Valore predefinito: 1Gi

Grafico: apigee-telemetry

Il limite di memoria per la risorsa proxy in un container Kubernetes, in gibibyte.

metrics.proxyStackdriverExporter.podDisruptionBudget.minAvailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-telemetry

Il numero minimo di pod proxyStackdriverExporter che deve rimanere disponibile durante un'interruzione volontaria, ad esempio durante un upgrade del node pool o uno svuotamento dei nodi. Questo campo imposta il campo minAvailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%").

minAvailable e maxUnavailable si escludono a vicenda; imposta solo uno dei due. L'operatore Apigee rifiuta l'impostazione di entrambi contemporaneamente. Se non imposti nessuno dei due campi, l'operatore Apigee genera comunque un PodDisruptionBudget per questi pod, utilizzando maxUnavailable: 1 per impostazione predefinita.

Ad esempio, in overrides.yaml:

metrics:
  proxyStackdriverExporter:
    podDisruptionBudget:
      minAvailable: "50%"
metrics.proxyStackdriverExporter.podDisruptionBudget.maxUnavailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-telemetry

Il numero massimo di pod proxyStackdriverExporter che possono non essere disponibili durante un'interruzione volontaria, ad esempio durante un upgrade del pool di nodi o uno svuotamento dei nodi. Questo campo imposta il campo maxUnavailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%").

maxUnavailable e minAvailable si escludono a vicenda; imposta solo uno dei due. L'operatore Apigee rifiuta l'impostazione di entrambi contemporaneamente. Se non imposti nessuno dei due campi, l'operatore Apigee genera comunque un PodDisruptionBudget per questi pod, utilizzando maxUnavailable: 1 per impostazione predefinita.

Ad esempio, in overrides.yaml:

metrics:
  proxyStackdriverExporter:
    podDisruptionBudget:
      maxUnavailable: 1
metrics.proxyStackdriverExporter.resources.requests.cpu Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 128m

Grafico: apigee-telemetry

La CPU necessaria per il normale funzionamento di stackdriverExporter in un container Kubernetes, in millicore.

metrics.proxyStackdriverExporter.resources.requests.memory Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 512Mi

Grafico: apigee-telemetry

La memoria necessaria per il normale funzionamento di stackdriverExporter in un container Kubernetes, in mebibyte.

metrics.proxyStackdriverExporter.resources.limits.cpu Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 500m

Grafico: apigee-telemetry

Il limite della CPU per la risorsa stackdriverExporter in un container Kubernetes, in millicore.

metrics.proxyStackdriverExporter.resources.limits.memory Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 1Gi

Grafico: apigee-telemetry

Il limite di memoria per la risorsa stackdriverExporter in un container Kubernetes, in gibibyte.

metrics.proxyURL Base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-telemetry

URL del proxy sidecar del processo delle metriche nel cluster Kubernetes.

metrics.sdSidecar.containerPort Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 9091

Grafico: apigee-telemetry

La porta per la connessione al servizio di metriche Cloud Monitoring.

metrics.sdSidecar.image.pullPolicy Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: IfNotPresent

Grafico: apigee-telemetry

Determina quando Kubelet esegue il pull dell'immagine Docker di questo servizio. I valori possibili sono:

  • IfNotPresent: Non estrarre una nuova immagine se esiste già
  • Always: estrai sempre la policy, anche se esiste già

    Per saperne di più, vedi Aggiornamento delle immagini.

metrics.sdSidecar.image.tag Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1.16.10

Grafico: apigee-telemetry

L'etichetta della versione per l'immagine Docker di questo servizio.

metrics.sdSidecar.image.url Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-telemetry

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository corrente per questo componente.

metrics.serviceAccountPath Base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-telemetry

È obbligatorio specificare un valore per serviceAccountPath o serviceAccountRef.

Percorso del file della chiave del service account Google con il ruolo Writer metriche Monitoring.

metrics.serviceAccountRef Base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-telemetry

È obbligatorio specificare un valore per serviceAccountPath o serviceAccountRef.

Un riferimento al secret Kubernetes a un file della chiave del service account Google. Consulta Memorizzazione delle chiavi dei account di servizio nei secret Kubernetes.

metrics.stackdriverExporter.resources.requests.cpu Avanzato Introdotto nella versione: 1.4.0

Grafico: apigee-telemetry

Deprecated: a partire dalla versione 1.8 di Hybrid, metrics:stackdriverExporter è stato sostituito con metrics:appStackdriverExporter e metrics:proxyStackdriverExporter. Vedi:

metrics.stackdriverExporter.resources.requests.memory Avanzato Introdotto nella versione: 1.4.0

Grafico: apigee-telemetry

Deprecated: a partire dalla versione 1.8 di Hybrid, metrics:stackdriverExporter è stato sostituito con metrics:appStackdriverExporter e metrics:proxyStackdriverExporter. Vedi:

metrics.stackdriverExporter.resources.limits.cpu Avanzato Introdotto nella versione: 1.4.0

Grafico: apigee-telemetry

Deprecated: a partire dalla versione 1.8 di Hybrid, metrics:stackdriverExporter è stato sostituito con metrics:appStackdriverExporter e metrics:proxyStackdriverExporter. Vedi:

metrics.stackdriverExporter.resources.limits.memory Avanzato Introdotto nella versione: 1.4.0

Grafico: apigee-telemetry

Deprecated: a partire dalla versione 1.8 di Hybrid, metrics:stackdriverExporter è stato sostituito con metrics:appStackdriverExporter e metrics:proxyStackdriverExporter. Vedi:

metrics.terminationGracePeriodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 300

Grafico: apigee-telemetry

Il tempo massimo tra una richiesta di eliminazione del pod e il momento in cui il pod viene terminato, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop e tutti i processi in esecuzione verranno terminati in modo controllato. Il pod verrà terminato quando tutti i processi in esecuzione saranno terminati o al termine del periodo di tolleranza, a seconda dell'evento che si verifica per primo. Se non sono in esecuzione processi, il pod verrà terminato immediatamente.

metrics.tolerations.effect Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-telemetry

Obbligatorio per utilizzare la funzionalità Taints and Tolerations di Kubernetes.

effect specifica l'effetto della corrispondenza di una tolleranza con un taint. I valori per effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per i dettagli, consulta Taints e tolleranze: concetti.

metrics.tolerations.key Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-telemetry

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

key identifica i pod a cui può essere applicata la tolleranza.

Per i dettagli, consulta Tolleranze e taint: concetti.

metrics.tolerations.operator Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: "Equal"

Grafico: apigee-telemetry

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

operator specifica l'operazione utilizzata per attivare effect. I valori per operator possono essere:

  • Equal corrisponde al valore impostato in value.
  • Exists ignora il valore impostato in value.

Per i dettagli, consulta Tolleranze e taint: concetti.

metrics.tolerations.tolerationSeconds Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-telemetry

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

tolerationSeconds definisce in secondi per quanto tempo un pod rimane associato a un nodo non riuscito o che non risponde.

Per i dettagli, consulta Tolleranze e taint: concetti.

metrics.tolerations.value Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-telemetry

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

value è il valore che attiva effect quando operator è impostato su Equal.

Per i dettagli, consulta Tolleranze e taint: concetti.

mintTaskScheduler

mintTaskScheduler è il cron job per pianificare le attività di monetizzazione, come il calcolo periodico delle commissioni ricorrenti.

La tabella seguente descrive le proprietà dell'oggetto mintTaskScheduler:

Proprietà Tipo Descrizione
mintTaskScheduler.securityContext.seccompProfile.type Avanzato

Introdotto nella versione: 1.16.0

Valore predefinito: nessuno

Grafico: apigee-org

Specifica il tipo di profilo Seccomp da applicare al contesto di sicurezza del pod. I valori consentiti sono RuntimeDefault (per utilizzare il profilo predefinito del runtime del container) o Unconfined (per non applicare restrizioni Seccomp). Se non specificato, Apigee non applica alcun profilo.

Consulta Configurare i profili Seccomp per la sicurezza dei pod.

mintTaskScheduler.gsa Avanzato Introdotto nella versione: 1.15.1

Valore predefinito: nessuno

Grafico: apigee-org

L'indirizzo email del account di servizio Google IAM apigee-mint-task-scheduler da associare al account di servizio Kubernetes corrispondente quando si abilita Workload Identity sui cluster GKE utilizzando i grafici Helm. Imposta questo valore quando hai impostato gcp.workloadIdentity.enabled su true.

Gli indirizzi email GSA hanno in genere il formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

apigee-mint-task-scheduler@my-hybrid-project.iam.gserviceaccount.com

Consulta Abilitare Workload Identity su GKE o Abilitare la federazione delle identità per i workload su AKS ed EKS.

mintTaskScheduler.image.pullPolicy Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: IfNotPresent

Grafico: apigee-org

Determina quando kubelet esegue il pull dell'immagine Docker del pod. I valori possibili sono:

  • IfNotPresent: non estrarre una nuova immagine se esiste già.
  • Always: estrae sempre l'immagine, indipendentemente dal fatto che esista già.

Per saperne di più, vedi Aggiornamento delle immagini.

mintTaskScheduler.image.tag Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 1.16.10

Grafico: apigee-org

L'etichetta della versione per l'immagine Docker di questo servizio.

mintTaskScheduler.image.url Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: nessuno

Grafico: apigee-org

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository corrente per questo componente.

mintTaskScheduler.resources.limits.cpu Avanzato Introdotto nella versione: 1.1.0

Valore predefinito: 2000m

Grafico: apigee-org

Il limite della CPU per la risorsa in un container Kubernetes, in millicore.

mintTaskScheduler.resources.limits.memory Avanzato Introdotto nella versione: 1.1.0

Valore predefinito: 4Gi

Grafico: apigee-org

Il limite di memoria per la risorsa in un container Kubernetes, in mebibyte.

mintTaskScheduler.resources.requests.cpu Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 500m

Grafico: apigee-org

La CPU necessaria per il normale funzionamento della risorsa in un contenitore Kubernetes, in millicore.

mintTaskScheduler.resources.requests.memory Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 512Mi

Grafico: apigee-org

La memoria necessaria per il normale funzionamento della risorsa in un container Kubernetes, in mebibyte.

mintTaskScheduler.serviceAccountPath Base Introdotto nella versione: 1.15.1

Valore predefinito: nessuno

Grafico: apigee-org

È obbligatorio specificare un valore per serviceAccountPath o serviceAccountRef.

Percorso del file della chiave del service account Google.

mintTaskScheduler.serviceAccountRef Base Introdotto nella versione: 1.15.1

Valore predefinito: nessuno

Grafico: apigee-org

È obbligatorio specificare un valore per serviceAccountPath o serviceAccountRef.

Un riferimento al secret Kubernetes a un file della chiave del service account Google. Consulta Memorizzazione delle chiavi dei account di servizio nei secret Kubernetes.

mintTaskScheduler.tolerations.effect Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-org

Obbligatorio per utilizzare la funzionalità Taints and Tolerations di Kubernetes.

effect specifica l'effetto della corrispondenza di una tolleranza con un taint. I valori per effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per i dettagli, consulta Taints e tolleranze: concetti.

mintTaskScheduler.tolerations.key Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-org

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

key identifica i pod a cui può essere applicata la tolleranza.

Per i dettagli, consulta Tolleranze e taint: concetti.

mintTaskScheduler.tolerations.operator Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: "Equal"

Grafico: apigee-org

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

operator specifica l'operazione utilizzata per attivare effect. I valori per operator possono essere:

  • Equal corrisponde al valore impostato in value.
  • Exists ignora il valore impostato in value.

Per i dettagli, consulta Tolleranze e taint: concetti.

mintTaskScheduler.tolerations.tolerationSeconds Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-org

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

tolerationSeconds definisce in secondi per quanto tempo un pod rimane associato a un nodo non riuscito o che non risponde.

Per i dettagli, consulta Tolleranze e taint: concetti.

mintTaskScheduler.tolerations.value Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-org

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

value è il valore che attiva effect quando operator è impostato su Equal.

Per i dettagli, consulta Tolleranze e taint: concetti.

newDataPipeline

newDataPipeline determina se Apigee hybrid utilizza la pipeline di dati Pub/Sub per consentire ai componenti di runtime di scrivere i dati direttamente nel control plane.

La tabella seguente descrive le proprietà dell'oggetto newDataPipeline:

Proprietà Tipo Descrizione
newDataPipeline.debugSession Avanzato Introdotto nella versione: 1.13.1

Valore predefinito: true

Grafico: apigee-env

Determina se la pipeline di dati Pub/Sub è abilitata.

newDataPipeline.analytics Avanzato Introdotto nella versione: 1.13.1

Valore predefinito: true

Grafico: apigee-env

Determina se l'analisi utilizza la pipeline di dati Pub/Sub.

nodeSelector

L'oggetto nodeSelector definisce il nodo per l'istanza Apigee. Dietro le quinte, Apigee Hybrid si occupa di mappare la chiave/il valore dell'etichetta per apigeeRuntime e apigeeData ai singoli componenti Istio e MART quando installi o esegui l'upgrade dei grafici apigee-org e apigee-ingress-manager. Puoi eseguire l'override per singoli oggetti nella proprietà mart:nodeSelector.

La tabella seguente descrive le proprietà dell'oggetto nodeSelector:

Proprietà Tipo Descrizione
nodeSelector.apigeeData.key Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: cloud.google.com/gke-nodepool

Grafico: apigee-operator, apigee-datastore, apigee-telemetry, apigee-redis, apigee-ingress-manager, apigee-org, apigee-env, apigee-virtualhost

ApigeeData è il nodo per il database Cassandra. Chiave di etichetta del selettore dei nodi per il targeting dei nodi Kubernetes per l'utilizzo dei dati dei servizi Apigee.

Consulta Configurare i pool di nodi dedicati.

nodeSelector.apigeeData.value Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: apigee-data

Grafico: apigee-operator, apigee-datastore, apigee-telemetry, apigee-redis, apigee-ingress-manager, apigee-org, apigee-env, apigee-virtualhost

apigee-data è il nodo per il database Cassandra. Valore dell'etichetta del selettore di nodi per il targeting dei nodi Kubernetes per l'utilizzo dei dati dei servizi Apigee.

Consulta Configurare i pool di nodi dedicati.

nodeSelector.apigeeRuntime.key Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: cloud.google.com/gke-nodepool

Grafico: apigee-operator, apigee-datastore, apigee-telemetry, apigee-redis, apigee-ingress-manager, apigee-org, apigee-env, apigee-virtualhost

Apigee Runtime è il nodo per l'ambiente di runtime del progetto. Chiave dell'etichetta del selettore di nodi per il targeting dei nodi Kubernetes per i servizi di runtime Apigee.

Consulta Configurare i pool di nodi dedicati.

nodeSelector.apigeeRuntime.value Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: apigee-runtime

Grafico: apigee-operator, apigee-datastore, apigee-telemetry, apigee-redis, apigee-ingress-manager, apigee-org, apigee-env, apigee-virtualhost

apigee-runtime è il nodo per l'ambiente di runtime del progetto. Valore dell'etichetta del selettore di nodi per il targeting dei nodi Kubernetes per i servizi di runtime Apigee.

Consulta Configurare i pool di nodi dedicati.

nodeSelector.requiredForScheduling Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: true

Grafico: apigee-operator, apigee-datastore, apigee-telemetry, apigee-redis, apigee-ingress-manager, apigee-org, apigee-env, apigee-virtualhost

Il valore predefinito della proprietà requiredForScheduling è true. Quando true, significa che se Kubernetes non riesce a trovare nodi con la coppia chiave/valore dell'etichetta configurata, i pod sottostanti non verranno pianificati sui nodi di lavoro VM.

Per la produzione, nodeSelector.requiredForScheduling deve essere impostato su true.

Consulta Configurare i pool di nodi dedicati.

redis

La tabella seguente descrive le proprietà dell'oggetto redis:

Proprietà Tipo Descrizione
redis.securityContext.seccompProfile.type Avanzato

Introdotto nella versione: 1.16.0

Valore predefinito: nessuno

Grafico: apigee-redis

Specifica il tipo di profilo Seccomp da applicare al contesto di sicurezza del pod. I valori consentiti sono RuntimeDefault (per utilizzare il profilo predefinito del runtime del container) o Unconfined (per non applicare restrizioni Seccomp). Se non specificato, Apigee non applica alcun profilo.

Consulta Configurare i profili Seccomp per la sicurezza dei pod.

redis.auth.password Base Introdotto nella versione: 1.6.0

Valore predefinito: iloveapis123

Grafico: apigee-redis

Obbligatorio

Password dell'amministratore Redis. L'utente amministratore viene utilizzato per qualsiasi attività amministrativa eseguita sul cluster Redis.

redis.auth.secret Base Introdotto nella versione: 1.9.1

Valore predefinito: nessuno

Grafico: apigee-redis

Il nome del file archiviato in un secret Kubernetes che contiene la password dell'amministratore Redis. Il file secret deve contenere la chiave:

data:
    redis.auth.password: encoded_value

Vedi anche:

redis.envoy.image.pullPolicy Avanzato Introdotto nella versione: 1.6.0

Valore predefinito: IfNotPresent

Grafico: apigee-redis

Determina quando kubelet esegue il pull dell'immagine Docker del pod. I valori possibili sono:

  • IfNotPresent: non estrarre una nuova immagine se esiste già.
  • Always: esegue sempre il pull dell'immagine, indipendentemente dal fatto che esista già.

Per saperne di più, vedi Aggiornamento delle immagini.

redis.envoy.image.tag Avanzato Introdotto nella versione: 1.6.0

Valore predefinito: 1.16.10

Grafico: apigee-redis

L'etichetta della versione per l'immagine Docker di questo servizio.

redis.envoy.image.url Avanzato Introdotto nella versione: 1.6.0

Valore predefinito: nessuno

Grafico: apigee-redis

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository corrente per questo componente.

redis.envoy.podDisruptionBudget.minAvailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-redis

Il numero minimo di pod Redis Envoy che devono rimanere disponibili durante un'interruzione volontaria, ad esempio durante un upgrade del pool di nodi o un'eliminazione dei nodi. Questo campo imposta il campo minAvailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%"). minAvailable e maxUnavailable si escludono a vicenda; imposta solo uno dei due. L'impostazione di entrambi contemporaneamente viene rifiutata dall'operatore Apigee. Se non imposti nessuno dei due campi, l'operatore Apigee genera comunque un PodDisruptionBudget per questi pod, utilizzando maxUnavailable: 1 per impostazione predefinita.

Ad esempio, in overrides.yaml:

redis:
  envoy:
    podDisruptionBudget:
      minAvailable: "50%"
redis.envoy.podDisruptionBudget.maxUnavailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-redis

Il numero massimo di pod Redis Envoy che possono essere non disponibili durante un'interruzione volontaria, ad esempio durante un upgrade del pool di nodi o un'evacuazione dei nodi. Questo campo imposta il campo maxUnavailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%"). maxUnavailable e minAvailable si escludono a vicenda; imposta solo uno dei due. L'impostazione di entrambi contemporaneamente viene rifiutata dall'operatore Apigee. Se non imposti nessuno dei due campi, l'operatore Apigee genera comunque un PodDisruptionBudget per questi pod, utilizzando maxUnavailable: 1 per impostazione predefinita.

Ad esempio, in overrides.yaml:

redis:
  envoy:
    podDisruptionBudget:
      maxUnavailable: 1
redis.image.pullPolicy Avanzato Introdotto nella versione: 1.6.0

Valore predefinito: IfNotPresent

Grafico: apigee-redis

Determina quando kubelet esegue il pull dell'immagine Docker del pod. I valori possibili sono:

  • IfNotPresent: non estrarre una nuova immagine se esiste già.
  • Always: esegue sempre il pull dell'immagine, indipendentemente dal fatto che esista già.

Per saperne di più, vedi Aggiornamento delle immagini.

redis.image.tag Avanzato Introdotto nella versione: 1.6.0

Valore predefinito: 1.16.10

Grafico: apigee-redis

L'etichetta della versione per l'immagine Docker di questo servizio.

redis.image.url Avanzato Introdotto nella versione: 1.6.0

Valore predefinito: nessuno

Grafico: apigee-redis

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository corrente per questo componente.

redis.replicaCount Base Introdotto nella versione: 1.6.0

Valore predefinito: 2

Grafico: apigee-redis

Redis è un archivio replicato. Questa proprietà specifica il numero di nodi Redis utilizzati come StatefulSet.

redis.resources.requests.cpu Avanzato Introdotto nella versione: 1.6.0

Valore predefinito: 500m

Grafico: apigee-redis

La CPU necessaria per il normale funzionamento della risorsa in un container Kubernetes, in millicore.

redis.tolerations.effect Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-redis

Obbligatorio per utilizzare la funzionalità Taints and Tolerations di Kubernetes.

effect specifica l'effetto della corrispondenza di una tolleranza con un taint. I valori per effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per i dettagli, consulta Taints e tolleranze: concetti.

redis.tolerations.key Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-redis

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

key identifica i pod a cui può essere applicata la tolleranza.

Per i dettagli, consulta Tolleranze e taint: concetti.

redis.tolerations.operator Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: "Equal"

Grafico: apigee-redis

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

operator specifica l'operazione utilizzata per attivare effect. I valori per operator possono essere:

  • Equal corrisponde al valore impostato in value.
  • Exists ignora il valore impostato in value.

Per i dettagli, consulta Tolleranze e taint: concetti.

redis.tolerations.tolerationSeconds Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-redis

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

tolerationSeconds definisce in secondi per quanto tempo un pod rimane associato a un nodo non riuscito o che non risponde.

Per i dettagli, consulta Tolleranze e taint: concetti.

redis.tolerations.value Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-redis

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

value è il valore che attiva effect quando operator è impostato su Equal.

Per i dettagli, consulta Tolleranze e taint: concetti.

runtime

La tabella seguente descrive le proprietà dell'oggetto runtime:

Proprietà Tipo Descrizione
runtime.securityContext.seccompProfile.type Avanzato

Introdotto nella versione: 1.16.0

Valore predefinito: nessuno

Grafico: apigee-env

Specifica il tipo di profilo Seccomp da applicare al contesto di sicurezza del pod. I valori consentiti sono RuntimeDefault (per utilizzare il profilo predefinito del runtime del container) o Unconfined (per non applicare restrizioni Seccomp). Se non specificato, Apigee non applica alcun profilo.

Consulta Configurare i profili Seccomp per la sicurezza dei pod.

runtime.annotations Avanzato Introdotto nella versione: 1.5.0

Valore predefinito: nessuno

Grafico: apigee-env

Mappa chiave/valore facoltativa utilizzata per annotare i pod. Per ulteriori informazioni, consulta Annotazioni personalizzate.

runtime.envVars Base Introdotto nella versione: 1.13.1

Valore predefinito: nessuno

Grafico: apigee-env

Consente di fornire variabili di ambiente aggiuntive al componente di runtime in una coppia chiave-valore:

runtime:
  envVars:
    KEY_1: VALUE_N
    ... ...
    KEY_N: VALUE_N

ad esempio:

runtime:
  envVars:
    RUNTIME_ENV_VAR1: "value of runtime env-var 1"
    RUNTIME_ENV_VAR2: "value of runtime env-var 2"
runtime.image.pullPolicy Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: IfNotPresent

Grafico: apigee-env

Determina quando kubelet esegue il pull dell'immagine Docker del pod. I valori possibili sono:

  • IfNotPresent: non estrarre una nuova immagine se esiste già.
  • Always: estrae sempre l'immagine, indipendentemente dal fatto che esista già.

Per saperne di più, vedi Aggiornamento delle immagini.

runtime.hpaBehavior.scaleDown.percent.periodSeconds Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 60

Grafico: apigee-env

La finestra temporale per cui la norma deve essere valida quando si fa lo scale down di una percentuale di istanze di runtime.

runtime.hpaBehavior.scaleDown.percent.value Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 20

Grafico: apigee-env

La quantità di variazione consentita dalla norma durante lo scale down di una percentuale di istanze di runtime.

runtime.hpaBehavior.scaleDown.pods.periodSeconds Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 60

Grafico: apigee-env

Il periodo di tempo per il quale la policy deve essere valida quando viene ridotto il numero di istanze di runtime.

runtime.hpaBehavior.scaleDown.pods.value Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 20

Grafico: apigee-env

La quantità di modifica consentita dalla policy durante la riduzione del numero di istanze di runtime.

runtime.hpaBehavior.scaleDown.selectPolicy Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: Min

Grafico: apigee-env

La decisione presa dal gestore della scalabilità automatica tra più policy di scalabilità automatica. Se imposti il valore su Min, si verifica la più piccola variazione nella riduzione delle istanze di runtime. Se imposti il valore su Max, puoi ridurre il numero di istanze di runtime in modo più significativo.

runtime.hpaBehavior.scaleDown.stabilizationWindowSeconds Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 120

Grafico: apigee-env

Il numero di secondi per i quali devono essere presi in considerazione i suggerimenti passati durante lo scale down.

runtime.hpaBehavior.scaleUp.percent.periodSeconds Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 60

Grafico: apigee-env

Il periodo di tempo per il quale la policy deve essere valida durante lo scale up di una percentuale di istanze di runtime.

runtime.hpaBehavior.scaleUp.percent.value Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 20

Grafico: apigee-env

Il periodo di tempo per il quale la policy deve essere valida durante lo scale up di una percentuale di istanze di runtime.

runtime.hpaBehavior.scaleUp.pods.periodSeconds Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 60

Grafico: apigee-env

La finestra temporale per la quale il criterio deve essere valido durante lo scale up di un numero di istanze di runtime.

runtime.hpaBehavior.scaleUp.pods.value Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 4

Grafico: apigee-env

La quantità di modifica consentita dalla policy durante lo scale up di un numero di istanze di runtime.

runtime.hpaBehavior.scaleUp.selectPolicy Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: Max

Grafico: apigee-env

La decisione presa dal gestore della scalabilità automatica tra più policy di scalabilità automatica. Se imposti il valore su Min, si verifica la più piccola variazione di scalabilità orizzontale delle istanze di runtime. Se imposti il valore su Max, si verifica la variazione più grande nello scaling delle istanze di runtime.

runtime.hpaBehavior.scaleUp.stabilizationWindowSeconds Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 30

Grafico: apigee-env

Il numero di secondi per i quali devono essere presi in considerazione i suggerimenti passati durante lo scale up delle istanze di runtime.

runtime.hpaMetrics.serverMainTaskWaitTime Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 400 M

Grafico: apigee-env

Il tempo di attesa medio desiderato (in ms) della coda di elaborazione nelle istanze di runtime per le richieste proxy a livello HTTP.

runtime.hpaMetrics.serverNioTaskWaitTime Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 400 M

Grafico: apigee-env

Il tempo di attesa medio desiderato (in ms) della coda di elaborazione nelle istanze di runtime per le richieste proxy per l'elaborazione dei criteri.

runtime.hpaMetrics.targetCPUUtilizationPercentage Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 75

Grafico: apigee-env

La percentuale di utilizzo della CPU desiderata in tutte le istanze di runtime.

runtime.image.tag Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1.16.10

Grafico: apigee-env

L'etichetta della versione per l'immagine Docker di questo servizio.

runtime.image.url Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-env

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository corrente per questo componente.

runtime.livenessProbe.failureThreshold Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 2

Grafico: apigee-env

Il numero di volte in cui Kubernetes verificherà che i probe di attività non siano riusciti prima di riavviare il container. Il valore minimo è 1.

runtime.livenessProbe.initialDelaySeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 60

Grafico: apigee-env

Il numero di secondi dopo l'avvio di un container prima dell'avvio di un probe di attività.

runtime.livenessProbe.periodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 5

Grafico: apigee-env

Determina la frequenza di esecuzione di un probe di attività, in secondi. Il valore minimo è 1.

runtime.livenessProbe.timeoutSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1

Grafico: apigee-env

Il numero di secondi dopo i quali un probe di attività va in timeout. Il valore minimo è 1.

runtime.nodeSelector.key Base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-env

Chiave di etichetta del selettore di nodi facoltativa per il targeting dei nodi Kubernetes per i servizi runtime.

Vedi la proprietà nodeSelector.

runtime.nodeSelector.value Base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-env

Valore dell'etichetta del selettore di nodi per il targeting dei nodi Kubernetes per i servizi runtime.

Consulta la sezione Configurazione di pool di nodi dedicati.

runtime.podDisruptionBudget.minAvailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-env

Il numero minimo di pod di runtime che devono rimanere disponibili durante un'interruzione volontaria, ad esempio durante un upgrade pool di nodi o un'eliminazione dei nodi. Questo campo imposta il campo minAvailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%"). minAvailable e maxUnavailable si escludono a vicenda; imposta solo uno dei due. L'impostazione di entrambi contemporaneamente viene rifiutata dall'operatore Apigee. Se non imposti nessuno dei due campi, l'operatore Apigee genera comunque un PodDisruptionBudget per questi pod, utilizzando maxUnavailable: 1 per impostazione predefinita. Per impostare un budget diverso per i pod runtime in un ambiente specifico, utilizza envs[].components.runtime.podDisruptionBudget.minAvailable.

Ad esempio, in overrides.yaml:

runtime:
  podDisruptionBudget:
    minAvailable: "50%"
runtime.podDisruptionBudget.maxUnavailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-env

Il numero massimo di pod di runtime che possono essere non disponibili durante un'interruzione volontaria, ad esempio durante un upgrade del pool di nodi o un nodo di svuotamento. Questo campo imposta il campo maxUnavailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%"). maxUnavailable e minAvailable si escludono a vicenda; imposta solo uno dei due. L'impostazione di entrambi contemporaneamente viene rifiutata dall'operatore Apigee. Se non imposti nessuno dei due campi, l'operatore Apigee genera comunque un PodDisruptionBudget per questi pod, utilizzando maxUnavailable: 1 per impostazione predefinita. Per impostare un budget diverso per i pod runtime in un ambiente specifico, utilizza envs[].components.runtime.podDisruptionBudget.maxUnavailable.

Ad esempio, in overrides.yaml:

runtime:
  podDisruptionBudget:
    maxUnavailable: 1
runtime.readinessProbe.failureThreshold Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 2

Grafico: apigee-env

Il numero di volte in cui Kubernetes verificherà che i probe di idoneità non sono riusciti prima di contrassegnare il pod come non pronto. Il valore minimo è 1.

runtime.readinessProbe.initialDelaySeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 60

Grafico: apigee-env

Il numero di secondi dopo l'avvio di un container prima dell'avvio di un probe di idoneità.

runtime.readinessProbe.periodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 5

Grafico: apigee-env

Determina la frequenza di esecuzione di un probe di prontezza, in secondi. Il valore minimo è 1.

runtime.readinessProbe.successThreshold Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1

Grafico: apigee-env

Il numero minimo di successi consecutivi necessari affinché un probe di idoneità venga considerato riuscito dopo un errore. Il valore minimo è 1.

runtime.readinessProbe.timeoutSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1

Grafico: apigee-env

Il numero di secondi dopo i quali un probe di attività va in timeout. Il valore minimo è 1.

runtime.release.strategy Avanzato Introdotto nella versione: 1.16.8

Valore predefinito: rolling

Grafico: apigee-env

Seleziona la strategia utilizzata per implementare un nuovo ReplicaSet di runtime (processore di messaggi) quando una modifica della configurazione dell'ambiente attiva una release. Puoi anche impostare questa opzione per ambiente con envs[].components.runtime.release.strategy.

Valori consentiti:

  • rolling (impostazione predefinita): crea il nuovo ReplicaSet insieme a quello esistente e sposta il traffico in più fasi prima di fare lo scale down del vecchio ReplicaSet. Ciò consente la migrazione del traffico in più fasi, ma richiede temporaneamente un headroom di calcolo aggiuntivo (fino a circa il doppio del numero di pod in stato stazionario) durante il rilascio. Consigliata per la maggior parte degli ambienti di produzione.
  • scale-down-first: sostituisce i pod uno alla volta, svuotando un pod esistente prima di creare il relativo sostituto. Poiché ogni swap è uno a uno, il rilascio rimane entro il conteggio dei pod in stato stazionario e non richiede headroom di calcolo aggiuntivo. Utilizza questa opzione per i cluster senza scalabilità automatica dei nodi, ad esempio installazioni bare metal o con limitazioni hardware. Le release sono più lente e non includono la migrazione graduale del traffico.
  • none: esegue una transizione immediata al nuovo ReplicaSet senza migrazione del traffico in più fasi.
runtime.replicaCountMax Base Introdotto nella versione: 1.0.0

Valore predefinito: 4

Grafico: apigee-env

Numero massimo di repliche disponibili per la scalabilità automatica.

Se utilizzi i limiti proxy avanzati per ambiente, questo valore verrà applicato a tutti i replicaset per l'ambiente. Ogni replicaset continuerà a scalare automaticamente in modo indipendente.

runtime.replicaCountMin Base Introdotto nella versione: 1.0.0

Valore predefinito: 1

Grafico: apigee-env

Numero minimo di repliche disponibili per la scalabilità automatica.

Se utilizzi i limiti proxy avanzati per ambiente, questo valore verrà applicato a tutti i replicaset per l'ambiente. Ogni replicaset continuerà a scalare automaticamente in modo indipendente.

runtime.resources.limits.cpu Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 4000m

Grafico: apigee-env

Il limite della CPU per la risorsa in un container Kubernetes, in millicore.

runtime.resources.limits.memory Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 6Gi

Grafico: apigee-env

Il limite di memoria per la risorsa in un container Kubernetes, in mebibyte (Mi) o gibibyte (Gi).

runtime.resources.requests.cpu Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 500m

Grafico: apigee-env

La CPU necessaria per il normale funzionamento della risorsa in un contenitore Kubernetes, in millicore.

runtime.resources.requests.memory Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 512Mi (vedi nota di seguito)

Grafico: apigee-env

La memoria necessaria per il normale funzionamento della risorsa in un container Kubernetes, in mebibyte (Mi) o gibibyte (Gi).

runtime.service.type Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: ClusterIP

Grafico: apigee-env

Il tipo di servizio. Puoi impostare questo valore su un servizio diverso da ClusterIP, ad esempio LoadBalancer.

runtime.targetCPUUtilizationPercentage Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 75

Grafico: apigee-env

Utilizzo CPU target per il processo di runtime sul pod. Il valore di questo campo consente al runtime di scalare automaticamente quando l'utilizzo della CPU raggiunge questo valore, fino a replicaCountMax.

runtime.terminationGracePeriodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 3600

Grafico: apigee-env

Il tempo massimo tra una richiesta di eliminazione del pod e il momento in cui il pod viene terminato, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop e tutti i processi in esecuzione verranno terminati in modo controllato. Il pod verrà terminato quando tutti i processi in esecuzione saranno terminati o al termine del periodo di tolleranza, a seconda dell'evento che si verifica per primo. Se non sono in esecuzione processi, il pod verrà terminato immediatamente.

runtime.tolerations.effect Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-env

Obbligatorio per utilizzare la funzionalità Taints and Tolerations di Kubernetes.

effect specifica l'effetto della corrispondenza di una tolleranza con un taint. I valori per effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per i dettagli, consulta Taints e tolleranze: concetti.

runtime.tolerations.key Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-env

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

key identifica i pod a cui può essere applicata la tolleranza.

Per i dettagli, consulta Tolleranze e taint: concetti.

runtime.tolerations.operator Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: "Equal"

Grafico: apigee-env

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

operator specifica l'operazione utilizzata per attivare effect. I valori per operator possono essere:

  • Equal corrisponde al valore impostato in value.
  • Exists ignora il valore impostato in value.

Per i dettagli, consulta Tolleranze e taint: concetti.

runtime.tolerations.tolerationSeconds Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-env

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

tolerationSeconds definisce in secondi per quanto tempo un pod rimane associato a un nodo non riuscito o che non risponde.

Per i dettagli, consulta Tolleranze e taint: concetti.

runtime.tolerations.value Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-env

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

value è il valore che attiva effect quando operator è impostato su Equal.

Per i dettagli, consulta Tolleranze e taint: concetti.

securityContext

Definisce le impostazioni di sicurezza per i pod che possono essere applicate a livello globale, di ambiente o di componente.

Proprietà Tipo Descrizione
securityContext.seccompProfile.type Avanzato

Introdotto nella versione: 1.16.0

Valore predefinito: nessuno

Grafico: apigee-operator

Specifica il tipo di profilo Seccomp da applicare al contesto di sicurezza del pod. I valori consentiti sono RuntimeDefault (per utilizzare il profilo predefinito del runtime del container) o Unconfined (per non applicare restrizioni Seccomp). Se non specificato, Apigee non applica alcun profilo.

Consulta Configurare i profili Seccomp per la sicurezza dei pod.

synchronizer

Garantisce che i Message Processor siano aggiornati con gli ultimi bundle di proxy API di cui è stato eseguito il deployment. A questo scopo, il sincronizzatore esegue il polling del management plane; quando viene rilevato un nuovo contratto, il sincronizzatore lo invia al runtime plane. Per impostazione predefinita, Synchronizer archivia i dati di configurazione dell'ambiente in Cassandra.

Per saperne di più, vedi Configurare Synchronizer.

La tabella seguente descrive le proprietà dell'oggetto synchronizer:

Proprietà Tipo Descrizione
synchronizer.securityContext.seccompProfile.type Avanzato

Introdotto nella versione: 1.16.0

Valore predefinito: nessuno

Grafico: apigee-env

Specifica il tipo di profilo Seccomp da applicare al contesto di sicurezza del pod. I valori consentiti sono RuntimeDefault (per utilizzare il profilo predefinito del runtime del container) o Unconfined (per non applicare restrizioni Seccomp). Se non specificato, Apigee non applica alcun profilo.

Consulta Configurare i profili Seccomp per la sicurezza dei pod.

synchronizer.annotations Avanzato Introdotto nella versione: 1.5.0

Valore predefinito: nessuno

Grafico: apigee-env

Mappa chiave/valore facoltativa utilizzata per annotare i pod. Per ulteriori informazioni, consulta Annotazioni personalizzate.

synchronizer.image.pullPolicy Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: IfNotPresent

Grafico: apigee-env

Determina quando kubelet esegue il pull dell'immagine Docker del pod. I valori possibili sono:

  • IfNotPresent: non estrarre una nuova immagine se esiste già.
  • Always: estrae sempre l'immagine, indipendentemente dal fatto che esista già.

Per saperne di più, vedi Aggiornamento delle immagini.

synchronizer.image.tag Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1.16.10

Grafico: apigee-env

L'etichetta della versione per l'immagine Docker di questo servizio.

synchronizer.image.url Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-env

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository corrente per questo componente.

synchronizer.livenessProbe.failureThreshold Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 2

Grafico: apigee-env

Il numero di volte in cui Kubernetes verificherà che i probe di attività non siano riusciti prima di riavviare il container. Il valore minimo è 1.

synchronizer.livenessProbe.initialDelaySeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 0

Grafico: apigee-env

Il numero di secondi dopo l'avvio di un container prima dell'avvio di un probe di attività.

synchronizer.livenessProbe.periodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 5

Grafico: apigee-env

Determina la frequenza di esecuzione di un probe di attività, in secondi. Il valore minimo è 1.

synchronizer.livenessProbe.timeoutSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1

Grafico: apigee-env

Il numero di secondi dopo i quali un probe di attività va in timeout. Il valore minimo è 1.

synchronizer.nodeSelector.key Base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-env

Obbligatorio

Chiave dell'etichetta del selettore di nodi facoltativa per il targeting dei nodi Kubernetes per i servizi di runtime synchronizer.

Vedi nodeSelector.

synchronizer.nodeSelector.value Base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-env

Valore dell'etichetta del selettore di nodi facoltativo utilizzato per il targeting dei nodi Kubernetes per i servizi di runtime synchronizer.

Vedi nodeSelector.

synchronizer.podDisruptionBudget.minAvailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-env

Il numero minimo di pod sincronizzatori che devono rimanere disponibili durante un'interruzione volontaria, ad esempio durante un upgrade del pool di nodi o un'eliminazione dei nodi. Questo campo imposta il campo minAvailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%"). minAvailable e maxUnavailable si escludono a vicenda; imposta solo uno dei due. L'impostazione di entrambi contemporaneamente viene rifiutata dall'operatore Apigee. Se non imposti nessuno dei due campi, l'operatore Apigee genera comunque un PodDisruptionBudget per questi pod, utilizzando maxUnavailable: 1 per impostazione predefinita. Per impostare un budget diverso per i pod del sincronizzatore in un ambiente specifico, utilizza envs[].components.synchronizer.podDisruptionBudget.minAvailable.

Ad esempio, in overrides.yaml:

synchronizer:
  podDisruptionBudget:
    minAvailable: "50%"
synchronizer.podDisruptionBudget.maxUnavailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-env

Il numero massimo di pod del sincronizzatore che possono non essere disponibili durante un'interruzione volontaria, ad esempio durante un upgrade del pool di nodi o un'eliminazione dei nodi. Questo campo imposta il campo maxUnavailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%"). maxUnavailable e minAvailable si escludono a vicenda; imposta solo uno dei due. L'impostazione di entrambi contemporaneamente viene rifiutata dall'operatore Apigee. Se non imposti nessuno dei due campi, l'operatore Apigee genera comunque un PodDisruptionBudget per questi pod, utilizzando maxUnavailable: 1 per impostazione predefinita. Per impostare un budget diverso per i pod del sincronizzatore in un ambiente specifico, utilizza envs[].components.synchronizer.podDisruptionBudget.maxUnavailable.

Ad esempio, in overrides.yaml:

synchronizer:
  podDisruptionBudget:
    maxUnavailable: 1
synchronizer.pollInterval Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 60

Grafico: apigee-env

Il periodo di tempo in cui Synchronizer attende tra le operazioni di polling. Synchronizer esegue il polling dei servizi del control plane Apigee per rilevare ed estrarre nuovi contratti di runtime.

synchronizer.readinessProbe.failureThreshold Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 2

Grafico: apigee-env

Il numero di volte in cui Kubernetes verificherà che i probe di idoneità non sono riusciti prima di contrassegnare il pod come non pronto. Il valore minimo è 1.

synchronizer.readinessProbe.initialDelaySeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 0

Grafico: apigee-env

Il numero di secondi dopo l'avvio di un container prima dell'avvio di un probe di idoneità.

synchronizer.readinessProbe.periodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 5

Grafico: apigee-env

Determina la frequenza di esecuzione di un probe di prontezza, in secondi. Il valore minimo è 1.

synchronizer.readinessProbe.successThreshold Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1

Grafico: apigee-env

Il numero minimo di successi consecutivi necessari affinché un probe di idoneità venga considerato riuscito dopo un errore. Il valore minimo è 1.

synchronizer.readinessProbe.timeoutSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1

Grafico: apigee-env

Il numero di secondi dopo i quali un probe di attività va in timeout. Il valore minimo è 1.

synchronizer.replicaCount Base Introdotto nella versione: 1.0.0

Grafico: apigee-env

Deprecated: A partire dalla versione 1.2 di Hybrid, gestisci il conteggio delle repliche di Synchronizer con: synchronizer.replicaCountMax e synchronizer.replicaCountMin

synchronizer.replicaCountMax Base Introdotto nella versione: 1.2.0

Valore predefinito: 4

Grafico: apigee-env

Numero massimo di repliche per la scalabilità automatica.

synchronizer.replicaCountMin Base Introdotto nella versione: 1.2.0

Valore predefinito: 1

Grafico: apigee-env

Numero minimo di repliche per la scalabilità automatica.

synchronizer.resources.limits.cpu Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 2000m

Grafico: apigee-env

Il limite della CPU per la risorsa in un container Kubernetes, in millicore.

synchronizer.resources.limits.memory Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 5Gi

Grafico: apigee-env

Il limite di memoria per la risorsa in un container Kubernetes, in mebibyte.

synchronizer.resources.requests.cpu Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 100m

Grafico: apigee-env

La CPU necessaria per il normale funzionamento della risorsa in un contenitore Kubernetes, in millicore.

synchronizer.resources.requests.memory Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1Gi

Grafico: apigee-env

La memoria necessaria per il normale funzionamento della risorsa in un container Kubernetes, in gigabyte.

synchronizer.serviceAccountPath Base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Grafico: apigee-env

È obbligatorio specificare un valore per serviceAccountPath o serviceAccountRef.

Percorso del file della chiave del service account Google con il ruolo Apigee Synchronizer Manager.

synchronizer.serviceAccountRef Base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-env

È obbligatorio specificare un valore per serviceAccountPath o serviceAccountRef.

Un riferimento al secret Kubernetes a un file della chiave del service account Google. Consulta Memorizzazione delle chiavi dei account di servizio nei secret Kubernetes.

synchronizer.serviceAccountSecret Base Introdotto nella versione: 1.1.0

Valore predefinito: nessuno

Grafico: apigee-env

Il nome di un secret Kubernetes. Devi creare il secret utilizzando una chiave dell'account di servizio Google con il ruolo Gestore sincronizzatore Apigee come input.

synchronizer.targetCPUUtilizationPercentage Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 75

Grafico: apigee-env

Utilizzo CPU target per il processo di sincronizzazione sul pod. Il valore di questo campo consente a Synchronizer di scalare automaticamente quando l'utilizzo della CPU raggiunge questo valore, fino a replicaCountMax.

synchronizer.terminationGracePeriodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 30

Grafico: apigee-env

Il tempo massimo tra una richiesta di eliminazione del pod e il momento in cui il pod viene terminato, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop e tutti i processi in esecuzione verranno terminati in modo controllato. Il pod verrà terminato quando tutti i processi in esecuzione saranno terminati o al termine del periodo di tolleranza, a seconda dell'evento che si verifica per primo. Se non sono in esecuzione processi, il pod verrà terminato immediatamente.

synchronizer.tolerations.effect Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-env

Obbligatorio per utilizzare la funzionalità Taints and Tolerations di Kubernetes.

effect specifica l'effetto della corrispondenza di una tolleranza con un taint. I valori per effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per i dettagli, consulta Taints e tolleranze: concetti.

synchronizer.tolerations.key Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-env

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

key identifica i pod a cui può essere applicata la tolleranza.

Per i dettagli, consulta Tolleranze e taint: concetti.

synchronizer.tolerations.operator Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: "Equal"

Grafico: apigee-env

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

operator specifica l'operazione utilizzata per attivare effect. I valori per operator possono essere:

  • Equal corrisponde al valore impostato in value.
  • Exists ignora il valore impostato in value.

Per i dettagli, consulta Tolleranze e taint: concetti.

synchronizer.tolerations.tolerationSeconds Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-env

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

tolerationSeconds definisce in secondi per quanto tempo un pod rimane associato a un nodo non riuscito o che non risponde.

Per i dettagli, consulta Tolleranze e taint: concetti.

synchronizer.tolerations.value Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-env

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

value è il valore che attiva effect quando operator è impostato su Equal.

Per i dettagli, consulta Tolleranze e taint: concetti.

virtualhosts

La proprietà virtualhosts è una proprietà di configurazione obbligatoria. Gli host virtuali consentono ad Apigee Hybrid di gestire le richieste API a un gruppo di ambienti specificato.

Per saperne di più, consulta Configura gli host virtuali.

La tabella seguente descrive le proprietà dell'oggetto virtualhosts:

Proprietà Tipo Descrizione
virtualhosts[].additionalGateways Base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-virtualhost

Un elenco di gateway Istio a cui instradare il traffico.

virtualhosts[].cipherSuites[] Avanzato Introdotto nella versione: 1.9.2

Valore predefinito: nessuno

Grafico: apigee-virtualhost

Questa proprietà configura le crittografie TLS utilizzate nel gateway in entrata.

I valori di virtualhosts.cipherSuites devono essere nel formato OpenSSL.

Di seguito è riportato un elenco delle cifrature supportate in formato OpenSSL. Puoi trovare maggiori informazioni sulle cifrature supportate nella documentazione relativa alla build Boring FIPS di Envoy. Un valore vuoto corrisponde alle suite di crittografia supportate dalla build Boring FIPS di Envoy.

TLS v1.3:

Questa opzione è attiva per impostazione predefinita Altre suite di crittografia
  • TLS_AES_128_GCM_SHA256
  • TLS_AES_256_GCM_SHA384
  • TLS_CHACHA20_POLY1305_SHA256
Le suite di crittografia TLS 1.3 non possono
essere sostituite.

TLS v1.2:

Questa opzione è attiva per impostazione predefinita Altre suite di crittografia
  • ECDHE-ECDSA-AES128-GCM-SHA256
  • ECDHE-RSA-AES128-GCM-SHA256
  • ECDHE-ECDSA-AES256-GCM-SHA384
  • ECDHE-RSA-AES256-GCM-SHA384
  • AES128-GCM-SHA256
  • AES128-SHA
  • AES256-GCM-SHA384
  • AES256-SHA
  • ECDHE-ECDSA-AES128-GCM-SHA256
  • ECDHE-ECDSA-AES128-SHA
  • ECDHE-ECDSA-AES256-GCM-SHA384
  • ECDHE-ECDSA-AES256-SHA
  • ECDHE-ECDSA-CHACHA20-POLY1305
  • ECDHE-RSA-AES128-GCM-SHA256
  • ECDHE-RSA-AES128-SHA
  • ECDHE-RSA-AES256-GCM-SHA384
  • ECDHE-RSA-AES256-SHA
  • ECDHE-RSA-CHACHA20-POLY1305

TLS v1.1:

Questa opzione è attiva per impostazione predefinita Altre suite di crittografia
TLS v1.1 non è abilitato per impostazione predefinita.
  • ECDHE-ECDSA-AES128-GCM-SHA256
  • ECDHE-RSA-AES128-GCM-SHA256
  • ECDHE-ECDSA-AES256-GCM-SHA384
  • ECDHE-RSA-AES256-GCM-SHA384
  • ECDHE-ECDSA-CHACHA20-POLY1305
  • ECDHE-RSA-CHACHA20-POLY1305
  • ECDHE-ECDSA-AES128-SHA
  • ECDHE-ECDSA-AES256-SHA
  • ECDHE-RSA-AES256-SHA

Per attivare altre suite di crittografia, aggiungile alla proprietà virtualhosts.cipherSuites insieme alla versione TLS per cui vuoi attivarle nella proprietà virtualhosts.minTLSProtocolVersion. Ad esempio, per attivare tutte le suite di crittografia TLS v.1.2 accettate, aggiungi quanto segue alla configurazione di virtualhosts:

virtualhosts:
- name: ENV_GROUP_NAME
  minTLSProtocolVersion: "1.2"
  cipherSuites:
  - "AES128-GCM-SHA256"
  - "AES128-SHA"
  - "AES256-GCM-SHA384"
  - "AES256-SHA"
  - "ECDHE-ECDSA-AES128-GCM-SHA256"
  - "ECDHE-ECDSA-AES128-SHA"
  - "ECDHE-ECDSA-AES256-GCM-SHA384"
  - "ECDHE-ECDSA-AES256-SHA"
  - "ECDHE-ECDSA-CHACHA20-POLY1305"
  - "ECDHE-RSA-AES128-GCM-SHA256"
  - "ECDHE-RSA-AES128-SHA"
  - "ECDHE-RSA-AES256-GCM-SHA384"
  - "ECDHE-RSA-AES256-SHA"
  - "ECDHE-RSA-CHACHA20-POLY1305"
...

Se vuoi abilitare versioni precedenti di TLS nel deployment del gateway in entrata Apigee, utilizza le proprietà virtualhosts.minTLSProtocolVersion e virtualhosts.cipherSuites.

Ad esempio, per abilitare TLS v.1.1:

virtualhosts:
- name: ENV_GROUP_NAME
  minTLSProtocolVersion: "1.1"
  cipherSuites:
  - "ECDHE-ECDSA-AES128-GCM-SHA256"
  - "ECDHE-RSA-AES128-GCM-SHA256"
  - "ECDHE-ECDSA-AES256-GCM-SHA384"
  - "ECDHE-RSA-AES256-GCM-SHA384"
  - "ECDHE-ECDSA-CHACHA20-POLY1305"
  - "ECDHE-RSA-CHACHA20-POLY1305"
  - "ECDHE-ECDSA-AES128-SHA"
  - "ECDHE-RSA-AES128-SHA"
  - "ECDHE-ECDSA-AES256-SHA"
  - "ECDHE-RSA-AES256-SHA"
...
virtualhosts[].name Base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-virtualhost

Obbligatorio

Il nome dell'host virtuale.

virtualhosts[].maxTLSProtocolVersion Base Introdotto nella versione: 1.3.0

Valore predefinito: nessuno

Grafico: apigee-virtualhost

La versione massima del protocollo TLS che Envoy può selezionare. Envoy utilizza automaticamente la versione ottimale del protocollo TLS tra virtualhosts[].minTLSProtocolVersion e virtualhosts[].maxTLSProtocolVersion.

Il valore deve essere una stringa che rappresenta il numero di versione TLS. Ad esempio:

virtualhosts:
- name: default
  maxTLSProtocolVersion: "1.3"

dove la stringa rappresenta il numero di versione TLS nel formato "#.#". Nell'esempio precedente, "1.3" rappresenta la versione TLS di Istio TLSV1_3.

Vedi anche ServerTLSSettings nella documentazione di Istio.

virtualhosts[].minTLSProtocolVersion Base Introdotto nella versione: 1.3.0

Valore predefinito: nessuno

Grafico: apigee-virtualhost

La versione minima del protocollo TLS che Envoy può selezionare. Envoy utilizza automaticamente la versione ottimale del protocollo TLS tra virtualhosts[].minTLSProtocolVersion e virtualhosts[].maxTLSProtocolVersion.

Il valore deve essere una stringa che rappresenta il numero di versione TLS. Ad esempio:

virtualhosts:
- name: default
  minTLSProtocolVersion: "1.2"

dove la stringa rappresenta il numero di versione TLS nel formato "#.#". Nell'esempio precedente, "1.2" rappresenta la versione TLS di Istio TLSV1_2.

Vedi anche ServerTLSSettings nella documentazione di Istio.

virtualhosts[].requestTimeout Base Introdotto nella versione: 1.10.0

Valore predefinito: 300

Grafico: apigee-virtualhost

Il numero di secondi dopo i quali una richiesta va in timeout. Il valore minimo è 1.

virtualhosts[].selector Base Introdotto nella versione: 1.2.0

Valore predefinito: app: apigee-ingressgateway

Grafico: apigee-virtualhost

Obbligatorio

Una coppia chiave-valore per indicare diversi selettori di ingresso.

  • apigee-ingressgateway: per le installazioni di Apigee hybrid che utilizzano il gateway in entrata Apigee.
  • istio-ingressgateway: per le installazioni di Apigee hybrid che utilizzano Cloud Service Mesh (versioni di Apigee hybrid 1.8 e precedenti).

Se non viene fornita alcuna etichetta del selettore, la configurazione viene fornita al gateway in entrata Apigee.

virtualhosts[].sslCertPath Base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-virtualhost

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

Il percorso sul tuo sistema di un file di certificato TLS.

virtualhosts[].sslKeyPath Base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-virtualhost

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

Il percorso nel sistema del file della chiave privata TLS.

virtualhosts[].sslSecret Base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Grafico: apigee-virtualhost

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

Il nome del file archiviato in un secret Kubernetes che contiene gli utenti e le password di Cassandra. Puoi creare il secret seguendo queste istruzioni: Crea il secret.

Vedi anche:

watcher

La proprietà watcher è una proprietà di configurazione obbligatoria. Il watcher è un processo che monitora le modifiche alla configurazione e ne attiva l'applicazione al piano di runtime.

La tabella seguente descrive le proprietà dell'oggetto watcher:

Proprietà Tipo Descrizione
watcher.securityContext.seccompProfile.type Avanzato

Introdotto nella versione: 1.16.0

Valore predefinito: nessuno

Grafico: apigee-org

Specifica il tipo di profilo Seccomp da applicare al contesto di sicurezza del pod. I valori consentiti sono RuntimeDefault (per utilizzare il profilo predefinito del runtime del container) o Unconfined (per non applicare restrizioni Seccomp). Se non specificato, Apigee non applica alcun profilo.

Consulta Configurare i profili Seccomp per la sicurezza dei pod.

watcher.annotations Avanzato Introdotto nella versione: 1.5.0

Valore predefinito: nessuno

Grafico: apigee-org

Mappa chiave/valore facoltativa utilizzata per annotare i pod. Per saperne di più, consulta Annotazioni personalizzate.

watcher.args.enableIssueScanning Avanzato Introdotto nella versione: 1.10.0

Valore predefinito: true

Grafico: apigee-org

Attiva o disattiva la visualizzazione automatica dei problemi. Quando true, Watcher esegue automaticamente la scansione dello stato del control plane e del server API Kubernetes per determinare se sono presenti problemi di configurazione.

Imposta su false per disattivare la visualizzazione automatica dei problemi. Per saperne di più, consulta Rilevamento automatico dei problemi.

watcher.args.enableLeaderElect Avanzato Introdotto nella versione: 1.13.0

Valore predefinito: true

Grafico: apigee-org

Quando true (impostazione predefinita) watcher.args.enableLeaderElect seleziona un singolo pod di monitoraggio per gestire e segnalare le informazioni di routing. La limitazione a un singolo pod è necessaria per evitare tempi di inattività durante gli upgrade o il rollback. Durante questi eventi, possono essere eseguite più versioni di watcher contemporaneamente. Ogni istanza di Watcher può avere una logica di creazione delle route diversa, il che può causare tempi di inattività.watcher.replicaCountMax.

watcher.args.issueScanInterval Avanzato Introdotto nella versione: 1.10.0

Valore predefinito: 60

Grafico: apigee-org

L'intervallo in secondi per la frequenza con cui Watcher esegue la scansione del piano di runtime per la visualizzazione automatica dei problemi. Per saperne di più, consulta Rilevamento automatico dei problemi.

watcher.gsa Avanzato Introdotto nella versione: 1.10.0

Valore predefinito: nessuno

Grafico: apigee-org

Solo Helm: l'indirizzo email del account di servizio Google IAM apigee-watcher da associare al account di servizio Kubernetes corrispondente quando si abilita Workload Identity sui cluster GKE utilizzando i grafici Helm. Imposta questo valore quando hai impostato gcp.workloadIdentity.enabled su true.

Gli indirizzi email GSA hanno in genere il formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

apigee-watcher@my-hybrid-project.iam.gserviceaccount.com

Consulta Abilitare Workload Identity su GKE o Abilitare la federazione delle identità per i workload su AKS ed EKS.

watcher.image.pullPolicy Avanzato Introdotto nella versione: 1.4.0

Valore predefinito: IfNotPresent

Grafico: apigee-org

Determina quando kubelet esegue il pull dell'immagine Docker del pod. I valori possibili sono:

  • IfNotPresent: non estrarre una nuova immagine se esiste già.
  • Always: esegue sempre il pull dell'immagine, indipendentemente dal fatto che esista già.

Per saperne di più, vedi Aggiornamento delle immagini.

watcher.image.tag Avanzato Introdotto nella versione: 1.4.0

Valore predefinito: 1.16.10

Grafico: apigee-org

L'etichetta della versione per l'immagine Docker di questo servizio.

watcher.image.url Avanzato Introdotto nella versione: 1.4.0

Valore predefinito: nessuno

Grafico: apigee-org

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository corrente per questo componente.

watcher.podDisruptionBudget.minAvailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-org

Il numero minimo di pod watcher che devono rimanere disponibili durante un'interruzione volontaria, ad esempio durante un upgrade pool di nodi o un'eliminazione dei nodi. Questo campo imposta il campo minAvailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%"). minAvailable e maxUnavailable si escludono a vicenda; imposta solo uno dei due. L'impostazione di entrambi contemporaneamente viene rifiutata dall'operatore Apigee. Se non imposti nessuno dei due campi, l'operatore Apigee genera comunque un PodDisruptionBudget per questi pod, utilizzando maxUnavailable: 1 per impostazione predefinita.

Ad esempio, in overrides.yaml:

watcher:
  podDisruptionBudget:
    minAvailable: "50%"
watcher.podDisruptionBudget.maxUnavailable Avanzato

Introdotto nella versione: 1.16.10

Valore predefinito: nessuno

Grafico: apigee-org

Il numero massimo di pod watcher che possono non essere disponibili durante un'interruzione volontaria, ad esempio durante un upgrade del pool di nodi o uno svuotamento dei nodi. Questo campo imposta il campo maxUnavailable di PodDisruptionBudget per questi pod. Accetta un numero intero di pod (1) o una stringa di percentuale ("50%"). maxUnavailable e minAvailable si escludono a vicenda; imposta solo uno dei due. L'impostazione di entrambi contemporaneamente viene rifiutata dall'operatore Apigee. Se non imposti nessuno dei due campi, l'operatore Apigee genera comunque un PodDisruptionBudget per questi pod, utilizzando maxUnavailable: 1 per impostazione predefinita.

Ad esempio, in overrides.yaml:

watcher:
  podDisruptionBudget:
    maxUnavailable: 1
watcher.replicaCountMax Base Introdotto nella versione: 1.3.0

Valore predefinito: 1

Grafico: apigee-org

Il numero massimo di repliche del watcher. Questo valore deve essere mantenuto a 1 per evitare conflitti.

Apigee hybrid utilizza un pod watcher per installazione. L'elezione del leader seleziona automaticamente un pod watcher. Le repliche dei pod di monitoraggio aggiuntive verranno forzate in uno stato instabile. Vedi watcher.args.enableLeaderElect.

watcher.replicaCountMin Base Introdotto nella versione: 1.3.0

Valore predefinito: 1

Grafico: apigee-org

Il numero minimo di repliche del watcher.

watcher.resources.limits.cpu Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 1000m

Grafico: apigee-org

Il limite della CPU per la risorsa in un container Kubernetes, in millicore.

watcher.resources.limits.memory Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 2Gi

Grafico: apigee-org

Il limite di memoria per la risorsa in un container Kubernetes, in mebibyte.

watcher.serviceAccountPath Base Introdotto nella versione: 1.3.0

Valore predefinito: nessuno

Grafico: apigee-org

Obbligatorio.

Percorso del file della chiave del service account Google con il ruolo Agente runtime Apigee.

watcher.serviceAccountRef Avanzato Introdotto nella versione: 1.3.0

Valore predefinito: nessuno

Grafico: apigee-org

È obbligatorio specificare serviceAccountPath o serviceAccountRef.

Un riferimento al secret Kubernetes a un file della chiave del service account Google. Consulta Memorizzazione delle chiavi dei account di servizio nei secret Kubernetes.

watcher.tolerations.effect Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-org

Obbligatorio per utilizzare la funzionalità Taints and Tolerations di Kubernetes.

effect specifica l'effetto della corrispondenza di una tolleranza con un taint. I valori per effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per i dettagli, consulta Taints e tolleranze: concetti.

watcher.tolerations.key Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-org

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

key identifica i pod a cui può essere applicata la tolleranza.

Per i dettagli, consulta Tolleranze e taint: concetti.

watcher.tolerations.operator Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: "Equal"

Grafico: apigee-org

Obbligatorio per utilizzare la funzionalità Incompatibilità e Tolleranze di Kubernetes.

operator specifica l'operazione utilizzata per attivare effect. I valori per operator possono essere:

  • Equal corrisponde al valore impostato in value.
  • Exists ignora il valore impostato in value.

Per i dettagli, consulta Tolleranze e taint: concetti.

watcher.tolerations.tolerationSeconds Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-org

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

tolerationSeconds definisce in secondi per quanto tempo un pod rimane associato a un nodo non riuscito o che non risponde.

Per i dettagli, consulta Tolleranze e taint: concetti.

watcher.tolerations.value Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Grafico: apigee-org

Utilizzato dalla funzionalità Incompatibilità e Tolleranze di Kubernetes.

value è il valore che attiva effect quando operator è impostato su Equal.

Per i dettagli, consulta Tolleranze e taint: concetti.