Riferimento per le proprietà di configurazione

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

Filtra questa pagina

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

Display   proprietà di configurazione in questa pagina.

Proprietà di primo livello

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

Proprietà Tipo Descrizione
axHashSalt Avanzato

Introdotto nella versione: 1.3.0

Valore predefinito: iloveapis123

Optional

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

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

Vedi: Offuscare i dati utente per l'analisi.
contractProvider Avanzato Introdotto nella versione: 1.0.0

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

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

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

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

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

Ad esempio:

contractProvider: https://us-apigee.googleapis.com
gcpProjectID Avanzato Deprecated: Per la versione 1.2.0 e successive, utilizza gcp.projectID.

Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

ID del tuo progetto Google Cloud. Funziona con k8sClusterName (ritirato) e gcpRegion (ritirato) per identificare il progetto e determinare dove apigee-logger e apigee-metrics inseriscono i dati.
gcpRegion Avanzato Deprecated: Per la versione 1.2.0 e successive, utilizza gcp.region.

Introdotto nella versione: 1.0.0

Valore predefinito: us-central1

Obbligatorio

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

Valore predefinito: nessuno

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

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

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

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

hub: private-docker-host.example.com

come:

## an example of internal component vs 3rd party
containers:
- name: apigee-udca
  image: private-docker-host.example.com/apigee-udca:1.13.4
  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 un pattern simile.

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

Consulta Utilizzare un repository di immagini privato con Apigee hybrid.

Puoi ignorare l'URL dell'immagine per i singoli componenti con le seguenti proprietà:
imagePullSecrets.name Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Nome del secret Kubernetes configurato come tipo docker-registry; utilizzato per eseguire il pull delle immagini dal repository privato.
instanceID Di base Introdotto nella versione: 1.3.0

Valore predefinito: nessuno

Obbligatorio

Un identificatore univoco per questa installazione.

Una stringa univoca per identificare questa istanza. Può essere una combinazione qualsiasi di lettere e numeri fino a 63 caratteri.
k8sClusterName Avanzato Deprecated: Per la versione 1.2.0 e successive, utilizza k8sCluster.name e k8sCluster.region.

Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Nome del progetto Kubernetes (K8S) in cui è in esecuzione il progetto ibrido. Funziona con gcpProjectID (ritirato) e gcpRegion (ritirato) per identificare il progetto e determinare dove apigee-logger e apigee-metrics inviano i dati.
kmsEncryptionKey Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: defaults.org.kmsEncryptionKey

(Facoltativo) Utilizza solo uno tra kmsEncryptionKey, kmsEncryptionPath o kmsEncryptionSecret.

Percorso del file system locale per la chiave di crittografia dei dati KMS di Apigee.
kmsEncryptionPath Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

(Facoltativo) Utilizza solo uno tra kmsEncryptionKey, kmsEncryptionPath o kmsEncryptionSecret.

Il percorso di un file contenente una chiave di crittografia codificata in Base64. Vedi Crittografia dei dati.
kmsEncryptionSecret.key Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

(Facoltativo) Utilizza solo uno tra kmsEncryptionKey, kmsEncryptionPath o kmsEncryptionSecret.

La chiave di un secret Kubernetes contenente una chiave di crittografia con codifica Base64. Vedi Crittografia dei dati.
kmsEncryptionSecret.name Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

(Facoltativo) Utilizza solo uno tra kmsEncryptionKey, kmsEncryptionPath o kmsEncryptionSecret.

Il nome di un secret Kubernetes contenente una chiave di crittografia con codifica Base64. Vedi Crittografia dei dati.
kvmEncryptionKey Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: defaults.org.kmsEncryptionKey

(Facoltativo) Utilizza solo uno tra kvmEncryptionKey, kvmEncryptionPath o kvmEncryptionSecret.

Percorso del file system locale per la chiave di crittografia dei dati KVM di Apigee.
kvmEncryptionPath Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

(Facoltativo) Utilizza solo uno tra kvmEncryptionKey, kvmEncryptionPath o kvmEncryptionSecret.

Il percorso di un file contenente una chiave di crittografia codificata in Base64. Vedi Crittografia dei dati.
kvmEncryptionSecret.key Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

(Facoltativo) Utilizza solo uno tra kvmEncryptionKey, kvmEncryptionPath o kvmEncryptionSecret.

La chiave di un secret Kubernetes contenente una chiave di crittografia con codifica Base64. Vedi Crittografia dei dati.
kvmEncryptionSecret.name Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

(Facoltativo) Utilizza solo uno tra kvmEncryptionKey, kvmEncryptionPath o kvmEncryptionSecret.

Il nome di un secret Kubernetes contenente una chiave di crittografia con codifica Base64. Vedi Crittografia dei dati.
multiOrgCluster Avanzato Introdotto nella versione: 1.10.0

Valore predefinito: false

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

namespace Di base Introdotto nella versione: 1.0.0

Valore predefinito: apigee

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

Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

L'organizzazione abilitata all'ibrido di cui è stato eseguito il provisioning per te da Apigee durante l'installazione ibrida. Un'organizzazione è il contenitore di primo livello in Apigee. Contiene tutti i tuoi proxy API e le risorse correlate. Se il valore è vuoto, devi aggiornarlo con il nome della tua organizzazione una volta creato.
orgScopedUDCA Avanzato Introdotto nella versione: 1.8.0

Valore predefinito: true

Attiva il servizio Universal Data Collection Agent (UDCA) a livello di organizzazione, che estrae analisi, monetizzazione e debug (traccia) e li invia alla Unified Analytics Platform (UAP) che risiede nel Control Plane.

L'UDCA con ambito organizzativo utilizza un singolo account di servizio Google per tutti gli ambienti Apigee. Il account di servizio deve disporre del ruolo Agente Apigee Analytics (roles/apigee.analyticsAgent).

Specifica il percorso del file della chiave dell'account di servizio con la proprietà udca.serviceAccountPath o 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 i valori per envs[].serviceAccountPaths.udca e envs[].serviceAccountSecretRefs.udca.

Vedi anche: udca.

revision Avanzato Introdotto nella versione: 1.0.0

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

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

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

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

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

Per ulteriori informazioni, vedi Aggiornamenti continui.
serviceAccountSecretProviderClass Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: nessuno

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

Consulta Memorizzare le chiavi del account di servizio in Hashicorp Vault.

validateOrg Avanzato Introdotto nella versione: 1.8.0

Valore predefinito: true

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

Vedi anche org

validateServiceAccounts Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: true

Attiva la convalida rigorosa delle autorizzazioni dell'account di servizio. Questo metodo API utilizza Cloud Resource Manager testIamPermissions per verificare che il account di servizio fornito disponga delle autorizzazioni necessarie. Nel caso di service account per un'organizzazione Apigee, il controllo dell'ID progetto è quello mappato all'organizzazione. Per Metriche e Logger, il progetto selezionato si basa sulla configurazione gcpProjectID overrides.yaml.

Vedi anche gcpProjectID

ao

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

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

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

Valore predefinito: true

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

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

Valore predefinito: true

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

ao.image.pullPolicy Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, vedi Aggiornare le immagini.
ao.image.tag Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: 1.13.4

L'etichetta della versione per l'immagine Docker di questo servizio.
ao.image.url Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository attuale per questo componente.
ao.resources.limits.cpu Avanzato Introdotto 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 Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: 256Mi

Il limite di memoria per la risorsa in un container Kubernetes, in mebibyte.
ao.resources.requests.cpu Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: 250m

La CPU necessaria per il normale funzionamento della risorsa in un container Kubernetes, in millicore.
ao.resources.requests.memory Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: 256Mi

La memoria necessaria per il normale funzionamento della risorsa in un container Kubernetes, in mebibyte.
ao.tolerations.effect Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta Taint e tolleranze: concetti.
ao.tolerations.key Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
ao.tolerations.operator Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: "Equal"

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
ao.tolerations.tolerationSeconds Avanzato Introdotto 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 non riuscito o che non risponde.

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
ao.tolerations.value Avanzato Introdotto 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 maggiori dettagli, consulta Taints e tolleranze: concetti.

apigeeIngressGateway

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

Consulta ingressGateways per configurare le singole istanze in modo univoco.

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

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

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

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, vedi Aggiornare le immagini.
apigeeIngressGateway.image.tag Avanzato Introdotto 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 Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository attuale per questo componente.
apigeeIngressGateway.nodeSelector.key Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: nessuno

Obbligatorio

Chiave dell'etichetta del selettore di nodi utilizzata per il targeting dei nodi Kubernetes dedicati per i servizi di gateway Ingress.

Consulta Configurazione dei pool di nodi dedicati.
apigeeIngressGateway.nodeSelector.value Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: nessuno

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

Vedi nodeSelector.
apigeeIngressGateway.replicaCountMax Di base Introdotto nella versione: 1.11.0

Valore predefinito: 4

Il numero massimo di pod che ibrido può aggiungere automaticamente per il gateway in entrata disponibile per la scalabilità automatica.
apigeeIngressGateway.replicaCountMin Di base Introdotto nella versione: 1.11.0

Valore predefinito: 2

Il numero minimo di pod per il gateway in entrata disponibile per la scalabilità automatica.
apigeeIngressGateway.targetCPUUtilizationPercentage Avanzato Introdotto nella versione: 1.10.5, 1.11.2, 1.12.1

Valore predefinito: 75

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

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

Per saperne di più sulla scalabilità in Kubernetes, consulta Scalabilità automatica pod orizzontale nella documentazione di Kubernetes.

apigeeIngressGateway.tolerations.effect Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: nessuno

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

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta Taint e tolleranze: concetti.
apigeeIngressGateway.tolerations.key Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: nessuno

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
apigeeIngressGateway.tolerations.operator Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: "Equal"

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
apigeeIngressGateway.tolerations.tolerationSeconds Avanzato Introdotto 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 non riuscito o che non risponde.

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
apigeeIngressGateway.tolerations.value Avanzato Introdotto 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 maggiori dettagli, consulta Taints e tolleranze: concetti.

cassandra

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

Per maggiori informazioni, vedi Configurazione di StorageClass.

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

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

Valore predefinito: nessuno

Mappa chiave/valore facoltativa utilizzata per annotare i pod. Per ulteriori informazioni, consulta la sezione Annotazioni personalizzate.
cassandra.auth.admin.password Di base Introdotto nella versione: 1.0.0

Valore predefinito: iloveapis123

Obbligatorio

Password dell'amministratore Cassandra. L'utente amministratore viene utilizzato per qualsiasi attività amministrativa eseguita sul cluster Cassandra, come il backup e il ripristino.
cassandra.auth.ddl.password Di base Introdotto nella versione: 1.0.0

Valore predefinito: iloveapis123

Obbligatorio

Password per l'utente DDL (Data Definition Language) di Cassandra. Utilizzato da MART per qualsiasi attività di definizione dei dati, come la creazione, l'aggiornamento e l'eliminazione di keyspace.
cassandra.auth.default.password Di base Introdotto 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. Consulta Configurazione di TLS per Cassandra.
cassandra.auth.dml.password Di base Introdotto nella versione: 1.0.0

Valore predefinito: iloveapis123

Obbligatorio

Password per l'utente Cassandra Data Manipulation Language (DML). L'utente DML viene utilizzato dalla comunicazione client per leggere e scrivere dati in Cassandra.
cassandra.auth.image.pullPolicy Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, vedi Aggiornare le immagini.
cassandra.auth.image.tag Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1.13.4

L'etichetta della versione per l'immagine Docker di questo servizio.
cassandra.auth.image.url Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository attuale per questo componente.
cassandra.auth.jmx.password Di base Introdotto 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 Di base Introdotto 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 Di base Introdotto nella versione: 1.4.0

Valore predefinito: iloveapis123

Obbligatorio

Password per l'utente delle operazioni JMX di Cassandra Jolokia. Utilizzato per autenticare e comunicare con l'API JMX di Cassandra.
cassandra.auth.jolokia.username Di base Introdotto nella versione: 1.4.0

Valore predefinito: apigee

Obbligatorio

Nome utente per l'utente delle operazioni JMX di Cassandra Jolokia. Utilizzato per autenticare e comunicare con l'API JMX di Cassandra.
cassandra.auth.secret Di base Introdotto nella versione: 1.3.3

Valore predefinito: nessuno

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

Vedi anche:
cassandra.auth.secretProviderClass Avanzato Introdotto nella versione: 1.10.3

Valore predefinito: nessuno

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

o il secret Kubernetes archiviato in:

Per istruzioni su come creare il criterio, consulta Memorizzazione dei secret di Cassandra in Hashicorp Vault.
cassandra.backup.cloudProvider Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: GCP

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

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

Valore predefinito: nessuno

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

Il nome di un bucket Google Cloud Storage esistente che verrà utilizzato per archiviare gli archivi di backup. Consulta Creazione di bucket se devi crearne uno.
cassandra.backup.enabled Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: false

Il backup dei dati non è abilitato per impostazione predefinita. Per attivarlo, imposta true.

Consulta Backup e ripristino di Cassandra.
cassandra.backup.image.pullPolicy Avanzato Introdotto 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 estrarre una nuova immagine se esiste già.
  • Always: esegue sempre il pull dell'immagine, indipendentemente dal fatto che esista già.

Per ulteriori informazioni, vedi Aggiornare le immagini.
cassandra.backup.image.tag Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1.13.4

L'etichetta della versione per l'immagine Docker di questo servizio.
cassandra.backup.image.url Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository attuale per questo componente.
cassandra.backup.keyfile Avanzato Introdotto nella versione: 1.3.0

Valore predefinito: nessuno

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

Il percorso nel file system locale del file della chiave privata SSH.
cassandra.backup.schedule Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 0 2 * * *

La pianificazione del cron job di backup.

Consulta Backup e ripristino di Cassandra.
cassandra.backup.server Avanzato Introdotto nella versione: 1.3.0

Valore predefinito: nessuno

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

L'indirizzo IP del server di backup SSH remoto.
cassandra.backup.serviceAccountPath Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

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

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

cassandra.backup.serviceAccountRef Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

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

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

cassandra.backup.storageDirectory Avanzato Introdotto nella versione: 1.3.0

Valore predefinito: nessuno

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

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

Il nome della directory di backup sul server SSH di backup.
cassandra.clusterName Di base Introdotto nella versione: 1.0.0

Valore predefinito: apigeecluster

Specifica il nome del cluster Cassandra.
cassandra.datacenter Di base Introdotto nella versione: 1.0.0

Valore predefinito: dc-1

Specifica il data center del nodo Cassandra.
cassandra.dnsPolicy Di base Introdotto nella versione: 1.1.1

Valore predefinito: nessuno

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

cassandra.externalSeedHost Di base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Nome host o IP di un nodo del cluster Cassandra. Se non impostato, viene utilizzato il servizio locale Kubernetes.
cassandra.heapNewSize Di base Introdotto nella versione: 1.0.0

Valore predefinito: 100M

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

cassandra.hostNetwork Di base Introdotto nella versione: 1.1.1

Valore predefinito: false

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

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

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

Quando true, il criterio DNS viene impostato automaticamente su ClusterFirstWithHostNet.
cassandra.image.pullPolicy Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, vedi Aggiornare le immagini.
cassandra.image.tag Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1.13.4

L'etichetta della versione per l'immagine Docker di questo servizio.
cassandra.image.url Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository attuale per questo componente.
cassandra.maxHeapSize Avanzato Introdotto 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 Di base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

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

cassandra.nodeSelector.key Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

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

Consulta Configurazione dei pool di nodi dedicati.
cassandra.nodeSelector.value Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

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

Vedi nodeSelector.
cassandra.port Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 9042

Numero di porta utilizzato per connettersi a Cassandra.
cassandra.rack Di base Introdotto nella versione: 1.0.0

Valore predefinito: ra-1

Specifica il rack del nodo Cassandra.
cassandra.readinessProbe.failureThreshold Avanzato Introdotto 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 Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 0

Il numero di secondi dopo l'avvio di un container prima dell'avvio di un probe di idoneità.
cassandra.readinessProbe.periodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 10

Determina la frequenza di esecuzione di un probe di preparazione, in secondi. Il valore minimo è 1.
cassandra.readinessProbe.successThreshold Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1

Il numero minimo di esecuzioni riuscite consecutive necessarie per considerare riuscita una sonda di idoneità dopo un errore. Il valore minimo è 1.
cassandra.readinessProbe.timeoutSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 5

Il numero di secondi dopo i quali un probe di attività va in timeout. Il valore minimo è 1.
cassandra.replicaCount Di base Introdotto 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 Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 500m

La CPU necessaria per il normale funzionamento della risorsa in un container Kubernetes, in millicore.
cassandra.resources.requests.memory Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1Gi

La memoria necessaria per il normale funzionamento della risorsa in un container Kubernetes, in mebibyte.
cassandra.restore.cloudProvider Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: GCP

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

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

Valore predefinito: nessuno

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

Il nome di un bucket Google Cloud Storage che archivia gli archivi di backup da utilizzare per il ripristino dei dati.
cassandra.restore.enabled Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: false

Il ripristino dei dati non è abilitato per impostazione predefinita. Per attivarlo, imposta true.

Consulta Backup e ripristino di Cassandra.
cassandra.restore.image.pullPolicy Avanzato Introdotto 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 estrarre una nuova immagine se esiste già.
  • Always: esegue sempre il pull dell'immagine, indipendentemente dal fatto che esista già.

Per ulteriori informazioni, vedi Aggiornare le immagini.
cassandra.restore.image.tag Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1.13.4

L'etichetta della versione per l'immagine Docker di questo servizio.
cassandra.restore.image.url Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository attuale per questo componente.
cassandra.restore.serviceAccountPath Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

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

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

cassandra.restore.serviceAccountRef Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

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

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

cassandra.restore.snapshotTimestamp Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio se il ripristino è attivato.

Timestamp del backup da ripristinare.
cassandra.sslCertPath Di base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Il percorso sul tuo sistema di un file di certificato TLS.
cassandra.sslKeyPath Di base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Il percorso sul tuo sistema del file della chiave privata TLS.
cassandra.sslRootCAPath Di base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

La catena di certificati all'autorità di certificazione (CA) radice.
cassandra.storage.capacity Di base Introdotto nella versione: 1.0.0

Valore predefinito: 10Gi

Obbligatorio se storage.storageclass è specificato

Specifica le dimensioni del disco richieste, in mebibyte (Mi) o gibibyte (Gi).
cassandra.storage.storageclass Di base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Specifica la classe di archiviazione on-premise utilizzata.
cassandra.storage.storageSize Di base Introdotto nella versione: 1.11.0

Valore predefinito: 10Gi

Obbligatorio se storage.storageclass è specificato

Specifica le dimensioni del disco richieste, in mebibyte (Mi) o gibibyte (Gi).
cassandra.terminationGracePeriodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 300

Il tempo che intercorre tra una richiesta di eliminazione del pod e l'eliminazione del pod, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop e tutti i processi in esecuzione verranno terminati in modo controllato.
cassandra.tolerations.effect Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta Taint e tolleranze: concetti.
cassandra.tolerations.key Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
cassandra.tolerations.operator Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: "Equal"

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
cassandra.tolerations.tolerationSeconds Avanzato Introdotto 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 non riuscito o che non risponde.

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
cassandra.tolerations.value Avanzato Introdotto 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 maggiori dettagli, consulta Taints e tolleranze: concetti.

certManager

Apigee utilizza cert-manager per la convalida dei certificati.

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

Proprietà Tipo Descrizione
certManager.namespace Avanzato Introdotto nella versione: 1.9.0

Valore predefinito: cert-manager

Lo spazio dei nomi per cert-manager.

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

connectAgent

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

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

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

Valore predefinito: nessuno

Mappa chiave/valore facoltativa utilizzata per annotare i pod. Per ulteriori informazioni, consulta la sezione Annotazioni personalizzate.
connectAgent.gsa Avanzato Introdotto nella versione: 1.10.0

Valore predefinito: nessuno

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

In genere, gli indirizzi email di GSA hanno il seguente formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

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

Consulta Abilitare Workload Identity su GKE o Abilitare la federazione delle identità per i carichi di lavoro su AKS ed EKS.
connectAgent.logLevel Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: INFO

Il livello di generazione dei report dei log. I valori possibili sono:

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

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, vedi Aggiornare le immagini.
connectAgent.image.tag Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: 1.13.4

L'etichetta della versione per l'immagine Docker di questo servizio.
connectAgent.image.url Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository attuale per questo componente.
connectAgent.replicaCountMax Di base Introdotto nella versione: 1.2.0

Valore predefinito: 5

Numero massimo di repliche disponibili per la scalabilità automatica.
connectAgent.replicaCountMin Di base Introdotto nella versione: 1.2.0

Valore predefinito: 1

Numero minimo di repliche disponibili per la scalabilità automatica.

In produzione, potresti voler aumentare replicaCountMin a 1 per avere un numero maggiore di connessioni al control plane per affidabilità e scalabilità.
connectAgent.resources.limits.cpu Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 512m

Il limite di CPU per la risorsa in un container Kubernetes, in millicore.
connectAgent.resources.limits.memory Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 512Mi

Il limite di memoria per la risorsa in un container Kubernetes, in mebibyte.
connectAgent.resources.requests.cpu Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 100m

La CPU necessaria per il normale funzionamento della risorsa in un container Kubernetes, in millicore.
connectAgent.resources.requests.memory Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: 30Mi

La memoria necessaria per il normale funzionamento della risorsa in un container Kubernetes, in mebibyte.
connectAgent.server Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: apigeeconnect.googleapis.com:443

La posizione del server e della porta per questo servizio.
connectAgent.serviceAccountPath Di base Introdotto nella versione: 1.1.1

Valore predefinito: nessuno

È obbligatorio specificare 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 Di base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare serviceAccountPath o serviceAccountRef.

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

connectAgent.targetCPUUtilizationPercentage Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: 75

Utilizzo CPU target per l'agente Apigee Connect sul pod. Il valore di questo campo consente a Apigee Connect di scalare automaticamente quando l'utilizzo della CPU raggiunge questo valore, fino a replicaCountMax.
connectAgent.terminationGracePeriodSeconds Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: 600

Il tempo che intercorre tra una richiesta di eliminazione del pod e l'eliminazione del pod, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop e tutti i processi in esecuzione verranno terminati in modo controllato.
connectAgent.tolerations.effect Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta Taint e tolleranze: concetti.
connectAgent.tolerations.key Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
connectAgent.tolerations.operator Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: "Equal"

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
connectAgent.tolerations.tolerationSeconds Avanzato Introdotto 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 non riuscito o che non risponde.

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
connectAgent.tolerations.value Avanzato Introdotto 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 maggiori dettagli, consulta Taints e tolleranze: concetti.

defaults

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

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

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

Valore predefinito: aWxvdmVhcGlzMTIzNDU2Nw==

Chiave di crittografia predefinita per l'organizzazione in KMS.

defaults.org.kvmEncryptionKey Di base Introdotto nella versione: 1.0.0

Valore predefinito: aWxvdmVhcGlzMTIzNDU2Nw==

Chiave di crittografia predefinita per l'organizzazione in KVM.

defaults.env.kmsEncryptionKey Di base Introdotto nella versione: 1.0.0

Valore predefinito: aWxvdmVhcGlzMTIzNDU2Nw==

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

defaults.env.kvmEncryptionKey Di base Introdotto nella versione: 1.0.0

Valore predefinito: aWxvdmVhcGlzMTIzNDU2Nw==

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

defaults.env.cacheEncryptionKey Di base Introdotto nella versione: 1.0.0

Valore predefinito: aWxvdmVhcGlzMTIzNDU2Nw==

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

diagnostic

Le impostazioni dello strumento di raccolta della diagnostica.

Vedi Utilizzo del raccoglitore Diagnostic

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

Proprietà Tipo Descrizione
diagnostic.bucket Di base Introdotto 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 Di base Introdotto nella versione: 1.6.0

Valore predefinito: nessuno

Obbligatorio

Specifica il tipo di pod da cui acquisisci i dati. I valori possono essere uno dei seguenti:

  • "apigee-cassandra" acquisisce i dati sul database Cassandra. I pod istio-cassandra vengono eseguiti nello spazio dei nomi apigee.
  • "apigee-mart-server" acquisisce i dati relativi a MART. I pod apigee-mart-server vengono eseguiti nello spazio dei nomi apigee.
  • "apigee-runtime" acquisisce i dati relativi al processore di messaggi. I pod apigee-runtime vengono eseguiti nello spazio dei nomi apigee.
  • "apigee-synchronizer" acquisisce dati sul sincronizzatore. I pod apigee-synchronizer vengono eseguiti nello spazio dei nomi apigee.
  • "apigee-udca" acquisisce i dati relativi all'UDCA. I pod apigee-udca vengono eseguiti nello spazio dei nomi apigee.
  • "apigee-watcher" acquisisce dati su Watcher. I pod apigee-watcher vengono eseguiti nello spazio dei nomi apigee.
  • "istio-proxy" acquisisce i dati sul gateway di ingresso Istio. I pod istio-proxy vengono eseguiti nello spazio dei nomi istio-system.
diagnostic.loggingDetails.logDuration Di base Introdotto nella versione: 1.6.0

Valore predefinito: nessuno

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

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

Leggi diagnostic.operation

diagnostic.loggingDetails.loggerNames[] Di base Introdotto nella versione: 1.6.0

Valore predefinito: nessuno

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

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

diagnostic:
 loggingDetails:
   loggerNames:
   - ALL
diagnostic.loggingDetails.logLevel Di base Introdotto nella versione: 1.6.0

Valore predefinito: nessuno

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

Specifica la granularità dei dati di logging da raccogliere. In Apigee hybrid 1.6, Only FINE is supported.
diagnostic.namespace Di base Introdotto nella versione: 1.6.0

Valore predefinito: nessuno

Obbligatorio

Lo spazio dei nomi Kubernetes in cui si trovano i pod su cui stai raccogliendo 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 Di base Introdotto nella versione: 1.6.0

Valore predefinito: nessuno

Obbligatorio

Specifica se raccogliere tutte le statistiche o solo i log.

I valori sono:
diagnostic.podNames[] Di base Introdotto 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 Di base Introdotto nella versione: 1.6.0

Valore predefinito: nessuno

Obbligatorio

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

Consulta Informazioni sui service account.
diagnostic.tcpDumpDetails.maxMsgs Di base Introdotto nella versione: 1.6.0

Valore predefinito: nessuno

Se utilizzi diagnostic.tcpDumpDetails, è obbligatorio specificare uno dei seguenti valori: diagnostic.tcpDumpDetails.maxMsgs o diagnostic.tcpDumpDetails.timeoutInSeconds.

Imposta il numero massimo di messaggi tcpDump da raccogliere. Apigee consiglia un valore massimo non superiore a 1000.
diagnostic.tcpDumpDetails.timeoutInSeconds Di base Introdotto nella versione: 1.6.0

Valore predefinito: nessuno

Se utilizzi diagnostic.tcpDumpDetails, è obbligatorio specificare uno dei seguenti valori: diagnostic.tcpDumpDetails.maxMsgs o diagnostic.tcpDumpDetails.timeoutInSeconds.

Imposta il tempo di attesa in secondi per la restituzione dei messaggi da parte di tcpDump.
diagnostic.threadDumpDetails.delayInSeconds Di base Introdotto 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 Di base Introdotto 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 di dump dei thread jstack da raccogliere.

envs

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

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

Per ulteriori informazioni, vedi Informazioni sugli ambienti.

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

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

Valore predefinito: nessuno

È obbligatorio specificare cacheEncryptionKey, cacheEncryptionPath o cacheEncryptionSecret.

Una chiave di crittografia codificata in base64. Vedi Crittografia dei dati.
envs[].cacheEncryptionPath Di base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare cacheEncryptionKey, cacheEncryptionPath o cacheEncryptionSecret.

Il percorso di un file contenente una chiave di crittografia codificata in Base64. Vedi Crittografia dei dati.
envs[].cacheEncryptionSecret.key Di base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare cacheEncryptionKey, cacheEncryptionPath o cacheEncryptionSecret.

La chiave di un secret Kubernetes contenente una chiave di crittografia con codifica Base64. Vedi Crittografia dei dati.
envs[].cacheEncryptionSecret.name Di base Introdotto 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. Vedi Crittografia dei dati.
envs[].components.runtime.replicaCountMax Di base Introdotto 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 Di base Introdotto 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 Di base Introdotto 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 Di base Introdotto 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 Di base Introdotto 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 Di base Introdotto 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 Avanzato Introdotto nella versione: 1.10.0

Valore predefinito: nessuno

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

Consulta Abilitare Workload Identity su GKE o Abilitare la federazione delle identità per i carichi di lavoro su AKS ed EKS.
envs.gsa.synchronizer Avanzato Introdotto nella versione: 1.10.0

Valore predefinito: nessuno

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

Consulta Abilitazione di Workload Identity su GKE o Abilitazione di Workload Identity Federation su AKS ed EKS.
envs.gsa.udca Avanzato Introdotto nella versione: 1.10.0

Valore predefinito: nessuno

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

Consulta Abilitazione di Workload Identity su GKE o Abilitazione di Workload Identity Federation su AKS ed EKS.
envs[].hostAliases[] Di base Introdotto 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 su ambienti e gruppi di ambienti.
envs[].httpProxy.host Di base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

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

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

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

Vedi anche: Configurare l'inoltro del proxy per i proxy API.
envs[].httpProxy.port Di base Introdotto 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 Di base Introdotto nella versione: 1.2.0

Valore predefinito: HTTPS

Specifica il tipo di proxy HTTP come HTTP o HTTPS. Per impostazione predefinita, utilizza HTTPS.
envs[].httpProxy.username Di base Introdotto 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 Di base Introdotto 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 Di base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

Nome dell'ambiente Apigee da sincronizzare.
envs[].pollInterval Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Intervallo utilizzato per il polling delle modifiche alla sincronizzazione dell'organizzazione e dell'ambiente, in secondi.
envs[].port Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Numero di porta TCP per il traffico HTTPS.
envs[].serviceAccountPaths.runtime Di base Introdotto 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 sezione Informazioni sui service account per i nomi predefiniti dei service account e i ruoli assegnati.
envs[].serviceAccountPaths.synchronizer Di base Introdotto nella versione: 1.0

Valore predefinito: nessuno

Percorso del file sul sistema locale di una chiave dell'account di servizio Google con il ruolo Apigee Synchronizer Manager.
envs[].serviceAccountPaths.udca Di base Introdotto nella versione: 1.0

Valore predefinito: nessuno

Percorso del file sul sistema locale di 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 Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: nessuno

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

Consulta Memorizzare le chiavi del account di servizio in Hashicorp Vault.

envs[].serviceAccountSecretRefs.runtime Di base Introdotto 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 Di base Introdotto 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 Apigee Synchronizer Manager come input.

envs[].serviceAccountSecretRefs.udca Di base Introdotto 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 Di base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

Il percorso sul tuo sistema di un file di certificato TLS.
envs[].sslKeyPath Di base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

Il percorso sul tuo sistema del file della chiave privata TLS.
envs[].sslSecret Di base Introdotto 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 i dati della chiave e del certificato TLS come input.

Vedi anche:

gcp

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

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

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

Valore predefinito: nessuno

Il pubblico consentito del provider di identità per i workload su piattaforme non GKE.

Consulta Abilitazione della federazione delle identità per i workload su AKS ed EKS.
gcp.federatedWorkloadIdentity.credentialSourceFile Di base Introdotto 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 workload per ottenere le credenziali per i service account. Questo è il valore che fornisci per credential-source-file quando configuri la federazione delle identità per i carichi di lavoro con il comando create-cred-config.

Consulta Abilitazione della federazione delle identità per i workload su AKS ed EKS.
gcp.federatedWorkloadIdentity.enabled Di base Introdotto nella versione: 1.12.0

Valore predefinito: false

Abilita la federazione delle identità per i carichi di lavoro su 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 workload su AKS ed EKS.
gcp.federatedWorkloadIdentity.tokenExpiration Di base Introdotto nella versione: 1.12.0

Valore predefinito: 3600

La durata del token in secondi.

Consulta Abilitazione della federazione delle identità per i workload su AKS ed EKS.
gcp.projectID Di base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Obbligatorio

Identifica il progetto Google Cloud in cui apigee-logger e apigee-metrics inviano i propri dati.
gcp.projectIDRuntime Di base Introdotto 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 il valore projectID venga utilizzato sia per il progetto Google Cloud dell'organizzazione Apigee sia per il progetto del cluster K8S di runtime.
gcp.region Di base Introdotto nella versione: 1.2.0

Valore predefinito: us-central1

Obbligatorio

Identifica la regione di Google Cloud in cui apigee-logger e apigee-metrics inviano i dati.
gcp.workloadIdentity.enabled Di base Introdotto nella versione: 1.10.0

Valore predefinito:false

Solo Helm: consente di utilizzare Workload Identity su GKE. Workload Identity consente ai carichi di lavoro nei cluster GKE di impersonare 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 di Apigee Hybrid. Consulta Informazioni sugli account di servizio.

Quando workloadIdentityEnabled è true, Apigee utilizza i service account Kubernetes e li mappa ai service account IAM appropriati per ogni componente. Specifica gli account di servizio IAM da mappare agli account di servizio Kubernetes con:
gcp.workloadIdentity.gsa Avanzato Introdotto nella versione: 1.10.0

Valore predefinito: nessuno

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

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

In genere, gli indirizzi email di GSA hanno il seguente 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 Di base Introdotto nella versione: 1.4.0

Valore predefinito:false

apigeectl solo: consente l'utilizzo di Workload Identity. Workload Identity consente ai carichi di lavoro nei cluster GKE di impersonare 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 di Apigee Hybrid. Consulta Informazioni sugli account di servizio.

Quando workloadIdentityEnabled è true, Apigee utilizza i service account Kubernetes anziché i service account 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, tutta la comunicazione internet per i componenti Apigee Connect, Logger, MART, Metrics, Synchronizer e UDCA passa attraverso il server proxy.

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

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

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

Valore predefinito: nessuno

Il nome host del proxy HTTP.
httpProxy.port Di base Introdotto nella versione: 1.1.1

Valore predefinito: nessuno

La porta del proxy HTTP.
httpProxy.scheme Di base Introdotto 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 Di base Introdotto 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 Di base Introdotto 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 in entrata Apigee. Utilizza queste proprietà quando vuoi gestire singole istanze separatamente per ingressGateways[].name.

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

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

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

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

Valore predefinito: nessuno

Obbligatorio

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

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

Per ulteriori informazioni, consulta DNS Subdomain Names nella documentazione di Kubernetes.

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

Valore predefinito: 2000m

Il limite CPU per la risorsa, in millicore.
ingressGateways[].resources.limits.memory Avanzato Introdotto nella versione: 1.8.0

Valore predefinito: 1Gi

Il limite di memoria per la risorsa, in mebibyte.
ingressGateways[].resources.requests.cpu Avanzato Introdotto nella versione: 1.8.0

Valore predefinito: 300m

La CPU necessaria per il normale funzionamento della risorsa, in millicore.
ingressGateways[].resources.requests.memory Avanzato Introdotto nella versione: 1.8.0

Valore predefinito: 128Mi

La memoria necessaria per il normale funzionamento della risorsa, in mebibyte.
ingressGateways[].replicaCountMax Di base Introdotto nella versione: 1.8.0

Valore predefinito: 10

Il numero massimo di pod che ibrido può aggiungere automaticamente per il gateway in entrata disponibile per la scalabilità automatica.
ingressGateways[].replicaCountMin Di base Introdotto 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 Di base Introdotto 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 Di base Introdotto nella versione: 1.8.0

Valore predefinito: nessuno

Sulle piattaforme che supportano la specifica dell'indirizzo IP del bilanciatore del carico, quest'ultimo verrà creato con questo indirizzo IP. Sulle piattaforme che non consentono di specificare l'indirizzo IP del bilanciatore del carico, questa proprietà viene ignorata.
ingressGateways[].svcType Di base Introdotto nella versione: 1.8.1

Valore predefinito: LoadBalancer

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

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

Valore predefinito: 75

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

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

Per saperne di più sulla scalabilità in Kubernetes, consulta Scalabilità automatica pod orizzontale nella documentazione di Kubernetes.

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

Valore predefinito: nessuno

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta Taint e tolleranze: concetti.
ingressGateways[].tolerations.key Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
ingressGateways[].tolerations.operator Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: "Equal"

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
ingressGateways[].tolerations.tolerationSeconds Avanzato Introdotto 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 non riuscito o che non risponde.

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
ingressGateways[].tolerations.value Avanzato Introdotto 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 maggiori dettagli, consulta Taints e tolleranze: concetti.

istiod

Configura l'ingresso Apigee.

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

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

Valore predefinito: /dev/stdout

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

Se questo valore non è definito, la registrazione degli accessi viene disattivata.
istiod.accessLogFormat Avanzato Introdotto nella versione: 1.8.0

Il formato del log di accesso in entrata.

Se questo valore non viene definito, viene utilizzato il formato predefinito del log di accesso 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 del log di accesso con interruzioni di riga aggiunte per una maggiore leggibilità. 

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

Valore predefinito: SANITIZE_SET

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

I valori possibili sono:

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

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

Se modifichi questa impostazione dopo aver installato Hybrid, applicala con apigeectl init e poi riavvia i pod del gateway in entrata Apigee.
istiod.healthCheckUserAgents Avanzato Introdotto nella versione: 1.12.0

Valori predefiniti: 

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

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

Per ignorare gli user agent predefiniti specificati, utilizza la seguente sintassi, inserendo gli user agent personalizzati: 

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

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

istiod:
  healthCheckUserAgents: []

istiod.image.pullPolicy Avanzato Introdotto nella versione: 1.8.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, vedi Aggiornare le immagini.
istiod.image.tag Avanzato Introdotto 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 Avanzato Introdotto nella versione: 1.8.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository attuale per questo componente.
istiod.tolerations.effect Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta Taint e tolleranze: concetti.
istiod.tolerations.key Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
istiod.tolerations.operator Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: "Equal"

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
istiod.tolerations.tolerationSeconds Avanzato Introdotto 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 non riuscito o che non risponde.

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
istiod.tolerations.value Avanzato Introdotto 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 maggiori dettagli, consulta Taints e tolleranze: concetti.

k8sCluster

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

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

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

Valore predefinito: nessuno

Il nome del cluster Kubernetes in cui è installato il runtime ibrido.
k8sCluster.region Di base Introdotto 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 basato sui ruoli di Kubernetes.

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

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

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, vedi Aggiornare le immagini.
kubeRBACProxy.image.tag Avanzato 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 Avanzato Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository attuale per questo componente.
kubeRBACProxy.resources.limits.cpu Avanzato Introdotto 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 Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 128Mi

Il limite di memoria per la risorsa in un container Kubernetes, in mebibyte.
kubeRBACProxy.resources.requests.cpu Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 5m

La CPU necessaria per il normale funzionamento della risorsa in un container Kubernetes, in millicore.
kubeRBACProxy.resources.requests.memory Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 64Mi

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

logger

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

Per ulteriori informazioni, consulta la panoramica di Logging.

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

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

Valore predefinito: nessuno

Mappa chiave/valore facoltativa utilizzata per annotare i pod. Per ulteriori informazioni, consulta la sezione Annotazioni personalizzate.
logger.bufferChunkSize Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 256 k

La dimensione iniziale del buffer per leggere i file di log.
logger.bufferMaxSize Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 104857600

Il limite delle dimensioni del buffer per file monitorato. I file che superano questo limite vengono rimossi dall'elenco dei file monitorati.
logger.bufferMemoryLimit Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 150 MB

Il limite di memoria che il logger può utilizzare. Se viene raggiunto, il logger interromperà momentaneamente la lettura di altri dati finché quelli esistenti non vengono svuotati dalla memoria.
logger.enabled Di base Introdotto nella versione: 1.0.0

Valore predefinito: false

Attiva o disattiva la registrazione nel cluster. Per GKE non impostato su true, per GKE su Google Cloud o Google Distributed Cloud impostato su false.
logger.envVars Di base Introdotto nella versione: 1.8.5

Valore predefinito: nessuno

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

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

ad esempio: 

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

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

Consulta NO_PROXY nella documentazione di Fluent Bit.
logger.flushInterval Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 1

L'intervallo di attesa prima di richiamare lo svuotamento del buffer successivo, in secondi.
logger.gsa Avanzato Introdotto nella versione: 1.10.0

Valore predefinito: nessuno

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

In genere, gli indirizzi email di GSA hanno il seguente formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

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

Consulta Abilitare Workload Identity su GKE o Abilitare la federazione delle identità per i carichi di lavoro su AKS ed EKS.
logger.image.pullPolicy Avanzato Introdotto 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 estrarre una nuova immagine se esiste già.
  • Always: esegue sempre il pull dell'immagine, indipendentemente dal fatto che esista già.

Per ulteriori informazioni, vedi Aggiornare le immagini.
logger.image.tag Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1.9.9

L'etichetta della versione per l'immagine Docker di questo servizio.
logger.image.url Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository attuale per questo componente.
logger.livenessProbe.failureThreshold Avanzato Introdotto 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 Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 0

Il numero di secondi dopo l'avvio di un container prima dell'avvio di un probe di attività.
logger.livenessProbe.periodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 60

Determina la frequenza di esecuzione di un probe di vivacità, in secondi. Il valore minimo è 1.
logger.livenessProbe.successThreshold Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1

Il numero minimo di operazioni riuscite consecutive necessario per considerare una sonda di attività riuscita dopo un errore. Il valore minimo è 1.
logger.livenessProbe.timeoutSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1

Il numero di secondi dopo i quali un probe di attività va in timeout. Il valore minimo è 1.
logger.nodeSelector.key Di base Introdotto nella versione: 1.0.0

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

Obbligatorio

Chiave dell'etichetta del selettore di nodi utilizzata per il targeting dei nodi Kubernetes dedicati per i servizi di runtime logger.

Consulta Configurazione dei pool di nodi dedicati.
logger.nodeSelector.value Di base Introdotto nella versione: 1.0.0

Valore predefinito: true

Obbligatorio

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

Consulta Configurazione dei pool di nodi dedicati.
logger.resources.limits.cpu Avanzato Introdotto 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 Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 500Mi

Il limite di memoria per la risorsa in un container Kubernetes, in mebibyte.
logger.resources.requests.cpu Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 100m

La CPU necessaria per il normale funzionamento della risorsa in un container Kubernetes, in millicore.
logger.resources.requests.memory Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 250Mi

La memoria necessaria per il normale funzionamento della risorsa in un container Kubernetes, in mebibyte.
logger.serviceAccountPath Di base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

È obbligatorio specificare un valore per serviceAccountPath o serviceAccountRef.

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

logger.serviceAccountRef Di base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare serviceAccountPath o serviceAccountRef.
logger.storageMaxChunks Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 128

Il numero massimo di blocchi che possono essere caricati in memoria. I blocchi che superano il limite verranno salvati nel file system.
logger.terminationGracePeriodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 30

Il tempo che intercorre tra una richiesta di eliminazione del pod e l'eliminazione del pod, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop e tutti i processi in esecuzione verranno terminati in modo controllato.
logger.tolerations.effect Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta Taint e tolleranze: concetti.
logger.tolerations.key Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
logger.tolerations.operator Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: "Equal"

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
logger.tolerations.tolerationSeconds Avanzato Introdotto 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 non riuscito o che non risponde.

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
logger.tolerations.value Avanzato Introdotto 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 maggiori dettagli, consulta Taints e tolleranze: concetti.

mart

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

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

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

Valore predefinito: nessuno

Mappa chiave/valore facoltativa utilizzata per annotare i pod. Per ulteriori informazioni, consulta la sezione Annotazioni personalizzate.
mart.gsa Avanzato Introdotto nella versione: 1.10.0

Valore predefinito: nessuno

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

In genere, gli indirizzi email di GSA hanno il seguente formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

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

Consulta Abilitare Workload Identity su GKE o Abilitare la federazione delle identità per i carichi di lavoro su AKS ed EKS.
mart.hostAlias Di base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

L'alias host che punta all'oggetto MART. Puoi impostare questa proprietà su * o un nome di dominio completo.
mart.image.pullPolicy Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, vedi Aggiornare le immagini.
mart.image.tag Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1.13.4

L'etichetta della versione per l'immagine Docker di questo servizio.
mart.image.url Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository attuale per questo componente.
mart.initCheckCF.resources.requests.cpu Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 10m

La quantità di risorse della CPU allocate al controllo di inizializzazione del processo Cloud Foundry.
mart.livenessProbe.failureThreshold Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 12

Il numero di volte in cui Kubernetes verificherà che i probe di attività non siano riusciti prima di riavviare il container. Il valore minimo è 1.
mart.livenessProbe.initialDelaySeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 15

Il numero di secondi dopo l'avvio di un container prima dell'avvio di un probe di attività.
mart.livenessProbe.periodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 5

Determina la frequenza di esecuzione di un probe di vivacità, in secondi. Il valore minimo è 1.
mart.livenessProbe.timeoutSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1

Il numero di secondi dopo i quali un probe di attività va in timeout. Il valore minimo è 1.
mart.metricsURL Di base Introdotto nella versione: 1.0.0

Valore predefinito: /v1/server/metrics

mart.nodeSelector.key Di base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Chiave dell'etichetta del selettore di nodi facoltativo 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 dei pool di nodi dedicati.
mart.nodeSelector.value Di base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

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

Consulta Configurazione dei pool di nodi dedicati.
mart.readinessProbe.failureThreshold Avanzato Introdotto 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 Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 15

Il numero di secondi dopo l'avvio di un container prima dell'avvio di un probe di idoneità.
mart.readinessProbe.periodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 5

Determina la frequenza di esecuzione di un probe di preparazione, in secondi. Il valore minimo è 1.
mart.readinessProbe.successThreshold Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1

Il numero minimo di esecuzioni riuscite consecutive necessarie per considerare riuscita una sonda di idoneità dopo un errore. Il valore minimo è 1.
mart.readinessProbe.timeoutSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1

Il numero di secondi dopo i quali un probe di attività va in timeout. Il valore minimo è 1.
mart.replicaCountMax Di base Introdotto nella versione: 1.0.0

Valore predefinito: 5

Numero massimo di repliche disponibili per la scalabilità automatica.
mart.replicaCountMin Di base Introdotto nella versione: 1.0.0

Valore predefinito: 1

Numero minimo di repliche disponibili per la scalabilità automatica.
mart.resources.limits.cpu Avanzato Introdotto 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 Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 5Gi

Il limite di memoria per la risorsa in un container Kubernetes, in mebibyte.
mart.resources.requests.cpu Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 500m

La CPU necessaria per il normale funzionamento della risorsa in un container Kubernetes, in millicore.
mart.resources.requests.memory Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 512Mi

La memoria necessaria per il normale funzionamento della risorsa in un container Kubernetes, in mebibyte.
mart.serviceAccountPath Di base Introdotto nella versione: 1.1.1

Valore predefinito: nessuno

È obbligatorio specificare serviceAccountPath o serviceAccountRef.

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

mart.serviceAccountRef Di base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare serviceAccountPath o serviceAccountRef.
mart.sslCertPath Di base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

Percorso del file system locale per caricare e codificare il certificato SSL in un secret.
mart.sslKeyPath Di base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

Percorso del file system locale per caricare e codificare la chiave SSL in un secret.
mart.sslSecret Di base Introdotto 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 i dati della chiave e del certificato TLS come input.

Vedi anche:
mart.targetCPUUtilizationPercentage Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 75

Utilizzo CPU target per il processo MART sul pod. Il valore di questo campo consente a MART di scalare automaticamente quando l'utilizzo della CPU raggiunge questo valore, fino a replicaCountMax.
mart.terminationGracePeriodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 30

Il tempo che intercorre tra una richiesta di eliminazione del pod e l'eliminazione del pod, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop e tutti i processi in esecuzione verranno terminati in modo controllato.
mart.tolerations.effect Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta Taint e tolleranze: concetti.
mart.tolerations.key Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
mart.tolerations.operator Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: "Equal"

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
mart.tolerations.tolerationSeconds Avanzato Introdotto 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 non riuscito o che non risponde.

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
mart.tolerations.value Avanzato Introdotto 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 maggiori dettagli, consulta Taints e tolleranze: concetti.

metrics

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

Per ulteriori informazioni, consulta la panoramica della raccolta di metriche.

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

Proprietà Tipo Descrizione
metrics.adapter.image.pullPolicy Avanzato Introdotto 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 estrarre una nuova immagine se esiste già.
  • Always: esegue sempre il pull dell'immagine, indipendentemente dal fatto che esista già.

Per ulteriori informazioni, vedi Aggiornare le immagini.
metrics.adapter.image.tag Avanzato Introdotto 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 Avanzato Introdotto nella versione: 1.8.1

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository attuale per questo componente.
metrics.adapter.resources.limits.cpu Avanzato Introdotto nella versione: 1.13.3

Valore predefinito: 500m

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

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

Valore predefinito: 4Gi

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

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

Valore predefinito: 100m

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

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

Valore predefinito: 128Mi

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

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

Valore predefinito: 500m

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

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

Valore predefinito: 512Mi

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

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

Valore predefinito: 500m

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

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

Valore predefinito: 3Gi

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

metrics.annotations Avanzato Introdotto nella versione: 1.5.0

Valore predefinito: nessuno

Mappa chiave/valore facoltativa utilizzata per annotare i pod. Per ulteriori informazioni, consulta la sezione Annotazioni personalizzate.
metrics.app.resources.requests.cpu Avanzato Introdotto nella versione: 1.4.0

Valore predefinito: 500m

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

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

Valore predefinito: 512Mi

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

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

Valore predefinito: 500m

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

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

Valore predefinito: 1Gi

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

metrics.appStackdriverExporter.resources.requests.cpu Avanzato Introdotto 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 Avanzato Introdotto 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 Avanzato Introdotto 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 Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 1Gi

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

metrics.collector.envVars Di base Introdotto nella versione: 1.13

Valore predefinito: nessuno

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

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

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

ad esempio: 

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

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

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

ad esempio: 

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

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

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

ad esempio: 

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

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

Consulta Supporto proxy nella documentazione di OpenTelemetry.
metrics.collector.imagePullPolicy Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta Utilizzare un repository di immagini privato con Apigee hybrid .
metrics.collector.image.tag Di base Introdotto 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 Di base Introdotto nella versione: 1.12.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository attuale per questo componente.
metrics.collector.resources.requests.cpu Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 500m

La CPU necessaria per il normale funzionamento dell'app in un container Kubernetes, in millicore.
metrics.collector.resources.requests.memory Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 512Mi

La memoria necessaria per il normale funzionamento dell'app in un container Kubernetes, in mebibyte.
metrics.collector.resources.limits.cpu Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 500m

Il limite di CPU per la risorsa app in un container Kubernetes, in millicore.
metrics.collector.resources.limits.memory Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 1Gi

Il limite di memoria per la risorsa app in un container Kubernetes, in gibibyte.
metrics.collector.livenessProbe.failureThreshold Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 5

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 Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 30

Il numero di secondi dopo l'avvio di un container prima dell'avvio di un probe di attività.
metrics.collector.livenessProbe.periodSeconds Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 10

Determina la frequenza di esecuzione di un probe di vivacità, in secondi. Il valore minimo è 1.
metrics.collector.livenessProbe.successThreshold Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 1

Il numero minimo di operazioni riuscite consecutive necessario per considerare una sonda di attività riuscita dopo un errore. Il valore minimo è 1.
metrics.collector.livenessProbe.timeoutSeconds Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 5

Il numero di secondi dopo i quali un probe di attività va in timeout. Il valore minimo è 1.
metrics.collector.readinessProbe.failureThreshold Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 3

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 Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 30

Il numero di secondi dopo l'avvio di un container prima dell'avvio di un probe di idoneità.
metrics.collector.readinessProbe.periodSeconds Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 10

Determina la frequenza di esecuzione di un probe di preparazione, in secondi. Il valore minimo è 1.
metrics.collector.readinessProbe.successThreshold Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 1

Il numero minimo di esecuzioni riuscite consecutive necessario per considerare riuscita una sonda di idoneità dopo un errore. Il valore minimo è 1.
metrics.collector.readinessProbe.timeoutSeconds Avanzato Introdotto nella versione: 1.12.0

Valore predefinito: 5

Il numero di secondi dopo i quali un probe di attività va in timeout. Il valore minimo è 1.
metrics.disablePrometheusPipeline Di base Introdotto nella versione: 1.12.0

Valore predefinito: true

Le metriche per le risorse monitorate ProxyV2 e TargetV2 non vengono emesse quando sono impostate su true. Utilizza invece le metriche per le risorse monitorate Proxy e Target.
metrics.enabled Di base Introdotto nella versione: 1.0.0

Valore predefinito: true

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

metrics.gsa Avanzato Introdotto nella versione: 1.10.0

Valore predefinito: nessuno

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

In genere, gli indirizzi email di GSA hanno il seguente formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

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

Consulta Abilitare Workload Identity su GKE o Abilitare la federazione delle identità per i carichi di lavoro su AKS ed EKS.
metrics.nodeSelector.key Di base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

Chiave dell'etichetta del selettore di nodi utilizzata per il targeting dei nodi Kubernetes dedicati per i servizi di runtime metrics.

Consulta Configurazione dei pool di nodi dedicati.
metrics.nodeSelector.value Di base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

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

Consulta Configurazione dei pool di nodi dedicati.
metrics.prometheus.containerPort Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 9090

La porta per connettersi al servizio di metriche Prometheus.
metrics.prometheus.image.pullPolicy Avanzato Introdotto 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 estrarre una nuova immagine se esiste già.
  • Always: esegue sempre il pull dell'immagine, indipendentemente dal fatto che esista già.

Per ulteriori informazioni, vedi Aggiornare le immagini.
metrics.prometheus.image.tag Avanzato Introdotto 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 Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository attuale per questo componente.
metrics.prometheus.livenessProbe.failureThreshold Avanzato Introdotto 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 Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 5

Determina la frequenza di esecuzione di un probe di vivacità, in secondi. Il valore minimo è 1.
metrics.prometheus.livenessProbe.timeoutSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 3

Il numero di secondi dopo i quali un probe di attività va in timeout. Il valore minimo è 1.
metrics.prometheus.readinessProbe.failureThreshold Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 120

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

Valore predefinito: 5

Determina la frequenza di esecuzione di un probe di preparazione, in secondi. Il valore minimo è 1.
metrics.prometheus.readinessProbe.timeoutSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 3

Il numero di secondi dopo i quali un probe di attività va in timeout. Il valore minimo è 1.
metrics.prometheus.resources.limits.cpu Avanzato Introdotto nella versione: 1.13.3

Valore predefinito: 500m

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

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

Valore predefinito: 4Gi

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

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

Valore predefinito: 128m

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

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

Valore predefinito: 512Mi

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

metrics.prometheus.sslCertPath Di base Introdotto 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 Di base Introdotto 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 Avanzato Introdotto 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 Avanzato Introdotto nella versione: 1.4.0

Valore predefinito: 512Mi

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

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

Valore predefinito: 500m

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

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

Valore predefinito: 1Gi

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

metrics.proxyStackdriverExporter.resources.requests.cpu Avanzato Introdotto 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 Avanzato Introdotto 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 Avanzato Introdotto 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 Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 1Gi

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

metrics.proxyURL Di base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

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

metrics.sdSidecar.containerPort Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 9091

La porta per la connessione al servizio di metriche di Cloud Monitoring.
metrics.sdSidecar.image.pullPolicy Avanzato Introdotto 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 estrarre una nuova immagine se esiste già
  • Always: estrai sempre la policy, anche se esiste già

    Per ulteriori informazioni, vedi Aggiornamento delle immagini.
metrics.sdSidecar.image.tag Avanzato Introdotto 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 Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository attuale per questo componente.
metrics.serviceAccountPath Di base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

È obbligatorio specificare serviceAccountPath o serviceAccountRef.

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

metrics.serviceAccountRef Di base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare serviceAccountPath o serviceAccountRef.
metrics.stackdriverExporter.resources.requests.cpu Avanzato Introdotto nella versione: 1.4.0

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

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

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

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

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

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

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

metrics.terminationGracePeriodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 300

Il tempo che intercorre tra una richiesta di eliminazione del pod e l'eliminazione del pod, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop e tutti i processi in esecuzione verranno terminati in modo controllato.
metrics.tolerations.effect Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

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

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta Taint e tolleranze: concetti.
metrics.tolerations.key Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
metrics.tolerations.operator Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: "Equal"

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
metrics.tolerations.tolerationSeconds Avanzato Introdotto 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 non riuscito o che non risponde.

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
metrics.tolerations.value Avanzato Introdotto 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 maggiori dettagli, consulta Taints e tolleranze: concetti.

mintTaskScheduler

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

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

Proprietà Tipo Descrizione
mintTaskScheduler.image.pullPolicy Avanzato Introdotto 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 estrarre una nuova immagine se esiste già.
  • Always: esegue sempre il pull dell'immagine, indipendentemente dal fatto che esista già.

Per ulteriori informazioni, vedi Aggiornare le immagini.
mintTaskScheduler.image.tag Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 1.13.4

L'etichetta della versione per l'immagine Docker di questo servizio.
mintTaskScheduler.image.url Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository attuale per questo componente.
mintTaskScheduler.resources.limits.cpu Avanzato Introdotto 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 Avanzato Introdotto nella versione: 1.1.0

Valore predefinito: 4Gi

Il limite di memoria per la risorsa in un container Kubernetes, in mebibyte.
mintTaskScheduler.resources.requests.cpu Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 500m

La CPU necessaria per il normale funzionamento della risorsa in un container Kubernetes, in millicore.
mintTaskScheduler.resources.requests.memory Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 512Mi

La memoria necessaria per il normale funzionamento della risorsa in un container Kubernetes, in mebibyte.
mintTaskScheduler.tolerations.effect Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta Taint e tolleranze: concetti.
mintTaskScheduler.tolerations.key Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
mintTaskScheduler.tolerations.operator Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: "Equal"

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
mintTaskScheduler.tolerations.tolerationSeconds Avanzato Introdotto 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 non riuscito o che non risponde.

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
mintTaskScheduler.tolerations.value Avanzato Introdotto 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 maggiori dettagli, consulta Taints e tolleranze: concetti.

newDataPipeline

newDataPipeline determina se Apigee hybrid utilizza la nuova pipeline di dati per consentire ai componenti di runtime di scrivere i dati direttamente nel piano di controllo. Questa proprietà è obbligatoria per le organizzazioni ibride con residenza dei dati abilitata alla versione 1.13.1 o successive. Non tentare di utilizzare la nuova funzionalità della pipeline di dati con organizzazioni non abilitate alla residenza dei dati; solo le nuove organizzazioni create su hybrid v1.13.1 possono utilizzare questa nuova funzionalità. Vedi anche Utilizzo della residenza dei dati con Apigee hybrid.

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

Proprietà Tipo Descrizione
newDataPipeline.debugSession Avanzato Introdotto nella versione: 1.13.1

Valore predefinito: false

Determina se la nuova pipeline di dati Pub/Sub è abilitata. Imposta questa proprietà su true per utilizzare la nuova pipeline di dati (obbligatoria per le nuove organizzazioni ibride v1.13.1 con residenza dei dati attivata). Lascia impostato il valore false per disattivare la nuova pipeline di dati. Per ulteriori informazioni, vedi Raccolta dei dati di analisi e di debug con la residenza dei dati.
newDataPipeline.analytics Avanzato Introdotto nella versione: 1.13.1

Valore predefinito: false

Determina se l'analisi utilizza la nuova pipeline di dati Pub/Sub. Imposta questo valore su true per consentire ad Analytics di utilizzare la nuova pipeline di dati (obbligatoria per le nuove organizzazioni ibride v1.13.1 con residenza dei dati attivata). Lascia impostato il valore false per forzare Analytics a utilizzare la vecchia pipeline di dati. Per ulteriori informazioni, vedi Raccolta dei dati di analisi e di debug con la residenza dei dati.

nodeSelector

L'oggetto nodeSelector definisce il nodo per l'istanza Apigee. Dietro le quinte Apigee Hybrid si occupa di mappare la chiave/il valore dell'etichetta per apigeeRuntime e apigeeData ai singoli componenti Istio e MART quando installi o esegui l'upgrade dei grafici apigee-org e apigee-ingress-manager. Puoi ignorare questa impostazione per i singoli oggetti nella proprietà mart:nodeSelector.

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

Proprietà Tipo Descrizione
nodeSelector.apigeeData.key Avanzato Introdotto nella versione: 1.0.0

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

ApigeeData è il nodo per il database Cassandra. Chiave dell'etichetta del selettore dei nodi per il targeting dei nodi Kubernetes per l'utilizzo dei dati dei servizi Apigee.

Consulta Configurazione dei pool di nodi dedicati.
nodeSelector.apigeeData.value Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: apigee-data

apigee-data è il nodo per il database Cassandra. Valore dell'etichetta del selettore di nodi per il targeting dei nodi Kubernetes per l'utilizzo dei dati dei servizi Apigee.

Consulta Configurazione dei pool di nodi dedicati.
nodeSelector.apigeeRuntime.key Avanzato Introdotto nella versione: 1.0.0

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

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

Consulta Configurazione dei pool di nodi dedicati.
nodeSelector.apigeeRuntime.value Avanzato Introdotto 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 Configurazione dei pool di nodi dedicati.
nodeSelector.requiredForScheduling Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: true

Per impostazione predefinita, la proprietà requiredForScheduling è impostata su true. Quando true, significa che se Kubernetes non riesce a trovare nodi con la coppia chiave/valore dell'etichetta configurata, i pod sottostanti non verranno pianificati sui nodi di lavoro VM.

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

Consulta Configurazione dei pool di nodi dedicati.

redis

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

Proprietà Tipo Descrizione
redis.auth.password Di base Introdotto nella versione: 1.6.0

Valore predefinito: iloveapis123

Obbligatorio

Password dell'amministratore Redis. L'utente amministratore viene utilizzato per qualsiasi attività amministrativa eseguita sul cluster Redis.
redis.auth.secret Di base Introdotto nella versione: 1.9.1

Valore predefinito: nessuno

Il nome del file archiviato in un secret Kubernetes contenente la password dell'amministratore Redis. Il file secret deve contenere la chiave: 

data:
    redis.auth.password: encoded_value

Vedi anche:
redis.envoy.image.pullPolicy Avanzato Introdotto nella versione: 1.6.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, vedi Aggiornare le immagini.
redis.envoy.image.tag Avanzato Introdotto 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 Avanzato Introdotto nella versione: 1.6.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository attuale per questo componente.
redis.image.pullPolicy Avanzato Introdotto 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 estrarre una nuova immagine se esiste già.
  • Always: esegue sempre il pull dell'immagine, indipendentemente dal fatto che esista già.

Per ulteriori informazioni, vedi Aggiornare le immagini.
redis.image.tag Avanzato Introdotto nella versione: 1.6.0

Valore predefinito: 1.13.4

L'etichetta della versione per l'immagine Docker di questo servizio.
redis.image.url Avanzato Introdotto nella versione: 1.6.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository attuale per questo componente.
redis.replicaCount Di base Introdotto 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 Avanzato Introdotto 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 Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

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

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta Taint e tolleranze: concetti.
redis.tolerations.key Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
redis.tolerations.operator Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: "Equal"

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
redis.tolerations.tolerationSeconds Avanzato Introdotto 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 non riuscito o che non risponde.

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
redis.tolerations.value Avanzato Introdotto 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 maggiori dettagli, consulta Taints e tolleranze: concetti.

runtime

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

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

Valore predefinito: nessuno

Mappa chiave/valore facoltativa utilizzata per annotare i pod. Per ulteriori informazioni, consulta la sezione Annotazioni personalizzate.
runtime.envVars Di base Introdotto nella versione: 1.13.1

Valore predefinito: nessuno

Consente di fornire variabili di ambiente aggiuntive al componente di runtime in una coppia chiave-valore: 

runtime:
  envVars:
    KEY_1: VALUE_N
    ... ...
    KEY_N: VALUE_N

ad esempio: 

runtime:
  envVars:
    RUNTIME_ENV_VAR1: "value of runtime env-var 1"
    RUNTIME_ENV_VAR2: "value of runtime env-var 2"
runtime.hpaBehavior.scaleDown.percent.periodSeconds Avanzato Introdotto nella versione: 1.7.0

Valore predefinito:60

Il periodo di tempo per il quale la norma deve essere valida durante la riduzione delle istanze di runtime in percentuale.
runtime.hpaBehavior.scaleDown.percent.value Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 20

La quantità di modifica consentita dal criterio durante la riduzione delle istanze di runtime.
runtime.hpaBehavior.scaleDown.pods.periodSeconds Avanzato Introdotto nella versione: 1.7.0

Valore predefinito:60

La finestra temporale per la quale il criterio deve essere valido durante la riduzione del numero di istanze di runtime.
runtime.hpaBehavior.scaleDown.pods.value Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 20

La quantità di modifica consentita dalle norme durante la riduzione del numero di istanze di runtime.
runtime.hpaBehavior.scaleDown.selectPolicy Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: Min

La decisione presa dal gestore della scalabilità automatica tra più policy di scalabilità automatica. Se imposti il valore su Min, si verifica la più piccola variazione nella riduzione delle istanze di runtime. Se imposti il valore su Max, la riduzione delle istanze di runtime sarà più significativa.
runtime.hpaBehavior.scaleDown.stabilizationWindowSeconds Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 120

Il numero di secondi per i quali devono essere presi in considerazione i consigli passati durante la riduzione.
runtime.hpaBehavior.scaleUp.percent.periodSeconds Avanzato Introdotto nella versione: 1.7.0

Valore predefinito:60

Il periodo di tempo per il quale la policy deve essere valida durante lo scale up di una percentuale di istanze di runtime.
runtime.hpaBehavior.scaleUp.percent.value Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 20

Il periodo di tempo per il quale la policy deve essere valida durante lo scale up di una percentuale di istanze di runtime.
runtime.hpaBehavior.scaleUp.pods.periodSeconds Avanzato Introdotto nella versione: 1.7.0

Valore predefinito:60

La finestra temporale per la quale il criterio deve essere valido durante lo scale up di un numero di istanze di runtime.
runtime.hpaBehavior.scaleUp.pods.value Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 4

La quantità di modifica consentita dalle norme durante lo scale up di un numero di istanze di runtime.
runtime.hpaBehavior.scaleUp.selectPolicy Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: Max

La decisione presa dal gestore della scalabilità automatica tra più policy di scalabilità automatica. Se imposti il valore su Min, si verifica la più piccola variazione nello scale up delle istanze di runtime. Se imposti il valore su Max, viene consentita la massima variazione di scalabilità delle istanze di runtime.
runtime.hpaBehavior.scaleUp.stabilizationWindowSeconds Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 30

Il numero di secondi per i quali devono essere prese in considerazione le raccomandazioni passate durante lo scale up delle istanze di runtime.
runtime.hpaMetrics.serverMainTaskWaitTime Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 400 M

Il tempo di attesa medio desiderato (in ms) della coda di elaborazione nelle istanze di runtime per le richieste proxy a livello HTTP.
runtime.hpaMetrics.serverNioTaskWaitTime Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 400 M

Il tempo di attesa medio desiderato (in ms) della coda di elaborazione nelle istanze di runtime per le richieste proxy per l'elaborazione dei criteri.
runtime.hpaMetrics.targetCPUUtilizationPercentage Avanzato Introdotto nella versione: 1.7.0

Valore predefinito: 75

La percentuale di utilizzo della CPU desiderata in tutte le istanze di runtime.
runtime.image.pullPolicy Avanzato Introdotto 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 estrarre una nuova immagine se esiste già.
  • Always: esegue sempre il pull dell'immagine, indipendentemente dal fatto che esista già.

Per ulteriori informazioni, vedi Aggiornare le immagini.
runtime.image.tag Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1.13.4

L'etichetta della versione per l'immagine Docker di questo servizio.
runtime.image.url Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository attuale per questo componente.
runtime.livenessProbe.failureThreshold Avanzato Introdotto 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 Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 60

Il numero di secondi dopo l'avvio di un container prima dell'avvio di un probe di attività.
runtime.livenessProbe.periodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 5

Determina la frequenza di esecuzione di un probe di vivacità, in secondi. Il valore minimo è 1.
runtime.livenessProbe.timeoutSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1

Il numero di secondi dopo i quali un probe di attività va in timeout. Il valore minimo è 1.
runtime.nodeSelector.key Di base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

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

Vedi la proprietà nodeSelector.
runtime.nodeSelector.value Di base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

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

Consulta Configurazione dei pool di nodi dedicati.
runtime.readinessProbe.failureThreshold Avanzato Introdotto 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 Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 60

Il numero di secondi dopo l'avvio di un container prima dell'avvio di un probe di idoneità.
runtime.readinessProbe.periodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 5

Determina la frequenza di esecuzione di un probe di preparazione, in secondi. Il valore minimo è 1.
runtime.readinessProbe.successThreshold Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1

Il numero minimo di esecuzioni riuscite consecutive necessarie per considerare riuscita una sonda di idoneità dopo un errore. Il valore minimo è 1.
runtime.readinessProbe.timeoutSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1

Il numero di secondi dopo i quali un probe di attività va in timeout. Il valore minimo è 1.
runtime.replicaCountMax Di base Introdotto nella versione: 1.0.0

Valore predefinito: 4

Numero massimo di repliche disponibili per la scalabilità automatica.
runtime.replicaCountMin Di base Introdotto nella versione: 1.0.0

Valore predefinito: 1

Numero minimo di repliche disponibili per la scalabilità automatica.
runtime.resources.limits.cpu Avanzato Introdotto 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 Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 6Gi

Il limite di memoria per la risorsa in un container Kubernetes, in mebibyte.
runtime.resources.requests.cpu Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 500m

La CPU necessaria per il normale funzionamento della risorsa in un container Kubernetes, in millicore.
runtime.resources.requests.memory Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 512Mi (vedi nota di seguito)

La memoria necessaria per il normale funzionamento della risorsa in un container Kubernetes, in mebibyte (Mi) o gibibyte (Gi).
runtime.service.type Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: ClusterIP

Il tipo di servizio. Puoi impostare questo valore su un servizio diverso da ClusterIP, ad esempio LoadBalancer.
runtime.targetCPUUtilizationPercentage Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 75

Utilizzo CPU target per il processo di runtime sul pod. Il valore di questo campo consente al runtime di scalare automaticamente quando l'utilizzo della CPU raggiunge questo valore, fino a replicaCountMax.
runtime.terminationGracePeriodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 180

Il tempo che intercorre tra una richiesta di eliminazione del pod e l'eliminazione del pod, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop e tutti i processi in esecuzione verranno terminati in modo controllato.
runtime.tolerations.effect Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta Taint e tolleranze: concetti.
runtime.tolerations.key Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
runtime.tolerations.operator Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: "Equal"

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
runtime.tolerations.tolerationSeconds Avanzato Introdotto 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 non riuscito o che non risponde.

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
runtime.tolerations.value Avanzato Introdotto 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 maggiori dettagli, consulta Taints e tolleranze: concetti.

synchronizer

Garantisce che i processori di messaggi siano aggiornati con i bundle del proxy API di cui è stato eseguito il deployment più recente. A questo scopo, Synchronizer esegue il polling del piano di gestione; quando viene rilevato un nuovo contratto, Synchronizer lo invia al piano di runtime. Per impostazione predefinita, Synchronizer archivia i dati di configurazione dell'ambiente in Cassandra.

Per saperne di più, consulta Configurare Synchronizer.

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

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

Valore predefinito: nessuno

Mappa chiave/valore facoltativa utilizzata per annotare i pod. Per ulteriori informazioni, consulta la sezione Annotazioni personalizzate.
synchronizer.image.pullPolicy Avanzato Introdotto 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 estrarre una nuova immagine se esiste già.
  • Always: esegue sempre il pull dell'immagine, indipendentemente dal fatto che esista già.

Per ulteriori informazioni, vedi Aggiornare le immagini.
synchronizer.image.tag Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1.13.4

L'etichetta della versione per l'immagine Docker di questo servizio.
synchronizer.image.url Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository attuale per questo componente.
synchronizer.livenessProbe.failureThreshold Avanzato Introdotto 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 Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 0

Il numero di secondi dopo l'avvio di un container prima dell'avvio di un probe di attività.
synchronizer.livenessProbe.periodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 5

Determina la frequenza di esecuzione di un probe di vivacità, in secondi. Il valore minimo è 1.
synchronizer.livenessProbe.timeoutSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1

Il numero di secondi dopo i quali un probe di attività va in timeout. Il valore minimo è 1.
synchronizer.nodeSelector.key Di base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

Chiave dell'etichetta del selettore di nodi facoltativo per il targeting dei nodi Kubernetes per i servizi di runtime synchronizer.

Vedi nodeSelector.
synchronizer.nodeSelector.value Di base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

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

Vedi nodeSelector.
synchronizer.pollInterval Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 60

Il periodo di tempo in cui Synchronizer attende tra le operazioni di polling. Synchronizer esegue il polling dei servizi del piano di controllo Apigee per rilevare ed estrarre nuovi contratti di runtime.
synchronizer.readinessProbe.failureThreshold Avanzato Introdotto 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 Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 0

Il numero di secondi dopo l'avvio di un container prima dell'avvio di un probe di idoneità.
synchronizer.readinessProbe.periodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 5

Determina la frequenza di esecuzione di un probe di preparazione, in secondi. Il valore minimo è 1.
synchronizer.readinessProbe.successThreshold Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1

Il numero minimo di esecuzioni riuscite consecutive necessarie per considerare riuscita una sonda di idoneità dopo un errore. Il valore minimo è 1.
synchronizer.readinessProbe.timeoutSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1

Il numero di secondi dopo i quali un probe di attività va in timeout. Il valore minimo è 1.
synchronizer.replicaCount Di base Introdotto nella versione: 1.0.0

Deprecated: A partire dalla versione ibrida 1.2, gestisci il conteggio delle repliche di Synchronizer con: synchronizer.replicaCountMax e synchronizer.replicaCountMin
synchronizer.replicaCountMax Di base Introdotto nella versione: 1.2.0

Valore predefinito: 4

Numero massimo di repliche per la scalabilità automatica.
synchronizer.replicaCountMin Di base Introdotto nella versione: 1.2.0

Valore predefinito: 1

Numero minimo di repliche per la scalabilità automatica.
synchronizer.resources.limits.cpu Avanzato Introdotto 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 Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 5Gi

Il limite di memoria per la risorsa in un container Kubernetes, in mebibyte.
synchronizer.resources.requests.cpu Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 100m

La CPU necessaria per il normale funzionamento della risorsa in un container Kubernetes, in millicore.
synchronizer.resources.requests.memory Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1Gi

La memoria necessaria per il normale funzionamento della risorsa in un container Kubernetes, in gigabyte.
synchronizer.serviceAccountPath Di base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

È obbligatorio specificare serviceAccountPath o serviceAccountRef.

Percorso del file della chiave del service account Google con il ruolo Apigee Synchronizer Manager.

synchronizer.serviceAccountRef Di base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare serviceAccountPath o serviceAccountRef.
synchronizer.serviceAccountSecret Di base Introdotto nella versione: 1.1.0

Valore predefinito: nessuno

Il nome di un secret Kubernetes. Devi creare il secret utilizzando una chiave di un service account Google con il ruolo Gestore sincronizzatore Apigee come input.
synchronizer.targetCPUUtilizationPercentage Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 75

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

synchronizer.terminationGracePeriodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 30

Il tempo che intercorre tra una richiesta di eliminazione del pod e l'eliminazione del pod, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop e tutti i processi in esecuzione verranno terminati in modo controllato.
synchronizer.tolerations.effect Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta Taint e tolleranze: concetti.
synchronizer.tolerations.key Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
synchronizer.tolerations.operator Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: "Equal"

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
synchronizer.tolerations.tolerationSeconds Avanzato Introdotto 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 non riuscito o che non risponde.

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
synchronizer.tolerations.value Avanzato Introdotto 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 maggiori dettagli, consulta Taints e tolleranze: concetti.

udca

(Agente di raccolta dati universale) Definisce il servizio che viene eseguito all'interno del pod di raccolta dati nel piano di runtime. Questo servizio estrae i dati di analisi e sullo stato di implementazione e li invia alla Unified Analytics Platform (UAP).

Per saperne di più, consulta Raccolta dei dati di analisi e dello stato di implementazione.

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

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

Valore predefinito: nessuno

Mappa chiave/valore facoltativa utilizzata per annotare i pod. Per ulteriori informazioni, consulta la sezione Annotazioni personalizzate.
udca.fluentd.image.pullPolicy Avanzato Introdotto 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 estrarre una nuova immagine se esiste già.
  • Always: esegue sempre il pull dell'immagine, indipendentemente dal fatto che esista già.

Per ulteriori informazioni, vedi Aggiornare le immagini.
udca.fluentd.image.tag Avanzato Introdotto 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 Avanzato Introdotto 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 Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 1000m

Il limite di memoria per la risorsa in un container Kubernetes, in mebibyte.
udca.fluentd.resources.limits.memory Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 500Mi

Il limite di memoria per la risorsa in un container Kubernetes, in mebibyte.
udca.fluentd.resources.requests.cpu Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 500m

La CPU necessaria per il normale funzionamento della risorsa in un container Kubernetes, in millicore.
udca.fluentd.resources.requests.memory Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 250Mi

La memoria necessaria per il normale funzionamento della risorsa in un container Kubernetes, in mebibyte.
udca.gsa Avanzato Introdotto nella versione: 1.10.0

Valore predefinito: nessuno

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

In genere, gli indirizzi email di GSA hanno il seguente formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

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

Consulta Abilitare Workload Identity su GKE o Abilitare la federazione delle identità per i carichi di lavoro su AKS ed EKS.
udca.image.pullPolicy Avanzato Introdotto 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 estrarre una nuova immagine se esiste già.
  • Always: esegue sempre il pull dell'immagine, indipendentemente dal fatto che esista già.

Per ulteriori informazioni, vedi Aggiornare le immagini.
udca.image.tag Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1.13.4

L'etichetta della versione per l'immagine Docker di questo servizio.
udca.image.url Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository attuale per questo componente.
udca.jvmXms Avanzato Introdotto nella versione: 1.0.0

Deprecated: a partire dalla versione 1.8 di Hybrid, udca.jvmXms non viene più utilizzato.

udca.jvmXmx Avanzato Introdotto nella versione: 1.0.0

Deprecated: a partire dalla versione 1.8 di Hybrid, udca.jvmXmx non viene più utilizzato.

udca.livenessProbe.failureThreshold Avanzato Introdotto 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 Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 0

Il numero di secondi dopo l'avvio di un container prima dell'avvio di un probe di attività.
udca.livenessProbe.periodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 5

Determina la frequenza di esecuzione di un probe di vivacità, in secondi. Il valore minimo è 1.
udca.livenessProbe.timeoutSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1

Il numero di secondi dopo i quali un probe di attività va in timeout. Il valore minimo è 1.
udca.nodeSelector.key Di base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

Chiave dell'etichetta del selettore di nodi utilizzata per il targeting dei nodi Kubernetes dedicati per i servizi di runtime udca.

Consulta Configurazione dei pool di nodi dedicati.
udca.nodeSelector.value Di base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

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

Consulta Configurazione dei pool di nodi dedicati.
udca.pollingIntervalInSec Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 1

Il periodo di tempo, in secondi, che UDCA attende tra le operazioni di polling. UDCA esegue il polling della directory dei dati nel file system del pod di raccolta dei dati per rilevare i nuovi file da caricare.
udca.replicaCountMax Di base Introdotto nella versione: 1.0.0

Valore predefinito: 4

Il numero massimo di pod che ibrido può aggiungere automaticamente per il deployment UDCA. Poiché UDCA è implementato 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 hai 3 ambienti, imposta udca.replicaCountMax: 12.

udca.replicaCountMin Di base Introdotto nella versione: 1.0.0

Valore predefinito: 1

Il numero minimo di pod per il deployment UDCA. Poiché UDCA è implementato come ReplicaSet, i pod sono repliche.

Se l'utilizzo della CPU supera udca.targetCPUUtilizationPercentage, l'ibrido aumenterà gradualmente il numero di pod fino a udca.replicaCountMax.
udca.resources.limits.cpu Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 1000m

Il limite di memoria per la risorsa in un container Kubernetes, in mebibyte.
udca.resources.limits.memory Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 2Gi

Il limite di memoria per la risorsa in un container Kubernetes, in mebibyte.
udca.resources.requests.cpu Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 250m

La CPU necessaria per il normale funzionamento della risorsa in un container Kubernetes, in millicore.
udca.resources.requests.memory Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 250Mi

La memoria necessaria per il normale funzionamento della risorsa in un container Kubernetes, in mebibyte.
udca.revision Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: v1

Un valore statico inserito in un'etichetta per abilitare i deployment canary.
udca.serviceAccountPath Di base Introdotto nella versione: 1.0.0

Valore predefinito: nessuno

È obbligatorio specificare serviceAccountPath o serviceAccountRef.

Percorso del file di chiave dell'account di servizio Google con il ruolo Agente Apigee Analytics.

udca.serviceAccountRef Di base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare serviceAccountPath o serviceAccountRef.
udca.targetCPUUtilizationPercentage Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 75

La soglia di utilizzo della CPU per scalare il numero di pod nel ReplicaSet, come percentuale delle risorse CPU totali disponibili. Hybrid utilizza l'utilizzo combinato di tutti i container nel pod di raccolta dati (sia fluentd che UDCA) per calcolare l'utilizzo attuale.

Quando l'utilizzo della CPU supera questo valore, l'autoscaling ibrido aumenterà gradualmente il numero di pod nel ReplicaSet fino a udca.replicaCountMax.
udca.terminationGracePeriodSeconds Avanzato Introdotto nella versione: 1.0.0

Valore predefinito: 600

Il tempo che intercorre tra una richiesta di eliminazione del pod e l'eliminazione del pod, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop e tutti i processi in esecuzione verranno terminati in modo controllato.
udca.tolerations.effect Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta Taint e tolleranze: concetti.
udca.tolerations.key Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
udca.tolerations.operator Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: "Equal"

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
udca.tolerations.tolerationSeconds Avanzato Introdotto 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 non riuscito o che non risponde.

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
udca.tolerations.value Avanzato Introdotto 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 maggiori dettagli, consulta Taints 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 un gruppo di ambienti specificato.

Per saperne di più, consulta Configurare gli host virtuali.

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

Proprietà Tipo Descrizione
virtualhosts[].additionalGateways Di base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Un elenco di gateway Istio a cui indirizzare il traffico.
virtualhosts[].cipherSuites[] Avanzato Introdotto nella versione: 1.9.2

Valore predefinito: nessuno

Questa proprietà configura le crittografie TLS utilizzate nel gateway in entrata. Di seguito è riportato un elenco delle cifrature abilitate per impostazione predefinita nel formato OpenSSL. Puoi trovare ulteriori informazioni sulle cifrature supportate nella documentazione relativa alla build FIPS di Boring di Envoy. Un valore vuoto corrisponde alle suite di crittografia supportate dalla build Boring FIPS di Envoy.

Abilitato per impostazione predefinita per TLS v.1.3 (non puoi eseguire l'override delle suite di crittografia TLS 1.3):

  • TLS_AES_128_GCM_SHA256
  • TLS_AES_256_GCM_SHA384
  • TLS_CHACHA20_POLY1305_SHA256

Attivato per impostazione predefinita per TLS v.1.2:

  • ECDHE-ECDSA-AES128-GCM-SHA256
  • ECDHE-RSA-AES128-GCM-SHA256
  • ECDHE-ECDSA-AES256-GCM-SHA384
  • ECDHE-RSA-AES256-GCM-SHA384

Se vuoi abilitare versioni precedenti di TLS nel deployment del gateway in entrata Apigee, utilizza virtualhosts.minTLSProtocolVersion insieme alla proprietà virtualhosts.cipherSuites.

Ad esempio, per attivare 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 Di base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

Obbligatorio

Il nome dell'host virtuale.
virtualhosts[].maxTLSProtocolVersion Di base Introdotto 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 un numero. Ad esempio: 

virtualhosts:
  - name: default
    maxTLSProtocolVersion: "1.3"

dove il numero rappresenta il numero di versione di TLS nel formato #.#. Nell'esempio precedente, "1.3" rappresenta la versione TLS di Istio TLSV1_3.

Vedi anche ServerTLSSettings.TLSProtocol nella documentazione di Istio.
virtualhosts[].minTLSProtocolVersion Di base Introdotto 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 un numero. Ad esempio: 

virtualhosts:
  - name: default
    minTLSProtocolVersion: "1.2"

dove il numero rappresenta il numero di versione di TLS nel formato #.#. Nell'esempio precedente, 1.2 rappresenta la versione TLS di Istio TLSV1_2.

Vedi anche ServerTLSSettings.TLSProtocol nella documentazione di Istio.
virtualhosts[].selector Di base Introdotto nella versione: 1.2.0

Valore predefinito: app: apigee-ingressgateway

Obbligatorio

Una coppia chiave-valore selettore-valore per indicare selettori di ingresso diversi.

  • apigee-ingressgateway: per le installazioni di Apigee hybrid che utilizzano il gateway in entrata Apigee.
  • istio-ingressgateway: per le installazioni di Apigee hybrid che utilizzano Cloud Service Mesh (versioni di Apigee hybrid 1.8 e precedenti).

Se non viene fornita alcuna etichetta del selettore, la configurazione viene fornita al gateway in entrata Apigee.

virtualhosts[].sslCertPath Di base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

Il percorso sul tuo sistema di un file di certificato TLS.
virtualhosts[].sslKeyPath Di base Introdotto nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

Il percorso sul tuo sistema del file della chiave privata TLS.
virtualhosts[].sslSecret Di base Introdotto 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 i dati della chiave e del certificato TLS come input.

Vedi anche:

watcher

La proprietà watcher è una proprietà di configurazione obbligatoria. Il watcher è un processo che monitora le modifiche alla configurazione e ne attiva l'applicazione al piano di runtime.

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

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

Valore predefinito: nessuno

Mappa chiave/valore facoltativa utilizzata per annotare i pod. Per ulteriori informazioni, consulta la sezione Annotazioni personalizzate.
watcher.args.enableIssueScanning Avanzato Introdotto nella versione: 1.10.0

Valore predefinito: true

Attiva o disattiva la visualizzazione automatica dei problemi. Quando true, Watcher esegue automaticamente la scansione dello stato del control plane e del server API Kubernetes per determinare se sono presenti problemi di configurazione.

Imposta false per disattivare la visualizzazione automatica dei problemi. Per saperne di più, consulta Rilevamento automatico dei problemi.
watcher.args.enableLeaderElect Avanzato Introdotto nella versione: 1.13.0

Valore predefinito: true

Quando true (impostazione predefinita) watcher.args.enableLeaderElect seleziona un singolo pod di monitoraggio per gestire e segnalare le informazioni di routing. La limitazione a un singolo pod è necessaria per evitare tempi di inattività durante gli upgrade o il rollback. Durante questi eventi, possono essere eseguite più versioni di watcher contemporaneamente. Ogni istanza di Watcher può avere una logica di creazione delle route diversa, il che può causare tempi di inattività.watcher.replicaCountMax.

watcher.args.issueScanInterval Avanzato Introdotto nella versione: 1.10.0

Valore predefinito: 60

L'intervallo in secondi per la frequenza con cui Watcher esegue la scansione del piano di runtime per la visualizzazione automatica dei problemi. Per saperne di più, consulta Rilevamento automatico dei problemi.
watcher.gsa Avanzato Introdotto nella versione: 1.10.0

Valore predefinito: nessuno

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

In genere, gli indirizzi email di GSA hanno il seguente formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

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

Consulta Abilitare Workload Identity su GKE o Abilitare la federazione delle identità per i carichi di lavoro su AKS ed EKS.
watcher.image.pullPolicy Avanzato Introdotto 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 estrarre una nuova immagine se esiste già.
  • Always: esegue sempre il pull dell'immagine, indipendentemente dal fatto che esista già.

Per ulteriori informazioni, vedi Aggiornare le immagini.
watcher.image.tag Avanzato Introdotto nella versione: 1.4.0

Valore predefinito: 1.13.4

L'etichetta della versione per l'immagine Docker di questo servizio.
watcher.image.url Avanzato Introdotto nella versione: 1.4.0

Valore predefinito: nessuno

La posizione dell'immagine Docker per questo servizio.

Utilizza apigee-pull-push --list per visualizzare l'URL del repository attuale per questo componente.
watcher.replicaCountMax Di base Introdotto nella versione: 1.3.0

Valore predefinito: 1

Il numero massimo di repliche del watcher. Questo valore deve essere mantenuto a 1 per evitare conflitti.

Apigee hybrid utilizza un pod watcher per installazione. La selezione del leader seleziona automaticamente un pod watcher. Le repliche dei pod di monitoraggio aggiuntivi verranno forzate in uno stato instabile. Vedi watcher.args.enableLeaderElect.

watcher.replicaCountMin Di base Introdotto nella versione: 1.3.0

Valore predefinito: 1

Il numero minimo di repliche del watcher.
watcher.resources.limits.cpu Avanzato Introdotto 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 Avanzato Introdotto nella versione: 1.11.0

Valore predefinito: 2Gi

Il limite di memoria per la risorsa in un container Kubernetes, in mebibyte.
watcher.serviceAccountPath Di base Introdotto nella versione: 1.3.0

Valore predefinito: nessuno

Obbligatorio.

Percorso del file della chiave dell'account di servizio Google con il ruolo Agente di runtime Apigee.

watcher.serviceAccountRef Avanzato Introdotto nella versione: 1.3.0

Valore predefinito: nessuno

È obbligatorio specificare serviceAccountPath o serviceAccountRef.
watcher.tolerations.effect Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

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

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, consulta Taint e tolleranze: concetti.
watcher.tolerations.key Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: nessuno

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
watcher.tolerations.operator Avanzato Introdotto nella versione: 1.10.1

Valore predefinito: "Equal"

Obbligatorio per utilizzare la funzionalità incompatibilità e tolleranze di Kubernetes.

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

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

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
watcher.tolerations.tolerationSeconds Avanzato Introdotto 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 non riuscito o che non risponde.

Per maggiori dettagli, consulta Taints e tolleranze: concetti.
watcher.tolerations.value Avanzato Introdotto 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 maggiori dettagli, consulta Taints e tolleranze: concetti.