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 Apigee.

Filtra questa pagina

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

Display   in questa pagina.

Proprietà di primo livello

Nella tabella seguente vengono descritte le proprietà di primo livello nel file overrides.yaml. Si tratta di proprietà che non appartengono a un altro oggetto e si applicano a livello di organizzazione o ambiente:

Proprietà Tipo Descrizione
axHashSalt Avanzata

Introdotta nella versione: 1.3.0

Valore predefinito: il nome della tua organizzazione

Optional

Il nome di un secret Kubernetes che contiene un sale utilizzato durante il calcolo degli hash per offuscare i dati utente prima che vengano inviati ad analisi di Apigee. Se non specifichi un valore di sale, per impostazione predefinita viene utilizzato iloveapis123. 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 dati dal piano di runtime al piano di controllo.

Consulta Oscurare i dati utente per l'analisi.

contractProvider Avanzata Introdotta nella versione: 1.0.0

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

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

gcpProjectID Avanzata Deprecated: Per le versioni 1.2.0 e successive, usa invece gcp.projectID.

Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

ID del tuo progetto Google Cloud. Funziona con k8sClusterName (deprecato) e gcpRegion (deprecato) per identificare il progetto e determinare dove apigee-logger e apigee-metrics eseguono il push dei loro dati.

gcpRegion Avanzata Deprecated: Per le versioni 1.2.0 e successive, usa invece gcp.region.

Introdotta nella versione: 1.0.0

Valore predefinito: us-central1

Obbligatorio

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

hub Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: nessuno

L'URL di un repository di container di immagini private utilizzato per eseguire il pull delle immagini per tutti i componenti apigee da un repository privato.

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

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

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

hub: private-docker-host.example.com

come:

## an example of internal component vs 3rd party
containers:
- name: apigee-udca
  image: private-docker-host.example.com/apigee-udca:1.12.0-hotfix.1
  imagePullPolicy: IfNotPresent

containers:
- name: apigee-ingressgateway
  image: private-docker-host.example.com/apigee-asm-ingress:1.18.7-asm.4-distroless
  imagePullPolicy: IfNotPresent

Gli altri componenti seguiranno uno schema simile.

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

Vedi Utilizzare un repository di immagini private con Apigee hybrid.

Puoi sostituire l'URL immagine per singoli componenti con le seguenti proprietà:

imagePullSecrets.name Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

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

instanceID Base Introdotta nella versione: 1.3.0

Valore predefinito: nessuno

Obbligatorio

Un identificatore univoco per questa installazione.

Una stringa univoca per identificare questa istanza. Scegli una combinazione qualsiasi di lettere e numeri, fino a un massimo di 63 caratteri.

k8sClusterName Avanzata Deprecated: Per le versioni 1.2.0 e successive, usa invece k8sCluster.name e k8sCluster.region.

Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Nome del procluster Kubernetes (K8S) su cui è in esecuzione il progetto ibrido. Funziona con gcpProjectID (deprecato) e gcpRegion (deprecato) per identificare il progetto e determinare dove apigee-logger e apigee-metrics eseguono il push dei loro dati.

kmsEncryptionKey Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: defaults.org.kmsEncryptionKey

Facoltativo. Usa un solo valore tra kmsEncryptionKey, kmsEncryptionPath o kmsEncryptionSecret.

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

kmsEncryptionPath Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

Facoltativo. Usa un solo valore tra kmsEncryptionKey, kmsEncryptionPath o kmsEncryptionSecret.

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

kmsEncryptionSecret.key Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

Facoltativo. Usa un solo valore tra kmsEncryptionKey, kmsEncryptionPath o kmsEncryptionSecret.

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

kmsEncryptionSecret.name Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

Facoltativo. Usa un solo valore tra kmsEncryptionKey, kmsEncryptionPath o kmsEncryptionSecret.

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

kvmEncryptionKey Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: defaults.org.kmsEncryptionKey

Facoltativo. Usa solo un valore tra kvmEncryptionKey, kvmEncryptionPath o kvmEncryptionSecret.

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

kvmEncryptionPath Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

Facoltativo. Usa solo un valore tra kvmEncryptionKey, kvmEncryptionPath o kvmEncryptionSecret.

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

kvmEncryptionSecret.key Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

Facoltativo. Usa solo un valore tra kvmEncryptionKey, kvmEncryptionPath o kvmEncryptionSecret.

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

kvmEncryptionSecret.name Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

Facoltativo. Usa solo un valore tra kvmEncryptionKey, kvmEncryptionPath o kvmEncryptionSecret.

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

multiOrgCluster Avanzata Presentata nella versione: 1.10.0

Valore predefinito: false

Per i cluster con più organizzazioni, questa proprietà consente l'esportazione delle metriche dell'organizzazione nel progetto elencato nella proprietà gcp.projectID. Applica questa impostazione nel file degli override per ogni organizzazione in un cluster a più organizzazioni. Per ulteriori informazioni, consulta Aggiunta di più organizzazioni ibride a un cluster.

namespace Base Introdotta nella versione: 1.0.0

Valore predefinito: apigee

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

org Base

Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

L'organizzazione con abilitazione ibrida di cui Apigee ha eseguito il provisioning 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 dopo averlo creato.

orgScopedUDCA Avanzata Presentata nella versione: 1.8.0

Valore predefinito: true

Abilita il servizio Universal Data Collection Agent (UDCA) a livello di organizzazione, che estrae l'analisi, la monetizzazione e il debug (traccia) e lo invia alla Unified Analytics Platform (UAP) che risiede nel piano di controllo.

L'UDCA con ambito a livello di organizzazione utilizza un singolo account di servizio Google per tutti gli ambienti Apigee. L'account di servizio deve avere il ruolo Apigee Analytics Agent (roles/apigee.analyticsAgent).

Specifica il percorso del file della chiave dell'account di servizio con la proprietà udca.serviceAccountPath oppure fornisci la chiave in un secret Kubernetes con la proprietà udca.serviceAccountRef nel file di configurazione overrides.yaml.

Se preferisci utilizzare un agente UDCA separato per ogni ambiente, imposta orgScopedUDCA: false e imposta i valori per envs[].serviceAccountPaths.udca e envs[].serviceAccountSecretRefs.udca.

Vedi anche: udca.

revision Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: "1120" (la tua versione ibrida di Apigee senza punti. Ad esempio per la versione 1.11.0, il valore predefinito è "1110".)

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 dei pod con nuove.

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

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

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

Per ulteriori informazioni, consulta la sezione Aggiornamenti in sequenza.

serviceAccountSecretProviderClass Avanzata Introdotta nella versione: 1.12.0

Valore predefinito: nessuno

Il nome della classe del provider di secret specifica dell'organizzazione (SecretProviderClass) utilizzata per archiviare le chiavi degli account di servizio in Vault.

Consulta Archiviazione delle chiavi degli account di servizio in Hashicorp Vault.

validateOrg Avanzata Presentata nella versione: 1.8.0

Valore predefinito: true

Abilita la convalida rigorosa del collegamento tra l'organizzazione Apigee e il progetto Google Cloud e controlla l'esistenza di gruppi di ambienti.

Vedi anche org

validateServiceAccounts Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: true

Abilita la convalida rigorosa delle autorizzazioni dell'account di servizio. Viene utilizzato il metodo testIamPermissions dell'API Cloud Resource Manager per verificare che l'account di servizio fornito disponga delle autorizzazioni necessarie. Nel caso degli account di servizio per un'organizzazione Apigee, il controllo dell'ID progetto è quello mappato all'organizzazione. Per metriche e logger, il progetto controllato si basa sulla configurazione di gcpProjectID overrides.yaml.

Vedi anche gcpProjectID

ao

Gli operatori Apigee (AO) creano e aggiornano le risorse Kubernetes e Istio di basso livello necessarie per il deployment e la manutenzione di un componente. Ad esempio, il controller esegue il rilascio dei processori di messaggi.

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

Proprietà Tipo Descrizione
ao.args.disableIstioConfigInAPIServer Avanzata Presentata nella versione: 1.8.0

Valore predefinito: true

Impedisce ad Apigee di fornire la configurazione ad ASM 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 Anthos Service Mesh (Apigee ibride versioni 1.8 e precedenti).
ao.args.disableManagedClusterRoles Avanzata Presentata nella versione: 1.10.0

Valore predefinito: true

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

ao.image.pullPolicy Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta la sezione Aggiornare le immagini.

ao.image.tag Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: 1.12.0-hotfix.1

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

ao.image.url Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Usa apigee-pull-push --list per vedere l'URL del repository attuale per questo componente.

ao.resources.limits.cpu Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: 250m

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

ao.resources.limits.memory Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: 256Mi

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

ao.resources.requests.cpu Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: 250m

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

ao.resources.requests.memory Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: 256Mi

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

ao.tolerations.effect Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Richiesto per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

effect specifica l'effetto che ha la corrispondenza di una tolleranza con un'incompatibilità. I valori di effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta la sezione Incompatibilità e tolleranze: concetti.

ao.tolerations.key Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

key identifica i pod a cui è possibile applicare la tolleranza.

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

ao.tolerations.operator Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

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

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

ao.tolerations.tolerationSeconds Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

ao.tolerations.value Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

apigeeIngressGateway

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

Vedi ingressGateways per configurare le singole istanze in modo univoco.

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

Nella tabella seguente vengono descritte le proprietà dell'oggetto apigeeIngressGateway:

Proprietà Tipo Descrizione
apigeeIngressGateway.image.pullPolicy Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta la sezione Aggiornare le immagini.

apigeeIngressGateway.image.tag Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: 1.18.7-asm.4-distroless

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

apigeeIngressGateway.image.url Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Usa apigee-pull-push --list per vedere l'URL del repository attuale per questo componente.

apigeeIngressGateway.nodeSelector.key Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: nessuno

Obbligatorio

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

Consulta Configurazione di pool di nodi dedicati.

apigeeIngressGateway.nodeSelector.value Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: nessuno

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

Vedi nodeSelector.

apigeeIngressGateway.replicaCountMax Base Introdotta nella versione: 1.11.0

Valore predefinito: 4

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

apigeeIngressGateway.replicaCountMin Base Introdotta nella versione: 1.11.0

Valore predefinito: 2

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

apigeeIngressGateway.tolerations.effect Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: nessuno

Richiesto per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

effect specifica l'effetto che ha la corrispondenza di una tolleranza con un'incompatibilità. I valori di effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta la sezione Incompatibilità e tolleranze: concetti.

apigeeIngressGateway.tolerations.key Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: nessuno

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

key identifica i pod a cui è possibile applicare la tolleranza.

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

apigeeIngressGateway.tolerations.operator Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: "Equal"

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

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

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

apigeeIngressGateway.tolerations.tolerationSeconds Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

apigeeIngressGateway.tolerations.value Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

cassandra

Definisce il servizio ibrido che gestisce il repository di dati di runtime. In questo repository sono archiviate configurazioni di applicazioni, contatori di quote distribuite, chiavi API e token OAuth per le applicazioni in esecuzione sul gateway.

Per ulteriori informazioni, vedi Configurazione di StorageClass.

Nella tabella seguente vengono descritte le proprietà dell'oggetto cassandra:

Proprietà Tipo Descrizione
cassandra.annotations Avanzata Introdotta nella versione: 1.5.0

Valore predefinito: nessuno

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

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

Valore predefinito: iloveapis123

Obbligatorio

Password per l'amministratore di Cassandra. L'utente amministratore viene utilizzato per qualsiasi attività amministrativa eseguita nel cluster Cassandra.

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

Valore predefinito: iloveapis123

Obbligatorio

Password per l'utente Cassandra Data Definition Language (DDL). Utilizzato da MART per tutte le attività di definizione dei dati, come la creazione, l'aggiornamento e l'eliminazione dello spazio delle chiavi.

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

Valore predefinito: iloveapis123

Obbligatorio

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

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

Valore predefinito: iloveapis123

Obbligatorio

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

cassandra.auth.image.pullPolicy Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta la sezione Aggiornare le immagini.

cassandra.auth.image.tag Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1.12.0-hotfix.1

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

cassandra.auth.image.url Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Usa apigee-pull-push --list per vedere l'URL del repository attuale per questo componente.

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

Valore predefinito: iloveapis123

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 Introdotta nella versione: 1.4.0

Valore predefinito: jmxuser

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 Introdotta nella versione: 1.4.0

Valore predefinito: iloveapis123

Obbligatorio

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

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

Valore predefinito: apigee

Obbligatorio

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

cassandra.auth.secret Base Introdotta nella versione: 1.3.3

Valore predefinito: nessuno

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:

cassandra.auth.secretProviderClass Avanzata Introdotta nella versione: 1.10.3

Valore predefinito: nessuno

Il criterio di archiviazione dei secret di Cassandra. Se impostato, deve corrispondere al valore SecretProviderClass che fa riferimento al provider di secret esterno, come Hashicorp Vault. Se il criterio non viene configurato, Apigee hybrid utilizza i nomi utente e le password archiviati in:

o il secret Kubernetes archiviato:

Per istruzioni su come creare il criterio, consulta Archiviazione dei secret di Cassandra in Hashicorp Vault.

cassandra.backup.cloudProvider Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: GCP

Obbligatorio se il backup è abilitato.

Cloud provider per l'archiviazione di backup.

Puoi impostare il valore su GCP o HYBRID. Imposta il valore su GCP se vuoi archiviare il backup su Google Cloud Storage e su HYBRID se vuoi archiviarlo su un server remoto.

Per informazioni su backup e ripristino CSI per piattaforme cloud come Google Cloud, AWS e Azure, consulta Backup e ripristino di CSI.

cassandra.backup.dbStorageBucket Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio se il backup è abilitato.

Bucket Cloud Storage per i dati di backup. Il percorso del bucket Cloud Storage deve essere nel formato gs://BUCKET_NAME. Il campo gs:// è obbligatorio nel nome del bucket cassandra.backup.dbStorageBucket.

cassandra.backup.enabled Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: false

Il backup dei dati non è abilitato per impostazione predefinita. Per attivarla, impostala su true.

Vedi Backup e recupero di Cassandra.

cassandra.backup.image.pullPolicy Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta la sezione Aggiornare le immagini.

cassandra.backup.image.tag Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1.12.0-hotfix.1

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

cassandra.backup.image.url Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Usa apigee-pull-push --list per vedere l'URL del repository attuale per questo componente.

cassandra.backup.schedule Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 0 2 * * *

La pianificazione del cron job.

Vedi Backup e recupero di Cassandra.

cassandra.backup.serviceAccountPath Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Se il backup è abilitato, è necessaria una delle seguenti proprietà: backup.serviceAccountPath o backup.serviceAccountRef.

Percorso del file della chiave dell'account di servizio Google con il ruolo Amministratore oggetti Storage.

cassandra.backup.serviceAccountRef Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

Se il backup è abilitato, è necessaria una delle seguenti proprietà: backup.serviceAccountPath o backup.serviceAccountRef.

cassandra.clusterName Base Introdotta nella versione: 1.0.0

Valore predefinito: apigeecluster

Specifica il nome del cluster Cassandra.

cassandra.datacenter Base Introdotta nella versione: 1.0.0

Valore predefinito: dc-1

Specifica il data center del nodo Cassandra.

cassandra.dnsPolicy Base Introdotta nella versione: 1.1.1

Valore predefinito: nessuno

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

cassandra.externalSeedHost Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

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

cassandra.heapNewSize Base Introdotta nella versione: 1.0.0

Valore predefinito: 100M

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

cassandra.hostNetwork Base Introdotta nella versione: 1.1.1

Valore predefinito: false

Abilita la funzionalità Kubernetes hostNetwork. Apigee utilizza questa funzionalità in installazioni multiregionali per comunicare tra pod se lo spazio dei nomi di rete dei pod non ha connettività tra i cluster (i cluster sono in esecuzione in "modalità di rete dell'isola"), che è il caso predefinito nelle installazioni non GKE, tra cui GKE On-Prem, GKE su AWS, Anthos on bare metal, AKS, EKS e OpenShift.

Imposta cassandra.hostNetwork su false per le installazioni in una singola regione e per più regioni con connettività tra pod in cluster diversi, ad esempio installazioni GKE.

Imposta cassandra.hostNetwork su true per installazioni in più regioni senza comunicazione tra pod in cluster diversi, ad esempio installazioni GKE On-Prem, GKE on AWS, Anthos on bare metal, AKS, EKS e OpenShift. Consulta Deployment per più regioni: prerequisiti.

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

cassandra.image.pullPolicy Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta la sezione Aggiornare le immagini.

cassandra.image.tag Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1.12.0-hotfix.1

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

cassandra.image.url Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Usa apigee-pull-push --list per vedere l'URL del repository attuale per questo componente.

cassandra.maxHeapSize Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 512M

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

cassandra.multiRegionSeedHost Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Indirizzo IP di un cluster Cassandra esistente utilizzato per espandere il cluster esistente in una nuova regione. Consulta Configurare l'host di origine per più regioni.

cassandra.nodeSelector.key Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

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

Consulta Configurazione di pool di nodi dedicati.

cassandra.nodeSelector.value Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

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

Vedi nodeSelector.

cassandra.port Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 9042

Numero di porta utilizzato per la connessione a Cassandra.

cassandra.rack Base Introdotta nella versione: 1.0.0

Valore predefinito: ra-1

Specifica il rack del nodo Cassandra.

cassandra.readinessProbe.failureThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 2

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

cassandra.readinessProbe.initialDelaySeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 0

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

cassandra.readinessProbe.periodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 10

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

cassandra.readinessProbe.successThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1

Il numero minimo di operazioni riuscite consecutive necessarie affinché un probe di idoneità venga considerato riuscito dopo un errore. Il valore minimo è 1.

cassandra.readinessProbe.timeoutSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 5

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

cassandra.replicaCount Base Introdotta nella versione: 1.0.0

Valore predefinito: 1

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

cassandra.resources.requests.cpu Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 500m

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

cassandra.resources.requests.memory Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1Gi

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

cassandra.restore.cloudProvider Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: GCP

Obbligatorio se il ripristino è abilitato.

Cloud provider per l'archiviazione di backup.

Per informazioni su backup e ripristino CSI per piattaforme cloud come Google Cloud, AWS e Azure, consulta Backup e ripristino di CSI.

cassandra.restore.dbStorageBucket Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio se il ripristino è abilitato.

Bucket Cloud Storage per i dati di backup da ripristinare.

cassandra.restore.enabled Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: false

cassandra.restore.image.pullPolicy Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta la sezione Aggiornare le immagini.

cassandra.restore.image.tag Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1.12.0-hotfix.1

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

cassandra.restore.image.url Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Usa apigee-pull-push --list per vedere l'URL del repository attuale per questo componente.

cassandra.restore.serviceAccountPath Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Se il ripristino è abilitato, è necessaria una delle seguenti proprietà: restore.serviceAccountPath o restore.serviceAccountRef.

Percorso del file della chiave dell'account di servizio Google con il ruolo Amministratore oggetti Storage.

cassandra.restore.serviceAccountRef Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

Se il ripristino è abilitato, è necessaria una delle seguenti proprietà: restore.serviceAccountPath o restore.serviceAccountRef.

cassandra.restore.snapshotTimestamp Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio se il ripristino è abilitato.

Timestamp del backup da ripristinare.

cassandra.restore.user Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: account amministratore

Nome utente Cassandra utilizzato per il ripristino del backup dello schema. Se non specificato, verrà utilizzato l'utente amministratore.

cassandra.sslCertPath Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

Il percorso sul sistema di un file di certificato TLS.

cassandra.sslKeyPath Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

Il percorso sul sistema del file della chiave privata TLS.

cassandra.sslRootCAPath Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

La catena di certificati alla CA radice (autorità di certificazione).

cassandra.storage.capacity Base Introdotta nella versione: 1.0.0

Valore predefinito: 10Gi

Obbligatorio se è specificato storage.storageclass

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

cassandra.storage.storageclass Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Specifica la classe di archiviazione on-prem in uso.

cassandra.terminationGracePeriodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 300

Il tempo in secondi che intercorre tra una richiesta di eliminazione di pod e la sua terminazione. Durante questo periodo, verranno eseguiti tutti gli eventuali hook prestop e qualsiasi processo in esecuzione dovrebbe terminare in modo controllato.

cassandra.tolerations.effect Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Richiesto per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

effect specifica l'effetto che ha la corrispondenza di una tolleranza con un'incompatibilità. I valori di effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta la sezione Incompatibilità e tolleranze: concetti.

cassandra.tolerations.key Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

key identifica i pod a cui è possibile applicare la tolleranza.

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

cassandra.tolerations.operator Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

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

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

cassandra.tolerations.tolerationSeconds Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

cassandra.tolerations.value Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

certManager

Apigee utilizza cert-manager per la convalida dei certificati.

Nella tabella seguente vengono descritte le proprietà dell'oggetto certManager:

Proprietà Tipo Descrizione
certManager.namespace Avanzata Presentata nella versione: 1.9.0

Valore predefinito: cert-manager

Lo spazio dei nomi per cert-manager.

Vedi Esecuzione di cert-manager in uno spazio dei nomi personalizzato.

connectAgent

Apigee Connect consente al piano di gestione ibrido Apigee di connettersi in modo sicuro al servizio MART nel piano di runtime senza che sia necessario esporre l'endpoint MART su internet.

Nella tabella seguente vengono descritte le proprietà dell'oggetto connectAgent:

Proprietà Tipo Descrizione
connectAgent.annotations Avanzata Introdotta nella versione: 1.5.0

Valore predefinito: nessuno

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

connectAgent.gsa Avanzata Presentata nella versione: 1.10.0

Valore predefinito: nessuno

Solo Helm: l'indirizzo email dell'account di servizio Google IAM (GSA) che connectAgent deve associare all'account di servizio Kubernetes corrispondente durante l'abilitazione di Workload Identity sui cluster GKE utilizzando i grafici Helm. Imposta questa opzione se hai impostato gcp.workloadIdentity.enabled su true.

In genere, gli indirizzi email di Gboard sono nel formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

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

Consulta Attivazione di Workload Identity su GKE o Abilitare la federazione delle identità per i carichi di lavoro su AKS ed EKS.

connectAgent.logLevel Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: INFO

Il livello dei report sui log. I valori possibili sono:

  • INFO: messaggi informativi oltre a messaggi di avviso, errori e irreversibili. È particolarmente 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 Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta la sezione Aggiornare le immagini.

connectAgent.image.tag Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: 1.12.0-hotfix.1

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

connectAgent.image.url Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Usa apigee-pull-push --list per vedere l'URL del repository attuale per questo componente.

connectAgent.replicaCountMax Base Introdotta nella versione: 1.2.0

Valore predefinito: 5

Numero massimo di repliche disponibili per la scalabilità automatica.

connectAgent.replicaCountMin Base Introdotta nella versione: 1.2.0

Valore predefinito: 1

Numero minimo di repliche disponibili per la scalabilità automatica.

In produzione, potresti voler aumentare il valore replicaCountMin a 1 per avere un numero maggiore di connessioni al piano di controllo per l'affidabilità e la scalabilità.

connectAgent.resources.limits.cpu Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: 512m

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

connectAgent.resources.limits.memory Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: 512Mi

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

connectAgent.resources.requests.cpu Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: 100m

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

connectAgent.resources.requests.memory Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: 30Mi

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

connectAgent.server Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: apigeeconnect.googleapis.com:443

La posizione del server e la porta per il servizio.

connectAgent.serviceAccountPath Base Introdotta nella versione: 1.1.1

Valore predefinito: nessuno

È obbligatorio specificare uno dei valori serviceAccountPath o serviceAccountRef.

Percorso del file della chiave dell'account di servizio Google per l'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 Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare uno dei valori serviceAccountPath o serviceAccountRef.

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

connectAgent.targetCPUUtilizationPercentage Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: 75

Utilizzo della 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 Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: 600

Il tempo in secondi che intercorre tra una richiesta di eliminazione di pod e la sua terminazione. Durante questo periodo, verranno eseguiti tutti gli eventuali hook prestop e qualsiasi processo in esecuzione dovrebbe terminare in modo controllato.

connectAgent.tolerations.effect Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Richiesto per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

effect specifica l'effetto che ha la corrispondenza di una tolleranza con un'incompatibilità. I valori di effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta la sezione Incompatibilità e tolleranze: concetti.

connectAgent.tolerations.key Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

key identifica i pod a cui è possibile applicare la tolleranza.

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

connectAgent.tolerations.operator Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

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

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

connectAgent.tolerations.tolerationSeconds Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

connectAgent.tolerations.value Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

defaults

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

Nella tabella seguente vengono descritte le proprietà dell'oggetto defaults:

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

Valore predefinito: aWxvdmVhcGlzMTIzNDU2Nw==

Chiave di crittografia predefinita per l'organizzazione in KMS.

defaults.org.kvmEncryptionKey Base Introdotta nella versione: 1.0.0

Valore predefinito: aWxvdmVhcGlzMTIzNDU2Nw==

Chiave di crittografia predefinita per l'organizzazione in KVM.

defaults.env.kmsEncryptionKey Base Introdotta nella versione: 1.0.0

Valore predefinito: aWxvdmVhcGlzMTIzNDU2Nw==

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

defaults.env.kvmEncryptionKey Base Introdotta nella versione: 1.0.0

Valore predefinito: aWxvdmVhcGlzMTIzNDU2Nw==

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

defaults.env.cacheEncryptionKey Base Introdotta nella versione: 1.0.0

Valore predefinito: aWxvdmVhcGlzMTIzNDU2Nw==

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

diagnostic

Le impostazioni per lo strumento di raccoglitore di diagnostica.

Consulta Utilizzo del raccoglitore di diagnostica

Nella tabella seguente vengono descritte le proprietà dell'oggetto diagnostic:

Proprietà Tipo Descrizione
diagnostic.bucket Base Introdotta nella versione: 1.6.0

Valore predefinito: nessuno

Obbligatorio

Il nome del bucket Google Cloud Storage in cui verranno depositati i dati diagnostici.

Consulta Creazione di bucket di archiviazione.

diagnostic.container Base Introdotta nella versione: 1.6.0

Valore predefinito: nessuno

Obbligatorio

Questo specifica il tipo di pod da cui stai acquisendo i dati. I valori possono essere:

  • "apigee-cassandra" acquisisce i dati relativi al databgase di Cassandra. I pod istio-cassandra vengono eseguiti nello spazio dei nomi apigee.
  • "apigee-mart-server" acquisisce dati sul MART. I pod apigee-mart-server vengono eseguiti nello spazio dei nomi apigee.
  • "apigee-runtime" acquisisce i dati sul processore di messaggi. I pod apigee-runtime vengono eseguiti nello spazio dei nomi apigee.
  • "apigee-synchronizer" acquisisce i dati sul sincronizzatore. I pod apigee-synchronizer vengono eseguiti nello spazio dei nomi apigee.
  • "apigee-udca" acquisisce dati sull'UDCA. I pod apigee-udca vengono eseguiti nello spazio dei nomi apigee.
  • "apigee-watcher" acquisisce i dati su Watcher. I pod apigee-watcher vengono eseguiti nello spazio dei nomi apigee.
  • "istio-proxy" acquisisce i dati sul gateway in entrata Istio. I pod istio-proxy vengono eseguiti nello spazio dei nomi istio-system.
diagnostic.loggingDetails.logDuration Base Introdotta nella versione: 1.6.0

Valore predefinito: nessuno

Obbligatorio se l'operazione di raccolta della diagnostica è "REGISTRAZIONE" (impostata con operation: "LOGGING")

Durata in millisecondi dei dati di log raccolti. Un valore tipico è 30000.

Leggi diagnostic.operation

diagnostic.loggingDetails.loggerNames[] Base Introdotta nella versione: 1.6.0

Valore predefinito: nessuno

Obbligatorio se l'operazione di raccolta della diagnostica è "REGISTRAZIONE" (impostata con operation: "LOGGING")

Specifica per nome da quali logger raccogliere i dati. Per Apigee ibrida versione 1.6.0, l'unico valore supportato è ALL, ovvero tutti i logger. Ad esempio:

diagnostic:
 loggingDetails:
   loggerNames:
   - ALL
diagnostic.loggingDetails.logLevel Base Introdotta nella versione: 1.6.0

Valore predefinito: nessuno

Obbligatorio se l'operazione di raccolta della diagnostica è "REGISTRAZIONE" (impostata con operation: "LOGGING")

Specifica la granularità dei dati di logging da raccogliere. In Apigee hybrid 1.6, è supportato solo FINE.

diagnostic.namespace Base Introdotta nella versione: 1.6.0

Valore predefinito: nessuno

Obbligatorio

Lo spazio dei nomi Kubernetes in cui risiedono i pod su cui vengono raccolti i dati. Lo spazio dei nomi deve essere quello corretto per il container specificato con diagnostic.container:

apigee per

  • apigee-runtime
  • apigee-synchronizer
  • apigee-udca
  • apigee-watcher
  • apigee-cassandra
  • apigee-mart-server

istio-system per

  • istio-proxy
diagnostic.operation Base Introdotta nella versione: 1.6.0

Valore predefinito: nessuno

Obbligatorio

Specifica se raccogliere tutte le statistiche o solo i log.

I valori sono:

diagnostic.podNames[] Base Introdotta nella versione: 1.6.0

Valore predefinito: nessuno

Obbligatorio

I nomi dei pod Kubernetes per i quali stai raccogliendo i dati. Ad esempio:

diagnostic:
 podNames:
 - apigee-runtime-eng-hybrid-example-3b2ebf3-150-8vfoj-2wcjn
 - apigee-runtime-eng-hybrid-example-3b2ebf3-150-8vfoj-6xzn2
diagnostic.serviceAccountPath Base Introdotta nella versione: 1.6.0

Valore predefinito: nessuno

Obbligatorio

Il percorso di un file di chiavi dell'account di servizio (.json) per l'account di servizio con il ruolo Storage Admin (roles/storage.admin). Nella maggior parte delle installazioni ibride di Apigee, questo è l'account di servizio apigee-cassandra.

Vedi Informazioni sugli account di servizio.

diagnostic.tcpDumpDetails.maxMsgs Base Introdotta nella versione: 1.6.0

Valore predefinito: nessuno

Uno tra diagnostic.tcpDumpDetails.maxMsgs o diagnostic.tcpDumpDetails.timeoutInSeconds è obbligatorio se utilizzi diagnostic.tcpDumpDetails.

Consente di impostare il numero massimo di messaggi tcpDump da raccogliere. Apigee consiglia un valore massimo non superiore a 1000.

diagnostic.tcpDumpDetails.timeoutInSeconds Base Introdotta nella versione: 1.6.0

Valore predefinito: nessuno

Uno tra diagnostic.tcpDumpDetails.maxMsgs o diagnostic.tcpDumpDetails.timeoutInSeconds è obbligatorio se utilizzi diagnostic.tcpDumpDetails.

Consente di impostare l'intervallo di tempo in secondi di attesa prima che tcpDump restituisca i messaggi.

diagnostic.threadDumpDetails.delayInSeconds Base Introdotta nella versione: 1.6.0

Valore predefinito: nessuno

Sia diagnostic.threadDumpDetails.delayInSeconds che diagnostic.threadDumpDetails.iterations sono obbligatori se utilizzi diagnostic.threadDumpDetails.

Il ritardo in secondi tra la raccolta di ogni dump dei thread.

diagnostic.threadDumpDetails.iterations Base Introdotta nella versione: 1.6.0

Valore predefinito: nessuno

Sia diagnostic.threadDumpDetails.delayInSeconds che diagnostic.threadDumpDetails.iterations sono obbligatori se utilizzi diagnostic.threadDumpDetails.

Il numero di iterazioni del dump del thread jstack da raccogliere.

envs

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

La tua organizzazione con tecnologia ibrida deve avere almeno un ambiente.

Per saperne di più, consulta Informazioni sugli ambienti.

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

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

Valore predefinito: nessuno

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

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

envs[].cacheEncryptionPath Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare uno dei seguenti 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 Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare uno dei seguenti 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 Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare uno dei seguenti valori: 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.replicaCountMax Base Introdotta nella versione: 1.9.3

Valore predefinito: 4

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

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

Valore predefinito: 1

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

envs[].components.synchronizer.replicaCountMax Base Introdotta nella versione: 1.9.3

Valore predefinito: 4

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

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

Valore predefinito: 1

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

envs[].components.udca.replicaCountMax Base Introdotta nella versione: 1.9.3

Valore predefinito: 4

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

envs[].components.udca.replicaCountMin Base Introdotta nella versione: 1.9.3

Valore predefinito: 1

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

envs.gsa.runtime Avanzata Presentata nella versione: 1.10.0

Valore predefinito: nessuno

Solo Helm: l'indirizzo email dell'account di servizio Google IAM runtime da associare all'account di servizio Kubernetes corrispondente quando abiliti Workload Identity sui cluster GKE utilizzando i grafici Helm.

Consulta Attivazione di Workload Identity su GKE o Abilitare la federazione delle identità per i carichi di lavoro su AKS ed EKS.

envs.gsa.synchronizer Avanzata Presentata nella versione: 1.10.0

Valore predefinito: nessuno

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

Consulta Attivazione di Workload Identity su GKE o Abilitare la federazione delle identità per i carichi di lavoro su AKS ed EKS.

envs.gsa.udca Avanzata Presentata nella versione: 1.10.0

Valore predefinito: nessuno

Solo Helm: l'indirizzo email dell'account di servizio Google IAM udca per udca con ambito env da associare all'account di servizio Kubernetes corrispondente quando si abilita Workload Identity sui cluster GKE utilizzando i grafici Helm.

Consulta Attivazione di Workload Identity su GKE o Abilitare la federazione delle identità per i carichi di lavoro su AKS ed EKS.

envs[].hostAliases[] Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

Deprecated: a partire dalla versione ibrida 1.4, il piano di runtime riceve queste informazioni dal piano di gestione. Consulta Informazioni sugli ambienti e sui gruppi di ambienti.

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

Valore predefinito: nessuno

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

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

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

Vedi anche: Configurare il proxy di inoltro per i proxy API.

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

Valore predefinito: nessuno

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 Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

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

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

Valore predefinito: nessuno

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

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

Valore predefinito: nessuno

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

envs[].name Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

Nome ambiente Apigee da sincronizzare.

envs[].pollInterval Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

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

envs[].port Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Numero di porta TCP per il traffico HTTPS.

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

Valore predefinito: nessuno

Percorso del file sul sistema locale a una chiave dell'account di servizio Google con il ruolo Agente Cloud Trace, in genere l'account di servizio apigee-runtime. Consulta la pagina Informazioni sugli account di servizio per conoscere i nomi predefiniti degli account di servizio e i relativi ruoli assegnati.

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

Valore predefinito: nessuno

Percorso di file sul sistema locale a una chiave dell'account di servizio Google con il ruolo Apigee Sincronizzar Manager.

envs[].serviceAccountPaths.udca Base Presentata nella versione: 1.0

Valore predefinito: nessuno

Percorso di file sul sistema locale a una chiave dell'account di servizio Google con il ruolo Agente di analisi Apigee.

Imposta questa proprietà solo se orgScopedUDCA è impostato su false.

envs[].serviceAccountSecretProviderClass Avanzata Introdotta nella versione: 1.12.0

Valore predefinito: nessuno

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

Consulta Archiviazione delle chiavi degli account di servizio in Hashicorp Vault.

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

Valore predefinito: nessuno

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

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

Valore predefinito: nessuno

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

envs[].serviceAccountSecretRefs.udca Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

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

Imposta questa proprietà solo se orgScopedUDCA è impostato su false.

envs[].sslCertPath Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

Il percorso sul sistema di un file di certificato TLS.

envs[].sslKeyPath Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

Il percorso sul sistema del file della chiave privata TLS.

envs[].sslSecret Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È 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 il certificato TLS e i dati della chiave come input.

Vedi anche:

gcp

Identifica l'ID progetto Google Cloud e la regione in cui apigee-logger e apigee-metrics eseguono il push dei loro dati.

Nella tabella seguente vengono descritte le proprietà dell'oggetto gcp:

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

Valore predefinito: nessuno

Il pubblico consentito del provider di identità per i carichi di lavoro sulle piattaforme non GKE.

Consulta Abilitazione della federazione delle identità per i carichi di lavoro su AKS ed EKS.

gcp.federatedWorkloadIdentity.credentialSourceFile Base Introdotta nella versione: 1.12.0

Valore predefinito: nessuno

Il nome file e il percorso del file di origine delle credenziali utilizzato dalla federazione delle identità per i carichi di lavoro per ottenere le credenziali per gli account di servizio. Questo è il valore che fornisci per credential-source-file quando configuri la federazione delle identità per i carichi di lavoro con il comando create-cred-config.

Consulta Abilitazione della federazione delle identità per i carichi di lavoro su AKS ed EKS.

gcp.federatedWorkloadIdentity.enabled Base Introdotta nella versione: 1.12.0

Valore predefinito: false

Abilita la federazione delle identità per i carichi di lavoro sulle piattaforme non GKE. Non deve essere impostato true se gcp.workloadIdentity.enabled è impostato su true nello stesso cluster.

Consulta Abilitazione della federazione delle identità per i carichi di lavoro su AKS ed EKS.

gcp.projectID Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

Obbligatorio

Identifica il progetto Google Cloud in cui apigee-logger e apigee-metrics eseguono il push dei loro dati.

gcp.projectIDRuntime Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

Identifica il progetto del cluster Kubernetes di runtime.

La proprietà projectIDRuntime è facoltativa. Se non viene utilizzato, si presume che venga utilizzato il valore projectID sia per il progetto Google Cloud dell'organizzazione Apigee sia per il progetto del cluster K8S di runtime.

gcp.region Base Introdotta nella versione: 1.2.0

Valore predefinito: us-central1

Obbligatorio

Identifica la regione Google Cloud in cui apigee-logger e apigee-metrics eseguono il push dei loro dati.

gcp.workloadIdentity.enabled Base Presentata nella versione: 1.10.0

Valore predefinito:false

Solo Helm: abilita l'utilizzo di Workload Identity su GKE. Workload Identity consente ai carichi di lavoro nei cluster GKE di impersonare gli account di servizio Identity and Access Management (IAM) 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 gli account di servizio IAM per ogni componente ibrido Apigee. Vedi Informazioni sugli account di servizio.

Se workloadIdentityEnabled è true, Apigee utilizza gli account di servizio Kubernetes e li mappa agli account di servizio IAM appropriati per ogni componente. Specifica gli account di servizio IAM da mappare agli account di servizio Kubernetes con:

gcp.workloadIdentity.gsa Avanzata Presentata nella versione: 1.10.0

Valore predefinito: nessuno

Solo Helm: l'indirizzo email dell'account di servizio Google IAM (GSA) per tutti i componenti da associare all'account di servizio Kubernetes corrispondente durante l'abilitazione di Workload Identity sui cluster GKE utilizzando i grafici Helm. Imposta questa opzione se 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 è necessario fornire un motore di analisi per i singoli componenti ibridi. Se specifichi una funzionalità di Google Cloud per un singolo componente, la funzionalità di quest'ultimo sostituisce gcp.workloadIdentity.gsa solo per quel componente.

In genere, gli indirizzi email di Gboard sono nel 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.

gcp.workloadIdentityEnabled Base Introdotta nella versione: 1.4.0

Valore predefinito:false

Solo apigeectl: consente di utilizzare Workload Identity. Workload Identity consente ai carichi di lavoro nei cluster GKE di impersonare gli account di servizio Identity and Access Management (IAM) per accedere ai servizi Google Cloud.

Quando workloadIdentityEnabled è false, il valore predefinito, Apigee utilizza gli account di servizio IAM per ogni componente ibrido Apigee. Vedi Informazioni sugli account di servizio.

Quando workloadIdentityEnabled è true, Apigee utilizza gli account di servizio Kubernetes invece degli account di servizio IAM e ignora le seguenti proprietà di configurazione:

httpProxy

httpProxy fornisce i parametri di configurazione per un server proxy di inoltro HTTP. Se configurata in overrides.yaml, tutte le comunicazioni internet per i componenti MART, synchronousr e UDCA passano attraverso il server proxy.

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

Nella tabella seguente vengono descritte le proprietà dell'oggetto httpProxy:

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

Valore predefinito: nessuno

Il nome host del proxy HTTP.

httpProxy.port Base Introdotta nella versione: 1.1.1

Valore predefinito: nessuno

La porta del proxy HTTP.

httpProxy.scheme Base Introdotta nella versione: 1.1.1

Valore predefinito: HTTPS

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

httpProxy.username Base Introdotta nella versione: 1.1.1

Valore predefinito: nessuno

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

httpProxy.password Base Introdotta nella versione: 1.1.1

Valore predefinito: nessuno

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

ingressGateways

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

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

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

Nella tabella seguente vengono descritte le proprietà dell'oggetto ingressGateways:

Proprietà Tipo Descrizione
ingressGateways[].image.pullPolicy Avanzata Presentata nella versione: 1.8.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta la sezione Aggiornare le immagini.

ingressGateways[].image.tag Avanzata Presentata nella versione: 1.8.0

Valore predefinito: 1.18.7-asm.4-distroless

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

ingressGateways[].image.url Avanzata Presentata nella versione: 1.8.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Usa apigee-pull-push --list per vedere l'URL del repository attuale per questo componente.

ingressGateways[].name Base Presentata nella versione: 1.8.0

Valore predefinito: nessuno

Obbligatorio

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

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

Per ulteriori informazioni, consulta Nomi dei sottodomini DNS nella documentazione di Kubernetes.

ingressGateways[].resources.limits.cpu Avanzata Presentata nella versione: 1.8.0

Valore predefinito: 2000m

Il limite di CPU per la risorsa, in millicore.

ingressGateways[].resources.limits.memory Avanzata Presentata nella versione: 1.8.0

Valore predefinito: 1Gi

Il limite di memoria per la risorsa, in mebibyte.

ingressGateways[].resources.requests.cpu Avanzata Presentata nella versione: 1.8.0

Valore predefinito: 300m

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

ingressGateways[].resources.requests.memory Avanzata Presentata nella versione: 1.8.0

Valore predefinito: 128Mi

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

ingressGateways[].replicaCountMax Base Presentata nella versione: 1.8.0

Valore predefinito: 10

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

ingressGateways[].replicaCountMin Base Presentata nella versione: 1.8.0

Valore predefinito: 2

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

ingressGateways[].svcAnnotations Base Presentata nella versione: 1.8.0

Valore predefinito: nessuno

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 Presentata nella versione: 1.8.0

Valore predefinito: nessuno

Sulle piattaforme che supportano la specifica dell'indirizzo IP del bilanciatore del carico, il bilanciatore del carico 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 Introdotta nella versione: 1.8.1

Valore predefinito: LoadBalancer

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

  • ClusterIP
  • LoadBalancer
ingressGateways[].tolerations.effect Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Richiesto per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

effect specifica l'effetto che ha la corrispondenza di una tolleranza con un'incompatibilità. I valori di effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta la sezione Incompatibilità e tolleranze: concetti.

ingressGateways[].tolerations.key Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

key identifica i pod a cui è possibile applicare la tolleranza.

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

ingressGateways[].tolerations.operator Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

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

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

ingressGateways[].tolerations.tolerationSeconds Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

ingressGateways[].tolerations.value Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

istiod

Configura il traffico Apigee in entrata.

Nella tabella seguente vengono descritte le proprietà dell'oggetto istiod:

Proprietà Tipo Descrizione
istiod.accessLogFile Avanzata Presentata nella versione: 1.8.0

Valore predefinito: /dev/stdout

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 disabilitato.

istiod.accessLogFormat Avanzata Presentata nella versione: 1.8.0

Il formato del log di accesso in entrata.

Se questo valore non è definito, viene utilizzato il formato predefinito per il log degli accessi del proxy.

Formato predefinito del log di accesso:

'{"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 per il log degli accessi, con interruzioni di riga aggiunte per migliorare la 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 Avanzata Introdotta nella versione: 1.9.2

Valore predefinito: SANITIZE_SET

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

I valori possibili sono:

  • SANITIZE_SET (predefinito) Se la connessione client è mTLS, reimposta l'intestazione XFCC con le informazioni del certificato client e inviala all'hop successivo.
  • FORWARD_ONLY Se la connessione client è mTLS (TLS reciproco), inoltra l'intestazione XFCC solo nella richiesta.
  • APPEND_FORWARD Se 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.filtri.network.http_connection_manager.v3.HttpConnectionManager.ForwardClientCertDetails.

Se modifichi questa impostazione dopo l'installazione di un ambiente ibrido, applicala con apigeectl init e poi riavvia i pod del gateway Apigee in entrata.

istiod.image.pullPolicy Avanzata Presentata nella versione: 1.8.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta la sezione Aggiornare le immagini.

istiod.image.tag Avanzata Presentata nella versione: 1.8.0

Valore predefinito: 1.18.7-asm.4-distroless

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

istiod.image.url Avanzata Presentata nella versione: 1.8.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Usa apigee-pull-push --list per vedere l'URL del repository attuale per questo componente.

istiod.tolerations.effect Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Richiesto per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

effect specifica l'effetto che ha la corrispondenza di una tolleranza con un'incompatibilità. I valori di effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta la sezione Incompatibilità e tolleranze: concetti.

istiod.tolerations.key Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

key identifica i pod a cui è possibile applicare la tolleranza.

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

istiod.tolerations.operator Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

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

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

istiod.tolerations.tolerationSeconds Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

istiod.tolerations.value Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

k8sCluster

Identifica il cluster Kubernetes in cui è installato il runtime ibrido.

Nella tabella seguente vengono descritte le proprietà dell'oggetto k8sCluster:

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

Valore predefinito: nessuno

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

k8sCluster.region Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

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.

Nella tabella seguente vengono descritte le proprietà dell'oggetto kubeRBACProxy:

Proprietà Tipo Descrizione
kubeRBACProxy.image.pullPolicy Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta la sezione Aggiornare le immagini.

kubeRBACProxy.image.tag Avanzata Introdotto nella versione: 1.2.0

Valore predefinito: v0.14.2

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

kubeRBACProxy.image.url Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Usa apigee-pull-push --list per vedere l'URL del repository attuale per questo componente.

kubeRBACProxy.resources.limits.cpu Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: 500m

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

kubeRBACProxy.resources.limits.memory Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: 128Mi

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

kubeRBACProxy.resources.requests.cpu Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: 5m

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

kubeRBACProxy.resources.requests.memory Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: 64Mi

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

logger

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

Per saperne di più, consulta Panoramica di Logging.

Nella tabella seguente vengono descritte le proprietà dell'oggetto logger:

Proprietà Tipo Descrizione
logger.annotations Avanzata Introdotta nella versione: 1.5.0

Valore predefinito: nessuno

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

logger.bufferChunkSize Avanzata Introdotta nella versione: 1.12.0

Valore predefinito: 256.000

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

logger.bufferMaxSize Avanzata Introdotta nella versione: 1.12.0

Valore predefinito: 104857600

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

logger.bufferMemoryLimit Avanzata Introdotta nella versione: 1.12.0

Valore predefinito: 150 MB

Il limite di memoria utilizzabile dal logger. Se si raggiunge la copertura, il logger sospenderà temporaneamente la lettura di più dati finché quelli esistenti non saranno stati cancellati in memoria.

logger.enabled Base Introdotta nella versione: 1.0.0

Valore predefinito: 2.1.8

Abilita o disabilita il logging sul cluster. Per non GKE imposta su true, per Anthos o GKE imposta su false.

logger.envVars Base Introdotta nella versione: 1.8.5

Valore predefinito: nessuno

Consente di includere la variabile di ambiente NO_PROXY bit Fluent, che specifica gli URL per cui il traffico non viene instradato tramite il proxy HTTP. La variabile NO_PROXY deve essere definita come 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 il proxy di inoltro HTTP è abilitato.

Consulta NO_PROXY nella documentazione di Fluent Bit.

logger.flushInterval Avanzata Introdotta nella versione: 1.12.0

Valore predefinito: 1

Intervallo in secondi di attesa prima di richiamare il successivo svuotamento del buffer.

logger.gsa Avanzata Presentata nella versione: 1.10.0

Valore predefinito: nessuno

Solo Helm: l'indirizzo email dell'account di servizio Google IAM (GSA) apigee-logger di Google da associare all'account di servizio Kubernetes corrispondente quando abiliti Workload Identity sui cluster GKE utilizzando i grafici Helm. Imposta questa opzione se hai impostato gcp.workloadIdentity.enabled su true.

In genere, gli indirizzi email di Gboard sono nel formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

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

Consulta Attivazione di Workload Identity su GKE o Abilitare la federazione delle identità per i carichi di lavoro su AKS ed EKS.

logger.image.pullPolicy Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta la sezione Aggiornare le immagini.

logger.image.tag Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1.9.9

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

logger.image.url Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Usa apigee-pull-push --list per vedere l'URL del repository attuale per questo componente.

logger.livenessProbe.failureThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 3

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 Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 0

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

logger.livenessProbe.periodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 60

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

logger.livenessProbe.successThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1

Il numero minimo di operazioni riuscite consecutive necessarie affinché un probe di attività possa essere considerato riuscito dopo un errore. Il valore minimo è 1.

logger.livenessProbe.timeoutSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1

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

logger.nodeSelector.key Base Introdotta nella versione: 1.0.0

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

Obbligatorio

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

Consulta Configurazione di pool di nodi dedicati.

logger.nodeSelector.value Base Introdotta nella versione: 1.0.0

Valore predefinito: true

Obbligatorio

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

Consulta Configurazione di pool di nodi dedicati.

logger.proxyURL Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

URL del server proxy del cliente.

logger.resources.limits.cpu Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 200m

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

logger.resources.limits.memory Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 500Mi

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

logger.resources.requests.cpu Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 100m

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

logger.resources.requests.memory Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 250Mi

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

logger.serviceAccountPath Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

È obbligatorio specificare il valore serviceAccountPath o serviceAccountRef.

Percorso del file della chiave dell'account di servizio Google con il ruolo Writer log.

logger.serviceAccountRef Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare il valore serviceAccountPath o serviceAccountRef.

logger.storageMaxChunks Avanzata Introdotta nella versione: 1.12.0

Valore predefinito: 128

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

logger.terminationGracePeriodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 30

Il tempo in secondi che intercorre tra una richiesta di eliminazione di pod e la sua terminazione. Durante questo periodo, verranno eseguiti tutti gli eventuali hook prestop e qualsiasi processo in esecuzione dovrebbe terminare in modo controllato.

logger.tolerations.effect Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Richiesto per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

effect specifica l'effetto che ha la corrispondenza di una tolleranza con un'incompatibilità. I valori di effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta la sezione Incompatibilità e tolleranze: concetti.

logger.tolerations.key Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

key identifica i pod a cui è possibile applicare la tolleranza.

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

logger.tolerations.operator Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

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

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

logger.tolerations.tolerationSeconds Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

logger.tolerations.value Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

mart

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

Nella tabella seguente vengono descritte le proprietà dell'oggetto mart:

Proprietà Tipo Descrizione
mart.annotations Avanzata Introdotta nella versione: 1.5.0

Valore predefinito: nessuno

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

mart.gsa Avanzata Presentata nella versione: 1.10.0

Valore predefinito: nessuno

Solo Helm: l'indirizzo email dell'account di servizio Google IAM (GSA) apigee-mart di Google da associare all'account di servizio Kubernetes corrispondente quando abiliti Workload Identity sui cluster GKE utilizzando i grafici Helm. Imposta questa opzione se hai impostato gcp.workloadIdentity.enabled su true.

In genere, gli indirizzi email di Gboard sono nel formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

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

Consulta Attivazione di Workload Identity su GKE o Abilitare la federazione delle identità per i carichi di lavoro su AKS ed EKS.

mart.hostAlias Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

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

mart.image.pullPolicy Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta la sezione Aggiornare le immagini.

mart.image.tag Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1.12.0-hotfix.1

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

mart.image.url Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Usa apigee-pull-push --list per vedere l'URL del repository attuale per questo componente.

mart.initCheckCF.resources.requests.cpu Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 10m

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

mart.livenessProbe.failureThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 12

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 Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 15

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

mart.livenessProbe.periodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 5

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

mart.livenessProbe.timeoutSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1

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

mart.metricsURL Base Introdotta nella versione: 1.0.0

Valore predefinito: /v1/server/metrics

mart.nodeSelector.key Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Chiave di etichetta del selettore dei 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 Configurazione di pool di nodi dedicati.

mart.nodeSelector.value Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

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

Consulta Configurazione di pool di nodi dedicati.

mart.readinessProbe.failureThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 2

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

mart.readinessProbe.initialDelaySeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 15

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

mart.readinessProbe.periodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 5

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

mart.readinessProbe.successThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1

Il numero minimo di operazioni riuscite consecutive necessarie affinché un probe di idoneità venga considerato riuscito dopo un errore. Il valore minimo è 1.

mart.readinessProbe.timeoutSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1

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

mart.replicaCountMax Base Introdotta nella versione: 1.0.0

Valore predefinito: 5

Numero massimo di repliche disponibili per la scalabilità automatica.

mart.replicaCountMin Base Introdotta nella versione: 1.0.0

Valore predefinito: 1

Numero minimo di repliche disponibili per la scalabilità automatica.

mart.resources.limits.cpu Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: 2000m

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

mart.resources.limits.memory Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: 5Gi

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

mart.resources.requests.cpu Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 500m

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

mart.resources.requests.memory Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 512Mi

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

mart.serviceAccountPath Base Introdotta nella versione: 1.1.1

Valore predefinito: nessuno

È obbligatorio specificare uno dei valori serviceAccountPath o serviceAccountRef.

Percorso del file della chiave dell'account di servizio Google senza ruolo.

mart.serviceAccountRef Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare uno dei valori serviceAccountPath o serviceAccountRef.

mart.sslCertPath Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

Percorso del file system locale per il caricamento e la codifica del certificato SSL in un secret.

mart.sslKeyPath Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

Percorso del file system locale per il caricamento e la codifica della chiave SSL in un secret.

mart.sslSecret Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È 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 il certificato TLS e i dati della chiave come input.

Vedi anche:

mart.targetCPUUtilizationPercentage Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 75

Utilizzo della 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 Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 30

Il tempo in secondi che intercorre tra una richiesta di eliminazione di pod e la sua terminazione. Durante questo periodo, verranno eseguiti tutti gli eventuali hook prestop e qualsiasi processo in esecuzione dovrebbe terminare in modo controllato.

mart.tolerations.effect Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Richiesto per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

effect specifica l'effetto che ha la corrispondenza di una tolleranza con un'incompatibilità. I valori di effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta la sezione Incompatibilità e tolleranze: concetti.

mart.tolerations.key Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

key identifica i pod a cui è possibile applicare la tolleranza.

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

mart.tolerations.operator Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

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

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

mart.tolerations.tolerationSeconds Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

mart.tolerations.value Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

metrics

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

Per saperne di più, consulta Panoramica della raccolta di metriche.

Nella tabella seguente vengono descritte le proprietà dell'oggetto metrics:

Proprietà Tipo Descrizione
metrics.adapter.image.pullPolicy Avanzata Introdotta nella versione: 1.8.1

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta la sezione Aggiornare le immagini.

metrics.adapter.image.tag Avanzata Introdotta nella versione: 1.8.1

Valore predefinito: v0.11.0

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

metrics.adapter.image.url Avanzata Introdotta nella versione: 1.8.1

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Usa apigee-pull-push --list per vedere l'URL del repository attuale per questo componente.

metrics.aggregator.resources.requests.cpu Avanzata Introdotta nella versione: 1.4.0

Valore predefinito: 500m

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

metrics.aggregator.resources.requests.memory Avanzata Introdotta nella versione: 1.4.0

Valore predefinito: 512Mi

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

metrics.aggregator.resources.limits.cpu Avanzata Introdotta nella versione: 1.4.0

Valore predefinito: 500m

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

metrics.aggregator.resources.limits.memory Avanzata Introdotta nella versione: 1.4.0

Valore predefinito: 3Gi

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

metrics.annotations Avanzata Introdotta nella versione: 1.5.0

Valore predefinito: nessuno

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

metrics.app.resources.requests.cpu Avanzata Introdotta nella versione: 1.4.0

Valore predefinito: 500m

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

metrics.app.resources.requests.memory Avanzata Introdotta nella versione: 1.4.0

Valore predefinito: 512Mi

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

metrics.app.resources.limits.cpu Avanzata Introdotta nella versione: 1.4.0

Valore predefinito: 500m

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

metrics.app.resources.limits.memory Avanzata Introdotta nella versione: 1.4.0

Valore predefinito: 1Gi

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

metrics.appStackdriverExporter.resources.requests.cpu Avanzata Presentata nella versione: 1.7.0

Valore predefinito: 128m

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

metrics.appStackdriverExporter.resources.requests.memory Avanzata Presentata nella versione: 1.7.0

Valore predefinito: 512Mi

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

metrics.appStackdriverExporter.resources.limits.cpu Avanzata Presentata nella versione: 1.7.0

Valore predefinito: 500m

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

metrics.appStackdriverExporter.resources.limits.memory Avanzata Presentata nella versione: 1.7.0

Valore predefinito: 1Gi

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

metrics.collector.imagePullPolicy Avanzata Introdotta nella versione: 1.12.0

Valore predefinito: IfNotPresent

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

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

Per maggiori informazioni, vedi Utilizzare un repository di immagini private con Apigee hybrid .

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

Valore predefinito: v0.93.0

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

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

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Usa apigee-pull-push --list per vedere l'URL del repository attuale per questo componente.

metrics.collector.resources.requests.cpu Avanzata Introdotta nella versione: 1.12.0

Valore predefinito: 500m

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

metrics.collector.resources.requests.memory Avanzata Introdotta nella versione: 1.12.0

Valore predefinito: 512Mi

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

metrics.collector.resources.limits.cpu Avanzata Introdotta nella versione: 1.12.0

Valore predefinito: 500m

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

metrics.collector.resources.limits.memory Avanzata Introdotta nella versione: 1.12.0

Valore predefinito: 1Gi

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

metrics.collector.livenessProbe.failureThreshold Avanzata Introdotta nella versione: 1.12.0

Valore predefinito: 5

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.collector.livenessProbe.initialDelaySeconds Avanzata Introdotta nella versione: 1.12.0

Valore predefinito: 30

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

metrics.collector.livenessProbe.periodSeconds Avanzata Introdotta nella versione: 1.12.0

Valore predefinito: 10

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

metrics.collector.livenessProbe.successThreshold Avanzata Introdotta nella versione: 1.12.0

Valore predefinito: 1

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

metrics.collector.livenessProbe.timeoutSeconds Avanzata Introdotta nella versione: 1.12.0

Valore predefinito: 5

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

metrics.collector.readinessProbe.failureThreshold Avanzata Introdotta nella versione: 1.12.0

Valore predefinito: 3

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

metrics.collector.readinessProbe.initialDelaySeconds Avanzata Introdotta nella versione: 1.12.0

Valore predefinito: 30

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

metrics.collector.readinessProbe.periodSeconds Avanzata Introdotta nella versione: 1.12.0

Valore predefinito: 10

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

metrics.collector.readinessProbe.successThreshold Avanzata Introdotta nella versione: 1.12.0

Valore predefinito: 1

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 Avanzata Introdotta nella versione: 1.12.0

Valore predefinito: 5

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

metrics.disablePrometheusPipeline Base Introdotta nella versione: 1.12.0

Valore predefinito: true

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

metrics.enabled Base Introdotta nella versione: 1.0.0

Valore predefinito: true

Abilita le metriche Apigee. Imposta true per attivare le metriche. Impostalo su false per disabilitare le metriche.

metrics.gsa Avanzata Presentata nella versione: 1.10.0

Valore predefinito: nessuno

Solo Helm: l'indirizzo email dell'account di servizio Google IAM (GSA) apigee-metrics di Google da associare all'account di servizio Kubernetes corrispondente quando abiliti Workload Identity sui cluster GKE utilizzando i grafici Helm. Imposta questa opzione se hai impostato gcp.workloadIdentity.enabled su true.

In genere, gli indirizzi email di Gboard sono nel formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

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

Consulta Attivazione di Workload Identity su GKE o Abilitare la federazione delle identità per i carichi di lavoro su AKS ed EKS.

metrics.nodeSelector.key Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

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

Consulta Configurazione di pool di nodi dedicati.

metrics.nodeSelector.value Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

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

Consulta Configurazione di pool di nodi dedicati.

metrics.prometheus.containerPort Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 9090

La porta da connettere al servizio di metriche Prometheus.

metrics.prometheus.image.pullPolicy Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta la sezione Aggiornare le immagini.

metrics.prometheus.image.tag Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: v2.45.0

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

metrics.prometheus.image.url Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Usa apigee-pull-push --list per vedere l'URL del repository attuale per questo componente.

metrics.prometheus.livenessProbe.failureThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 6

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 Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 5

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

metrics.prometheus.livenessProbe.timeoutSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 3

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

metrics.prometheus.readinessProbe.failureThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 120

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

metrics.prometheus.readinessProbe.periodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 5

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

metrics.prometheus.readinessProbe.timeoutSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 3

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

metrics.prometheus.sslCertPath Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

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 Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

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 Avanzata Introdotta nella versione: 1.4.0

Valore predefinito: 500m

La CPU necessaria per il normale funzionamento del proxy in un container Kubernetes, in millicore.

metrics.proxy.resources.requests.memory Avanzata Introdotta nella versione: 1.4.0

Valore predefinito: 512Mi

La memoria necessaria per il normale funzionamento del proxy in un container Kubernetes, espressa in mebibyte.

metrics.proxy.resources.limits.cpu Avanzata Introdotta nella versione: 1.4.0

Valore predefinito: 500m

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

metrics.proxy.resources.limits.memory Avanzata Introdotta nella versione: 1.4.0

Valore predefinito: 1Gi

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

metrics.proxyStackdriverExporter.resources.requests.cpu Avanzata Presentata nella versione: 1.7.0

Valore predefinito: 128m

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

metrics.proxyStackdriverExporter.resources.requests.memory Avanzata Presentata nella versione: 1.7.0

Valore predefinito: 512Mi

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

metrics.proxyStackdriverExporter.resources.limits.cpu Avanzata Presentata nella versione: 1.7.0

Valore predefinito: 500m

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

metrics.proxyStackdriverExporter.resources.limits.memory Avanzata Presentata nella versione: 1.7.0

Valore predefinito: 1Gi

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

metrics.proxyURL Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

URL per il proxy sidecar del processo delle metriche nel cluster Kubernetes.

metrics.sdSidecar.containerPort Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 9091

La porta per la connessione al servizio di metriche di Cloud Monitoring.

metrics.sdSidecar.image.pullPolicy Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: IfNotPresent

Determina quando Kubelet esegue il pull dell'immagine Docker di questo servizio. I valori possibili sono:

  • IfNotPresent: non eseguire il pull di una nuova immagine se esiste già
  • Always: esegui sempre il pull del criterio, anche se esiste già

    Per maggiori informazioni, consulta la pagina Aggiornare le immagini.

metrics.sdSidecar.image.tag Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: v0.9.0

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

metrics.sdSidecar.image.url Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Usa apigee-pull-push --list per vedere l'URL del repository attuale per questo componente.

metrics.serviceAccountPath Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

È obbligatorio specificare il valore serviceAccountPath o serviceAccountRef.

Percorso del file della chiave dell'account di servizio Google con il ruolo Monitoring Metric Writer.

metrics.serviceAccountRef Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare il valore serviceAccountPath o serviceAccountRef.

metrics.stackdriverExporter.resources.requests.cpu Avanzata Introdotta nella versione: 1.4.0

Deprecated: a partire dalla versione ibrida 1.8, metrics:stackdriverExporter è stato sostituito con metrics:appStackdriverExporter e metrics:proxyStackdriverExporter. Vedi:

metrics.stackdriverExporter.resources.requests.memory Avanzata Introdotta nella versione: 1.4.0

Deprecated: a partire dalla versione ibrida 1.8, metrics:stackdriverExporter è stato sostituito con metrics:appStackdriverExporter e metrics:proxyStackdriverExporter. Vedi:

metrics.stackdriverExporter.resources.limits.cpu Avanzata Introdotta nella versione: 1.4.0

Deprecated: a partire dalla versione ibrida 1.8, metrics:stackdriverExporter è stato sostituito con metrics:appStackdriverExporter e metrics:proxyStackdriverExporter. Vedi:

metrics.stackdriverExporter.resources.limits.memory Avanzata Introdotta nella versione: 1.4.0

Deprecated: a partire dalla versione ibrida 1.8, metrics:stackdriverExporter è stato sostituito con metrics:appStackdriverExporter e metrics:proxyStackdriverExporter. Vedi:

metrics.terminationGracePeriodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 300

Il tempo in secondi che intercorre tra una richiesta di eliminazione di pod e la sua terminazione. Durante questo periodo, verranno eseguiti tutti gli eventuali hook prestop e qualsiasi processo in esecuzione dovrebbe terminare in modo controllato.

metrics.tolerations.effect Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Richiesto per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

effect specifica l'effetto che ha la corrispondenza di una tolleranza con un'incompatibilità. I valori di effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta la sezione Incompatibilità e tolleranze: concetti.

metrics.tolerations.key Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

key identifica i pod a cui è possibile applicare la tolleranza.

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

metrics.tolerations.operator Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

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

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

metrics.tolerations.tolerationSeconds Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

metrics.tolerations.value Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

mintTaskScheduler

mintTaskScheduler è il cron job per pianificare le attività di monetizzazione, come il calcolo periodico delle tariffe ricorrenti.

Nella tabella seguente vengono descritte le proprietà dell'oggetto mintTaskScheduler:

Proprietà Tipo Descrizione
mintTaskScheduler.image.pullPolicy Avanzata Presentata nella versione: 1.7.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta la sezione Aggiornare le immagini.

mintTaskScheduler.image.tag Avanzata Presentata nella versione: 1.7.0

Valore predefinito: 1.12.0-hotfix.1

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

mintTaskScheduler.image.url Avanzata Presentata nella versione: 1.7.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Usa apigee-pull-push --list per vedere l'URL del repository attuale per questo componente.

mintTaskScheduler.resources.limits.cpu Avanzata Introdotta nella versione: 1.1.0

Valore predefinito: 2000m

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

mintTaskScheduler.resources.limits.memory Avanzata Introdotta nella versione: 1.1.0

Valore predefinito: 4Gi

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

mintTaskScheduler.resources.requests.cpu Avanzata Presentata nella versione: 1.7.0

Valore predefinito: 500m

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

mintTaskScheduler.resources.requests.memory Avanzata Presentata nella versione: 1.7.0

Valore predefinito: 512Mi

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

mintTaskScheduler.tolerations.effect Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Richiesto per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

effect specifica l'effetto che ha la corrispondenza di una tolleranza con un'incompatibilità. I valori di effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta la sezione Incompatibilità e tolleranze: concetti.

mintTaskScheduler.tolerations.key Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

key identifica i pod a cui è possibile applicare la tolleranza.

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

mintTaskScheduler.tolerations.operator Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

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

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

mintTaskScheduler.tolerations.tolerationSeconds Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

mintTaskScheduler.tolerations.value Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

nodeSelector

L'oggetto nodeSelector definisce il nodo per la tua istanza Apigee. Dietro le quinte, Apigee hybrid si occupa di mappare la chiave/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 di questa impostazione per i singoli oggetti nella proprietà mart:nodeSelector.

Nella tabella seguente vengono descritte le proprietà dell'oggetto nodeSelector:

Proprietà Tipo Descrizione
nodeSelector.apigeeData.key Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: cloud.google.com/gke-nodepool

ApigeeData è il nodo per il database Cassandra. Chiave di etichetta del selettore di nodi per scegliere come target i nodi Kubernetes per lavorare con i dati dei servizi Apigee.

Consulta Configurare pool di nodi dedicati.

nodeSelector.apigeeData.value Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: apigee-data

apigee-data è il nodo per il database Cassandra. Valore dell'etichetta del selettore dei nodi per scegliere come target i nodi Kubernetes per lavorare con i dati dei servizi Apigee.

Consulta Configurare pool di nodi dedicati.

nodeSelector.apigeeRuntime.key Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: cloud.google.com/gke-nodepool

Il runtime Apigee è il nodo per l'ambiente di runtime del progetto. Chiave di etichetta del selettore di nodi per il targeting dei nodi Kubernetes per i servizi di runtime Apigee.

Consulta Configurare pool di nodi dedicati.

nodeSelector.apigeeRuntime.value Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: apigee-runtime

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 pool di nodi dedicati.

nodeSelector.requiredForScheduling Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: false

Per impostazione predefinita, la proprietà requiredForScheduling è false. Se questo valore viene sostituito in true, se Kubernetes non riesce a trovare i nodi con la chiave/valore dell'etichetta configurata, i pod sottostanti non verranno pianificati sui nodi worker delle VM.

Per la produzione, nodeSelector.requiredForScheduling deve essere impostato su true.

Consulta Configurare pool di nodi dedicati.

redis

Nella tabella seguente vengono descritte le proprietà dell'oggetto redis:

Proprietà Tipo Descrizione
redis.auth.password Base Introdotta nella versione: 1.6.0

Valore predefinito: iloveapis123

Obbligatorio

Password per l'amministratore Redis. L'utente amministratore viene utilizzato per qualsiasi attività amministrativa eseguita sul cluster Redis.

redis.auth.secret Base Introdotta nella versione: 1.9.1

Valore predefinito: nessuno

Il nome del file archiviato in un secret Kubernetes che contiene la password per l'amministratore Redis. Il file secret deve contenere la chiave:

data:
    redis.auth.password: encoded_value

Vedi anche:

redis.envoy.image.pullPolicy Avanzata Introdotta nella versione: 1.6.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta la sezione Aggiornare le immagini.

redis.envoy.image.tag Avanzata Introdotta nella versione: 1.6.0

Valore predefinito: v1.27.0

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

redis.envoy.image.url Avanzata Introdotta nella versione: 1.6.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Usa apigee-pull-push --list per vedere l'URL del repository attuale per questo componente.

redis.image.pullPolicy Avanzata Introdotta nella versione: 1.6.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta la sezione Aggiornare le immagini.

redis.image.tag Avanzata Introdotta nella versione: 1.6.0

Valore predefinito: 1.12.0-hotfix.1

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

redis.image.url Avanzata Introdotta nella versione: 1.6.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Usa apigee-pull-push --list per vedere l'URL del repository attuale per questo componente.

redis.replicaCount Base Introdotta nella versione: 1.6.0

Valore predefinito: 2

Redis è uno spazio di archiviazione replicato. Questa proprietà specifica il numero di nodi Redis utilizzati come StatefulSet.

redis.resources.requests.cpu Avanzata Introdotta nella versione: 1.6.0

Valore predefinito: 500m

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

redis.tolerations.effect Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Richiesto per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

effect specifica l'effetto che ha la corrispondenza di una tolleranza con un'incompatibilità. I valori di effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta la sezione Incompatibilità e tolleranze: concetti.

redis.tolerations.key Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

key identifica i pod a cui è possibile applicare la tolleranza.

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

redis.tolerations.operator Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

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

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

redis.tolerations.tolerationSeconds Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

redis.tolerations.value Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

runtime

Nella tabella seguente vengono descritte le proprietà dell'oggetto runtime:

Proprietà Tipo Descrizione
runtime.annotations Avanzata Introdotta nella versione: 1.5.0

Valore predefinito: nessuno

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

runtime.image.pullPolicy Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta la sezione Aggiornare le immagini.

runtime.image.tag Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1.12.0-hotfix.1

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

runtime.image.url Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Usa apigee-pull-push --list per vedere l'URL del repository attuale per questo componente.

runtime.livenessProbe.failureThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 2

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 Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 60

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

runtime.livenessProbe.periodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 5

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

runtime.livenessProbe.timeoutSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1

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

runtime.nodeSelector.key Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Chiave facoltativa del selettore di nodi per il targeting dei nodi Kubernetes per i servizi runtime.

Vedi la proprietà nodeSelector.

runtime.nodeSelector.value Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Valore dell'etichetta del selettore dei nodi per il targeting dei nodi Kubernetes per i servizi runtime.

Consulta Configurazione di pool di nodi dedicati.

runtime.readinessProbe.failureThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 2

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

runtime.readinessProbe.initialDelaySeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 60

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

runtime.readinessProbe.periodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 5

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

runtime.readinessProbe.successThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1

Il numero minimo di operazioni riuscite consecutive necessarie affinché un probe di idoneità venga considerato riuscito dopo un errore. Il valore minimo è 1.

runtime.readinessProbe.timeoutSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1

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

runtime.replicaCountMax Base Introdotta nella versione: 1.0.0

Valore predefinito: 4

Numero massimo di repliche disponibili per la scalabilità automatica.

runtime.replicaCountMin Base Introdotta nella versione: 1.0.0

Valore predefinito: 1

Numero minimo di repliche disponibili per la scalabilità automatica.

runtime.resources.limits.cpu Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: 4000m

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

runtime.resources.limits.memory Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: 6Gi

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

runtime.resources.requests.cpu Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 500m

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

runtime.resources.requests.memory Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 512Mi (vedi nota sotto)

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

runtime.service.type Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: ClusterIP

Il tipo di servizio. Puoi impostarlo su un servizio diverso da ClusterIP, ad esempio LoadBalancer.

runtime.targetCPUUtilizationPercentage Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 75

Utilizzo della 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 Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 180

Il tempo in secondi che intercorre tra una richiesta di eliminazione di pod e la sua terminazione. Durante questo periodo, verranno eseguiti tutti gli eventuali hook prestop e qualsiasi processo in esecuzione dovrebbe terminare in modo controllato.

runtime.tolerations.effect Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Richiesto per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

effect specifica l'effetto che ha la corrispondenza di una tolleranza con un'incompatibilità. I valori di effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta la sezione Incompatibilità e tolleranze: concetti.

runtime.tolerations.key Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

key identifica i pod a cui è possibile applicare la tolleranza.

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

runtime.tolerations.operator Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

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

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

runtime.tolerations.tolerationSeconds Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

runtime.tolerations.value Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

synchronizer

Garantisce che i processori di messaggi siano sempre aggiornati con gli ultimi bundle di proxy API di cui è stato eseguito il deployment. A questo scopo, il sincronizzatore esegue il polling del piano di gestione; quando viene rilevato un nuovo contratto, lo invia al piano di runtime. Per impostazione predefinita, il sincronizzatore archivia i dati di configurazione dell'ambiente in Cassandra.

Per ulteriori informazioni, vedi Configurare il sincronizzatore.

Nella tabella seguente vengono descritte le proprietà dell'oggetto synchronizer:

Proprietà Tipo Descrizione
synchronizer.annotations Avanzata Introdotta nella versione: 1.5.0

Valore predefinito: nessuno

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

synchronizer.image.pullPolicy Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta la sezione Aggiornare le immagini.

synchronizer.image.tag Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1.12.0-hotfix.1

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

synchronizer.image.url Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Usa apigee-pull-push --list per vedere l'URL del repository attuale per questo componente.

synchronizer.livenessProbe.failureThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 2

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 Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 0

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

synchronizer.livenessProbe.periodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 5

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

synchronizer.livenessProbe.timeoutSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1

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

synchronizer.nodeSelector.key Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

Chiave di etichetta del selettore dei nodi facoltativa per il targeting dei nodi Kubernetes per i servizi di runtime synchronizer.

Vedi nodeSelector.

synchronizer.nodeSelector.value Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Valore facoltativo dell'etichetta del selettore dei nodi utilizzato per scegliere come target i nodi Kubernetes per i servizi di runtime synchronizer.

Vedi nodeSelector.

synchronizer.pollInterval Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 60

Il tempo di attesa del sincronizzatore tra le operazioni di polling. Il sincronizzatore esegue il polling dei servizi del piano di controllo Apigee per rilevare ed estrarre nuovi contratti di runtime.

synchronizer.readinessProbe.failureThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 2

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

synchronizer.readinessProbe.initialDelaySeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 0

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

synchronizer.readinessProbe.periodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 5

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

synchronizer.readinessProbe.successThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1

Il numero minimo di operazioni riuscite consecutive necessarie affinché un probe di idoneità venga considerato riuscito dopo un errore. Il valore minimo è 1.

synchronizer.readinessProbe.timeoutSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1

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

synchronizer.replicaCount Base Introdotta nella versione: 1.0.0

Deprecated: a partire dalla versione ibrida 1.2, gestisci il conteggio delle repliche del sincronizzatore con: synchronizer.replicaCountMax e synchronizer.replicaCountMin

synchronizer.replicaCountMax Base Introdotta nella versione: 1.2.0

Valore predefinito: 4

Numero massimo di repliche per la scalabilità automatica.

synchronizer.replicaCountMin Base Introdotta nella versione: 1.2.0

Valore predefinito: 1

Numero minimo di repliche per la scalabilità automatica.

synchronizer.resources.limits.cpu Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: 2000m

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

synchronizer.resources.limits.memory Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: 5Gi

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

synchronizer.resources.requests.cpu Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 100m

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

synchronizer.resources.requests.memory Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1Gi

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

synchronizer.serviceAccountPath Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

È obbligatorio specificare il valore serviceAccountPath o serviceAccountRef.

Percorso del file chiave dell'account di servizio Google con il ruolo Apigee synchronousr Manager.

synchronizer.serviceAccountRef Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare il valore serviceAccountPath o serviceAccountRef.

synchronizer.targetCPUUtilizationPercentage Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 75

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

synchronizer.terminationGracePeriodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 30

Il tempo in secondi che intercorre tra una richiesta di eliminazione di pod e la sua terminazione. Durante questo periodo, verranno eseguiti tutti gli eventuali hook prestop e qualsiasi processo in esecuzione dovrebbe terminare in modo controllato.

synchronizer.tolerations.effect Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Richiesto per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

effect specifica l'effetto che ha la corrispondenza di una tolleranza con un'incompatibilità. I valori di effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta la sezione Incompatibilità e tolleranze: concetti.

synchronizer.tolerations.key Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

key identifica i pod a cui è possibile applicare la tolleranza.

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

synchronizer.tolerations.operator Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

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

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

synchronizer.tolerations.tolerationSeconds Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

synchronizer.tolerations.value Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

udca

(Universal Data Collection Agent) Definisce il servizio eseguito all'interno del pod di raccolta dati nel piano di runtime. Questo servizio estrae i dati di analisi e sullo stato del deployment e li invia alla piattaforma UAP (Unified Analytics Platform).

Per ulteriori informazioni, consulta Raccolta dei dati sullo stato di analisi e deployment.

Nella tabella seguente vengono descritte le proprietà dell'oggetto udca:

Proprietà Tipo Descrizione
udca.annotations Avanzata Introdotta nella versione: 1.5.0

Valore predefinito: nessuno

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

udca.fluentd.image.pullPolicy Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta la sezione Aggiornare le immagini.

udca.fluentd.image.tag Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1.9.12-2

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

udca.fluentd.image.url Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: gcr.io/apigee-release/hybrid/apigee-stackdriver-logging-agent

La posizione dell'immagine Docker per questo servizio.

udca.fluentd.resources.limits.cpu Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: 1000m

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

udca.fluentd.resources.limits.memory Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: 500Mi

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

udca.fluentd.resources.requests.cpu Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 500m

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

udca.fluentd.resources.requests.memory Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 250Mi

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

udca.gsa Avanzata Presentata nella versione: 1.10.0

Valore predefinito: nessuno

Solo Helm: l'indirizzo email dell'account di servizio Google IAM (GSA) apigee-udca di Google da associare all'account di servizio Kubernetes corrispondente quando abiliti Workload Identity sui cluster GKE utilizzando i grafici Helm. Imposta questa opzione se hai impostato gcp.workloadIdentity.enabled su true.

In genere, gli indirizzi email di Gboard sono nel formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

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

Consulta Attivazione di Workload Identity su GKE o Abilitare la federazione delle identità per i carichi di lavoro su AKS ed EKS.

udca.image.pullPolicy Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta la sezione Aggiornare le immagini.

udca.image.tag Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1.12.0-hotfix.1

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

udca.image.url Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Usa apigee-pull-push --list per vedere l'URL del repository attuale per questo componente.

udca.jvmXms Avanzata Introdotta nella versione: 1.0.0

Deprecated: a partire dalla versione ibrida 1.8, udca.jvmXms non viene più utilizzato.

udca.jvmXmx Avanzata Introdotta nella versione: 1.0.0

Deprecated: a partire dalla versione ibrida 1.8, udca.jvmXmx non viene più utilizzato.

udca.livenessProbe.failureThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 2

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.

udca.livenessProbe.initialDelaySeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 0

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

udca.livenessProbe.periodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 5

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

udca.livenessProbe.timeoutSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1

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

udca.nodeSelector.key Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

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

Consulta Configurazione di pool di nodi dedicati.

udca.nodeSelector.value Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

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

Consulta Configurazione di pool di nodi dedicati.

udca.pollingIntervalInSec Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1

Il tempo, in secondi, durante il quale l'UDCA attende tra le operazioni di polling. UDCA esegue il polling della directory dei dati sul file system del pod di raccolta dati per rilevare nuovi file da caricare.

udca.replicaCountMax Base Introdotta nella versione: 1.0.0

Valore predefinito: 4

Il numero massimo di pod che un ibrido può aggiungere automaticamente per il deployment UDCA. Poiché l'UDCA è implementata come ReplicaSet, i pod sono repliche.

Ti consigliamo di impostare udca.replicaCountMax su un numero massimo di repliche per ambiente moltiplicato per il numero di ambienti nella tua organizzazione Apigee. Ad esempio, se vuoi consentire al massimo 4 repliche per ambiente e disponi di 3 ambienti, imposta udca.replicaCountMax: 12.

udca.replicaCountMin Base Introdotta nella versione: 1.0.0

Valore predefinito: 1

Il numero minimo di pod per il deployment UDCA. Poiché l'UDCA è implementato come ReplicaSet, i pod sono repliche.

Se l'utilizzo della CPU supera udca.targetCPUUtilizationPercentage, il modello ibrido aumenterà gradualmente il numero di pod, fino a udca.replicaCountMax.

udca.resources.limits.cpu Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: 1000m

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

udca.resources.limits.memory Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: 2Gi

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

udca.resources.requests.cpu Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 250m

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

udca.resources.requests.memory Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 250Mi

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

udca.revision Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: v1

Valore statico compilato in un'etichetta per abilitare i deployment canary.

udca.serviceAccountPath Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

È obbligatorio specificare il valore serviceAccountPath o serviceAccountRef.

Percorso al file chiave dell'account di servizio Google con il ruolo Agente di analisi Apigee.

udca.serviceAccountRef Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare il valore serviceAccountPath o serviceAccountRef.

udca.targetCPUUtilizationPercentage Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 75

La soglia di utilizzo della CPU per la scalabilità del numero di pod nel ReplicaSet, come percentuale delle risorse totali disponibili della CPU. L'uso ibrido utilizza l'utilizzo combinato di tutti i container nel pod di raccolta dati (sia fluente che UDCA) per calcolare l'utilizzo attuale.

Quando l'utilizzo della CPU supera questo valore, il modello ibrido aumenta gradualmente il numero di pod in ReplicaSet fino a udca.replicaCountMax.

udca.terminationGracePeriodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 600

Il tempo in secondi che intercorre tra una richiesta di eliminazione di pod e la sua terminazione. Durante questo periodo, verranno eseguiti tutti gli eventuali hook prestop e qualsiasi processo in esecuzione dovrebbe terminare in modo controllato.

udca.tolerations.effect Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Richiesto per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

effect specifica l'effetto che ha la corrispondenza di una tolleranza con un'incompatibilità. I valori di effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta la sezione Incompatibilità e tolleranze: concetti.

udca.tolerations.key Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

key identifica i pod a cui è possibile applicare la tolleranza.

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

udca.tolerations.operator Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

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

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

udca.tolerations.tolerationSeconds Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

udca.tolerations.value Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

virtualhosts

La proprietà virtualhosts è una proprietà di configurazione obbligatoria. Gli host virtuali consentono ad Apigee hybrid di gestire le richieste API a uno specifico gruppo di ambienti.

Per ulteriori informazioni, vedi Configurare gli host virtuali.

Nella tabella seguente vengono descritte le proprietà dell'oggetto virtualhosts:

Proprietà Tipo Descrizione
virtualhosts[].additionalGateways Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

Un elenco di gateway Istio a cui instradare il traffico.

virtualhosts[].cipherSuites[] Avanzata Introdotta nella versione: 1.9.2

Valore predefinito: nessuno

L'elenco di crittografie TLS. Puoi trovare l'elenco completo delle crittografie supportate nella documentazione per la build FIPS Boring di Envoy. Se non viene specificato, il valore predefinito corrisponde alle suite di crittografia supportate dalla build FIPS Boring di Envoy.

Ad esempio, per supportare 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 Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

Obbligatorio

Il nome dell'host virtuale.

virtualhosts[].maxTLSProtocolVersion Base Introdotta nella versione: 1.3.0

Valore predefinito: nessuno

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 sotto forma di numero. Ad esempio:

virtualhosts:
  - name: default
    maxTLSProtocolVersion: "1.3"

Dove il numero rappresenta il numero di versione TLS nel formato #.#. Nell'esempio precedente, "1.3" rappresenta la versione TLSV1_3 di Istio TLS.

Vedi anche ServerTLSSettings.TLSProtocol nella documentazione di Istio.

virtualhosts[].minTLSProtocolVersion Base Introdotta nella versione: 1.3.0

Valore predefinito: nessuno

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 sotto forma di numero. Ad esempio:

virtualhosts:
  - name: default
    minTLSProtocolVersion: "1.2"

Dove il numero rappresenta il numero di versione TLS nel formato #.#. Nell'esempio precedente, 1.2 rappresenta la versione TLSV1_2 di Istio TLS.

Vedi anche ServerTLSSettings.TLSProtocol nella documentazione di Istio.

virtualhosts[].selector Base Introdotta nella versione: 1.2.0

Valore predefinito: app: apigee-ingressgateway

Obbligatorio

Una coppia chiave-valore-selettore per puntare a diversi selettori in entrata.

  • apigee-ingressgateway: per le installazioni ibride di Apigee che utilizzano il gateway in entrata Apigee.
  • istio-ingressgateway: per le installazioni ibride di Apigee che utilizzano Anthos Service Mesh (Apigee ibride versioni 1.8 e precedenti).

Se non viene fornita un'etichetta del selettore, la configurazione viene fornita al gateway in entrata Apigee.

virtualhosts[].sslCertPath Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

Il percorso sul sistema di un file di certificato TLS.

virtualhosts[].sslKeyPath Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

Il percorso sul sistema del file della chiave privata TLS.

virtualhosts[].sslSecret Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È 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 il certificato TLS e i dati della chiave come input.

Vedi anche:

watcher

La proprietà watcher è una proprietà di configurazione obbligatoria. L'osservatore è un processo che monitora le modifiche alla configurazione e attiva l'applicazione sul piano di runtime.

Nella tabella seguente vengono descritte le proprietà dell'oggetto watcher:

Proprietà Tipo Descrizione
watcher.annotations Avanzata Introdotta nella versione: 1.5.0

Valore predefinito: nessuno

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

watcher.args.enableIssueScanning Avanzata Presentata nella versione: 1.10.0

Valore predefinito: true

Attiva o disattiva la visualizzazione automatica dei problemi. Quando true, Watcher analizza automaticamente il piano di controllo e lo stato del server API Kubernetes per determinare se ci sono problemi di configurazione.

Imposta su false per disattivare la visualizzazione automatica dei problemi. Per maggiori informazioni, consulta la pagina Creazione automatica dei problemi.

watcher.args.issueScanInterval Avanzata Presentata nella versione: 1.10.0

Valore predefinito: 60

L'intervallo in secondi per la frequenza con cui Watcher analizza il piano di runtime per rilevare automaticamente i problemi. Per maggiori informazioni, consulta la pagina Creazione automatica dei problemi.

watcher.gsa Avanzata Presentata nella versione: 1.10.0

Valore predefinito: nessuno

Solo Helm: l'indirizzo email dell'account di servizio Google IAM (GSA) apigee-watcher di Google da associare all'account di servizio Kubernetes corrispondente quando abiliti Workload Identity sui cluster GKE utilizzando i grafici Helm. Imposta questa opzione se hai impostato gcp.workloadIdentity.enabled su true.

In genere, gli indirizzi email di Gboard sono nel formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

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

Consulta Attivazione di Workload Identity su GKE o Abilitare la federazione delle identità per i carichi di lavoro su AKS ed EKS.

watcher.image.pullPolicy Avanzata Introdotta nella versione: 1.4.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta la sezione Aggiornare le immagini.

watcher.image.tag Avanzata Introdotta nella versione: 1.4.0

Valore predefinito: 1.12.0-hotfix.1

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

watcher.image.url Avanzata Introdotta nella versione: 1.4.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Usa apigee-pull-push --list per vedere l'URL del repository attuale per questo componente.

watcher.replicaCountMax Base Introdotta nella versione: 1.3.0

Valore predefinito: 1

Il numero massimo di repliche di watcher. Questo valore deve essere mantenuto su 1 per evitare conflitti.

watcher.replicaCountMin Base Introdotta nella versione: 1.3.0

Valore predefinito: 1

Il numero minimo di repliche di watcher.

watcher.resources.limits.cpu Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: 1000m

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

watcher.resources.limits.memory Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: 2Gi

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

watcher.serviceAccountPath Base Introdotta nella versione: 1.3.0

Valore predefinito: nessuno

Obbligatorio.

Percorso del file chiave dell'account di servizio Google con ruolo Agente di runtime Apigee.

watcher.serviceAccountRef Avanzata Introdotta nella versione: 1.3.0

Valore predefinito: nessuno

È obbligatorio specificare serviceAccountPath o serviceAccountRef.

watcher.tolerations.effect Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Richiesto per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

effect specifica l'effetto che ha la corrispondenza di una tolleranza con un'incompatibilità. I valori di effect possono essere:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta la sezione Incompatibilità e tolleranze: concetti.

watcher.tolerations.key Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

key identifica i pod a cui è possibile applicare la tolleranza.

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

watcher.tolerations.operator Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

Necessaria per utilizzare la funzionalità Incompatibilità e tolleranze di Kubernetes.

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

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

watcher.tolerations.tolerationSeconds Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.

watcher.tolerations.value Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Incompatibilità e tolleranze di Kubernetes.

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

Per i dettagli, consulta Incompatibilità e tolleranze: concetti.