Riferimento per le proprietà di configurazione

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

Filtra questa pagina

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

Rete Display   in questa pagina.

Proprietà di primo livello

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

Proprietà Tipo Descrizione
axHashSalt Avanzata

Introdotta nella versione: 1.3.0

Valore predefinito : il nome della tua organizzazione

Optional

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

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

Vedi: Ooffuscare i dati utente per l'analisi.

contractProvider Avanzata Introdotta nella versione: 1.0.0

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

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

gcpProjectID Avanzata Deprecated: Per 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 (deprecato) e gcpRegion (deprecato) per identificare il progetto e determinare dove apigee-logger e apigee-metrics eseguono il push dei propri dati.

gcpRegion Avanzata 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 del tuo cluster Kubernetes. Funziona con gcpProjectID (deprecato) e k8sClusterName (deprecato) per identificare il progetto e determinare dove apigee-logger e apigee-metrics eseguono il push dei propri dati.

imagePullSecrets.name Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Nome del secret Kubernetes configurato come tipo di registro Docker; utilizzato per eseguire il pull delle immagini dal repository privato.

instanceID Base Introdotta nella versione: 1.3.0

Valore predefinito: nessuno

Obbligatorio

Un identificatore univoco per questa installazione.

Una stringa univoca per identificare questa istanza. Può essere una combinazione qualsiasi di lettere e numeri, con una lunghezza massima di 63 caratteri.

k8sClusterName Avanzata 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) su cui è in esecuzione il tuo progetto ibrido. Funziona con gcpProjectID (deprecato) e gcpRegion (deprecato) per identificare il progetto e determinare dove apigee-logger e apigee-metrics eseguono il push dei propri dati.

kmsEncryptionKey Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: defaults.org.kmsEncryptionKey

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

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

kmsEncryptionPath Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

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

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

kmsEncryptionSecret.key Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

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

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

kmsEncryptionSecret.name Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

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

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

kvmEncryptionKey Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: defaults.org.kmsEncryptionKey

Facoltativo. Utilizza un solo elemento kvmEncryptionKey, kvmEncryptionPath o kvmEncryptionSecret.

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

kvmEncryptionPath Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

Facoltativo. Utilizza un solo elemento kvmEncryptionKey, kvmEncryptionPath o kvmEncryptionSecret.

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

kvmEncryptionSecret.key Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

Facoltativo. Utilizza un solo elemento kvmEncryptionKey, kvmEncryptionPath o kvmEncryptionSecret.

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

kvmEncryptionSecret.name Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

Facoltativo. Utilizza un solo elemento kvmEncryptionKey, kvmEncryptionPath o kvmEncryptionSecret.

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

multiOrgCluster Avanzata 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 di override per ciascuna organizzazione in un cluster con più organizzazioni. Per saperne di più, consulta Aggiunta di più organizzazioni ibride a un cluster.

namespace Base Introdotta nella versione: 1.0.0

Valore predefinito: apigee

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

org Base

Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

L'organizzazione abilitata per gli ambienti ibridi di cui è stato eseguito il provisioning per te da Apigee durante l'installazione ibrida. Un'organizzazione è il container di primo livello in Apigee. Contiene tutti i proxy API e le risorse correlate. Se il valore è vuoto, devi aggiornarlo con il nome della tua organizzazione dopo averlo creato.

orgScopedUDCA Avanzata Introdotta nella versione: 1.8.0

Valore predefinito: true

Abilita il servizio UDCA (Universal Data Collection Agent) a livello di organizzazione, che estrae analisi, monetizzazione ed effettua il debug (tracciamento) e li invia alla Unified Analytics Platform (UAP) che si trova nel piano di controllo.

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

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

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

Vedi anche: udca.

revision Avanzata Introdotta nella versione: 1.0.0

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

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

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

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

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

Per ulteriori informazioni, consulta la sezione Aggiornamenti in sequenza.

validateOrg Avanzata Introdotta nella versione: 1.8.0

Valore predefinito: true

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

Vedi anche org

validateServiceAccounts Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: true

Abilita la convalida rigorosa delle autorizzazioni dell'account di servizio. Viene utilizzato il metodo API testIamPermissions di 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 le metriche e lo strumento, il progetto controllato si basa sulla configurazione di gcpProjectID overrides.yaml.

Vedi anche gcpProjectID

ao

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

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

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

Valore predefinito: true

Impedisce ad Apigee di fornire la configurazione all'ASM installato dal cliente.

  • Imposta true per le installazioni ibride utilizzando il gateway in entrata Apigee.
  • Imposta false per le installazioni ibride utilizzando Anthos Service Mesh (Apigee ibrido versioni 1.8 e precedenti).
ao.args.disableManagedClusterRoles Avanzata Introdotta nella versione: 1.10.0

Valore predefinito: true

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

ao.image.pullPolicy Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: IfNotPresent

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

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

Per maggiori informazioni, consulta Aggiornare le immagini.

ao.image.tag Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: 1.12.0

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

ao.image.url Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: gcr.io/apigee-release/hybrid/apigee-operators

La località dell'immagine Docker per questo servizio.

ao.installer.pullPolicy Avanzata Introdotta nella versione: 1.3.0

Valore predefinito: IfNotPresent

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

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

Per maggiori informazioni, consulta Aggiornare le immagini.

ao.installer.tag Avanzata Introdotta nella versione: 1.3.0

Valore predefinito: 1.12.0

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

ao.installer.url Avanzata Introdotta nella versione: 1.3.0

Valore predefinito: gcr.io/apigee-release/hybrid/apigee-installer

La località dell'immagine Docker per questo servizio.

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

Valore predefinito: 250m

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

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

Valore predefinito: 256Mi

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

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

Valore predefinito: 250m

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

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

Valore predefinito: 256Mi

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

ao.tolerations.effect Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Necessario per utilizzare la funzionalità Tensioni e tolleranze di Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, vedi Invecchiamenti e tolleranze: concetti.

ao.tolerations.key Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

ao.tolerations.operator Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

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

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

ao.tolerations.tolerationSeconds Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

ao.tolerations.value Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

apigeeIngressGateway

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

Consulta ingressGateways per configurare le singole istanze in modo univoco.

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

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

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

Valore predefinito: IfNotPresent

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

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

Per maggiori informazioni, consulta Aggiornare le immagini.

apigeeIngressGateway.image.tag Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: 1.18.7-asm.4-distroless

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

apigeeIngressGateway.image.url Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: gcr.io/apigee-release/hybrid/apigee-asm-ingress

La località dell'immagine Docker per questo servizio.

apigeeIngressGateway.nodeSelector.key Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: nessuno

Obbligatorio

Chiave di etichetta del selettore di nodi utilizzata per il targeting di nodi Kubernetes dedicati per i servizi gateway in entrata.

Vedi Configurazione dei pool di nodi dedicati.

apigeeIngressGateway.nodeSelector.value Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: nessuno

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

Vedi nodeSelector.

apigeeIngressGateway.replicaCountMax Base Introdotta nella versione: 1.11.0

Valore predefinito: 4

Il numero massimo di pod che gli ambienti ibridi possono aggiungere automaticamente per il gateway in entrata disponibile per la scalabilità automatica.

apigeeIngressGateway.replicaCountMin Base Introdotta nella versione: 1.11.0

Valore predefinito: 2

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

apigeeIngressGateway.tolerations.effect Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: nessuno

Necessario per utilizzare la funzionalità Tensioni e tolleranze di Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, vedi Invecchiamenti e tolleranze: concetti.

apigeeIngressGateway.tolerations.key Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: nessuno

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

apigeeIngressGateway.tolerations.operator Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: "Equal"

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

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

apigeeIngressGateway.tolerations.tolerationSeconds Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

apigeeIngressGateway.tolerations.value Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

cassandra

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

Per ulteriori informazioni, consulta Configurazione di StorageClass.

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

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

Valore predefinito: nessuno

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

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

Valore predefinito: iloveapis123

Obbligatorio

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

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

Valore predefinito: iloveapis123

Obbligatorio

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

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

Valore predefinito: iloveapis123

Obbligatorio

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

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

Valore predefinito: iloveapis123

Obbligatorio

Password per l'utente 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 Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per maggiori informazioni, consulta Aggiornare le immagini.

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

Valore predefinito: 1.12.0

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

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

Valore predefinito: gcr.io/apigee-release/hybrid/apigee-hybrid-cassandra-client

La località dell'immagine Docker per questo servizio.

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

Valore predefinito: iloveapis123

Obbligatorio

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

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

Valore predefinito: jmxuser

Obbligatorio

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

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

Valore predefinito: iloveapis123

Obbligatorio

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

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

Valore predefinito: apigee

Obbligatorio

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

cassandra.auth.secret Base Introdotta nella versione: 1.3.3

Valore predefinito: nessuno

Il nome del file archiviato in un secret Kubernetes che contiene gli utenti e le password Cassandra. Puoi creare il secret utilizzando le seguenti istruzioni: Crea il secret.

Vedi anche:

cassandra.auth.secretProviderClass Avanzata Introdotta nella versione: 1.10.3

Valore predefinito: nessuno

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

o il secret di Kubernetes archiviato:

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

cassandra.backup.cloudProvider Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: GCP

Obbligatorio se è abilitato il backup.

Cloud provider per l'archiviazione di backup.

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

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

cassandra.backup.dbStorageBucket Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio se è abilitato il backup.

Bucket Cloud Storage per i dati di backup.

cassandra.backup.enabled Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: false

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

Vedi Backup e ripristino da Cassandra.

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

Valore predefinito: IfNotPresent

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

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

Per maggiori informazioni, consulta Aggiornare le immagini.

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

Valore predefinito: 1.12.0

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

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

Valore predefinito: gcr.io/apigee-release/hybrid/apigee-cassandra-backup-utility

La località dell'immagine Docker per questo servizio.

cassandra.backup.schedule Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 0 2 * * *

La pianificazione del cron job.

Vedi Backup e ripristino da Cassandra.

cassandra.backup.serviceAccountPath Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Se il backup è abilitato, è obbligatorio specificare il valore backup.serviceAccountPath o backup.serviceAccountRef.

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

cassandra.backup.serviceAccountRef Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

Se il backup è abilitato, è obbligatorio specificare il valore backup.serviceAccountPath o backup.serviceAccountRef.

cassandra.clusterName Base Introdotta nella versione: 1.0.0

Valore predefinito: apigeecluster

Specifica il nome del cluster Cassandra.

cassandra.datacenter Base Introdotta nella versione: 1.0.0

Valore predefinito: dc-1

Specifica il data center del nodo Cassandra.

cassandra.dnsPolicy Base Introdotta nella versione: 1.1.1

Valore predefinito: nessuno

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

cassandra.externalSeedHost Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

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

cassandra.heapNewSize Base Introdotta nella versione: 1.0.0

Valore predefinito: 100M

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

cassandra.hostNetwork Base Introdotta nella versione: 1.1.1

Valore predefinito: false

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

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

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

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

cassandra.image.pullPolicy Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per maggiori informazioni, consulta Aggiornare le immagini.

cassandra.image.tag Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1.12.0

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

cassandra.image.url Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: gcr.io/apigee-release/hybrid/apigee-hybrid-cassandra

La località dell'immagine Docker per questo servizio.

cassandra.maxHeapSize Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 512M

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

cassandra.multiRegionSeedHost Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

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

cassandra.nodeSelector.key Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

Chiave di etichetta del selettore di nodi utilizzata per il targeting di nodi Kubernetes dedicati per i servizi dati cassandra.

Vedi Configurazione dei pool di nodi dedicati.

cassandra.nodeSelector.value Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

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

Vedi nodeSelector.

cassandra.port Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 9042

Numero di porta utilizzato per la connessione alla cassandra.

cassandra.rack Base Introdotta nella versione: 1.0.0

Valore predefinito: ra-1

Specifica il rack del nodo Cassandra.

cassandra.readinessProbe.failureThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 2

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

cassandra.readinessProbe.initialDelaySeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 0

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

cassandra.readinessProbe.periodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 10

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

cassandra.readinessProbe.successThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1

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

cassandra.readinessProbe.timeoutSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 5

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

cassandra.replicaCount Base Introdotta nella versione: 1.0.0

Valore predefinito: 1

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

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

Valore predefinito: 500m

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

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

Valore predefinito: 1Gi

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

cassandra.restore.cloudProvider Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: GCP

Obbligatorio se è abilitato il ripristino.

Cloud provider per l'archiviazione di backup.

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

cassandra.restore.dbStorageBucket Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio se è abilitato il ripristino.

Bucket Cloud Storage per il ripristino dei dati di backup.

cassandra.restore.enabled Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: false

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

Valore predefinito: IfNotPresent

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

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

Per maggiori informazioni, consulta Aggiornare le immagini.

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

Valore predefinito: 1.12.0

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

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

Valore predefinito: gcr.io/apigee-release/hybrid/apigee-cassandra-backup-utility

La località dell'immagine Docker per questo servizio.

cassandra.restore.serviceAccountPath Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Se il ripristino è abilitato, è obbligatorio specificare restore.serviceAccountPath o restore.serviceAccountRef.

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

cassandra.restore.serviceAccountRef Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

Se il ripristino è abilitato, è obbligatorio specificare restore.serviceAccountPath o restore.serviceAccountRef.

cassandra.restore.snapshotTimestamp Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio se è abilitato il ripristino.

Timestamp del backup da ripristinare.

cassandra.restore.user Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: admin account

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

cassandra.sslCertPath Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

Il percorso sul sistema di un file di certificato TLS.

cassandra.sslKeyPath Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

Il percorso sul sistema del file della chiave privata TLS.

cassandra.sslRootCAPath Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

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

cassandra.storage.capacity Base Introdotta nella versione: 1.0.0

Valore predefinito: 10Gi

Obbligatorio se viene specificato storage.storageclass

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

cassandra.storage.storageclass Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Specifica la classe di archiviazione on-prem in uso.

cassandra.terminationGracePeriodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 300

Il tempo in secondi tra una richiesta di eliminazione di un pod e il momento in cui il pod viene terminato. Durante questo periodo, verranno eseguiti eventuali hook prestop e qualsiasi processo in esecuzione dovrebbe terminare senza problemi.

cassandra.tolerations.effect Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Necessario per utilizzare la funzionalità Tensioni e tolleranze di Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, vedi Invecchiamenti e tolleranze: concetti.

cassandra.tolerations.key Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

cassandra.tolerations.operator Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

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

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

cassandra.tolerations.tolerationSeconds Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

cassandra.tolerations.value Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

certManager

Apigee utilizza cert-manager per la convalida dei certificati.

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

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

Valore predefinito: cert-manager

Lo spazio dei nomi per cert-manager.

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

connectAgent

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

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

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

Valore predefinito: nessuno

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

connectAgent.gsa Avanzata Introdotta nella versione: 1.10.0

Valore predefinito: nessuno

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

Gli indirizzi email di Google Search Ads generalmente hanno il formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

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

Vedi Abilitazione di Workload Identity su GKE o Abilitazione della federazione di Workload Identity su AKS ed EKS.

connectAgent.logLevel Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: INFO

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

  • INFO: messaggi informativi oltre a messaggi di avviso, errore e irreversibili. Utile soprattutto 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 irreversibili che causano l'arresto anomalo di Apigee Connect.
connectAgent.image.pullPolicy Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: IfNotPresent

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

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

Per maggiori informazioni, consulta Aggiornare le immagini.

connectAgent.image.tag Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: 1.12.0

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

connectAgent.image.url Avanzata Introdotta nella versione: 1.2.0

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

La località dell'immagine Docker per questo servizio. Controlla il file values.yaml per l'URL specifico.

connectAgent.replicaCountMax Base Introdotta nella versione: 1.2.0

Valore predefinito: 5

Numero massimo di repliche disponibili per la scalabilità automatica.

connectAgent.replicaCountMin Base Introdotta nella versione: 1.2.0

Valore predefinito: 1

Numero minimo di repliche disponibili per la scalabilità automatica.

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

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

Valore predefinito: 512m

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

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

Valore predefinito: 512Mi

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

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

Valore predefinito: 100m

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

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

Valore predefinito: 30Mi

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

connectAgent.server Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: apigeeconnect.googleapis.com:443

La posizione del server e la porta per questo servizio.

connectAgent.serviceAccountPath 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 per l'account di servizio apigee-mart.

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

connectAgent.serviceAccountRef Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare serviceAccountPath o serviceAccountRef.

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

connectAgent.targetCPUUtilizationPercentage Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: 75

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

connectAgent.terminationGracePeriodSeconds Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: 600

Il tempo in secondi tra una richiesta di eliminazione di un pod e il momento in cui il pod viene terminato. Durante questo periodo, verranno eseguiti eventuali hook prestop e qualsiasi processo in esecuzione dovrebbe terminare senza problemi.

connectAgent.tolerations.effect Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Necessario per utilizzare la funzionalità Tensioni e tolleranze di Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, vedi Invecchiamenti e tolleranze: concetti.

connectAgent.tolerations.key Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

connectAgent.tolerations.operator Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

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

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

connectAgent.tolerations.tolerationSeconds Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

connectAgent.tolerations.value Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

defaults

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

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

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

Valore predefinito: aWxvdmVhcGlzMTIzNDU2Nw==

Chiave di crittografia predefinita per l'organizzazione in KMS.

defaults.org.kvmEncryptionKey Base Introdotta nella versione: 1.0.0

Valore predefinito: aWxvdmVhcGlzMTIzNDU2Nw==

Chiave di crittografia predefinita per l'organizzazione in KVM.

defaults.env.kmsEncryptionKey Base Introdotta nella versione: 1.0.0

Valore predefinito: aWxvdmVhcGlzMTIzNDU2Nw==

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

defaults.env.kvmEncryptionKey Base Introdotta nella versione: 1.0.0

Valore predefinito: aWxvdmVhcGlzMTIzNDU2Nw==

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

defaults.env.cacheEncryptionKey Base Introdotta nella versione: 1.0.0

Valore predefinito: aWxvdmVhcGlzMTIzNDU2Nw==

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

diagnostic

Le impostazioni dello strumento di raccolta diagnostica.

Consulta Utilizzo del raccoglitore di diagnostica

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

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

Valore predefinito: nessuno

Obbligatorio

Nome del bucket Google Cloud Storage in cui verranno depositati i tuoi dati diagnostici.

Vedi Creazione di bucket di archiviazione.

diagnostic.container Base Introdotta nella versione: 1.6.0

Valore predefinito: nessuno

Obbligatorio

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

  • "apigee-cassandra" acquisisce dati sul databgase Cassandra. I pod istio-cassandra vengono eseguiti nello spazio dei nomi apigee.
  • "apigee-mart-server" acquisisce dati relativi a MART. I pod apigee-mart-server viene eseguito nello spazio dei nomi apigee.
  • "apigee-runtime" acquisisce dati relativi al processore di messaggi. I pod apigee-runtime viene eseguito nello spazio dei nomi apigee.
  • "apigee-synchronizer" acquisisce dati sul sincronizzatore. I pod apigee-synchronizer viene eseguito nello spazio dei nomi apigee.
  • L'app "apigee-udca" acquisisce dati relativi alle UDCA. I pod apigee-udca viene eseguito 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 in entrata Istio. I pod istio-proxy vengono eseguiti nello spazio dei nomi istio-system.
diagnostic.loggingDetails.logDuration Base Introdotta nella versione: 1.6.0

Valore predefinito: nessuno

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

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

Leggi diagnostic.operation

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

Valore predefinito: nessuno

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

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

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

Valore predefinito: nessuno

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

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

diagnostic.namespace Base Introdotta nella versione: 1.6.0

Valore predefinito: nessuno

Obbligatorio

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

apigee per

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

istio-system per

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

Valore predefinito: nessuno

Obbligatorio

Specifica se raccogliere tutte le statistiche o solo i log.

I valori sono:

diagnostic.podNames[] Base Introdotta nella versione: 1.6.0

Valore predefinito: nessuno

Obbligatorio

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

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

Valore predefinito: nessuno

Obbligatorio

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

Vedi Informazioni sugli account di servizio.

diagnostic.tcpDumpDetails.maxMsgs Base Introdotta nella versione: 1.6.0

Valore predefinito: nessuno

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

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

diagnostic.tcpDumpDetails.timeoutInSeconds Base Introdotta nella versione: 1.6.0

Valore predefinito: nessuno

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

Imposta il tempo di attesa in secondi che deve trascorrere prima che tcpDump restituisca i messaggi.

diagnostic.threadDumpDetails.delayInSeconds Base Introdotta nella versione: 1.6.0

Valore predefinito: nessuno

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

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

diagnostic.threadDumpDetails.iterations Base Introdotta nella versione: 1.6.0

Valore predefinito: nessuno

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

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

envs

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

L'organizzazione abilitata per l'ibrida deve avere almeno un ambiente.

Per saperne di più, consulta Informazioni sugli ambienti.

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

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

Valore predefinito: nessuno

È obbligatorio specificare un valore cacheEncryptionKey, cacheEncryptionPath o cacheEncryptionSecret.

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

envs[].cacheEncryptionPath Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare un valore cacheEncryptionKey, cacheEncryptionPath o cacheEncryptionSecret.

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

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

Valore predefinito: nessuno

È obbligatorio specificare un valore 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 Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare 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 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 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 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 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 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 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 Avanzata 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 abiliti Workload Identity sui cluster GKE utilizzando i grafici Helm.

Vedi Abilitazione di Workload Identity su GKE o Abilitazione della federazione di Workload Identity su AKS ed EKS.

envs.gsa.synchronizer Avanzata Introdotta nella versione: 1.10.0

Valore predefinito: nessuno

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

Vedi Abilitazione di Workload Identity su GKE o Abilitazione della federazione di Workload Identity su AKS ed EKS.

envs.gsa.udca Avanzata Introdotta nella versione: 1.10.0

Valore predefinito: nessuno

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

Vedi Abilitazione di Workload Identity su GKE o Abilitazione della federazione di Workload Identity su AKS ed EKS.

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

Valore predefinito: nessuno

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

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

Valore predefinito: nessuno

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

Elenca 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 di forwarding per i proxy API.

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

Valore predefinito: nessuno

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

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

Valore predefinito: nessuno

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

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

Valore predefinito: nessuno

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

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

Valore predefinito: nessuno

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

envs[].name Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

Nome dell'ambiente Apigee da sincronizzare.

envs[].pollInterval Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Intervallo in secondi utilizzato per le modifiche alla sincronizzazione dell'organizzazione di polling e dell'ambiente.

envs[].port Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Numero di porta TCP per il traffico HTTPS.

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

Valore predefinito: nessuno

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

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

Valore predefinito: nessuno

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

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

Valore predefinito: nessuno

Percorso del file su un 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[].serviceAccountSecretRefs.runtime Base Introdotta nella versione: 1.4.0

Valore predefinito: nessuno

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

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

Valore predefinito: nessuno

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

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

Valore predefinito: nessuno

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

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

envs[].sslCertPath Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

Il percorso sul sistema di un file di certificato TLS.

envs[].sslKeyPath Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

Il percorso sul sistema del file della chiave privata TLS.

envs[].sslSecret Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

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

Vedi anche:

gcp

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

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

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

Valore predefinito: nessuno

Il pubblico consentito del provider Workload Identity sulle piattaforme non GKE.

Vedi Abilitazione della federazione di Workload Identity su AKS ed EKS.

gcp.federatedWorkloadIdentity.credentialSourceFile Base Introdotta nella versione: 1.12.0

Valore predefinito: nessuno

Il nome file e il percorso del file di origine delle credenziali utilizzato dalla federazione di Workload Identity 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.

Vedi Abilitazione della federazione di Workload Identity su AKS ed EKS.

gcp.federatedWorkloadIdentity.enabled Base Introdotta nella versione: 1.12.0

Valore predefinito: false

Abilita la federazione di Workload Identity sulle piattaforme non GKE. Non deve essere impostato su true se gcp.workloadIdentity.enabled è impostato su true nello stesso cluster.

Vedi Abilitazione della federazione di Workload Identity su AKS ed EKS.

gcp.projectID Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

Obbligatorio

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

gcp.projectIDRuntime Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

Identifica il progetto del cluster Kubernetes di runtime.

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

Valore predefinito: us-central1

Obbligatorio

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

gcp.workloadIdentity.enabled Base Introdotta nella versione: 1.10.0

Valore predefinito:false

Solo Helm: consente l'utilizzo di Workload Identity su GKE. Workload Identity consente ai carichi di lavoro nei tuoi cluster GKE di impersonare gli 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 Avanzata Introdotta nella versione: 1.10.0

Valore predefinito: nessuno

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

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

Gli indirizzi email di Google Search Ads generalmente hanno il formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

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

Consulta la pagina Enabling Workload Identity on GKE.

gcp.workloadIdentityEnabled Base Introdotta nella versione: 1.4.0

Valore predefinito:false

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

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

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

httpProxy

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

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

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

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

Valore predefinito: nessuno

Il nome host del proxy HTTP.

httpProxy.port Base Introdotta nella versione: 1.1.1

Valore predefinito: nessuno

La porta del proxy HTTP.

httpProxy.scheme Base Introdotta nella versione: 1.1.1

Valore predefinito: HTTPS

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

httpProxy.username Base Introdotta nella versione: 1.1.1

Valore predefinito: nessuno

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

httpProxy.password Base Introdotta nella versione: 1.1.1

Valore predefinito: nessuno

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

ingressGateways

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

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

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

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

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

Valore predefinito: IfNotPresent

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

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

Per maggiori informazioni, consulta Aggiornare le immagini.

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

Valore predefinito: 1.18.7-asm.4-distroless

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

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

Valore predefinito: gcr.io/apigee-release/hybrid/apigee-asm-ingress

La località dell'immagine Docker per questo servizio.

ingressGateways[].name Base Introdotta nella versione: 1.8.0

Valore predefinito: nessuno

Obbligatorio

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

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

Per maggiori informazioni, consulta la pagina relativa ai nomi dei sottodomini DNS nella documentazione di Kubernetes.

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

Valore predefinito: 2000m

Il limite di CPU per la risorsa, in millicore.

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

Valore predefinito: 1Gi

Il limite di memoria per la risorsa, in mebibyte.

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

Valore predefinito: 300m

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

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

Valore predefinito: 128Mi

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

ingressGateways[].replicaCountMax Base Introdotta nella versione: 1.8.0

Valore predefinito: 10

Il numero massimo di pod che gli ambienti ibridi possono aggiungere automaticamente per il gateway in entrata disponibile per la scalabilità automatica.

ingressGateways[].replicaCountMin Base Introdotta nella versione: 1.8.0

Valore predefinito: 2

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

ingressGateways[].svcAnnotations Base Introdotta nella versione: 1.8.0

Valore predefinito: nessuno

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

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

Valore predefinito: nessuno

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

ingressGateways[].svcType Base Introdotta nella versione: 1.8.1

Valore predefinito: LoadBalancer

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

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

Valore predefinito: nessuno

Necessario per utilizzare la funzionalità Tensioni e tolleranze di Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, vedi Invecchiamenti e tolleranze: concetti.

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

Valore predefinito: nessuno

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

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

Valore predefinito: "Equal"

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

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

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

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

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

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

istiod

Configura il traffico in entrata di Apigee.

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

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

Valore predefinito: /dev/stdout

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

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

istiod.accessLogFormat Avanzata Introdotta nella versione: 1.8.0

Il formato del log degli accessi in entrata.

Se questo valore non viene definito, verrà utilizzato il formato di log degli accessi predefinito del proxy.

Formato predefinito dei log degli accessi:

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

Di seguito è riportata una copia del formato predefinito del log degli accessi con l'aggiunta di interruzioni di riga per una migliore leggibilità.

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

Valore predefinito: SANITIZE_SET

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

I valori possibili sono:

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

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

Se modifichi questa impostazione dopo l'installazione di Hybrid, applicala con apigeectl init e riavvia i pod gateway in entrata di Apigee.

istiod.image.pullPolicy Avanzata Introdotta nella versione: 1.8.0

Valore predefinito: IfNotPresent

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

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

Per maggiori informazioni, consulta Aggiornare le immagini.

istiod.image.tag Avanzata Introdotta nella versione: 1.8.0

Valore predefinito: 1.18.7-asm.4-distroless

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

istiod.image.url Avanzata Introdotta nella versione: 1.8.0

Valore predefinito: gcr.io/apigee-release/hybrid/apigee-asm-istiod

La località dell'immagine Docker per questo servizio.

istiod.tolerations.effect Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Necessario per utilizzare la funzionalità Tensioni e tolleranze di Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, vedi Invecchiamenti e tolleranze: concetti.

istiod.tolerations.key Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

istiod.tolerations.operator Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

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

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

istiod.tolerations.tolerationSeconds Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

istiod.tolerations.value Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

k8sCluster

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

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

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

Valore predefinito: nessuno

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

k8sCluster.region Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

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

kubeRBACProxy

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

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

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

Valore predefinito: IfNotPresent

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

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

Per maggiori informazioni, consulta Aggiornare le immagini.

kubeRBACProxy.image.tag Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: v0.14.2

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

kubeRBACProxy.image.url Avanzata Introdotta nella versione: 1.2.0

Valore predefinito: gcr.io/apigee-release/hybrid/apigee-kube-rbac-proxy

La località dell'immagine Docker per questo servizio.

Se non vuoi utilizzare Google Docker Hub, scarica le immagini e utilizza l'indirizzo in cui le immagini Docker sono ospitate internamente.

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

Valore predefinito: 500m

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

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

Valore predefinito: 128Mi

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

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

Valore predefinito: 5m

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

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

Valore predefinito: 64Mi

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

logger

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

Per saperne di più, consulta Panoramica di Logging.

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

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

Valore predefinito: nessuno

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

logger.bufferChunkSize Avanzata Introdotta nella versione: 1.12.0

Valore predefinito: 256.000

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

logger.bufferMaxSize Avanzata Introdotta nella versione: 1.12.0

Valore predefinito: 104857600

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

logger.bufferMemoryLimit Avanzata Introdotta nella versione: 1.12.0

Valore predefinito: 150 MB

Il limite di memoria che il logger può utilizzare. Se viene raggiunta la copertura, il logger metterà temporaneamente in pausa la lettura di altri dati finché i dati esistenti non verranno cancellati in memoria.

logger.enabled Base Introdotta nella versione: 1.0.0

Valore predefinito: 2.1.8

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

logger.envVars 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 instradato tramite il proxy HTTP. La variabile NO_PROXY deve essere definita come una stringa di nomi host separati da virgole nel formato:

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

ad esempio:

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

Usa envVars: NO_PROXY facoltativamente se hai abilitato il proxy di inoltro HTTP.

Vedi NO_PROXY nella documentazione di Fluent Bit.

logger.flushInterval Avanzata Introdotta nella versione: 1.12.0

Valore predefinito: 1

L'intervallo di attesa prima di richiamare il buffer successivo per lo svuotamento, in secondi.

logger.gsa Avanzata Introdotta nella versione: 1.10.0

Valore predefinito: nessuno

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

Gli indirizzi email di Google Search Ads generalmente hanno il formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

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

Vedi Abilitazione di Workload Identity su GKE o Abilitazione della federazione di Workload Identity su AKS ed EKS.

logger.image.pullPolicy Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per maggiori informazioni, consulta Aggiornare le immagini.

logger.image.tag Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1.9.9

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

logger.image.url Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: gcr.io/apigee-release/hybrid/apigee-fluent-bit

La località dell'immagine Docker per questo servizio.

logger.livenessProbe.failureThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 3

Il numero di volte in cui Kubernetes verificherà l'esito negativo dei probe di attività prima di riavviare il container. Il valore minimo è 1.

logger.livenessProbe.initialDelaySeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 0

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

logger.livenessProbe.periodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 60

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

logger.livenessProbe.successThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1

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

logger.livenessProbe.timeoutSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1

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

logger.nodeSelector.key Base Introdotta nella versione: 1.0.0

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

Obbligatorio

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

Vedi Configurazione dei pool di nodi dedicati.

logger.nodeSelector.value Base Introdotta nella versione: 1.0.0

Valore predefinito: true

Obbligatorio

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

Vedi Configurazione dei pool di nodi dedicati.

logger.proxyURL Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

URL del server proxy del cliente.

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

Valore predefinito: 200m

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

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

Valore predefinito: 500Mi

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

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

Valore predefinito: 100m

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

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

Valore predefinito: 250Mi

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

logger.serviceAccountPath 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 ruolo Writer log.

logger.serviceAccountRef Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare serviceAccountPath o serviceAccountRef.

logger.storageMaxChunks Avanzata Introdotta nella versione: 1.12.0

Valore predefinito: 128

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

logger.terminationGracePeriodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 30

Il tempo in secondi tra una richiesta di eliminazione di un pod e il momento in cui il pod viene terminato. Durante questo periodo, verranno eseguiti eventuali hook prestop e qualsiasi processo in esecuzione dovrebbe terminare senza problemi.

logger.tolerations.effect Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Necessario per utilizzare la funzionalità Tensioni e tolleranze di Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, vedi Invecchiamenti e tolleranze: concetti.

logger.tolerations.key Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

logger.tolerations.operator Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

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

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

logger.tolerations.tolerationSeconds Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

logger.tolerations.value Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

mart

Definisce il servizio MART (API di gestione per dati RunTime), che agisce da provider di API per le API Apigee pubbliche in modo che tu possa accedere e gestire entità di dati di runtime come KMS (chiavi API e token OAuth), KVM, quota e prodotti API.

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

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

Valore predefinito: nessuno

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

mart.gsa Avanzata Introdotta nella versione: 1.10.0

Valore predefinito: nessuno

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

Gli indirizzi email di Google Search Ads generalmente hanno il formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

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

Vedi Abilitazione di Workload Identity su GKE o Abilitazione della federazione di Workload Identity su AKS ed EKS.

mart.hostAlias Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

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

mart.image.pullPolicy Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per maggiori informazioni, consulta Aggiornare le immagini.

mart.image.tag Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1.12.0

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

mart.image.url Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: gcr.io/apigee-release/hybrid/apigee-mart-server

La località dell'immagine Docker per questo servizio. Controlla il file values.yaml per l'URL specifico.Puoi sostituire questa impostazione.

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

Valore predefinito: 10m

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

mart.livenessProbe.failureThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 12

Il numero di volte in cui Kubernetes verificherà l'esito negativo dei probe di attività prima di riavviare il container. Il valore minimo è 1.

mart.livenessProbe.initialDelaySeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 15

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

mart.livenessProbe.periodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 5

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

mart.livenessProbe.timeoutSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1

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

mart.metricsURL Base Introdotta nella versione: 1.0.0

Valore predefinito: /v1/server/metrics

mart.nodeSelector.key Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

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

Vedi Configurazione dei pool di nodi dedicati.

mart.nodeSelector.value Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

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

Vedi Configurazione dei pool di nodi dedicati.

mart.readinessProbe.failureThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 2

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

mart.readinessProbe.initialDelaySeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 15

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

mart.readinessProbe.periodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 5

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

mart.readinessProbe.successThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1

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

mart.readinessProbe.timeoutSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1

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

mart.replicaCountMax Base Introdotta nella versione: 1.0.0

Valore predefinito: 5

Numero massimo di repliche disponibili per la scalabilità automatica.

mart.replicaCountMin Base Introdotta nella versione: 1.0.0

Valore predefinito: 1

Numero minimo di repliche disponibili per la scalabilità automatica.

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

Valore predefinito: 2000m

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

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

Valore predefinito: 5Gi

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

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

Valore predefinito: 500m

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

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

Valore predefinito: 512Mi

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

mart.serviceAccountPath 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 ruolo.

mart.serviceAccountRef Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare serviceAccountPath o serviceAccountRef.

mart.sslCertPath Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

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

mart.sslKeyPath Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

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

mart.sslSecret Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

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

Vedi anche:

mart.targetCPUUtilizationPercentage Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 75

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

mart.terminationGracePeriodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 30

Il tempo in secondi tra una richiesta di eliminazione di un pod e il momento in cui il pod viene terminato. Durante questo periodo, verranno eseguiti eventuali hook prestop e qualsiasi processo in esecuzione dovrebbe terminare senza problemi.

mart.tolerations.effect Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Necessario per utilizzare la funzionalità Tensioni e tolleranze di Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, vedi Invecchiamenti e tolleranze: concetti.

mart.tolerations.key Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

mart.tolerations.operator Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

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

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

mart.tolerations.tolerationSeconds Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

mart.tolerations.value Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

metrics

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

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

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

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

Valore predefinito: IfNotPresent

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

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

Per maggiori informazioni, consulta Aggiornare le immagini.

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

Valore predefinito: v0.11.0

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

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

Valore predefinito: gcr.io/apigee-release/hybrid/apigee-prometheus-adapter

La località dell'immagine Docker per questo servizio.

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

Valore predefinito: 500m

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

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

Valore predefinito: 512Mi

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

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

Valore predefinito: 500m

Limite di CPU per la risorsa di aggregazione in un container Kubernetes, espresso in millicore.

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

Valore predefinito: 3Gi

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

metrics.annotations Avanzata Introdotta nella versione: 1.5.0

Valore predefinito: nessuno

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

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

Valore predefinito: 500m

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

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

Valore predefinito: 512Mi

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

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

Valore predefinito: 500m

Limite di CPU per la risorsa app in un container Kubernetes, espresso in millicore.

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

Valore predefinito: 1Gi

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

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

Valore predefinito: 128m

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

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

Valore predefinito: 500m

Limite di CPU per la risorsa stackdriverExporter in un container Kubernetes, espresso in millicore.

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

Valore predefinito: 1Gi

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

metrics.collector.imagePullPolicy Avanzata Introdotta nella versione: 1.12.0

Valore predefinito: IfNotPresent

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

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

Per maggiori informazioni, consulta Utilizzare un repository di immagini privato con Apigee hybrid .

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

Valore predefinito: v0.93.0

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

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

Valore predefinito: gcr.io/apigee-release/hybrid/apigee-open-telemetry-collector

La località dell'immagine Docker per questo servizio.

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

Valore predefinito: 500m

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

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

Valore predefinito: 512Mi

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

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

Valore predefinito: 500m

Limite di CPU per la risorsa app in un container Kubernetes, espresso in millicore.

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

Valore predefinito: 1Gi

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

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

Valore predefinito: 5

Il numero di volte in cui Kubernetes verificherà l'esito negativo dei probe di attività prima di riavviare il container. Il valore minimo è 1.

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

Valore predefinito: 30

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

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

Valore predefinito: 10

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

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

Valore predefinito: 1

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

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

Valore predefinito: 5

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

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

Valore predefinito: 3

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

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

Valore predefinito: 30

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

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

Valore predefinito: 10

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

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

Valore predefinito: 1

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

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

Valore predefinito: 5

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

metrics.disablePrometheusPipeline Base Introdotta nella versione: 1.12.0

Valore predefinito: true

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

metrics.enabled Base Introdotta nella versione: 1.0.0

Valore predefinito: true

Abilita le metriche Apigee. Impostala su true per attivare le metriche. Imposta il valore su false per disabilitare le metriche.

metrics.gsa Avanzata Introdotta nella versione: 1.10.0

Valore predefinito: nessuno

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

Gli indirizzi email di Google Search Ads generalmente hanno il formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

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

Vedi Abilitazione di Workload Identity su GKE o Abilitazione della federazione di Workload Identity su AKS ed EKS.

metrics.nodeSelector.key Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

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

Vedi Configurazione dei pool di nodi dedicati.

metrics.nodeSelector.value Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

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

Vedi Configurazione dei pool di nodi dedicati.

metrics.prometheus.containerPort Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 9090

La porta per la connessione al servizio delle metriche Prometheus.

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

Valore predefinito: IfNotPresent

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

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

Per maggiori informazioni, consulta Aggiornare le immagini.

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

Valore predefinito: v2.45.0

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

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

Valore predefinito: gcr.io/apigee-release/hybrid/apigee-prom-prometheus

La località dell'immagine Docker per questo servizio.

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

Valore predefinito: 6

Il numero di volte in cui Kubernetes verificherà l'esito negativo dei probe di attività prima di riavviare il container. Il valore minimo è 1.

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

Valore predefinito: 5

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

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

Valore predefinito: 3

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

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

Valore predefinito: 120

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

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

Valore predefinito: 5

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

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

Valore predefinito: 3

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

metrics.prometheus.sslCertPath Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

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

Vedi:

metrics.prometheus.sslKeyPath Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

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

Vedi:

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

Valore predefinito: 500m

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

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

Valore predefinito: 512Mi

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

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

Valore predefinito: 500m

Limite di CPU per la risorsa proxy in un container Kubernetes, espresso in millicore.

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

Valore predefinito: 1Gi

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

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

Valore predefinito: 128m

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

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

Valore predefinito: 500m

Limite di CPU per la risorsa stackdriverExporter in un container Kubernetes, espresso in millicore.

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

Valore predefinito: 1Gi

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

metrics.proxyURL Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

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

metrics.sdSidecar.containerPort Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 9091

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

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

Valore predefinito: IfNotPresent

Determina quando kubelet esegue il pull dell'immagine Docker di questo servizio. I valori possono essere:

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

    Per maggiori informazioni, consulta Aggiornamento delle immagini.

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

Valore predefinito: v0.9.0

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

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

Valore predefinito: gcr.io/apigee-release/hybrid/apigee-stackdriver-prometheus-sidecar

La località dell'immagine Docker per questo servizio.

metrics.serviceAccountPath Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

È obbligatorio specificare serviceAccountPath o serviceAccountRef.

Percorso del file di chiavi dell'account di servizio Google con ruolo Writer metriche di Monitoring.

metrics.serviceAccountRef Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare serviceAccountPath o serviceAccountRef.

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

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

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

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

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

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

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

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

metrics.terminationGracePeriodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 300

Il tempo in secondi tra una richiesta di eliminazione di un pod e il momento in cui il pod viene terminato. Durante questo periodo, verranno eseguiti eventuali hook prestop e qualsiasi processo in esecuzione dovrebbe terminare senza problemi.

metrics.tolerations.effect Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Necessario per utilizzare la funzionalità Tensioni e tolleranze di Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, vedi Invecchiamenti e tolleranze: concetti.

metrics.tolerations.key Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

metrics.tolerations.operator Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

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

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

metrics.tolerations.tolerationSeconds Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

metrics.tolerations.value Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

mintTaskScheduler

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

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

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

Valore predefinito: IfNotPresent

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

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

Per maggiori informazioni, consulta Aggiornare le immagini.

mintTaskScheduler.image.tag Avanzata Introdotta nella versione: 1.7.0

Valore predefinito: 1.12.0

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

mintTaskScheduler.image.url Avanzata Introdotta nella versione: 1.7.0

Valore predefinito: gcr.io/apigee-release/hybrid/apigee-mint-task-scheduler

La località dell'immagine Docker per questo servizio.

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

Valore predefinito: 2000m

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

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

Valore predefinito: 4Gi

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

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

Valore predefinito: 500m

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

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

Valore predefinito: 512Mi

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

mintTaskScheduler.tolerations.effect Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Necessario per utilizzare la funzionalità Tensioni e tolleranze di Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, vedi Invecchiamenti e tolleranze: concetti.

mintTaskScheduler.tolerations.key Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

mintTaskScheduler.tolerations.operator Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

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

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

mintTaskScheduler.tolerations.tolerationSeconds Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

mintTaskScheduler.tolerations.value Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

nodeSelector

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

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

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

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

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

Vedi Configurare pool di nodi dedicati.

nodeSelector.apigeeData.value Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: apigee-data

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

Vedi Configurare pool di nodi dedicati.

nodeSelector.apigeeRuntime.key Avanzata 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 di etichetta del selettore nodi per il targeting dei nodi Kubernetes per i servizi di runtime Apigee.

Vedi Configurare pool di nodi dedicati.

nodeSelector.apigeeRuntime.value Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: apigee-runtime

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

Vedi Configurare pool di nodi dedicati.

nodeSelector.requiredForScheduling Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: false

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

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

Vedi Configurare pool di nodi dedicati.

redis

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

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

Valore predefinito: iloveapis123

Obbligatorio

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

redis.auth.secret Base Introdotta nella versione: 1.9.1

Valore predefinito: nessuno

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

data:
    redis.auth.password: encoded_value

Vedi anche:

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

Valore predefinito: IfNotPresent

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

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

Per maggiori informazioni, consulta Aggiornare le immagini.

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

Valore predefinito: v1.27.0

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

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

Valore predefinito: gcr.io/apigee-release/hybrid/apigee-envoy

La località dell'immagine Docker per questo servizio.

redis.image.pullPolicy Avanzata Introdotta nella versione: 1.6.0

Valore predefinito: IfNotPresent

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

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

Per maggiori informazioni, consulta Aggiornare le immagini.

redis.image.tag Avanzata Introdotta nella versione: 1.6.0

Valore predefinito: 1.12.0

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

redis.image.url Avanzata Introdotta nella versione: 1.6.0

Valore predefinito: gcr.io/apigee-release/hybrid/apigee-redis

La località dell'immagine Docker per questo servizio.

redis.replicaCount Base Introdotta nella versione: 1.6.0

Valore predefinito: 2

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

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

Valore predefinito: 500m

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

redis.tolerations.effect Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Necessario per utilizzare la funzionalità Tensioni e tolleranze di Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, vedi Invecchiamenti e tolleranze: concetti.

redis.tolerations.key Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

redis.tolerations.operator Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

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

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

redis.tolerations.tolerationSeconds Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

redis.tolerations.value Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

runtime

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

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

Valore predefinito: nessuno

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

runtime.image.pullPolicy Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per maggiori informazioni, consulta Aggiornare le immagini.

runtime.image.tag Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1.12.0

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

runtime.image.url Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: URL della risorsa immagine dell'installazione, ad esempio: gcr.io/apigee-release/hybrid/apigee-runtime

La località dell'immagine Docker per questo servizio.

runtime.livenessProbe.failureThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 2

Il numero di volte in cui Kubernetes verificherà l'esito negativo dei probe di attività prima di riavviare il container. Il valore minimo è 1.

runtime.livenessProbe.initialDelaySeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 60

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

runtime.livenessProbe.periodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 5

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

runtime.livenessProbe.timeoutSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1

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

runtime.nodeSelector.key Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

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

Consulta la proprietà nodeSelector.

runtime.nodeSelector.value Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

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

Vedi Configurazione dei pool di nodi dedicati.

runtime.readinessProbe.failureThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 2

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

runtime.readinessProbe.initialDelaySeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 60

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

runtime.readinessProbe.periodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 5

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

runtime.readinessProbe.successThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1

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

runtime.readinessProbe.timeoutSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1

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

runtime.replicaCountMax Base Introdotta nella versione: 1.0.0

Valore predefinito: 4

Numero massimo di repliche disponibili per la scalabilità automatica.

runtime.replicaCountMin Base Introdotta nella versione: 1.0.0

Valore predefinito: 1

Numero minimo di repliche disponibili per la scalabilità automatica.

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

Valore predefinito: 4000m

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

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

Valore predefinito: 6Gi

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

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

Valore predefinito: 500m

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

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

Valore predefinito: 512Mi (vedi la nota sotto)

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

runtime.service.type Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: ClusterIP

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

runtime.targetCPUUtilizationPercentage Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 75

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

runtime.terminationGracePeriodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 180

Il tempo in secondi tra una richiesta di eliminazione di un pod e il momento in cui il pod viene terminato. Durante questo periodo, verranno eseguiti eventuali hook prestop e qualsiasi processo in esecuzione dovrebbe terminare senza problemi.

runtime.tolerations.effect Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Necessario per utilizzare la funzionalità Tensioni e tolleranze di Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, vedi Invecchiamenti e tolleranze: concetti.

runtime.tolerations.key Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

runtime.tolerations.operator Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

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

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

runtime.tolerations.tolerationSeconds Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

runtime.tolerations.value Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

synchronizer

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

Per ulteriori informazioni, consulta la sezione Configurare il programma di sincronizzazione.

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

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

Valore predefinito: nessuno

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

synchronizer.image.pullPolicy Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per maggiori informazioni, consulta Aggiornare le immagini.

synchronizer.image.tag Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1.12.0

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

synchronizer.image.url Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: gcr.io/apigee-release/hybrid/apigee-synchronizer

La località dell'immagine Docker per questo servizio.

synchronizer.livenessProbe.failureThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 2

Il numero di volte in cui Kubernetes verificherà l'esito negativo dei probe di attività prima di riavviare il container. Il valore minimo è 1.

synchronizer.livenessProbe.initialDelaySeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 0

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

synchronizer.livenessProbe.periodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 5

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

synchronizer.livenessProbe.timeoutSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1

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

synchronizer.nodeSelector.key Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

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

Vedi nodeSelector.

synchronizer.nodeSelector.value Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

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

Vedi nodeSelector.

synchronizer.pollInterval Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 60

Il tempo di attesa del sincronizzatore tra le operazioni di polling. Il sincronizzatore esegue il polling dei servizi del piano di controllo Apigee per rilevare ed eseguire il pull di nuovi contratti di runtime.

synchronizer.readinessProbe.failureThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 2

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

synchronizer.readinessProbe.initialDelaySeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 0

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

synchronizer.readinessProbe.periodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 5

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

synchronizer.readinessProbe.successThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1

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

synchronizer.readinessProbe.timeoutSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1

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

synchronizer.replicaCount Base Introdotta nella versione: 1.0.0

Deprecated: a partire dalla versione ibrida 1.2, gestisci il numero delle repliche del programma di sincronizzazione con: synchronizer.replicaCountMax e synchronizer.replicaCountMin

synchronizer.replicaCountMax Base Introdotta nella versione: 1.2.0

Valore predefinito: 4

Numero massimo di repliche per la scalabilità automatica.

synchronizer.replicaCountMin Base Introdotta nella versione: 1.2.0

Valore predefinito: 1

Numero minimo di repliche per la scalabilità automatica.

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

Valore predefinito: 2000m

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

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

Valore predefinito: 5Gi

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

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

Valore predefinito: 100m

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

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

Valore predefinito: 1Gi

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

synchronizer.serviceAccountPath Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

È obbligatorio specificare serviceAccountPath o serviceAccountRef.

Percorso del file delle chiavi dell'account di servizio Google con il ruolo Apigee Syncr Manager.

synchronizer.serviceAccountRef Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare serviceAccountPath o serviceAccountRef.

synchronizer.targetCPUUtilizationPercentage Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 75

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

synchronizer.terminationGracePeriodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 30

Il tempo in secondi tra una richiesta di eliminazione di un pod e il momento in cui il pod viene terminato. Durante questo periodo, verranno eseguiti eventuali hook prestop e qualsiasi processo in esecuzione dovrebbe terminare senza problemi.

synchronizer.tolerations.effect Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Necessario per utilizzare la funzionalità Tensioni e tolleranze di Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, vedi Invecchiamenti e tolleranze: concetti.

synchronizer.tolerations.key Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

synchronizer.tolerations.operator Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

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

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

synchronizer.tolerations.tolerationSeconds Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

synchronizer.tolerations.value Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

udca

(Agente Universal Data Collection) Definisce il servizio eseguito nel pod di raccolta dati nel piano di runtime. Questo servizio estrae i dati di analisi e sullo stato del deployment e li invia alla Unified Analytics Platform (UAP).

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

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

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

Valore predefinito: nessuno

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

udca.fluentd.image.pullPolicy Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per maggiori informazioni, consulta Aggiornare le immagini.

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

Valore predefinito: 1.9.12-2

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

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

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

La località dell'immagine Docker per questo servizio.

udca.fluentd.resources.limits.cpu Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: 1000m

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

udca.fluentd.resources.limits.memory Avanzata Introdotta nella versione: 1.11.0

Valore predefinito: 500Mi

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

udca.fluentd.resources.requests.cpu Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 500m

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

udca.fluentd.resources.requests.memory Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 250Mi

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

udca.gsa Avanzata Introdotta nella versione: 1.10.0

Valore predefinito: nessuno

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

Gli indirizzi email di Google Search Ads generalmente hanno il formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

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

Vedi Abilitazione di Workload Identity su GKE o Abilitazione della federazione di Workload Identity su AKS ed EKS.

udca.image.pullPolicy Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per maggiori informazioni, consulta Aggiornare le immagini.

udca.image.tag Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1.12.0

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

udca.image.url Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: gcr.io/apigee-release/hybrid/apigee-udca

La località dell'immagine Docker per questo servizio.

udca.jvmXms Avanzata Introdotta nella versione: 1.0.0

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

udca.jvmXmx Avanzata Introdotta nella versione: 1.0.0

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

udca.livenessProbe.failureThreshold Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 2

Il numero di volte in cui Kubernetes verificherà l'esito negativo dei probe di attività prima di riavviare il container. Il valore minimo è 1.

udca.livenessProbe.initialDelaySeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 0

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

udca.livenessProbe.periodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 5

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

udca.livenessProbe.timeoutSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1

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

udca.nodeSelector.key Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

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

Vedi Configurazione dei pool di nodi dedicati.

udca.nodeSelector.value Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

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

Vedi Configurazione dei pool di nodi dedicati.

udca.pollingIntervalInSec Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 1

Il tempo di attesa, in secondi, dell'UDCA tra le operazioni di polling. UDCA esegue il polling della directory dei dati sul file system del pod di raccolta dei dati per rilevare i nuovi file da caricare.

udca.replicaCountMax Base Introdotta nella versione: 1.0.0

Valore predefinito: 4

Il numero massimo di pod che gli ambienti ibridi possono 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 Base Introdotta nella versione: 1.0.0

Valore predefinito: 1

Il numero minimo di pod per il deployment UDCA. Poiché UDCA viene implementato come ReplicaSet, i pod sono repliche.

Se l'utilizzo della CPU supera udca.targetCPUUtilizationPercentage, la modalità ibrida aumenterà gradualmente il numero di pod, fino a udca.replicaCountMax.

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

Valore predefinito: 1000m

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

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

Valore predefinito: 2Gi

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

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

Valore predefinito: 250m

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

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

Valore predefinito: 250Mi

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

udca.revision Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: v1

Un valore statico compilato in un'etichetta per abilitare i deployment canary.

udca.serviceAccountPath Base Introdotta nella versione: 1.0.0

Valore predefinito: nessuno

È obbligatorio specificare serviceAccountPath o serviceAccountRef.

Percorso del file delle chiavi dell'account di servizio Google con il ruolo Agente Analytics Apigee.

udca.serviceAccountRef Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare serviceAccountPath o serviceAccountRef.

udca.targetCPUUtilizationPercentage Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 75

La soglia di utilizzo della CPU per la scalabilità del numero di pod nel ReplicaSet, come percentuale delle risorse totali della CPU disponibili. Il modello ibrido utilizza l'utilizzo combinato di tutti i container nel pod di raccolta dei dati (sia fluenti che UDCA) per calcolare l'utilizzo attuale.

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

udca.terminationGracePeriodSeconds Avanzata Introdotta nella versione: 1.0.0

Valore predefinito: 600

Il tempo in secondi tra una richiesta di eliminazione di un pod e il momento in cui il pod viene terminato. Durante questo periodo, verranno eseguiti eventuali hook prestop e qualsiasi processo in esecuzione dovrebbe terminare senza problemi.

udca.tolerations.effect Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Necessario per utilizzare la funzionalità Tensioni e tolleranze di Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, vedi Invecchiamenti e tolleranze: concetti.

udca.tolerations.key Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

udca.tolerations.operator Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

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

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

udca.tolerations.tolerationSeconds Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

udca.tolerations.value Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti 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 la sezione Configurare gli host virtuali.

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

Proprietà Tipo Descrizione
virtualhosts[].additionalGateways Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

Un elenco di gateway Istio a cui instradare il traffico.

virtualhosts[].cipherSuites[] Avanzata Introdotta nella versione: 1.9.2

Valore predefinito: nessuno

L'elenco di crittografie TLS. Puoi trovare l'elenco completo delle crittografie supportate nella documentazione per la build FIPS noiosa di Envoy. Se il valore è vuoto, vengono impostate automaticamente le suite di crittografia supportate dalla build FIPS noiosa di Envoy.

Ad esempio, per supportare TLS v.1.1:

virtualhosts:
- name: ENV_GROUP_NAME
  minTLSProtocolVersion: "1.1"
  cipherSuites:
  - "ECDHE-ECDSA-AES128-GCM-SHA256"
  - "ECDHE-RSA-AES128-GCM-SHA256"
  - "ECDHE-ECDSA-AES256-GCM-SHA384"
  - "ECDHE-RSA-AES256-GCM-SHA384"
  - "ECDHE-ECDSA-CHACHA20-POLY1305"
  - "ECDHE-RSA-CHACHA20-POLY1305"
  - "ECDHE-ECDSA-AES128-SHA"
  - "ECDHE-RSA-AES128-SHA"
  - "ECDHE-ECDSA-AES256-SHA"
  - "ECDHE-RSA-AES256-SHA"
  ...
      
virtualhosts[].name Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

Obbligatorio

Il nome dell'host virtuale.

virtualhosts[].maxTLSProtocolVersion Base Introdotta nella versione: 1.3.0

Valore predefinito: nessuno

La versione massima del protocollo TLS che Envoy può selezionare. Envoy utilizza automaticamente la versione ottimale del protocollo TLS tra virtualhosts[].minTLSProtocolVersion e virtualhosts[].maxTLSProtocolVersion.

Il valore deve essere sotto forma di numero. Ad esempio:

virtualhosts:
  - name: default
    maxTLSProtocolVersion: "1.3"

dove il numero rappresenta il numero di versione TLS nel formato #.#. Nell'esempio precedente, "1.3" rappresenta la versione TLS di Istio TLSV1_3.

Vedi anche ServerTLSSettings.TLSProtocol nella documentazione di Istio.

virtualhosts[].minTLSProtocolVersion Base Introdotta nella versione: 1.3.0

Valore predefinito: nessuno

La versione minima del protocollo TLS che Envoy può selezionare. Envoy utilizza automaticamente la versione ottimale del protocollo TLS tra virtualhosts[].minTLSProtocolVersion e virtualhosts[].maxTLSProtocolVersion.

Il valore deve essere sotto forma di numero. Ad esempio:

virtualhosts:
  - name: default
    minTLSProtocolVersion: "1.2"

dove il numero rappresenta il numero di versione TLS nel formato #.#. Nell'esempio precedente, 1.2 rappresenta la versione TLS di Istio TLSV1_2.

Vedi anche ServerTLSSettings.TLSProtocol nella documentazione di Istio.

virtualhosts[].selector Base Introdotta nella versione: 1.2.0

Valore predefinito: app: apigee-ingressgateway

Obbligatorio

Una coppia di selettore-valore chiave-valore che punta a diversi selettori in entrata.

  • apigee-ingressgateway: per le installazioni ibride di Apigee che utilizzano il gateway in entrata di Apigee.
  • istio-ingressgateway: per le installazioni ibride di Apigee che utilizzano Anthos Service Mesh (versione ibrida Apigee 1.8 e precedenti).

Se non viene fornita alcuna etichetta del selettore, la configurazione viene fornita al gateway in entrata di Apigee.

virtualhosts[].sslCertPath Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

Il percorso sul sistema di un file di certificato TLS.

virtualhosts[].sslKeyPath Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

Il percorso sul sistema del file della chiave privata TLS.

virtualhosts[].sslSecret Base Introdotta nella versione: 1.2.0

Valore predefinito: nessuno

È obbligatorio specificare sslCertPath/sslKeyPath o sslSecret.

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

Vedi anche:

watcher

La proprietà watcher è una proprietà di configurazione obbligatoria. L'watcher è un processo che monitora le modifiche alla configurazione e attiva la relativa applicazione sul piano di runtime.

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

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

Valore predefinito: nessuno

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

watcher.args.enableIssueScanning Avanzata Introdotta nella versione: 1.10.0

Valore predefinito: true

Abilita o disabilita la segnalazione automatica dei problemi. Quando true, Watcher analizza automaticamente lo stato del piano di controllo e del server dell'API Kubernetes per determinare se sono presenti problemi di configurazione.

Imposta su false per disattivare la visualizzazione automatica dei problemi. Per maggiori informazioni, consulta Visualizzazione automatica dei problemi.

watcher.args.issueScanInterval Avanzata Introdotta nella versione: 1.10.0

Valore predefinito: 60

L'intervallo in secondi per la frequenza con cui Watcher analizza il piano di runtime per rilevare automaticamente i problemi. Per maggiori informazioni, consulta Visualizzazione automatica dei problemi.

watcher.gsa Avanzata Introdotta nella versione: 1.10.0

Valore predefinito: nessuno

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

Gli indirizzi email di Google Search Ads generalmente hanno il formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Ad esempio:

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

Vedi Abilitazione di Workload Identity su GKE o Abilitazione della federazione di Workload Identity su AKS ed EKS.

watcher.image.pullPolicy Avanzata Introdotta nella versione: 1.4.0

Valore predefinito: IfNotPresent

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

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

Per maggiori informazioni, consulta Aggiornare le immagini.

watcher.image.tag Avanzata Introdotta nella versione: 1.4.0

Valore predefinito: 1.12.0

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

watcher.image.url Avanzata Introdotta nella versione: 1.4.0

Valore predefinito: gcr.io/apigee-release/hybrid/apigee-watcher

la località dell'immagine Docker per questo servizio.

watcher.replicaCountMax Base Introdotta nella versione: 1.3.0

Valore predefinito: 1

Il numero massimo di repliche di watcher. Deve essere mantenuto all'indirizzo 1 per evitare conflitti.

watcher.replicaCountMin Base Introdotta nella versione: 1.3.0

Valore predefinito: 1

Il numero minimo di repliche di Watcher.

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

Valore predefinito: 1000m

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

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

Valore predefinito: 2Gi

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

watcher.serviceAccountPath Base Introdotta nella versione: 1.3.0

Valore predefinito: nessuno

Obbligatorio.

Percorso del file delle chiavi dell'account di servizio Google con il ruolo Apigee Runtime Agent.

watcher.serviceAccountRef Avanzata Introdotta nella versione: 1.3.0

Valore predefinito: nessuno

È obbligatorio specificare serviceAccountPath o serviceAccountRef.

watcher.tolerations.effect Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Necessario per utilizzare la funzionalità Tensioni e tolleranze di Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Per maggiori dettagli, vedi Invecchiamenti e tolleranze: concetti.

watcher.tolerations.key Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

watcher.tolerations.operator Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: "Equal"

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

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

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

watcher.tolerations.tolerationSeconds Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.

watcher.tolerations.value Avanzata Introdotta nella versione: 1.10.1

Valore predefinito: nessuno

Utilizzato dalla funzionalità Tinte e tolleranze di Kubernetes.

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

Per maggiori dettagli, consulta Invecchiamenti e tolleranze: concetti.