Riferimento per le proprietà di configurazione

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

Proprietà di primo livello

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

Proprietà Descrizione
contractProvider Versione: 1.0.0

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

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

gcpProjectID Versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

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

gcpRegion Versione: 1.0.0

Valore predefinito: us-central1

Obbligatorio

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

imagePullSecrets.name Versione: 1.0.0

Valore predefinito: nessuno

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

k8sClusterName

Tipo:

Versione: 1.0.0

Valore predefinito: nessuno

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

namespace Versione: 1.0.0

Valore predefinito: apigee

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

org Obbligatorio

Versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

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

revision Versione: 1.0.0

Valore predefinito: 1.0.0

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

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

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

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

Per ulteriori informazioni, vedi Aggiornamenti continui.

validateServiceAccounts Versione: 1.0.0

Valore predefinito: true

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

Vedi anche gcpProjectID

adah

L'admission webhook di deployment di Apigee (ADAH) è responsabile della convalida della configurazione che l'utente fornisce per apigee-deployment-controller. Viene eseguito in un cluster Kubernetes ed è responsabile della convalida delle richieste di creazione/aggiornamento/eliminazione in entrata dal controller di deployment Apigee. Vedi anche:

La tabella seguente descrive le proprietà dell'oggetto adah del controller di deployment Apigee:

Proprietà Descrizione
adah.image.pullPolicy Versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, vedi Aggiornare le immagini.

adah.image.tag Versione: 1.0.0

Valore predefinito: 1.0.0

La posizione dell'immagine Docker per questo servizio.

adah.image.url Versione: 1.0.0

Valore predefinito: "us.gcr.io/google.com/edge-ci/release/eda/apigee-deployment-admissionhook/master/admissionhook"

La posizione dell'immagine Docker per questo servizio.

adc

L'Apigee Deployment Controller (ADC) è un processo che gestisce il deployment di Apigee nei cluster Kubernetes. Si tratta di un controller personalizzato di Kubernetes che crea e aggiorna risorse Kubernetes e Istio di basso livello necessarie per il deployment e la manutenzione di ApigeeDeployment (AD).

Vedi anche adah (Apigee Deployment Admissionhook)

.

La tabella seguente descrive le proprietà dell'oggetto apigee-deployment-controller adc:

Proprietà Descrizione
adc.image.pullPolicy Versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, vedi Aggiornare le immagini.

adc.image.tag Versione: 1.0.0

Valore predefinito: 1.0.0

La posizione dell'immagine Docker per questo servizio.

adc.image.url Versione: 1.0.0

Valore predefinito: "us.gcr.io/google.com/edge-ci/release/eda/apigee-deployment-controller/master/controller"

La posizione dell'immagine Docker per questo servizio.

adc.resources.limits.cpu Versione: 1.0.0

Valore predefinito: 250m

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

adc.resources.limits.memory Versione: 1.0.0

Valore predefinito: 256Mi

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

adc.resources.requests.cpu Versione: 1.0.0

Valore predefinito: 250m

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

adc.resources.requests.memory Versione: 1.0.0

Valore predefinito: 256Mi

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

authz

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

Proprietà Descrizione
authz.image.pullPolicy Versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, vedi Aggiornare le immagini.

authz.image.tag Versione: 1.0.0

Valore predefinito: 1.0.0

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

authz.image.url Versione: 1.0.0

Valore predefinito: "us.gcr.io/google.com/edge-ci/integration/featureplatform/apigee-authn-authz/master"

La posizione dell'immagine Docker per questo servizio.

authz.livenessProbe.failureThreshold Versione: 1.0.0

Valore predefinito: 2

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

authz.livenessProbe.initialDelaySeconds 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à.

authz.livenessProbe.periodSeconds Versione: 1.0.0

Valore predefinito: 5

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

authz.livenessProbe.timeoutSeconds Versione: 1.0.0

Valore predefinito: 1

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

authz.readinessProbe.failureThreshold Versione: Beta2

Valore predefinito: 2

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

authz.readinessProbe.initialDelaySeconds 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à.

authz.readinessProbe.periodSeconds Versione: 1.0.0

Valore predefinito: 5

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

authz.readinessProbe.successThreshold 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.

authz.readinessProbe.timeoutSeconds Versione: 1.0.0

Valore predefinito: 1

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

authz.resources.requests.cpu Versione: 1.0.0

Valore predefinito: 50m

La quantità di risorse CPU da allocare per le richieste di autenticazione.

authz.resources.requests.memory Versione: 1.0.0

Valore predefinito: 128Mi

La quantità di risorse di memoria da allocare per le richieste di autenticazione.

authz.serviceAccountPath Versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

Il percorso del file della chiave dell'account di servizio Google con il ruolo "Amministratore di Apigee di sola lettura".

busyBoxInit

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

Proprietà Descrizione
busyBoxInit.image.pullPolicy Versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, vedi Aggiornare le immagini.

busyBoxInit.image.tag Versione: 1.0.0

Valore predefinito: "1.0.0"

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

busyBoxInit.image.url Versione: 1.0.0

Valore predefinito: "busybox"

La posizione dell'immagine Docker per questo servizio.

cassandra

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

Per saperne di più, consulta Configurare Cassandra.

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

Proprietà Descrizione
cassandra.auth.admin.password Versione: 1.0.0

Valore predefinito: "iloveapis123"

Obbligatorio

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

cassandra.auth.ddl.password Versione: 1.0.0

Valore predefinito: "iloveapis123"

Obbligatorio

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

cassandra.auth.default.password Versione: 1.0.0

Valore predefinito: "iloveapis123"

Obbligatorio

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

cassandra.auth.dml.password Versione: 1.0.0

Valore predefinito: "iloveapis123"

Obbligatorio

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

cassandra.auth.image.pullPolicy Versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, vedi Aggiornare le immagini.

cassandra.auth.image.tag Versione: 1.0.0

Valore predefinito: 1.0.0

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

cassandra.auth.image.url Versione: 1.0.0

Valore predefinito: "google/apigee-cassandra-client"

La posizione dell'immagine Docker per questo servizio.

cassandra.backup.cloudProvider Versione: 1.0.0

Valore predefinito: "GCP"

Obbligatorio se il backup è attivo.

Provider cloud per l'archiviazione dei backup.

cassandra.backup.dbStorageBucket Versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio se il backup è attivo.

Bucket Cloud Storage per i dati di backup.

cassandra.backup.enabled Versione: 1.0.0

Valore predefinito: false

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

Consulta Backup e ripristino di Cassandra.

cassandra.backup.image.pullPolicy Versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, vedi Aggiornare le immagini.

cassandra.backup.image.tag Versione: 1.0.0

Valore predefinito: 1.0.0

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

cassandra.backup.image.url Versione: 1.0.0

Valore predefinito: "google/apigee-cassandra-backup-utility"

La posizione dell'immagine Docker per questo servizio.

cassandra.backup.schedule Versione: 1.0.0

Valore predefinito: "0 2 * * *"

La pianificazione del cron job.

Consulta Backup e ripristino di Cassandra.

cassandra.backup.serviceAccountPath Versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio se il backup è attivo.

Il percorso del file della chiave dell'account di servizio Google con il ruolo "Amministratore di Apigee di sola lettura".

cassandra.clusterName Versione: 1.0.0

Valore predefinito: "apigeecluster"

Specifica il nome del cluster Cassandra.

cassandra.datacenter Versione: 1.0.0

Valore predefinito: "dc-1"

Specifica il data center del nodo Cassandra.

cassandra.dnsPolicy Versione: 1.1.1

Valore predefinito: ClusterFirstWithHostNet

Quando cassandra.hostNetwork è impostato su true, questo determina quale criterio DNS utilizza Cassandra. Per i deployment basati su Anthos, deve essere impostato su ClusterFirstWithHostNet.

cassandra.externalSeedHost Versione: 1.0.0

Valore predefinito: nessuno

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

cassandra.heapNewSize Versione: 1.0.0

Valore predefinito: 100M

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

cassandra.hostNetwork Versione: 1.1.1

Valore predefinito: true

Imposta su true per i deployment basati su Anthos.

cassandra.image.pullPolicy Versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, vedi Aggiornare le immagini.

cassandra.image.tag Versione: 1.0.0

Valore predefinito: 1.0.0

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

cassandra.image.url Versione: 1.0.0

Valore predefinito: "google/apigee-cassandra"

La posizione dell'immagine Docker per questo servizio.

cassandra.maxHeapSize Versione: 1.0.0

Valore predefinito: 512M

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

cassandra.multiRegionSeedHost Versione: 1.0.0

Valore predefinito: nessuno

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

cassandra.nodeSelector.key Versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

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

Vedi Aggiungere selettori di nodi.

cassandra.nodeSelector.value Versione: 1.0.0

Valore predefinito: nessuno

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

Vedi nodeSelector.

cassandra.port Versione: 1.0.0

Valore predefinito: 9042

Numero di porta utilizzato per connettersi a Cassandra.

cassandra.rack Versione: 1.0.0

Valore predefinito: "ra-1"

Specifica il rack del nodo Cassandra.

cassandra.readinessProbe.failureThreshold Versione: 1.0.0

Valore predefinito: 2

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

cassandra.readinessProbe.initialDelaySeconds 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 Versione: 1.0.0

Valore predefinito: 10

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

cassandra.readinessProbe.successThreshold 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 Versione: 1.0.0

Valore predefinito: 5

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

cassandra.replicaCount Versione: 1.0.0

Valore predefinito: 3

Cassandra è un database replicato. È configurato in modo da avere almeno tre copie dei dati in ogni regione o data center. Questa proprietà specifica il numero di nodi Cassandra utilizzati come StatefulSet.

cassandra.resources.requests.cpu 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 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 Versione: 1.0.0

Valore predefinito: "GCP"

Obbligatorio se il ripristino è attivato.

Provider cloud per l'archiviazione dei backup.

cassandra.restore.dbStorageBucket Versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio se il ripristino è attivato.

Bucket Cloud Storage per i dati di backup da ripristinare.

cassandra.restore.enabled Versione: 1.0.0

Valore predefinito: false

cassandra.restore.image.pullPolicy Versione: 1.0.0

Valore predefinito: IfNotPresent

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

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

Per ulteriori informazioni, vedi Aggiornare le immagini.

cassandra.restore.image.tag Versione: 1.0.0

Valore predefinito: 1.0.0

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

cassandra.restore.image.url Versione: 1.0.0

Valore predefinito: "google/apigee-cassandra-backup-utility"

La posizione dell'immagine Docker per questo servizio.

cassandra.restore.serviceAccountPath Versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio se il ripristino è attivato.

Il percorso del file della chiave dell'account di servizio Google con il ruolo "Amministratore di Apigee di sola lettura".

cassandra.restore.snapshotTimestamp Versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio se il ripristino è attivato.

Timestamp del backup da ripristinare.

cassandra.storage.capacity Versione: 1.0.0

Valore predefinito: 50Gi

Obbligatorio se è specificato storage.storageClass

Specifica le dimensioni del disco richieste, in mebibyte.

cassandra.storage.storageClass Versione: 1.0.0

Valore predefinito: nessuno

Specifica la classe di archiviazione on-premise in uso.

cassandra.terminationGracePeriodSeconds Versione: 1.0.0

Valore predefinito: 300

Il tempo che intercorre tra una richiesta di eliminazione del pod e l'eliminazione del pod, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop e tutti i processi in esecuzione verranno terminati in modo controllato.

defaults

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

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

Proprietà Descrizione
defaults.org.kmsEncryptionKey Versione: 1.0.0

Valore predefinito: "aWxvdmVhcGlzMTIzNDU2Nw=="

Chiave di crittografia predefinita per l'organizzazione in KMS.

defaults.org.kvmEncryptionKey Versione: 1.0.0

Valore predefinito: "aWxvdmVhcGlzMTIzNDU2Nw=="

Chiave di crittografia predefinita per l'organizzazione in KVM.

defaults.env.kmsEncryptionKey Versione: 1.0.0

Valore predefinito: "aWxvdmVhcGlzMTIzNDU2Nw=="

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

defaults.env.kvmEncryptionKey Versione: 1.0.0

Valore predefinito: "aWxvdmVhcGlzMTIzNDU2Nw=="

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

defaults.env.cacheEncryptionKey Versione: 1.0.0

Valore predefinito: "aWxvdmVhcGlzMTIzNDU2Nw=="

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

envs

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

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

Utilizza envs[] per configurare il routing del percorso di base, che ti consente di configurare e gestire il modo in cui Apigee hybrid indirizza le chiamate proxy API all'ambiente corretto.

Per saperne di più, vedi:

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

Proprietà Descrizione
envs[].cacheEncryptionKey Versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

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

envs[].hostAlias Versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

Il nome DNS del server. Ad esempio, foo-test.mydomain.com. Se non hai un nome DNS, puoi utilizzare un carattere jolly ('*'). Se utilizzi un carattere jolly, puoi utilizzare l'IP esterno di istio-ingressgateway, che puoi ottenere chiamando kubectl get services -n namespace dopo aver completato l'installazione.

Se hai più ambienti, devi utilizzare un nome alias host univoco per ciascuno. Ad esempio, foo-test.mydomain.com e foo-prod.mydomain.com.

envs[].kmsEncryptionKey Versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

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

envs[].name Versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

Nome dell'ambiente Apigee da sincronizzare.

envs[].pollInterval Versione: 1.0.0

Valore predefinito: nessuno

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

envs[].paths.uri.prefixes Versione: 1.0.0

Valore predefinito: nessuno

Una proprietà per supportare il routing del percorso base del prefisso. Fornisci questi percorsi nel seguente formato:

      org: hybrid
      envs:
      - name: test
        paths:
          uri:
            prefixes:
            - /foo
            - /bar
envs[].port Versione: 1.0.0

Valore predefinito: nessuno

Numero di porta TCP per il traffico HTTPS.

envs[].serviceAccountPaths.synchronizer Versione: GA

Valore predefinito: nessuno

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

envs[].serviceAccountPaths.udca Versione: GA

Valore predefinito: nessuno

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

envs[].sslCertPath Versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

Il percorso sul tuo sistema di un file di certificato TLS.

envs[].sslKeyPath Versione: 1.0.0

Valore predefinito: nessuno

Obbligatorio

Il percorso nel sistema del file della chiave privata TLS.

httpProxy

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

Vedi anche: MART, Synchronizer e UDCA.

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

Proprietà Descrizione
httpProxy.host Versione: 1.1.1

Valore predefinito: nessuno

Il nome host del proxy HTTP.

httpProxy.port Versione: 1.1.1

Valore predefinito: nessuno

La porta del proxy HTTP.

httpProxy.scheme Versione: 1.1.1

Valore predefinito: HTTPS

Lo schema utilizzato dal proxy. I valori possono essere HTTP o HTTPS.

ingress

ingress è l'istanza di Istio Ingress Gateway, la risorsa Kubernetes Ingress viene utilizzata per specificare i servizi che devono essere esposti all'esterno del cluster. Definisce un'app in container che instrada il traffico dall'esterno del piano di runtime ai servizi all'interno del piano di runtime. L'installazione di Apigee crea due oggetti Istio Ingress per:

  1. Runtime
  2. MART

Vedi anche:

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

Proprietà Descrizione
ingress.enableAccesslog Versione: 1.0.0

Valore predefinito: false

Attiva o disattiva il log di accesso Ingress. Per impostazione predefinita, è disattivata.

ingress.envoyHeaders.headers Versione: 1.0.0

Valore predefinito: nessuno

Un elenco di intestazioni Envoy.

ingress.envoyHeaders.preserved Versione: 1.0.0

Valore predefinito: false

Determina se conservare o meno le intestazioni di Envoy. Per impostazione predefinita, non lo sono.

ingress.httpsRedirect Versione: 1.0.0

Valore predefinito: true

Attiva o disattiva il reindirizzamento HTTPS automatico per tutto il traffico in entrata.

ingress.mart.loadBalancerIP Versione: 1.1.1

Valore predefinito: 10.0.10.252

Indirizzo IP del bilanciatore del carico MART.

ingress.runtime.loadBalancerIP Versione: 1.1.1

Valore predefinito: 10.0.10.251

Indirizzo IP del bilanciatore del carico per l'oggetto Apigee-runtime.

ingress.serviceType Versione: 1.0.0

Valore predefinito: LoadBalancer

Il tipo di servizio utilizzato per instradare il traffico esterno ai servizi interni.

I valori possibili sono:

  • ClusterIP (non supportato)
  • LoadBalancer
  • NodePort

istio

L'implementazione di Istio di Google Cloud Platform (GCP) è un mesh di servizi che si sovrappone all'istanza Apigee esistente, aiutandola a integrarsi con la piattaforma di logging, il sistema di telemetria e le norme.

Vedi anche: documentazione di Istio di Google Cloud e Che cos'è Istio?

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

Proprietà Descrizione
istio.ingressgateway.replicaCountMax Versione: 1.0.0

Valore predefinito: 5

Obbligatorio

Numero massimo di repliche del gateway in entrata Istio consentite.

Vedi:

istio.ingressgateway.replicaCountMin Versione: 1.0.0

Valore predefinito: 1

Obbligatorio

Numero minimo di repliche del gateway in entrata Istio richieste.

Vedi:

istio.ingressgateway.resources.requests.cpu Versione: 1.0.0

Valore predefinito: 100 m

Obbligatorio

Risorse CPU allocate al controller Ingress, necessarie per il funzionamento ottimale del gateway.

Vedi:

istio.ingressgateway.resources.requests.memory Versione: 1.0.0

Valore predefinito: 128 Mi

Risorse di memoria allocate al controller Ingress, necessarie per il funzionamento ottimale del gateway.

  • oggetto Ingress
  • Ingress Gateways nella documentazione di Istio
  • Controller Ingress nella documentazione di Kubernetes.
  • istio.nodeSelector.key Versione: 1.0.0

    Valore predefinito: nessuno

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

    istio.nodeSelector.value Versione: 1.0.0

    Valore predefinito: nessuno

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

    istio.pilot.replicaCountMax Versione: 1.0.0

    Valore predefinito: 5

    Obbligatorio

    La gestione del traffico principale pilot all'interno del cluster, che comunica con il proxy envoy sidecar. replicaCountMax è il numero massimo di repliche di Istio Pilot consentite.

    Consulta Progetto pilota: gestione del traffico principale nella documentazione di Istio.

    istio.pilot.replicaCountMin Versione: 1.0.0

    Valore predefinito: 1

    Obbligatorio

    La gestione del traffico principale pilot all'interno del cluster, che comunica con il proxy envoy sidecar. replicaCountMax è il numero massimo di repliche di Istio Pilot richieste.

    Consulta Progetto pilota: gestione del traffico principale nella documentazione di Istio.

    istio.pilot.resources.requests.cpu Versione: 1.0.0

    Valore predefinito: 500 m

    Obbligatorio

    Risorse CPU allocate al processo pilota, necessarie per il funzionamento ottimale del gateway.

    Vedi:

    istio.pilot.resources.requests.memory Versione: 1.0.0

    Valore predefinito: 2048 Mi

    Risorse di memoria allocate al processo pilota, necessarie per il funzionamento ottimale del gateway.

    Vedi:

    logger

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

    Per ulteriori informazioni, consulta la sezione Logging.

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

    Proprietà Descrizione
    logger.enabled Versione: 1.0.0

    Valore predefinito: true

    Attiva o disattiva la registrazione nel cluster. Per GKE non impostato su true, per Anthos o GKE impostato su false.

    logger.fluentd.buffer_chunk_limit Versione: 1.0.0

    Valore predefinito: 512k

    La dimensione massima consentita di un blocco del buffer, in kilobyte. I blocchi che superano il limite verranno scaricati automaticamente nella coda di output.

    logger.fluentd.buffer_queue_limit Versione: 1.0.0

    Valore predefinito: 6

    La lunghezza massima della coda di output. Il limite predefinito è 256 blocchi.

    logger.fluentd.flush_interval Versione: 1.0.0

    Valore predefinito: 5s

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

    logger.fluentd.max_retry_wait Versione: 1.0.0

    Valore predefinito: 30

    L'intervallo massimo tra i tentativi di scrittura, in secondi.

    logger.fluentd.num_threads Versione: 1.0.0

    Valore predefinito: 2

    Il numero di thread utilizzati per svuotare il buffer. Il valore predefinito è 1.

    logger.image.pullPolicy Versione: 1.0.0

    Valore predefinito: IfNotPresent

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

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

    Per ulteriori informazioni, vedi Aggiornare le immagini.

    logger.image.tag Versione: 1.0.0

    Valore predefinito: "1.6.8"

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

    logger.image.url Versione: 1.0.0

    Valore predefinito: "google/apigee-stackdriver-logging-agent"

    La posizione dell'immagine Docker per questo servizio.

    logger.livenessProbe.failureThreshold Versione: 1.0.0

    Valore predefinito: 3

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

    logger.livenessProbe.initialDelaySeconds 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 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 Versione: 1.0.0

    Valore predefinito: 1

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

    logger.livenessProbe.timeoutSeconds Versione: 1.0.0

    Valore predefinito: 1

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

    logger.nodeSelector.key Versione: 1.0.0

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

    Obbligatorio

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

    Vedi Aggiungere selettori di nodi.

    logger.nodeSelector.value Versione: 1.0.0

    Valore predefinito: "true"

    Obbligatorio

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

    Vedi Aggiungere selettori di nodi.

    logger.proxyURL Versione: 1.0.0

    Valore predefinito: nessuno

    URL del server proxy del cliente.

    logger.resource.limits.memory Versione: 1.0.0

    Valore predefinito: 500Mi

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

    logger.resource.limits.cpu Versione: 1.0.0

    Valore predefinito: 200m

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

    logger.resource.requests.cpu Versione: 1.0.0

    Valore predefinito: 100m

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

    logger.resource.requests.memory Versione: 1.0.0

    Valore predefinito: 250Mi

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

    logger.serviceAccountPath Versione: 1.0.0

    Valore predefinito: nessuno

    Obbligatorio

    Il percorso del file della chiave dell'account di servizio Google con il ruolo "Amministratore di Apigee di sola lettura".

    logger.terminationGracePeriodSeconds Versione: 1.0.0

    Valore predefinito: 30

    Il tempo che intercorre tra una richiesta di eliminazione del pod e l'eliminazione del pod, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop e tutti i processi in esecuzione verranno terminati in modo controllato.

    mart

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

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

    Proprietà Descrizione
    mart.hostAlias Versione: 1.0.0

    Valore predefinito: nessuno

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

    mart.image.pullPolicy Versione: 1.0.0

    Valore predefinito: IfNotPresent

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

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

    Per ulteriori informazioni, vedi Aggiornare le immagini.

    mart.image.tag Versione: 1.0.0

    Valore predefinito: 1.0.0

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

    mart.image.url Versione: 1.0.0

    Valore predefinito: "google/apigee-mart-server"

    La posizione dell'immagine Docker per questo servizio. Controlla il file values.yaml per l'URL specifico.Puoi eseguire l'override.

    mart.initCheckCF.resources.requests.cpu Versione: 1.0.0

    Valore predefinito: 10m

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

    mart.livenessProbe.failureThreshold Versione: 1.0.0

    Valore predefinito: 12

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

    mart.livenessProbe.initialDelaySeconds 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 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 Versione: 1.0.0

    Valore predefinito: 1

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

    mart.metricsURL Versione: 1.0.0

    Valore predefinito: "/v1/server/metrics"

    mart.nodeSelector.key Versione: 1.0.0

    Valore predefinito: nessuno

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

    Vedi Aggiungere selettori di nodi.

    mart.nodeSelector.value Versione: 1.0.0

    Valore predefinito: nessuno

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

    Vedi Aggiungere selettori di nodi.

    mart.readinessProbe.failureThreshold Versione: 1.0.0

    Valore predefinito: 2

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

    mart.readinessProbe.initialDelaySeconds 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 Versione: 1.0.0

    Valore predefinito: 5

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

    mart.readinessProbe.successThreshold 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 Versione: 1.0.0

    Valore predefinito: 1

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

    mart.replicaCountMax Versione: 1.0.0

    Valore predefinito: 5

    Numero massimo di repliche disponibili per la scalabilità automatica.

    mart.replicaCountMin Versione: 1.0.0

    Valore predefinito: 1

    Numero minimo di repliche disponibili per la scalabilità automatica.

    mart.resources.requests.cpu 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 Versione: 1.0.0

    Valore predefinito: 512Mi

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

    mart.serviceAccountPath Versione: 1.1.1

    Valore predefinito: nessuno

    Obbligatorio

    Il percorso del file della chiave dell'account di servizio Google con il ruolo "Amministratore di Apigee di sola lettura".

    mart.sslCertPath Versione: 1.0.0

    Valore predefinito: nessuno

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

    mart.sslKeyPath Versione: 1.0.0

    Valore predefinito: nessuno

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

    mart.targetCPUUtilizationPercentage Versione: 1.0.0

    Valore predefinito: 75

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

    mart.terminationGracePeriodSeconds Versione: 1.0.0

    Valore predefinito: 30

    Il tempo che intercorre tra una richiesta di eliminazione del pod e l'eliminazione del pod, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop e tutti i processi in esecuzione verranno terminati in modo controllato.

    metrics

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

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

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

    Proprietà Descrizione
    metrics.enabled Versione: 1.0.0

    Valore predefinito: false

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

    metrics.nodeSelector.key Versione: 1.0.0

    Valore predefinito: nessuno

    Obbligatorio

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

    Vedi Aggiungere selettori di nodi.

    metrics.nodeSelector.value Versione: 1.0.0

    Valore predefinito: nessuno

    Obbligatorio

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

    Vedi Aggiungere selettori di nodi.

    metrics.prometheus.args.storage_tsdb_retention Versione: 1.0.0

    Valore predefinito: 48h

    Il periodo di tempo che Prometheus attende prima di rimuovere i dati precedenti dallo spazio di archiviazione locale, in ore.

    metrics.prometheus.containerPort Versione: 1.0.0

    Valore predefinito: 9090

    La porta per connettersi al servizio di metriche Prometheus.

    metrics.prometheus.image.pullPolicy Versione: 1.0.0

    Valore predefinito: IfNotPresent

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

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

    Per ulteriori informazioni, vedi Aggiornare le immagini.

    metrics.prometheus.image.tag Versione: 1.0.0

    Valore predefinito: "v2.9.2"

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

    metrics.prometheus.image.url Versione: 1.0.0

    Valore predefinito: "google/apigee-prom-prometheus"

    La posizione dell'immagine Docker per questo servizio.

    metrics.prometheus.livenessProbe.failureThreshold Versione: 1.0.0

    Valore predefinito: 6

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

    metrics.prometheus.livenessProbe.periodSeconds 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 Versione: 1.0.0

    Valore predefinito: 3

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

    metrics.prometheus.readinessProbe.failureThreshold Versione: 1.0.0

    Valore predefinito: 120

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

    metrics.prometheus.readinessProbe.periodSeconds Versione: 1.0.0

    Valore predefinito: 5

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

    metrics.prometheus.readinessProbe.timeoutSeconds Versione: 1.0.0

    Valore predefinito: 3

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

    metrics.proxyURL Versione: 1.0.0

    Valore predefinito: nessuno

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

    metrics.resources.limits.cpu Versione: 1.0.0

    Valore predefinito: 250m

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

    metrics.resources.limits.memory Versione: 1.0.0

    Valore predefinito: 256Mi

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

    metrics.resources.requests.cpu Versione: 1.0.0

    Valore predefinito: 250m

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

    metrics.resources.requests.memory Versione: 1.0.0

    Valore predefinito: 256Mi

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

    metrics.sdSidecar.containerPort Versione: 1.0.0

    Valore predefinito: 9091

    La porta per connettersi al servizio di metriche Stackdriver.

    metrics.sdSidecar.image.pullPolicy Versione: 1.0.0

    Valore predefinito: IfNotPresent

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

    • IfNotPresent: Non estrarre una nuova immagine se esiste già
    • Always: estrai sempre la policy, anche se esiste già

      Per ulteriori informazioni, vedi Aggiornamento delle immagini.

    metrics.sdSidecar.image.tag Versione: 1.0.0

    Valore predefinito: "release-0.4.0"

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

    metrics.sdSidecar.image.url Versione: 1.0.0

    Valore predefinito: "google/apigee-stackdriver-prometheus-sidecar"

    La posizione dell'immagine Docker per questo servizio.

    metrics.serviceAccountPath Versione: 1.0.0

    Valore predefinito: nessuno

    Obbligatorio

    Il percorso del file della chiave dell'account di servizio Google con il ruolo "Amministratore di Apigee di sola lettura".

    metrics.terminationGracePeriodSeconds Versione: 1.0.0

    Valore predefinito: 300

    Il tempo che intercorre tra una richiesta di eliminazione del pod e l'eliminazione del pod, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop e tutti i processi in esecuzione verranno terminati in modo controllato.

    nodeSelector

    L'oggetto nodeSelector definisce il nodo per l'istanza Apigee. Quando viene eseguito apigeectl, si occupa di mappare la chiave/il valore dell'etichetta per apigeeRuntime e apigeeData ai singoli componenti Istio e MART. Puoi ignorare questa impostazione per i singoli oggetti nelle proprietà istio:nodeSelector e mart:nodeSelector.

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

    Proprietà Descrizione
    nodeSelector.apigeeData.key Versione: 1.0.0

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

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

    Vedi Aggiungere selettori di nodi.

    nodeSelector.apigeeData.value Versione: 1.0.0

    Valore predefinito: "apigee-data"

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

    Vedi Aggiungere selettori di nodi.

    nodeSelector.apigeeRuntime.key Versione: 1.0.0

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

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

    Vedi Aggiungere selettori di nodi.

    nodeSelector.apigeeRuntime.value 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 Aggiungere selettori di nodi.

    nodeSelector.requiredForScheduling Versione: 1.0.0

    Valore predefinito: false

    Il valore predefinito della proprietà requiredForScheduling è false. Se questo valore viene sostituito con true, significa che se Kubernetes non riesce a trovare nodi con la chiave/il valore dell'etichetta configurati, i pod sottostanti non verranno pianificati sui nodi di lavoro VM.

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

    Vedi Aggiungere selettori di nodi.

    runtime

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

    Proprietà Descrizione
    runtime.image.pullPolicy Versione: 1.0.0

    Valore predefinito: IfNotPresent

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

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

    Per ulteriori informazioni, vedi Aggiornare le immagini.

    runtime.image.tag Versione: 1.0.0

    Valore predefinito: 1.0.0

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

    runtime.image.url Versione: 1.0.0

    Valore predefinito: URL della risorsa immagine dell'installazione, ad esempio: "google/apigee-runtime"

    La posizione dell'immagine Docker per questo servizio.

    runtime.livenessProbe.failureThreshold Versione: 1.0.0

    Valore predefinito: 2

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

    runtime.livenessProbe.initialDelaySeconds 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 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 Versione: 1.0.0

    Valore predefinito: 1

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

    runtime.nodeSelector.key Versione: 1.0.0

    Valore predefinito: nessuno

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

    Vedi la proprietà nodeSelector.

    runtime.nodeSelector.value 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 Aggiungere selettori di nodi.

    runtime.readinessProbe.failureThreshold Versione: 1.0.0

    Valore predefinito: 2

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

    runtime.readinessProbe.initialDelaySeconds 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 Versione: 1.0.0

    Valore predefinito: 5

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

    runtime.readinessProbe.successThreshold 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 Versione: 1.0.0

    Valore predefinito: 1

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

    runtime.replicaCountMax Versione: 1.0.0

    Valore predefinito: 4

    Numero massimo di repliche disponibili per la scalabilità automatica.

    runtime.replicaCountMin Versione: 1.0.0

    Valore predefinito: 1

    Numero minimo di repliche disponibili per la scalabilità automatica.

    runtime.resources.requests.cpu 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 Versione: 1.0.0

    Valore predefinito: 1Gi

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

    runtime.service.type Versione: 1.0.0

    Valore predefinito: ClusterIP

    Il tipo di servizio. Puoi impostare questo valore su un servizio diverso da ClusterIP, ad esempio LoadBalancer.

    runtime.targetCPUUtilizationPercentage Versione: 1.0.0

    Valore predefinito: 75

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

    runtime.terminationGracePeriodSeconds Versione: 1.0.0

    Valore predefinito: 180

    Il tempo che intercorre tra una richiesta di eliminazione del pod e l'eliminazione del pod, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop e tutti i processi in esecuzione verranno terminati in modo controllato.

    synchronizer

    Assicura che i processori di messaggi siano aggiornati con gli ultimi bundle di proxy API di cui è stato eseguito il deployment. A questo scopo, Synchronizer esegue il polling del piano di gestione; quando viene rilevato un nuovo contratto, Synchronizer lo invia al piano di runtime.

    Per saperne di più, vedi Synchronizer.

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

    Proprietà Descrizione
    synchronizer.image.pullPolicy Versione: 1.0.0

    Valore predefinito: IfNotPresent

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

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

    Per ulteriori informazioni, vedi Aggiornare le immagini.

    synchronizer.image.tag Versione: 1.0.0

    Valore predefinito: 1.0.0

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

    synchronizer.image.url Versione: 1.0.0

    Valore predefinito: "google/apigee-synchronizer"

    La posizione dell'immagine Docker per questo servizio.

    synchronizer.livenessProbe.failureThreshold Versione: 1.0.0

    Valore predefinito: 2

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

    synchronizer.livenessProbe.initialDelaySeconds 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 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 Versione: 1.0.0

    Valore predefinito: 1

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

    synchronizer.nodeSelector.key Versione: 1.0.0

    Valore predefinito: nessuno

    Obbligatorio

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

    Vedi nodeSelector.

    synchronizer.nodeSelector.value Versione: 1.0.0

    Valore predefinito: nessuno

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

    Vedi nodeSelector.

    synchronizer.pollInterval Versione: 1.0.0

    Valore predefinito: 60

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

    synchronizer.readinessProbe.failureThreshold Versione: 1.0.0

    Valore predefinito: 2

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

    synchronizer.readinessProbe.initialDelaySeconds 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 Versione: 1.0.0

    Valore predefinito: 5

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

    synchronizer.readinessProbe.successThreshold 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 Versione: 1.0.0

    Valore predefinito: 1

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

    synchronizer.replicaCount Versione: 1.0.0

    Valore predefinito: 2

    Numero di repliche per la scalabilità automatica.

    synchronizer.resources.requests.cpu 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 Versione: 1.0.0

    Valore predefinito: 1Gi

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

    synchronizer.serviceAccountPath Versione: 1.0.0

    Valore predefinito: nessuno

    Obbligatorio

    Il percorso del file della chiave dell'account di servizio Google con il ruolo "Amministratore di Apigee di sola lettura".

    synchronizer.targetCPUUtilizationPercentage Versione: 1.0.0

    Valore predefinito: 75

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

    synchronizer.terminationGracePeriodSeconds Versione: 1.0.0

    Valore predefinito: 30

    Il tempo che intercorre tra una richiesta di eliminazione del pod e l'eliminazione del pod, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop e tutti i processi in esecuzione verranno terminati in modo controllato.

    udca

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

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

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

    Proprietà Descrizione
    udca.fluentd.image.pullPolicy Versione: 1.0.0

    Valore predefinito: IfNotPresent

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

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

    Per ulteriori informazioni, vedi Aggiornare le immagini.

    udca.fluentd.image.tag Versione: 1.0.0

    Valore predefinito: 1.0.0

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

    udca.fluentd.image.url Versione: 1.0.0

    Valore predefinito: "google/apigee-stackdriver-logging-agent"

    La posizione dell'immagine Docker per questo servizio.

    udca.fluentd.resource.limits.memory Versione: 1.0.0

    Valore predefinito: 500Mi

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

    udca.fluentd.resource.requests.cpu Versione: 1.0.0

    Valore predefinito: 500m

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

    udca.fluentd.resource.requests.memory Versione: 1.0.0

    Valore predefinito: 250Mi

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

    udca.image.pullPolicy Versione: 1.0.0

    Valore predefinito: IfNotPresent

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

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

    Per ulteriori informazioni, vedi Aggiornare le immagini.

    udca.image.tag Versione: 1.0.0

    Valore predefinito: "1.0.0"

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

    udca.image.url Versione: 1.0.0

    Valore predefinito: "google/apigee-udca"

    La posizione dell'immagine Docker per questo servizio.

    udca.jvmXms Versione: 1.0.0

    Valore predefinito: 256m

    La quantità iniziale di memoria per la JVM del pod di raccolta dei dati.

    udca.jvmXmx Versione: 1.0.0

    Valore predefinito: 256m

    L'allocazione massima di memoria per la JVM del pod di raccolta dei dati.

    udca.livenessProbe.failureThreshold Versione: 1.0.0

    Valore predefinito: 2

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

    udca.livenessProbe.initialDelaySeconds 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 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 Versione: 1.0.0

    Valore predefinito: 1

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

    udca.nodeSelector.key Versione: 1.0.0

    Valore predefinito: nessuno

    Obbligatorio

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

    Vedi Aggiungere selettori di nodi.

    udca.nodeSelector.value Versione: 1.0.0

    Valore predefinito: nessuno

    Obbligatorio

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

    Vedi Aggiungere selettori di nodi.

    udca.pollingIntervalInSec Versione: 1.0.0

    Valore predefinito: 1

    La durata, in secondi, dell'attesa di UDCA tra le operazioni di polling. UDCA esegue il polling della directory dei dati nel file system del pod di raccolta dei dati per rilevare i nuovi file da caricare.

    prometheus.sslCertPath 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:

    prometheus.sslKeyPath 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:

    udca.replicaCountMax Versione: 1.0.0

    Valore predefinito: 4

    Il numero massimo di pod che ibrido può aggiungere automaticamente per il deployment UDCA. Poiché UDCA è implementato come ReplicaSet, i pod sono repliche.

    udca.replicaCountMin Versione: 1.0.0

    Valore predefinito: 1

    Il numero minimo di pod per il deployment UDCA. Poiché UDCA è implementato come ReplicaSet, i pod sono repliche.

    Se l'utilizzo della CPU supera udca.targetCPUUtilizationPercentage, il sistema ibrido aumenterà gradualmente il numero di pod fino a udca.replicaCountMax.

    udca.resource.requests.cpu Versione: 1.0.0

    Valore predefinito: 250m

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

    udca.revision Versione: 1

    Valore predefinito: "v1"

    Un valore statico inserito in un'etichetta per abilitare i deployment canary.

    udca.targetCPUUtilizationPercentage Versione: 1.0.0

    Valore predefinito: 75

    La soglia di utilizzo della CPU per scalare il numero di pod nel ReplicaSet, come percentuale delle risorse CPU totali disponibili. L'utilizzo ibrido utilizza l'utilizzo combinato di tutti i container nel pod di raccolta dei dati (sia fluentd che UDCA) per calcolare l'utilizzo attuale.

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

    udca.terminationGracePeriodSeconds Versione: 1.0.0

    Valore predefinito: 600

    Il tempo che intercorre tra una richiesta di eliminazione del pod e l'eliminazione del pod, in secondi. Durante questo periodo, verranno eseguiti tutti gli hook prestop e tutti i processi in esecuzione verranno terminati in modo controllato.