Riferimento per le proprietà di configurazione

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

Filtra questa pagina

Per filtrare le proprietà visualizzate in questa pagina, seleziona Base (proprietà più comuni) o Avanzate (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. Si tratta di proprietà che non appartengono a un altro oggetto e si applicano a livello di organizzazione o ambiente:

Proprietà Tipo Descrizione
axHashSalt Avanzato

Introdotta nella versione: 1.3.0

Valore predefinito: il nome della tua organizzazione

Optional

Il nome di un secret Kubernetes che contiene un "sale" utilizzato durante il calcolo degli hash per offuscare i dati utente prima che vengano inviati ad Apigee Analytics. Se non specifichi un valore di salt, per impostazione predefinita viene utilizzato iloveapis123. Crea il secret con il valore della salatura 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.

Consulta Offuscare i dati utente per l'analisi.

contractProvider Avanzato Introdotta nella versione: 1.0.0

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

Definisce il percorso dell'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 piano di controllo, come i bundle proxy. Per un elenco, consulta Regioni del piano di controllo 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.

Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

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

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

Introdotta nella versione: 1.0.0

Valore predefinito: us-central1

Obbligatorio

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

hub Avanzato Introdotta 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 singola proprietà image.url per ogni componente. Configura gli URL individuali 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.14.0
  imagePullPolicy: IfNotPresent

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

Gli altri componenti seguiranno uno schema simile.

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

Consulta Utilizzare un repository di immagini private con Apigee hybrid.

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

imagePullSecrets.name Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: Nessuno

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

instanceID Di base Introdotta 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 con una lunghezza massima di 63 caratteri.

k8sClusterName Avanzato Deprecated: Per la versione 1.2.0 e successive, utilizza k8sCluster.name e k8sCluster.region.

Introdotta nella versione: 1.0.0

Valore predefinito: Nessuno

Nome del procluster Kubernetes (K8S) in cui è in esecuzione il progetto ibrido. Funziona con gcpProjectID (dismesso) e gcpRegion (dismesso) per identificare il progetto e determinare dove apigee-logger e apigee-metrics inviano i dati.

kmsEncryptionKey Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: defaults.org.kmsEncryptionKey

Facoltativo. Utilizza solo uno dei valori kmsEncryptionKey, kmsEncryptionPath o kmsEncryptionSecret.

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

kmsEncryptionPath Avanzato Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

Facoltativo. Utilizza solo uno dei valori kmsEncryptionKey, kmsEncryptionPath o kmsEncryptionSecret.

Il percorso di un file contenente una chiave di crittografia codificata in Base64. Vedi Crittografia dei dati.

kmsEncryptionSecret.key Avanzato Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

Facoltativo. Utilizza solo uno dei valori 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 Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

Facoltativo. Utilizza solo uno dei valori kmsEncryptionKey, kmsEncryptionPath o kmsEncryptionSecret.

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

kvmEncryptionKey Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: defaults.org.kmsEncryptionKey

Facoltativo. Utilizza solo uno dei valori kvmEncryptionKey, kvmEncryptionPath o kvmEncryptionSecret.

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

kvmEncryptionPath Avanzato Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

Facoltativo. Utilizza solo uno dei valori kvmEncryptionKey, kvmEncryptionPath o kvmEncryptionSecret.

Il percorso di un file contenente una chiave di crittografia codificata in Base64. Vedi Crittografia dei dati.

kvmEncryptionSecret.key Avanzato Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

Facoltativo. Utilizza solo uno dei valori 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 Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

Facoltativo. Utilizza solo uno dei valori kvmEncryptionKey, kvmEncryptionPath o kvmEncryptionSecret.

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

multiOrgCluster Avanzato Introdotta 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 delle sostituzioni per ogni organizzazione in un cluster multi-organizzazione. Per maggiori informazioni, consulta Aggiungere più organizzazioni ibride a un cluster.

namespace Di base Introdotta 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

Introdotta nella versione: 1.0.0

Valore predefinito: Nessuno

Obbligatorio

L'organizzazione abilitata all'utilizzo di Apigee hybrid di cui è stato eseguito il provisioning da parte di Apigee durante l'installazione di Apigee hybrid. Un'organizzazione è il contenitore di primo livello in Apigee. Contiene tutti i proxy API e le risorse correlate. Se il valore è vuoto, devi aggiornarlo con il nome della tua organizzazione dopo averlo creato.

orgScopedUDCA Avanzato Introdotta nella versione: 1.8.0

Valore predefinito: true

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

L'accesso a dati di clienti a livello di organizzazione utilizza un unico account di servizio Google per tutti gli ambienti Apigee. L'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 imposta i valori per envs[].serviceAccountPaths.udca e envs[].serviceAccountSecretRefs.udca.

Vedi anche: udca.

revision Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: "1140" (la versione di Apigee hybrid senza i 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 di pod con nuove.

Quando aggiorni determinate sostituzioni YAML che comportano la modifica del PodTemplateSpec Kubernetes sottostante, la proprietà di sostituzione revision deve essere modificata anche nel override.yaml del cliente. Questo è necessario per consentire al controller ApigeeDeployment (AD) di Kubernetes sottostante di eseguire un aggiornamento graduale sicuro dalla versione precedente alla 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, consulta la sezione Aggiornamenti incrementali.

serviceAccountSecretProviderClass Avanzato Introdotta nella versione: 1.12.0

Valore predefinito: Nessuno

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

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

validateOrg Avanzato Introdotta nella versione: 1.8.0

Valore predefinito: true

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

Vedi anche org

validateServiceAccounts Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: true

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

Vedi anche gcpProjectID

ao

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

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

Proprietà Tipo Descrizione
ao.args.disableIstioConfigInAPIServer Avanzato Introdotta 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 di ingresso Apigee.
  • Imposta su false per le installazioni ibride che utilizzano Cloud Service Mesh (Apigee hybrid versioni 1.8 e precedenti).
ao.args.disableManagedClusterRoles Avanzato Introdotta nella versione: 1.10.0

Valore predefinito: true

Se è impostato su true (il valore predefinito), Apigee Hybrid non gestisce direttamente Kubernetes ClusterRole e ClursterRoleBinding. Se hai un processo che richiede la gestione di queste risorse, deve essere eseguito da un utente con le autorizzazioni corrette.

ao.image.pullPolicy Avanzato Introdotta nella versione: 1.2.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta Aggiornare le immagini.

ao.image.tag Avanzato Introdotta nella versione: 1.2.0

Valore predefinito: 1.14.0

L'etichetta della versione dell'immagine Docker di questo servizio.

ao.image.url Avanzato Introdotta 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 Introdotta nella versione: 1.2.0

Valore predefinito: 250m

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

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

Valore predefinito: 256Mi

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

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

Valore predefinito: 250m

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

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

Valore predefinito: 256Mi

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

ao.tolerations.effect Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

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

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

ao.tolerations.key Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

ao.tolerations.operator Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

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

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

ao.tolerations.tolerationSeconds Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

tolerationSeconds definisce in secondi il tempo per cui un pod rimane associato a un nodo in stato di errore o non rispondente.

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

ao.tolerations.value Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

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

Per informazioni dettagliate, consulta Contaminazioni 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à apigeeIngressGateway con il grafico apigee-org.

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

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

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta Aggiornare le immagini.

apigeeIngressGateway.image.tag Avanzato Introdotta nella versione: 1.11.0

Valore predefinito: 1.18.7-asm.4-distroless

L'etichetta della versione dell'immagine Docker di questo servizio.

apigeeIngressGateway.image.url Avanzato Introdotta 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 Introdotta nella versione: 1.11.0

Valore predefinito: Nessuno

Obbligatorio

Chiave dell'etichetta del selettore dei nodi utilizzata per scegliere come target i nodi Kubernetes dedicati per i servizi di gateway di ingresso.

Consulta Configurare i pool di nodi dedicati.

apigeeIngressGateway.nodeSelector.value Avanzato Introdotta nella versione: 1.11.0

Valore predefinito: Nessuno

Valore facoltativo dell'etichetta del selettore di nodi utilizzato per scegliere come target i nodi Kubernetes dedicati per i servizi di gateway di ingresso e per eseguire l'override delle impostazioni nodeSelector.apigeeData.

Vedi nodeSelector.

apigeeIngressGateway.replicaCountMax Di base Introdotta nella versione: 1.11.0

Valore predefinito: 4

Il numero massimo di pod che Hybrid può aggiungere automaticamente per il gateway di ingresso disponibile per la scalabilità automatica.

apigeeIngressGateway.replicaCountMin Di base Introdotta nella versione: 1.11.0

Valore predefinito: 2

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

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

Valore predefinito: 75

La soglia di utilizzo della CPU per la scalabilità del numero di pod nel ReplicaSet, in percentuale delle risorse CPU totali disponibili.

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

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

apigeeIngressGateway.tolerations.effect Avanzato Introdotta nella versione: 1.11.0

Valore predefinito: Nessuno

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

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

apigeeIngressGateway.tolerations.key Avanzato Introdotta nella versione: 1.11.0

Valore predefinito: Nessuno

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

apigeeIngressGateway.tolerations.operator Avanzato Introdotta nella versione: 1.11.0

Valore predefinito: "Equal"

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

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

apigeeIngressGateway.tolerations.tolerationSeconds Avanzato Introdotta nella versione: 1.11.0

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

tolerationSeconds definisce in secondi il tempo per cui un pod rimane associato a un nodo in stato di errore o non rispondente.

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

apigeeIngressGateway.tolerations.value Avanzato Introdotta nella versione: 1.11.0

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

cassandra

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

Per ulteriori informazioni, consulta la configurazione della classe di archiviazione.

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

Proprietà Tipo Descrizione
cassandra.annotations Avanzato Introdotta 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 Introdotta nella versione: 1.0.0

Valore predefinito: iloveapis123

Obbligatorio

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

cassandra.auth.ddl.password Di base Introdotta nella versione: 1.0.0

Valore predefinito: iloveapis123

Obbligatorio

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

cassandra.auth.default.password Di base Introdotta nella versione: 1.0.0

Valore predefinito: iloveapis123

Obbligatorio

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

cassandra.auth.dml.password Di base Introdotta 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 del client per leggere e scrivere dati in Cassandra.

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

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta Aggiornare le immagini.

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

Valore predefinito: 1.14.0

L'etichetta della versione dell'immagine Docker di questo servizio.

cassandra.auth.image.url Avanzato Introdotta 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 Introdotta nella versione: 1.4.0

Valore predefinito: iloveapis123

Obbligatorio

Password per l'utente delle operazioni JMX di Cassandra. Utilizzato per autenticarsi e comunicare con l'interfaccia JMX di Cassandra.

cassandra.auth.jmx.username Di base Introdotta nella versione: 1.4.0

Valore predefinito: jmxuser

Obbligatorio

Nome utente per l'utente delle operazioni JMX di Cassandra. Utilizzato per autenticarsi e comunicare con l'interfaccia JMX di Cassandra.

cassandra.auth.jolokia.password Di base Introdotta 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 Introdotta 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 Introdotta nella versione: 1.3.3

Valore predefinito: Nessuno

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

Vedi anche:

cassandra.auth.secretProviderClass Avanzato Introdotta nella versione: 1.10.3

Valore predefinito: Nessuno

Il criterio 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:

oppure il secret Kubernetes archiviato in:

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

cassandra.backup.cloudProvider Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: GCP

Il nome di un provider 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 (consigliato) per utilizzare i snapshot dei volumi Kubernetes CSI 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 di CSI.
cassandra.backup.dbStorageBucket Avanzato Introdotta 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 i backup. Consulta Creare bucket se devi crearne uno.

cassandra.backup.enabled Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: false

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

Consulta Backup e recupero di Cassandra.

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

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta Aggiornare le immagini.

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

Valore predefinito: 1.14.0

L'etichetta della versione dell'immagine Docker di questo servizio.

cassandra.backup.image.url Avanzato Introdotta 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 Introdotta 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 Introdotta nella versione: 1.0.0

Valore predefinito: 0 2 * * *

La pianificazione del cron job di backup.

Consulta Backup e recupero di Cassandra.

cassandra.backup.server Avanzato Introdotta 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 Introdotta nella versione: 1.0.0

Valore predefinito: Nessuno

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

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

cassandra.backup.serviceAccountRef Avanzato Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

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

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

cassandra.backup.storageDirectory Avanzato Introdotta 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 Introdotta nella versione: 1.0.0

Valore predefinito: apigeecluster

Specifica il nome del cluster Cassandra.

cassandra.datacenter Di base Introdotta nella versione: 1.0.0

Valore predefinito: dc-1

Specifica il data center del nodo Cassandra.

cassandra.dnsPolicy Di base Introdotta nella versione: 1.1.1

Valore predefinito: Nessuno

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

cassandra.externalSeedHost Di base Introdotta 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 Introdotta 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 Introdotta nella versione: 1.1.1

Valore predefinito: false

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

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

Imposta cassandra.hostNetwork su true per le installazioni multiregione 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. Consulta Deployment multiregionale: prerequisiti.

Quando è true, DNS policy viene impostato automaticamente su ClusterFirstWithHostNet.

cassandra.image.pullPolicy Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta Aggiornare le immagini.

cassandra.image.tag Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 1.14.0

L'etichetta della versione dell'immagine Docker di questo servizio.

cassandra.image.url Avanzato Introdotta 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 Introdotta nella versione: 1.0.0

Valore predefinito: 512M

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

cassandra.multiRegionSeedHost Di base Introdotta nella versione: 1.0.0

Valore predefinito: Nessuno

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

cassandra.nodeSelector.key Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: Nessuno

Obbligatorio

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

Consulta Configurare i pool di nodi dedicati.

cassandra.nodeSelector.value Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: Nessuno

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

Vedi nodeSelector.

cassandra.port Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 9042

Numero di porta utilizzato per connettersi a Cassandra.

cassandra.rack Di base Introdotta nella versione: 1.0.0

Valore predefinito: ra-1

Specifica il rack del nodo Cassandra.

cassandra.readinessProbe.failureThreshold Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 2

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

cassandra.readinessProbe.initialDelaySeconds Avanzato Introdotta 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 Introdotta nella versione: 1.0.0

Valore predefinito: 10

Determina la frequenza con cui eseguire un controllo di idoneità, in secondi. Il valore minimo è 1.

cassandra.readinessProbe.successThreshold Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 1

Il numero minimo di operazioni riuscite consecutive necessarie per considerare riuscita una verifica di idoneità dopo un errore. Il valore minimo è 1.

cassandra.readinessProbe.timeoutSeconds Avanzato Introdotta 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 Introdotta nella versione: 1.0.0

Valore predefinito: 1

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

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

Valore predefinito: 500m

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

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

Valore predefinito: 1Gi

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

cassandra.restore.cloudProvider Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: GCP

Il nome di un provider 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 (consigliato) per utilizzare i snapshot dei volumi Kubernetes CSI 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 di CSI.
cassandra.restore.dbStorageBucket Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: Nessuno

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

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

cassandra.restore.enabled Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: false

Il ripristino dei dati non è abilitato per impostazione predefinita. Per attivarla, imposta il valore su true.

Consulta Backup e recupero di Cassandra.

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

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta Aggiornare le immagini.

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

Valore predefinito: 1.14.0

L'etichetta della versione dell'immagine Docker di questo servizio.

cassandra.restore.image.url Avanzato Introdotta 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 Introdotta nella versione: 1.0.0

Valore predefinito: Nessuno

Percorso del file della chiave di un account di servizio Google con il ruolo Amministratore oggetti archiviazione (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 requisiti 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 Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

Il nome di un secret Kubernetes esistente che memorizza i contenuti di un file della chiave di un account di servizio Google con il ruolo Amministratore oggetti archiviazione (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 requisiti 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 Introdotta nella versione: 1.0.0

Valore predefinito: Nessuno

Obbligatorio se il ripristino è attivo.

Timestamp del backup da ripristinare.

cassandra.sslCertPath Di base Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

Il percorso sul sistema di un file del certificato TLS.

cassandra.sslKeyPath Di base Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

Il percorso sul sistema del file della chiave privata TLS.

cassandra.sslRootCAPath Di base Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

La catena di certificati fino all'autorità di certificazione (CA) radice.

cassandra.storage.capacity Di base Introdotta nella versione: 1.0.0

Valore predefinito: 10Gi

Obbligatorio se è specificato storage.storageclass

Specifica la dimensione del disco richiesta, in mebibyte (Mi) o gibibyte (Gi).

cassandra.storage.storageclass Di base Introdotta nella versione: 1.0.0

Valore predefinito: Nessuno

Specifica la classe di archiviazione on-premise in uso.

cassandra.terminationGracePeriodSeconds Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 300

Il tempo che intercorre tra una richiesta di eliminazione del pod e il momento in cui il pod viene interrotto, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop ed eventuali processi in esecuzione dovrebbero terminare in modo corretto.

cassandra.tolerations.effect Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

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

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

cassandra.tolerations.key Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

cassandra.tolerations.operator Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

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

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

cassandra.tolerations.tolerationSeconds Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

tolerationSeconds definisce in secondi il tempo per cui un pod rimane associato a un nodo in stato di errore o non rispondente.

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

cassandra.tolerations.value Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

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

Per informazioni dettagliate, consulta Contaminazioni 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 Introdotta nella versione: 1.9.0

Valore predefinito: cert-manager

Lo spazio dei nomi per cert-manager.

Consulta Eseguire 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 che tu debba esporre l'endpoint MART su internet.

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

Proprietà Tipo Descrizione
connectAgent.annotations Avanzato Introdotta 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 Introdotta nella versione: 1.10.0

Valore predefinito: Nessuno

Solo Helm: l'indirizzo email dell'account di servizio Google IAM (GSA) da associare a connectAgent con l'account di servizio Kubernetes corrispondente quando attivi Workload Identity sui cluster GKE utilizzando i grafici Helm. Imposta questo valore dopo aver impostato gcp.workloadIdentity.enabled su true.

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

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

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

Consulta Abilitazione di Workload Identity su GKE o Abilitazione di Workload Identity Federation su AKS ed EKS.

connectAgent.logLevel Avanzato Introdotta nella versione: 1.2.0

Valore predefinito: INFO

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

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

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta Aggiornare le immagini.

connectAgent.image.tag Avanzato Introdotta nella versione: 1.2.0

Valore predefinito: 1.14.0

L'etichetta della versione dell'immagine Docker di questo servizio.

connectAgent.image.url Avanzato Introdotta 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 Introdotta nella versione: 1.2.0

Valore predefinito: 5

Numero massimo di repliche disponibili per la scalabilità automatica.

connectAgent.replicaCountMin Di base Introdotta nella versione: 1.2.0

Valore predefinito: 1

Numero minimo di repliche disponibili per la scalabilità automatica.

In produzione, ti consigliamo di aumentare replicaCountMin a 1 per avere un numero maggiore di connessioni al piano di controllo per affidabilità e scalabilità.

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

Valore predefinito: 512m

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

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

Valore predefinito: 512Mi

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

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

Valore predefinito: 100m

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

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

Valore predefinito: 30Mi

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

connectAgent.server Avanzato Introdotta 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 Introdotta nella versione: 1.1.1

Valore predefinito: Nessuno

È obbligatorio specificare serviceAccountPath o serviceAccountRef.

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

Valore predefinito: 75

Utilizzo CPU target per l'agente Apigee Connect nel pod. Il valore di questo campo consente ad Apigee Connect di eseguire la scalabilità automatica quando l'utilizzo della CPU raggiunge questo valore, fino a replicaCountMax.

connectAgent.terminationGracePeriodSeconds Avanzato Introdotta nella versione: 1.2.0

Valore predefinito: 600

Il tempo che intercorre tra una richiesta di eliminazione del pod e il momento in cui il pod viene interrotto, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop ed eventuali processi in esecuzione dovrebbero terminare in modo corretto.

connectAgent.tolerations.effect Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

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

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

connectAgent.tolerations.key Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

connectAgent.tolerations.operator Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

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

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

connectAgent.tolerations.tolerationSeconds Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

tolerationSeconds definisce in secondi il tempo per cui un pod rimane associato a un nodo in stato di errore o non rispondente.

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

connectAgent.tolerations.value Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

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

Per informazioni dettagliate, consulta Contaminazioni 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 Introdotta nella versione: 1.0.0

Valore predefinito: aWxvdmVhcGlzMTIzNDU2Nw==

Chiave di crittografia predefinita per l'organizzazione in KMS.

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

Valore predefinito: aWxvdmVhcGlzMTIzNDU2Nw==

Chiave di crittografia predefinita per l'organizzazione in KVM.

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

Valore predefinito: aWxvdmVhcGlzMTIzNDU2Nw==

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

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

Valore predefinito: aWxvdmVhcGlzMTIzNDU2Nw==

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

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

Valore predefinito: aWxvdmVhcGlzMTIzNDU2Nw==

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

diagnostic

Le impostazioni dello strumento Diagnostic Collector.

Consulta Utilizzare il raccoglitore Diagnostic

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

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

Valore predefinito: Nessuno

Obbligatorio

Il nome del bucket di archiviazione Google Cloud in cui verranno depositati i dati di diagnostica.

Consulta Creare bucket di archiviazione.

diagnostic.container Di base Introdotta nella versione: 1.6.0

Valore predefinito: Nessuno

Obbligatorio

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

  • "apigee-cassandra" acquisisce i dati sul database Cassandra. I pod istio-cassandra vengono eseguiti nello spazio dei nomi apigee.
  • "apigee-mart-server" acquisisce dati su 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 i dati relativi al 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 Introdotta 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 dei log raccolti. Un valore tipico è 30000.

Leggi diagnostic.operation

diagnostic.loggingDetails.loggerNames[] Di base Introdotta 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 la versione 1.6.0 di Apigee hybrid, l'unico valore supportato è ALL, ovvero tutti i logger. Ad esempio:

diagnostic:
 loggingDetails:
   loggerNames:
   - ALL
diagnostic.loggingDetails.logLevel Di base Introdotta 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 log da raccogliere. In Apigee hybrid 1.6 è supportato solo FINE.

diagnostic.namespace Di base Introdotta nella versione: 1.6.0

Valore predefinito: Nessuno

Obbligatorio

Lo spazio dei nomi Kubernetes in cui si trovano i pod su cui stai raccogliendo i dati. Lo spazio dei nomi deve essere quello corretto per il contenitore 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 Introdotta nella versione: 1.6.0

Valore predefinito: Nessuno

Obbligatorio

Specifica se raccogliere tutte le statistiche o solo i log.

I valori sono:

diagnostic.podNames[] Di base Introdotta nella versione: 1.6.0

Valore predefinito: Nessuno

Obbligatorio

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

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

Valore predefinito: Nessuno

Obbligatorio

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

Consulta Informazioni sugli account di servizio.

diagnostic.tcpDumpDetails.maxMsgs Di base Introdotta nella versione: 1.6.0

Valore predefinito: Nessuno

Uno dei seguenti valori è obbligatorio se utilizzi diagnostic.tcpDumpDetails: 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 Introdotta nella versione: 1.6.0

Valore predefinito: Nessuno

Uno dei seguenti valori è obbligatorio se utilizzi diagnostic.tcpDumpDetails: diagnostic.tcpDumpDetails.maxMsgs o diagnostic.tcpDumpDetails.timeoutInSeconds.

Imposta il tempo in secondi di attesa per il ritorno dei messaggi da tcpDump.

diagnostic.threadDumpDetails.delayInSeconds Di base Introdotta nella versione: 1.6.0

Valore predefinito: Nessuno

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

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

diagnostic.threadDumpDetails.iterations Di base Introdotta nella versione: 1.6.0

Valore predefinito: Nessuno

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

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

envs

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

L'organizzazione abilitata all'utilizzo dell'approccio ibrido deve avere almeno un ambiente.

Per ulteriori informazioni, consulta Informazioni sugli ambienti.

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

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

Valore predefinito: Nessuno

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

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

envs[].cacheEncryptionPath Di base Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

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

Valore predefinito: Nessuno

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

Valore predefinito: Nessuno

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

Valore predefinito: 4

Numero massimo di repliche per la scalabilità automatica. Sostituisce runtime.replicaCountMax se specificato.

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

Valore predefinito: 1

Numero minimo di repliche per la scalabilità automatica. Sostituisce runtime.replicaCountMin se specificato.

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

Valore predefinito: 4

Numero massimo di repliche per la scalabilità automatica. Sostituisce synchronizer.replicaCountMax se specificato.

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

Valore predefinito: 1

Numero minimo di repliche per la scalabilità automatica. Sostituisce synchronizer.replicaCountMin se specificato.

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

Valore predefinito: 4

Numero massimo di repliche per la scalabilità automatica. Sostituisce udca.replicaCountMax se specificato.

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

Valore predefinito: 1

Numero minimo di repliche per la scalabilità automatica. Sostituisce udca.replicaCountMin se specificato.

envs.gsa.runtime Avanzato Introdotta nella versione: 1.10.0

Valore predefinito: Nessuno

Solo Helm: l'indirizzo email dell'account di servizio Google IAM di runtime da associare all'account di servizio Kubernetes corrispondente quando attivi 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.synchronizer Avanzato Introdotta nella versione: 1.10.0

Valore predefinito: Nessuno

Solo Helm: l'indirizzo email dell'account di servizio Google IAM del sincronizzatore da associare al corrispondente account di servizio Kubernetes quando attivi 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 Introdotta nella versione: 1.10.0

Valore predefinito: Nessuno

Solo Helm: l'indirizzo email dell'account di servizio Google IAM udca per l'udca basato sull'ambiente da associare al corrispondente account di servizio Kubernetes quando attivi 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 Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

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

envs[].httpProxy.host Di base Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

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

Elenca 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 il proxy in avanti per i proxy API.

envs[].httpProxy.port Di base Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

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

envs[].httpProxy.scheme Di base Introdotta nella versione: 1.2.0

Valore predefinito: HTTPS

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

envs[].httpProxy.username Di base Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

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

envs[].httpProxy.password Di base Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

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

envs[].name Di base Introdotta nella versione: 1.0.0

Valore predefinito: Nessuno

Obbligatorio

Nome dell'ambiente Apigee da sincronizzare.

envs[].pollInterval Avanzato Introdotta 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 Introdotta nella versione: 1.0.0

Valore predefinito: Nessuno

Numero di porta TCP per il traffico HTTPS.

envs[].serviceAccountPaths.runtime Di base Introdotta nella versione: 1.4.0

Valore predefinito: Nessuno

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

envs[].serviceAccountPaths.synchronizer Di base Introdotta nella versione: 1.0

Valore predefinito: Nessuno

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

envs[].serviceAccountPaths.udca Di base Introdotta nella versione: 1.0

Valore predefinito: Nessuno

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

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

envs[].serviceAccountSecretProviderClass Avanzato Introdotta nella versione: 1.12.0

Valore predefinito: Nessuno

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

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

envs[].serviceAccountSecretRefs.runtime Di base Introdotta nella versione: 1.4.0

Valore predefinito: Nessuno

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

envs[].serviceAccountSecretRefs.synchronizer Di base Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

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

envs[].serviceAccountSecretRefs.udca Di base Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

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

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

envs[].sslCertPath Di base Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

Il percorso sul sistema di un file del certificato TLS.

envs[].sslKeyPath Di base Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

Il percorso sul sistema del file della chiave privata TLS.

envs[].sslSecret Di base Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

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

Vedi anche:

gcp

Identifica l'ID progetto e la regione Google Cloud 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 Introdotta nella versione: 1.12.0

Valore predefinito: Nessuno

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

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

gcp.federatedWorkloadIdentity.credentialSourceFile Di base Introdotta nella versione: 1.12.0

Valore predefinito: Nessuno

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

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

gcp.federatedWorkloadIdentity.enabled Di base Introdotta nella versione: 1.12.0

Valore predefinito: false

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

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

gcp.federatedWorkloadIdentity.tokenExpiration Di base Introdotta nella versione: 1.12.0

Valore predefinito: 3600

La durata del token in secondi.

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

gcp.projectID Di base Introdotta 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 Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

Identifica il progetto del cluster Kubernetes di runtime.

La proprietà projectIDRuntime è facoltativa. Se non viene utilizzato, si presume che 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 Introdotta nella versione: 1.2.0

Valore predefinito: us-central1

Obbligatorio

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

gcp.workloadIdentity.enabled Di base Introdotta 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 tuoi cluster GKE di rubare l'identità degli account di servizio Identity and Access Management (IAM) per accedere ai servizi Google Cloud.

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

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

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

gcp.workloadIdentity.gsa Avanzato Introdotta nella versione: 1.10.0

Valore predefinito: Nessuno

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

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

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

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

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

Consulta Enabling Workload Identity on GKE.

gcp.workloadIdentityEnabled Di base Introdotta nella versione: 1.4.0

Valore predefinito:false

Solo apigeectl: consente di utilizzare Workload Identity. Workload Identity consente ai carichi di lavoro nei tuoi cluster GKE di rubare l'identità degli account di servizio Identity and Access Management (IAM) per accedere ai servizi Google Cloud.

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

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

httpProxy

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

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

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

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

Valore predefinito: Nessuno

Il nome host del proxy HTTP.

httpProxy.port Di base Introdotta nella versione: 1.1.1

Valore predefinito: Nessuno

La porta del proxy HTTP.

httpProxy.scheme Di base Introdotta nella versione: 1.1.1

Valore predefinito: HTTPS

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

httpProxy.username Di base Introdotta nella versione: 1.1.1

Valore predefinito: Nessuno

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

httpProxy.password Di base Introdotta nella versione: 1.1.1

Valore predefinito: Nessuno

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

ingressGateways

Configura ogni singola istanza del gateway di ingresso Apigee. Utilizza queste proprietà quando vuoi gestire le singole istanze separatamente per ingressGateways[].name.

Consulta apigeeIngressGateway per applicare la configurazione comune a tutte le istanze del gateway di ingresso Apigee.

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

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

Proprietà Tipo Descrizione
ingressGateways[].name Di base Introdotta 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
  • Deve contenere solo caratteri alfanumerici minuscoli, "-" o "."
  • Deve iniziare con un carattere alfanumerico
  • Deve terminare con un carattere alfanumerico

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

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

Valore predefinito: 2000m

Il limite di CPU per la risorsa, in millicore.

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

Valore predefinito: 1Gi

Il limite di memoria per la risorsa, in mebibyte.

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

Valore predefinito: 300m

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

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

Valore predefinito: 128Mi

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

ingressGateways[].replicaCountMax Di base Introdotta nella versione: 1.8.0

Valore predefinito: 10

Il numero massimo di pod che Hybrid può aggiungere automaticamente per il gateway di ingresso disponibile per la scalabilità automatica.

ingressGateways[].replicaCountMin Di base Introdotta nella versione: 1.8.0

Valore predefinito: 2

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

ingressGateways[].svcAnnotations Di base Introdotta 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 Introdotta nella versione: 1.8.0

Valore predefinito: Nessuno

Sulle piattaforme che supportano l'indicazione dell'indirizzo IP del bilanciatore del carico, il bilanciatore del carico verrà creato con questo indirizzo IP. Su piattaforme che non consentono di specificare l'indirizzo IP del bilanciatore del carico, questa proprietà viene ignorata.

ingressGateways[].svcType Di base Introdotta nella versione: 1.8.1

Valore predefinito: LoadBalancer

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

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

Valore predefinito: 75

La soglia di utilizzo della CPU per la scalabilità del numero di pod nel ReplicaSet, in percentuale delle risorse CPU totali disponibili.

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

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

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

Valore predefinito: Nessuno

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

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

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

Valore predefinito: Nessuno

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

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

Valore predefinito: "Equal"

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

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

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

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

tolerationSeconds definisce in secondi il tempo per cui un pod rimane associato a un nodo in stato di errore o non rispondente.

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

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

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

istiod

Configura l'ingresso Apigee.

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

Proprietà Tipo Descrizione
istiod.accessLogFile Avanzato Introdotta 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 lasci questo valore non definito, il logging degli accessi viene disattivato.

istiod.accessLogFormat Avanzato Introdotta nella versione: 1.8.0

Il formato del log di accesso in entrata.

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

Formato del log di accesso predefinito:

'{"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 del log di accesso predefinito con interruzioni di riga aggiunte per la leggibilità.

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

Valore predefinito: SANITIZE_SET

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

I valori possibili sono:

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

Per ulteriori informazioni su questi valori, consulta la documentazione di Envoy relativa a 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 di ingresso Apigee.

istiod.healthCheckUserAgents Avanzato Introdotta nella versione: 1.12.0

Valori predefiniti:

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

Consente ai bilanciatori di carico non Google Cloud di controllare gli endpoint di controllo dell'integrità del gateway di ingresso (/healthz/ingress e /healthz) sostituendo la lista consentita predefinita per gli user agent 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 dell'agente utente, utilizza quanto segue:

istiod:
  healthCheckUserAgents: []

istiod.image.pullPolicy Avanzato Introdotta 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 importare una nuova immagine se esiste già.
  • Always: estrae sempre l'immagine, indipendentemente dal fatto che esista già.

Per ulteriori informazioni, consulta Aggiornare le immagini.

istiod.image.tag Avanzato Introdotta nella versione: 1.8.0

Valore predefinito: 1.18.7-asm.4-distroless

L'etichetta della versione dell'immagine Docker di questo servizio.

istiod.image.url Avanzato Introdotta 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 Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

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

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

istiod.tolerations.key Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

istiod.tolerations.operator Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

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

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

istiod.tolerations.tolerationSeconds Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

tolerationSeconds definisce in secondi il tempo per cui un pod rimane associato a un nodo in stato di errore o non rispondente.

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

istiod.tolerations.value Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

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

Per informazioni dettagliate, consulta Contaminazioni 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 Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

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

k8sCluster.region Di base Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

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

kubeRBACProxy

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

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

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

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta Aggiornare le immagini.

kubeRBACProxy.image.tag Avanzato Introdotta nella versione: 1.2.0

Valore predefinito: v0.14.2

L'etichetta della versione dell'immagine Docker di questo servizio.

kubeRBACProxy.image.url Avanzato Introdotta 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 Introdotta nella versione: 1.11.0

Valore predefinito: 500m

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

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

Valore predefinito: 128Mi

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

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

Valore predefinito: 5m

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

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

Valore predefinito: 64Mi

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

logger

Definisce il servizio che gestisce i log operativi. Tutti i servizi ibridi Apigee che vengono eseguiti nel cluster Kubernetes generano queste informazioni.

Per ulteriori informazioni, consulta la panoramica della registrazione.

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

Proprietà Tipo Descrizione
logger.annotations Avanzato Introdotta 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 Introdotta nella versione: 1.12.0

Valore predefinito: 256 KB

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

logger.bufferMaxSize Avanzato Introdotta nella versione: 1.12.0

Valore predefinito: 104857600

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

logger.bufferMemoryLimit Avanzato Introdotta nella versione: 1.12.0

Valore predefinito: 150 MB

Il limite di memoria che il logger può consumare. In caso di raggiungimento, il logger mette in pausa temporaneamente la lettura di altri dati fino a quando i dati esistenti non vengono svuotati dalla memoria.

logger.enabled Di base Introdotta nella versione: 1.0.0

Valore predefinito: false

Attiva o disattiva il logging sul cluster. Per i non GKE imposta true, per GKE su Google Cloud o Google Distributed Cloud imposta false.

logger.envVars Di base Introdotta 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 indirizzato tramite il proxy HTTP. La variabile NO_PROXY deve essere definita come una stringa di nomi di 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'

Se vuoi, utilizza envVars: NO_PROXY quando il proxy di inoltro HTTP è abilitato.

Consulta NO_PROXY nella documentazione di Fluent Bit.

logger.flushInterval Avanzato Introdotta 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 Introdotta nella versione: 1.10.0

Valore predefinito: Nessuno

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

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

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

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

Consulta Abilitazione di Workload Identity su GKE o Abilitazione di Workload Identity Federation su AKS ed EKS.

logger.image.pullPolicy Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta Aggiornare le immagini.

logger.image.tag Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 1.9.9

L'etichetta della versione dell'immagine Docker di questo servizio.

logger.image.url Avanzato Introdotta 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 Introdotta nella versione: 1.0.0

Valore predefinito: 3

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

logger.livenessProbe.initialDelaySeconds Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 0

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

logger.livenessProbe.periodSeconds Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 60

Determina la frequenza con cui eseguire un controllo di presenza, in secondi. Il valore minimo è 1.

logger.livenessProbe.successThreshold Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 1

Il numero minimo di operazioni riuscite consecutive necessarie per considerare riuscita una verifica di attività dopo un errore. Il valore minimo è 1.

logger.livenessProbe.timeoutSeconds Avanzato Introdotta 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 Introdotta nella versione: 1.0.0

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

Obbligatorio

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

Consulta Configurare i pool di nodi dedicati.

logger.nodeSelector.value Di base Introdotta nella versione: 1.0.0

Valore predefinito: true

Obbligatorio

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

Consulta Configurare i pool di nodi dedicati.

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

Valore predefinito: 200m

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

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

Valore predefinito: 500Mi

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

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

Valore predefinito: 100m

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

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

Valore predefinito: 250Mi

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

logger.serviceAccountPath Di base Introdotta 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 log.

logger.serviceAccountRef Di base Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

È obbligatorio specificare serviceAccountPath o serviceAccountRef.

logger.storageMaxChunks Avanzato Introdotta nella versione: 1.12.0

Valore predefinito: 128

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

logger.terminationGracePeriodSeconds Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 30

Il tempo che intercorre tra una richiesta di eliminazione del pod e il momento in cui il pod viene interrotto, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop ed eventuali processi in esecuzione dovrebbero terminare in modo corretto.

logger.tolerations.effect Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

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

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

logger.tolerations.key Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

logger.tolerations.operator Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

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

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

logger.tolerations.tolerationSeconds Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

tolerationSeconds definisce in secondi il tempo per cui un pod rimane associato a un nodo in stato di errore o non rispondente.

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

logger.tolerations.value Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

mart

Definisce il servizio MART (Management API for RunTime data), che funge da provider 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 Introdotta 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 Introdotta nella versione: 1.10.0

Valore predefinito: Nessuno

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

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

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

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

Consulta Abilitazione di Workload Identity su GKE o Abilitazione di Workload Identity Federation su AKS ed EKS.

mart.hostAlias Di base Introdotta nella versione: 1.0.0

Valore predefinito: Nessuno

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

mart.image.pullPolicy Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta Aggiornare le immagini.

mart.image.tag Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 1.14.0

L'etichetta della versione dell'immagine Docker di questo servizio.

mart.image.url Avanzato Introdotta 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 Introdotta 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 Introdotta nella versione: 1.0.0

Valore predefinito: 12

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

mart.livenessProbe.initialDelaySeconds Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 15

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

mart.livenessProbe.periodSeconds Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 5

Determina la frequenza con cui eseguire un controllo di presenza, in secondi. Il valore minimo è 1.

mart.livenessProbe.timeoutSeconds Avanzato Introdotta 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 Introdotta nella versione: 1.0.0

Valore predefinito: /v1/server/metrics

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

Valore predefinito: Nessuno

Chiave dell'etichetta del selettore dei nodi facoltativa per scegliere come target i 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 Configurare i pool di nodi dedicati.

mart.nodeSelector.value Di base Introdotta nella versione: 1.0.0

Valore predefinito: Nessuno

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

Consulta Configurare i pool di nodi dedicati.

mart.readinessProbe.failureThreshold Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 2

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

mart.readinessProbe.initialDelaySeconds Avanzato Introdotta 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 Introdotta nella versione: 1.0.0

Valore predefinito: 5

Determina la frequenza con cui eseguire un controllo di idoneità, in secondi. Il valore minimo è 1.

mart.readinessProbe.successThreshold Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 1

Il numero minimo di operazioni riuscite consecutive necessarie per considerare riuscita una verifica di idoneità dopo un errore. Il valore minimo è 1.

mart.readinessProbe.timeoutSeconds Avanzato Introdotta 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 Introdotta nella versione: 1.0.0

Valore predefinito: 5

Numero massimo di repliche disponibili per la scalabilità automatica.

mart.replicaCountMin Di base Introdotta nella versione: 1.0.0

Valore predefinito: 1

Numero minimo di repliche disponibili per la scalabilità automatica.

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

Valore predefinito: 2000m

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

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

Valore predefinito: 5Gi

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

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

Valore predefinito: 500m

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

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

Valore predefinito: 512Mi

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

mart.serviceAccountPath Di base Introdotta nella versione: 1.1.1

Valore predefinito: Nessuno

È obbligatorio specificare serviceAccountPath o serviceAccountRef.

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

mart.serviceAccountRef Di base Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

È obbligatorio specificare serviceAccountPath o serviceAccountRef.

mart.sslCertPath Di base Introdotta nella versione: 1.0.0

Valore predefinito: Nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

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

mart.sslKeyPath Di base Introdotta nella versione: 1.0.0

Valore predefinito: Nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

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

mart.sslSecret Di base Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

Il nome di un file memorizzato in un secret Kubernetes contenente il certificato TLS e la chiave privata. Devi creare il token segreto utilizzando il certificato TLS e i dati della chiave come input.

Vedi anche:

mart.targetCPUUtilizationPercentage Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 75

Utilizzo CPU target per il processo MART nel pod. Il valore di questo campo consente a MART di eseguire la scalabilità automatica quando l'utilizzo della CPU raggiunge questo valore, fino a replicaCountMax.

mart.terminationGracePeriodSeconds Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 30

Il tempo che intercorre tra una richiesta di eliminazione del pod e il momento in cui il pod viene interrotto, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop ed eventuali processi in esecuzione dovrebbero terminare in modo corretto.

mart.tolerations.effect Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

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

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

mart.tolerations.key Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

mart.tolerations.operator Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

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

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

mart.tolerations.tolerationSeconds Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

tolerationSeconds definisce in secondi il tempo per cui un pod rimane associato a un nodo in stato di errore o non rispondente.

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

mart.tolerations.value Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

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

Per informazioni dettagliate, consulta Contaminazioni 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 Hybrid, 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 Introdotta nella versione: 1.8.1

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta Aggiornare le immagini.

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

Valore predefinito: v0.11.0

L'etichetta della versione dell'immagine Docker di questo servizio.

metrics.adapter.image.url Avanzato Introdotta 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.aggregator.resources.requests.cpu Avanzato Introdotta nella versione: 1.4.0

Valore predefinito: 500m

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

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

Valore predefinito: 512Mi

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

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

Valore predefinito: 500m

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

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

Valore predefinito: 3Gi

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

metrics.annotations Avanzato Introdotta 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 Introdotta nella versione: 1.4.0

Valore predefinito: 500m

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

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

Valore predefinito: 512Mi

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

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

Valore predefinito: 500m

Il limite di CPU per la risorsa dell'app in un contenitore Kubernetes, in millicore.

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

Valore predefinito: 1Gi

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

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

Valore predefinito: 128m

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

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

Valore predefinito: 500m

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

metrics.appStackdriverExporter.resources.limits.memory Avanzato Introdotta 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 Introdotta nella versione: 1.13

Valore predefinito: Nessuno

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

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

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

ad esempio:

  EnvVars:
    HTTP_PROXY: 'http://1.1.1.1:80'

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

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

ad esempio:

  EnvVars:
    HTTPS_PROXY: 'https://1.1.1.1:80'

La variabile NO_PROXY deve essere definita come una stringa di nomi di 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'

Se hai attivato il proxy in avanti HTTP, puoi utilizzare envVars: HTTP_PROXY, envVars: HTTPS_PROXY o envVars: NO_PROXY.

Consulta la sezione Supporto dei proxy nella documentazione di OpenTelemetry.

metrics.collector.imagePullPolicy Avanzato Introdotta nella versione: 1.12.0

Valore predefinito: IfNotPresent

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

  • IfNotPresent: non importare una nuova immagine se esiste già.
  • Always: estrae sempre l'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 Introdotta nella versione: 1.12.0

Valore predefinito: v0.93.0

L'etichetta della versione dell'immagine Docker di questo servizio.

metrics.collector.image.url Di base Introdotta 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 Introdotta nella versione: 1.12.0

Valore predefinito: 500m

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

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

Valore predefinito: 512Mi

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

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

Valore predefinito: 500m

Il limite di CPU per la risorsa dell'app in un contenitore Kubernetes, in millicore.

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

Valore predefinito: 1Gi

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

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

Valore predefinito: 5

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

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

Valore predefinito: 30

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

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

Valore predefinito: 10

Determina la frequenza con cui eseguire un controllo di presenza, in secondi. Il valore minimo è 1.

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

Valore predefinito: 1

Il numero minimo di operazioni riuscite consecutive necessarie per considerare riuscita una verifica di attività dopo un errore. Il valore minimo è 1.

metrics.collector.livenessProbe.timeoutSeconds Avanzato Introdotta 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 Introdotta nella versione: 1.12.0

Valore predefinito: 3

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

metrics.collector.readinessProbe.initialDelaySeconds Avanzato Introdotta 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 Introdotta nella versione: 1.12.0

Valore predefinito: 10

Determina la frequenza con cui eseguire un controllo di idoneità, in secondi. Il valore minimo è 1.

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

Valore predefinito: 1

Il numero minimo di operazioni riuscite consecutive necessarie per considerare riuscita una verifica di idoneità dopo un errore. Il valore minimo è 1.

metrics.collector.readinessProbe.timeoutSeconds Avanzato Introdotta 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 Introdotta nella versione: 1.12.0

Valore predefinito: true

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

metrics.enabled Di base Introdotta nella versione: 1.0.0

Valore predefinito: true

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

metrics.gsa Avanzato Introdotta nella versione: 1.10.0

Valore predefinito: Nessuno

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

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

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

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

Consulta Abilitazione di Workload Identity su GKE o Abilitazione di Workload Identity Federation su AKS ed EKS.

metrics.nodeSelector.key Di base Introdotta nella versione: 1.0.0

Valore predefinito: Nessuno

Obbligatorio

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

Consulta Configurare i pool di nodi dedicati.

metrics.nodeSelector.value Di base Introdotta nella versione: 1.0.0

Valore predefinito: Nessuno

Obbligatorio

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

Consulta Configurare i pool di nodi dedicati.

metrics.prometheus.containerPort Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 9090

La porta per connettersi al servizio di metriche Prometheus.

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

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta Aggiornare le immagini.

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

Valore predefinito: v2.45.0

L'etichetta della versione dell'immagine Docker di questo servizio.

metrics.prometheus.image.url Avanzato Introdotta 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 Introdotta nella versione: 1.0.0

Valore predefinito: 6

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

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

Valore predefinito: 5

Determina la frequenza con cui eseguire un controllo di presenza, in secondi. Il valore minimo è 1.

metrics.prometheus.livenessProbe.timeoutSeconds Avanzato Introdotta 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 Introdotta nella versione: 1.0.0

Valore predefinito: 120

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

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

Valore predefinito: 5

Determina la frequenza con cui eseguire un controllo di idoneità, in secondi. Il valore minimo è 1.

metrics.prometheus.readinessProbe.timeoutSeconds Avanzato Introdotta 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.sslCertPath Di base Introdotta nella versione: 1.0.0

Valore predefinito: Nessuno

Obbligatorio

Percorso del certificato SSL per il processo di raccolta delle metriche di Prometheus. Prometheus è uno strumento utilizzabile da Apigee per raccogliere ed elaborare le metriche.

Vedi:

metrics.prometheus.sslKeyPath Di base Introdotta nella versione: 1.0.0

Valore predefinito: Nessuno

Obbligatorio

Percorso della chiave SSL per il processo di raccolta delle metriche di Prometheus. Prometheus è uno strumento utilizzabile da Apigee per raccogliere ed elaborare le metriche.

Vedi:

metrics.proxy.resources.requests.cpu Avanzato Introdotta nella versione: 1.4.0

Valore predefinito: 500m

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

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

Valore predefinito: 512Mi

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

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

Valore predefinito: 500m

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

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

Valore predefinito: 1Gi

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

metrics.proxyStackdriverExporter.resources.requests.cpu Avanzato Introdotta nella versione: 1.7.0

Valore predefinito: 128m

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

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

Valore predefinito: 500m

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

metrics.proxyStackdriverExporter.resources.limits.memory Avanzato Introdotta 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 Introdotta nella versione: 1.0.0

Valore predefinito: Nessuno

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

metrics.sdSidecar.containerPort Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 9091

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

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

Valore predefinito: IfNotPresent

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

  • IfNotPresent: non importare una nuova immagine se esiste già
  • Always: estrae sempre il criterio, anche se esiste già

    Per ulteriori informazioni, consulta Aggiornare le immagini.

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

Valore predefinito: v0.9.0

L'etichetta della versione dell'immagine Docker di questo servizio.

metrics.sdSidecar.image.url Avanzato Introdotta 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 Introdotta 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 monitoraggio.

metrics.serviceAccountRef Di base Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

È obbligatorio specificare serviceAccountPath o serviceAccountRef.

metrics.stackdriverExporter.resources.requests.cpu Avanzato Introdotta 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 Introdotta 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 Introdotta 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 Introdotta 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 Introdotta nella versione: 1.0.0

Valore predefinito: 300

Il tempo che intercorre tra una richiesta di eliminazione del pod e il momento in cui il pod viene interrotto, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop ed eventuali processi in esecuzione dovrebbero terminare in modo corretto.

metrics.tolerations.effect Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

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

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

metrics.tolerations.key Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

metrics.tolerations.operator Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

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

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

metrics.tolerations.tolerationSeconds Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

tolerationSeconds definisce in secondi il tempo per cui un pod rimane associato a un nodo in stato di errore o non rispondente.

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

metrics.tolerations.value Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

mintTaskScheduler

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

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

Proprietà Tipo Descrizione
mintTaskScheduler.image.pullPolicy Avanzato Introdotta 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 importare una nuova immagine se esiste già.
  • Always: estrae sempre l'immagine, indipendentemente dal fatto che esista già.

Per ulteriori informazioni, consulta Aggiornare le immagini.

mintTaskScheduler.image.tag Avanzato Introdotta nella versione: 1.7.0

Valore predefinito: 1.14.0

L'etichetta della versione dell'immagine Docker di questo servizio.

mintTaskScheduler.image.url Avanzato Introdotta 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 Introdotta nella versione: 1.1.0

Valore predefinito: 2000m

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

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

Valore predefinito: 4Gi

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

mintTaskScheduler.resources.requests.cpu Avanzato Introdotta nella versione: 1.7.0

Valore predefinito: 500m

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

mintTaskScheduler.resources.requests.memory Avanzato Introdotta nella versione: 1.7.0

Valore predefinito: 512Mi

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

mintTaskScheduler.tolerations.effect Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

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

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

mintTaskScheduler.tolerations.key Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

mintTaskScheduler.tolerations.operator Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

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

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

mintTaskScheduler.tolerations.tolerationSeconds Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

tolerationSeconds definisce in secondi il tempo per cui un pod rimane associato a un nodo in stato di errore o non rispondente.

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

mintTaskScheduler.tolerations.value Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

newDataPipeline

newDataPipeline determina se Apigee Hybrid utilizza la nuova pipeline di dati per i componenti di runtime per scrivere i dati direttamente nel piano di controllo. Questa proprietà è obbligatoria per le organizzazioni ibride abilitate per la residenza dei dati nella versione 1.13.1 o successive. Non tentare di utilizzare la nuova funzionalità della pipeline di dati con organizzazioni non in cui è attiva la residenza dei dati. Solo le nuove organizzazioni create su versione ibrida 1.13.1 possono utilizzare questa nuova funzionalità. Consulta anche Utilizzare la residenza dei dati con Apigee hybrid.

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

Proprietà Tipo Descrizione
newDataPipeline.debugSession Avanzato Introdotta 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 la residenza dei dati abilitata). Lascialo impostato su false per disattivare la nuova pipeline di dati. Per ulteriori informazioni, consulta Raccolta dei dati di analisi e debug con la residenza dei dati.

newDataPipeline.analytics Avanzato Introdotta 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 (obbligatorio per le nuove organizzazioni ibride v1.13.1 con la residenza dei dati abilitata). Lascialo impostato su false per forzare Analytics a utilizzare la vecchia pipeline di dati. Per ulteriori informazioni, consulta Raccolta dei dati di analisi e 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 esegui l'installazione o l'upgrade dei grafici apigee-org e apigee-ingress-manager. Puoi sostituire questo valore per i singoli oggetti nella proprietà mart:nodeSelector.

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

Proprietà Tipo Descrizione
nodeSelector.apigeeData.key Avanzato Introdotta 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 lavorare con i dati dei servizi Apigee.

Consulta Configurare i pool di nodi dedicati.

nodeSelector.apigeeData.value Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: apigee-data

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

Consulta Configurare i pool di nodi dedicati.

nodeSelector.apigeeRuntime.key Avanzato Introdotta 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 dei nodi per scegliere come target i nodi Kubernetes per i servizi di runtime Apigee.

Consulta Configurare i pool di nodi dedicati.

nodeSelector.apigeeRuntime.value Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: apigee-runtime

apigee-runtime è il nodo per l'ambiente di runtime del progetto. Valore dell'etichetta del selettore dei nodi per scegliere come target i nodi Kubernetes per i servizi di runtime Apigee.

Consulta Configurare i pool di nodi dedicati.

nodeSelector.requiredForScheduling Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: true

Il valore predefinito della proprietà requiredForScheduling è true. Quando true, significa che se Kubernetes non riesce a trovare i nodi con la chiave/il valore dell'etichetta configurata, i pod sottostanti non verranno pianificati sui nodi worker VM.

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

Consulta Configurare i pool di nodi dedicati.

redis

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

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

Valore predefinito: iloveapis123

Obbligatorio

Password per l'amministratore di Redis. L'utente amministratore viene utilizzato per tutte le attività amministrative svolte sul cluster Redis.

redis.auth.secret Di base Introdotta nella versione: 1.9.1

Valore predefinito: Nessuno

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

data:
    redis.auth.password: encoded_value

Vedi anche:

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

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta Aggiornare le immagini.

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

Valore predefinito: v1.27.0

L'etichetta della versione dell'immagine Docker di questo servizio.

redis.envoy.image.url Avanzato Introdotta 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 Introdotta nella versione: 1.6.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta Aggiornare le immagini.

redis.image.tag Avanzato Introdotta nella versione: 1.6.0

Valore predefinito: 1.14.0

L'etichetta della versione dell'immagine Docker di questo servizio.

redis.image.url Avanzato Introdotta 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 Introdotta nella versione: 1.6.0

Valore predefinito: 2

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

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

Valore predefinito: 500m

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

redis.tolerations.effect Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

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

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

redis.tolerations.key Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

redis.tolerations.operator Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

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

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

redis.tolerations.tolerationSeconds Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

tolerationSeconds definisce in secondi il tempo per cui un pod rimane associato a un nodo in stato di errore o non rispondente.

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

redis.tolerations.value Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

runtime

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

Proprietà Tipo Descrizione
runtime.annotations Avanzato Introdotta 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 Introdotta nella versione: 1.13.1

Valore predefinito: Nessuno

Ti consente di fornire variabili env aggiuntive al componente di runtime in una coppia chiave-valore:

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

ad esempio:

runtime:
  envVars:
    RUNTIME_ENV_VAR1: "value of runtime env-var 1"
    RUNTIME_ENV_VAR2: "value of runtime env-var 2"
runtime.image.pullPolicy Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta Aggiornare le immagini.

runtime.image.tag Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 1.14.0

L'etichetta della versione dell'immagine Docker di questo servizio.

runtime.image.url Avanzato Introdotta 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 Introdotta nella versione: 1.0.0

Valore predefinito: 2

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

runtime.livenessProbe.initialDelaySeconds Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 60

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

runtime.livenessProbe.periodSeconds Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 5

Determina la frequenza con cui eseguire un controllo di presenza, in secondi. Il valore minimo è 1.

runtime.livenessProbe.timeoutSeconds Avanzato Introdotta 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 Introdotta nella versione: 1.0.0

Valore predefinito: Nessuno

Chiave dell'etichetta del selettore dei nodi facoltativa per scegliere come target i nodi Kubernetes per i servizi runtime.

Vedi la proprietà nodeSelector.

runtime.nodeSelector.value Di base Introdotta nella versione: 1.0.0

Valore predefinito: Nessuno

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

Consulta Configurare i pool di nodi dedicati.

runtime.readinessProbe.failureThreshold Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 2

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

runtime.readinessProbe.initialDelaySeconds Avanzato Introdotta 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 Introdotta nella versione: 1.0.0

Valore predefinito: 5

Determina la frequenza con cui eseguire un controllo di idoneità, in secondi. Il valore minimo è 1.

runtime.readinessProbe.successThreshold Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 1

Il numero minimo di operazioni riuscite consecutive necessarie per considerare riuscita una verifica di idoneità dopo un errore. Il valore minimo è 1.

runtime.readinessProbe.timeoutSeconds Avanzato Introdotta 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 Introdotta nella versione: 1.0.0

Valore predefinito: 4

Numero massimo di repliche disponibili per la scalabilità automatica.

runtime.replicaCountMin Di base Introdotta nella versione: 1.0.0

Valore predefinito: 1

Numero minimo di repliche disponibili per la scalabilità automatica.

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

Valore predefinito: 4000m

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

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

Valore predefinito: 6Gi

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

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

Valore predefinito: 500m

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

runtime.resources.requests.memory Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 512Mi (vedi nota di seguito)

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

runtime.service.type Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: ClusterIP

Il tipo di servizio. Puoi impostarlo su un servizio diverso da ClusterIP, ad esempio LoadBalancer.

runtime.targetCPUUtilizationPercentage Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 75

Utilizzo della CPU target per il processo di runtime nel pod. Il valore di questo campo consente al runtime di eseguire la scalabilità automatica quando l'utilizzo della CPU raggiunge questo valore, fino a replicaCountMax.

runtime.terminationGracePeriodSeconds Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 180

Il tempo che intercorre tra una richiesta di eliminazione del pod e il momento in cui il pod viene interrotto, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop ed eventuali processi in esecuzione dovrebbero terminare in modo corretto.

runtime.tolerations.effect Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

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

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

runtime.tolerations.key Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

runtime.tolerations.operator Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

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

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

runtime.tolerations.tolerationSeconds Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

tolerationSeconds definisce in secondi il tempo per cui un pod rimane associato a un nodo in stato di errore o non rispondente.

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

runtime.tolerations.value Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

synchronizer

Garantisce che i processori di messaggi vengano mantenuti aggiornati con gli ultimi bundle del proxy API di cui è stato eseguito il deployment. A questo scopo, il Synchronizer esegue il polling del piano di gestione. Quando viene rilevato un nuovo contratto, lo invia al piano di runtime. Per impostazione predefinita, Synchronizer memorizza i dati di configurazione dell'ambiente in Cassandra.

Per ulteriori informazioni, vedi Configurare il sincronizzatore.

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

Proprietà Tipo Descrizione
synchronizer.annotations Avanzato Introdotta 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 Introdotta nella versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta Aggiornare le immagini.

synchronizer.image.tag Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 1.14.0

L'etichetta della versione dell'immagine Docker di questo servizio.

synchronizer.image.url Avanzato Introdotta 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 Introdotta nella versione: 1.0.0

Valore predefinito: 2

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

synchronizer.livenessProbe.initialDelaySeconds Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 0

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

synchronizer.livenessProbe.periodSeconds Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 5

Determina la frequenza con cui eseguire un controllo di presenza, in secondi. Il valore minimo è 1.

synchronizer.livenessProbe.timeoutSeconds Avanzato Introdotta 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 Introdotta nella versione: 1.0.0

Valore predefinito: Nessuno

Obbligatorio

Chiave dell'etichetta del selettore dei nodi facoltativa per scegliere come target i nodi Kubernetes per i servizi di runtime synchronizer.

Vedi nodeSelector.

synchronizer.nodeSelector.value Di base Introdotta nella versione: 1.0.0

Valore predefinito: Nessuno

Valore facoltativo dell'etichetta del selettore dei nodi utilizzato per scegliere come target i nodi Kubernetes per i servizi di runtime synchronizer.

Vedi nodeSelector.

synchronizer.pollInterval Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 60

Il periodo di tempo che Synchronizer attende tra le operazioni di polling. Il sincronizzatore esegue il polling dei servizi del piano di controllo di Apigee per rilevare e recuperare i nuovi contratti di runtime.

synchronizer.readinessProbe.failureThreshold Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 2

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

synchronizer.readinessProbe.initialDelaySeconds Avanzato Introdotta 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 Introdotta nella versione: 1.0.0

Valore predefinito: 5

Determina la frequenza con cui eseguire un controllo di idoneità, in secondi. Il valore minimo è 1.

synchronizer.readinessProbe.successThreshold Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 1

Il numero minimo di operazioni riuscite consecutive necessarie per considerare riuscita una verifica di idoneità dopo un errore. Il valore minimo è 1.

synchronizer.readinessProbe.timeoutSeconds Avanzato Introdotta 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 Introdotta nella versione: 1.0.0

Deprecated: a partire dalla versione 1.2 di Hybrid, gestisci il conteggio delle repliche del sincronizzatore con: synchronizer.replicaCountMax e synchronizer.replicaCountMin

synchronizer.replicaCountMax Di base Introdotta nella versione: 1.2.0

Valore predefinito: 4

Numero massimo di repliche per la scalabilità automatica.

synchronizer.replicaCountMin Di base Introdotta nella versione: 1.2.0

Valore predefinito: 1

Numero minimo di repliche per la scalabilità automatica.

synchronizer.resources.limits.cpu Avanzato Introdotta nella versione: 1.11.0

Valore predefinito: 2000m

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

synchronizer.resources.limits.memory Avanzato Introdotta nella versione: 1.11.0

Valore predefinito: 5Gi

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

synchronizer.resources.requests.cpu Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 100m

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

synchronizer.resources.requests.memory Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 1Gi

La memoria necessaria per il normale funzionamento della risorsa in un contenitore Kubernetes, in gigabyte.

synchronizer.serviceAccountPath Di base Introdotta 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 Apigee Synchronizer Manager.

synchronizer.serviceAccountRef Di base Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

È obbligatorio specificare serviceAccountPath o serviceAccountRef.

synchronizer.serviceAccountSecret Di base Introdotta nella versione: 1.1.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.

synchronizer.targetCPUUtilizationPercentage Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 75

Utilizzo CPU target per il processo Synchronizer nel pod. Il valore di questo campo consente a Synchronizer di eseguire la scalabilità automatica quando l'utilizzo della CPU raggiunge questo valore, fino a replicaCountMax.

synchronizer.terminationGracePeriodSeconds Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 30

Il tempo che intercorre tra una richiesta di eliminazione del pod e il momento in cui il pod viene interrotto, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop ed eventuali processi in esecuzione dovrebbero terminare in modo corretto.

synchronizer.tolerations.effect Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

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

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

synchronizer.tolerations.key Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

synchronizer.tolerations.operator Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

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

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

synchronizer.tolerations.tolerationSeconds Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

tolerationSeconds definisce in secondi il tempo per cui un pod rimane associato a un nodo in stato di errore o non rispondente.

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

synchronizer.tolerations.value Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

udca

(Universal Data Collection Agent) definisce il servizio in esecuzione nel pod di raccolta dei dati nel piano di runtime. Questo servizio estrae i dati di analisi e stato di implementazione e li invia alla Unified Analytics Platform (UAP).

Per ulteriori informazioni, consulta la sezione Raccolta dei dati di analisi e stato di implementazione.

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

Proprietà Tipo Descrizione
udca.annotations Avanzato Introdotta 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 Introdotta nella versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta Aggiornare le immagini.

udca.fluentd.image.tag Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 1.9.12-2

L'etichetta della versione dell'immagine Docker di questo servizio.

udca.fluentd.image.url Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: gcr.io/apigee-release/hybrid/apigee-stackdriver-logging-agent

La posizione dell'immagine Docker per questo servizio.

udca.fluentd.resources.limits.cpu Avanzato Introdotta nella versione: 1.11.0

Valore predefinito: 1000m

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

udca.fluentd.resources.limits.memory Avanzato Introdotta nella versione: 1.11.0

Valore predefinito: 500Mi

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

udca.fluentd.resources.requests.cpu Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 500m

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

udca.fluentd.resources.requests.memory Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 250Mi

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

udca.gsa Avanzato Introdotta nella versione: 1.10.0

Valore predefinito: Nessuno

Solo Helm: l'indirizzo email dell'apigee-udca account di servizio IAM (GSA) di Google da associare all'account di servizio Kubernetes corrispondente quando attivi Workload Identity sui cluster GKE utilizzando i grafici Helm. Imposta questo valore dopo aver impostato gcp.workloadIdentity.enabled su true.

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

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

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

Consulta Abilitazione di Workload Identity su GKE o Abilitazione di Workload Identity Federation su AKS ed EKS.

udca.image.pullPolicy Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta Aggiornare le immagini.

udca.image.tag Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 1.14.0

L'etichetta della versione dell'immagine Docker di questo servizio.

udca.image.url Avanzato Introdotta 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 Introdotta nella versione: 1.0.0

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

udca.jvmXmx Avanzato Introdotta nella versione: 1.0.0

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

udca.livenessProbe.failureThreshold Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 2

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

udca.livenessProbe.initialDelaySeconds Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 0

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

udca.livenessProbe.periodSeconds Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 5

Determina la frequenza con cui eseguire un controllo di presenza, in secondi. Il valore minimo è 1.

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

Valore predefinito: Nessuno

Obbligatorio

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

Consulta Configurare i pool di nodi dedicati.

udca.nodeSelector.value Di base Introdotta nella versione: 1.0.0

Valore predefinito: Nessuno

Obbligatorio

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

Consulta Configurare i pool di nodi dedicati.

udca.pollingIntervalInSec Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 1

La durata, in secondi, dell'attesa dell'UDCA tra le operazioni di polling. UDCA esegue la polling della directory dei dati sul file system del pod di raccolta dei dati per rilevare i nuovi file da caricare.

udca.replicaCountMax Di base Introdotta nella versione: 1.0.0

Valore predefinito: 4

Il numero massimo di pod che Hybrid 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 Introdotta 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, la versione ibrida aumenterà gradualmente il numero di pod fino a udca.replicaCountMax.

udca.resources.limits.cpu Avanzato Introdotta nella versione: 1.11.0

Valore predefinito: 1000m

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

udca.resources.limits.memory Avanzato Introdotta nella versione: 1.11.0

Valore predefinito: 2Gi

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

udca.resources.requests.cpu Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 250m

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

udca.resources.requests.memory Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 250Mi

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

udca.revision Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: v1

Un valore statico inserito in un'etichetta per attivare i deployment canary.

udca.serviceAccountPath Di base Introdotta 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 Agente Apigee Analytics.

udca.serviceAccountRef Di base Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

È obbligatorio specificare serviceAccountPath o serviceAccountRef.

udca.targetCPUUtilizationPercentage Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 75

La soglia di utilizzo della CPU per la scalabilità del numero di pod nel ReplicaSet, in percentuale delle risorse CPU totali disponibili. La modalità ibrida utilizza l'utilizzo combinato di tutti i container nel pod di raccolta dei dati (sia fluentd che UDCA) per calcolare l'utilizzo corrente.

Quando l'utilizzo della CPU supera questo valore, la modalità ibrida aumenterà gradualmente il numero di pod nel ReplicaSet fino a udca.replicaCountMax.

udca.terminationGracePeriodSeconds Avanzato Introdotta nella versione: 1.0.0

Valore predefinito: 600

Il tempo che intercorre tra una richiesta di eliminazione del pod e il momento in cui il pod viene interrotto, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop ed eventuali processi in esecuzione dovrebbero terminare in modo corretto.

udca.tolerations.effect Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

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

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

udca.tolerations.key Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

udca.tolerations.operator Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

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

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

udca.tolerations.tolerationSeconds Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

tolerationSeconds definisce in secondi il tempo per cui un pod rimane associato a un nodo in stato di errore o non rispondente.

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

udca.tolerations.value Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

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

Per informazioni dettagliate, consulta Contaminazioni 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 ulteriori informazioni, consulta Configurare gli host virtuali.

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

Proprietà Tipo Descrizione
virtualhosts[].additionalGateways Di base Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

Un elenco di gateway Istio a cui instradare il traffico.

virtualhosts[].cipherSuites[] Avanzato Introdotta nella versione: 1.9.2

Valore predefinito: Nessuno

Questa proprietà configura le chiavi di crittografia TLS utilizzate nel gateway in entrata. Di seguito è riportato un elenco delle crittografie abilitate per impostazione predefinita in formato OpenSSL. Puoi trovare ulteriori informazioni sulle cifre supportate nella documentazione della build Boring FIPS di Envoy. Se il valore è vuoto, per impostazione predefinita vengono utilizzate le suite di crittografia supportate dalla compilazione Boring FIPS di Envoy.

Abilitato per impostazione predefinita per TLS 1.3 (non puoi sostituire le suite di crittografia TLS 1.3):

  • TLS_AES_128_GCM_SHA256
  • TLS_AES_256_GCM_SHA384
  • TLS_CHACHA20_POLY1305_SHA256

Abilitato per impostazione predefinita per TLS 1.2:

  • ECDHE-ECDSA-AES128-GCM-SHA256
  • ECDHE-RSA-AES128-GCM-SHA256
  • ECDHE-ECDSA-AES256-GCM-SHA384
  • ECDHE-RSA-AES256-GCM-SHA384

Se vuoi attivare versioni precedenti di TLS nel deployment del gateway di ingresso Apigee, utilizza virtualhosts.minTLSProtocolVersion insieme alla proprietà virtualhosts.cipherSuites.

Ad esempio, per attivare TLS 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 Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

Obbligatorio

Il nome dell'host virtuale.

virtualhosts[].maxTLSProtocolVersion Di base Introdotta nella versione: 1.3.0

Valore predefinito: Nessuno

La versione massima del protocollo TLS che Envoy può selezionare. Envoy utilizza automaticamente la versione ottimale del protocollo TLS tra virtualhosts[].minTLSProtocolVersion e virtualhosts[].maxTLSProtocolVersion.

Il valore deve essere sotto forma di numero. Ad esempio:

virtualhosts:
  - name: default
    maxTLSProtocolVersion: "1.3"

dove il numero rappresenta il numero di versione TLS nel formato #.#. Nell'esempio precedente, "1.3" rappresenta la versione TLS di Istio TLSV1_3.

Consulta anche ServerTLSSettings.TLSProtocol nella documentazione di Istio.

virtualhosts[].minTLSProtocolVersion Di base Introdotta nella versione: 1.3.0

Valore predefinito: Nessuno

La versione minima del protocollo TLS che Envoy può selezionare. Envoy utilizza automaticamente la versione ottimale del protocollo TLS tra virtualhosts[].minTLSProtocolVersion e virtualhosts[].maxTLSProtocolVersion.

Il valore deve essere sotto forma di numero. Ad esempio:

virtualhosts:
  - name: default
    minTLSProtocolVersion: "1.2"

dove il numero rappresenta il numero di versione TLS nel formato #.#. Nell'esempio precedente, 1.2 rappresenta la versione TLS di Istio TLSV1_2.

Consulta anche ServerTLSSettings.TLSProtocol nella documentazione di Istio.

virtualhosts[].selector Di base Introdotta nella versione: 1.2.0

Valore predefinito: app: apigee-ingressgateway

Obbligatorio

Una coppia chiave-valore per il selettore per fare riferimento a diversi selettori di ingressi.

  • apigee-ingressgateway: per le installazioni di Apigee hybrid che utilizzano il gateway di ingresso Apigee.
  • istio-ingressgateway: per le installazioni di Apigee hybrid che utilizzano Cloud Service Mesh (versioni Apigee hybrid 1.8 e precedenti).

Se non viene fornita un'etichetta del selettore, la configurazione viene fornita al gateway di ingresso Apigee.

virtualhosts[].sslCertPath Di base Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

Il percorso sul sistema di un file del certificato TLS.

virtualhosts[].sslKeyPath Di base Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

Il percorso sul sistema del file della chiave privata TLS.

virtualhosts[].sslSecret Di base Introdotta nella versione: 1.2.0

Valore predefinito: Nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

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

Vedi anche:

watcher

La proprietà watcher è una proprietà di configurazione obbligatoria. Il watcher è un processo che controlla le modifiche alla configurazione e attiva l'applicazione nel piano di runtime.

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

Proprietà Tipo Descrizione
watcher.annotations Avanzato Introdotta 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 Introdotta nella versione: 1.10.0

Valore predefinito: true

Attiva o disattiva la visualizzazione automatica dei problemi. Quando è true, Watcher esamina automaticamente lo stato del piano di controllo e del server API Kubernetes per determinare se sono presenti problemi di configurazione.

Imposta su false per disattivare la visualizzazione automatica dei problemi. Per saperne di più, consulta Rilevamento automatico dei problemi.

watcher.args.enableLeaderElect Avanzato Introdotta nella versione: 1.13.0

Valore predefinito: true

Quando true (il valore predefinito) watcher.args.enableLeaderElect seleziona un singolo pod di osservatori per gestire e segnalare le informazioni di routing. È necessario limitare questa operazione a un singolo pod per evitare i tempi di riposo durante gli upgrade o il rollback. Durante questi eventi, possono essere in esecuzione contemporaneamente più versioni di Watcher. Ogni istanza di Watcher potrebbe avere una logica di creazione dei percorsi diversa, il che può causare tempi di riposo.watcher.replicaCountMax.

watcher.args.issueScanInterval Avanzato Introdotta 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 Introdotta nella versione: 1.10.0

Valore predefinito: Nessuno

Solo Helm: l'indirizzo email dell'apigee-watcher account di servizio IAM (GSA) di Google da associare all'account di servizio Kubernetes corrispondente quando attivi Workload Identity sui cluster GKE utilizzando i grafici Helm. Imposta questo valore dopo aver impostato gcp.workloadIdentity.enabled su true.

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

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

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

Consulta Abilitazione di Workload Identity su GKE o Abilitazione di Workload Identity Federation su AKS ed EKS.

watcher.image.pullPolicy Avanzato Introdotta nella versione: 1.4.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, consulta Aggiornare le immagini.

watcher.image.tag Avanzato Introdotta nella versione: 1.4.0

Valore predefinito: 1.14.0

L'etichetta della versione dell'immagine Docker di questo servizio.

watcher.image.url Avanzato Introdotta 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 Introdotta nella versione: 1.3.0

Valore predefinito: 1

Il numero massimo di repliche di osservatori. Deve essere impostato su 1 per evitare conflitti.

Apigee hybrid utilizza un pod di monitoraggio per installazione. L'elezione del leader seleziona automaticamente un pod di osservatori. Le repliche dei pod di monitoraggio aggiuntive verranno forzate in uno stato instabile. Vedi watcher.args.enableLeaderElect.

watcher.replicaCountMin Di base Introdotta nella versione: 1.3.0

Valore predefinito: 1

Il numero minimo di repliche dello watcher.

watcher.resources.limits.cpu Avanzato Introdotta nella versione: 1.11.0

Valore predefinito: 1000m

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

watcher.resources.limits.memory Avanzato Introdotta nella versione: 1.11.0

Valore predefinito: 2Gi

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

watcher.serviceAccountPath Di base Introdotta 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 Introdotta nella versione: 1.3.0

Valore predefinito: Nessuno

È obbligatorio specificare uno tra serviceAccountPath o serviceAccountRef.

watcher.tolerations.effect Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

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

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

watcher.tolerations.key Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

watcher.tolerations.operator Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

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

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

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

watcher.tolerations.tolerationSeconds Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

tolerationSeconds definisce in secondi il tempo per cui un pod rimane associato a un nodo in stato di errore o non rispondente.

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.

watcher.tolerations.value Avanzato Introdotta nella versione: 1.10.1

Valore predefinito: Nessuno

Utilizzato dalla funzionalità di incompatibilità e tolleranze di Kubernetes.

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

Per informazioni dettagliate, consulta Contaminazioni e tolleranze: concetti.