Referenz zu Konfigurationsattributen

In diesem Abschnitt werden alle Konfigurationsattribute aufgeführt, mit denen Sie die Laufzeitebene Ihrer Bereitstellung von Apigee Hybrid anpassen können.

Diese Seite filtern

Wählen Sie zum Filtern der auf dieser Seite angezeigten Attribute Einfach (am häufigsten verwendete Attribute) oder Erweitert (Attribute, die sich nur selten ändern) aus:

   Konfigurationsattribute auf dieser Seite anzeigen

Attribute der obersten Ebene

In der folgenden Tabelle werden die Attribute der obersten Ebene in der Datei overrides.yaml beschrieben. Dies sind Attribute, die nicht zu einem anderen Objekt gehören und auf Organisations- oder Umgebungsebene angewendet werden:

Attribut Typ Beschreibung
axHashSalt Erweitert

Eingeführt in Version: 1.3.0

Standardwert: iloveapis123

Optional

Der Name eines Kubernetes-Secrets, das einen Salt-Wert für die Berechnung von Hashes enthält, um Nutzerdaten zu verschleiern, bevor sie an Apigee Analytics gesendet werden. Wenn Sie keinen Salt-Wert angeben, wird standardmäßig iloveapis123 verwendet. Erstellen Sie das Secret mit dem Salt-Wert als Eingabe. Sie können denselben Salt-Wert für mehrere Cluster verwenden, damit die Hash-Ergebnisse zwischen den Clustern konsistent sind.

Apigee verwendet SHA512, um den ursprünglichen Wert zu hashen, bevor Daten von der Laufzeitebene an die Steuerungsebene gesendet werden.

Weitere Informationen finden Sie unter Nutzerdaten für Analysen verschleiern.

contractProvider Erweitert Eingeführt in Version: 1.0.0

Standardwert: https://apigee.googleapis.com

Definiert den API-Pfad für alle APIs in Ihrer Installation.

Erforderlich, wenn für Ihre Hybridinstallation der Datenstandort im folgenden Format verwendet wird:

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

Dabei ist CONTROL_PLANE_LOCATION der Ort, an dem Daten der Steuerungsebene wie Proxy-Bundles gespeichert werden. Eine Liste finden Sie unter Verfügbare Regionen der Apigee API-Steuerungsebene.

Beispiel:

contractProvider: https://us-apigee.googleapis.com
customAutoscaling.enabled Einfach Eingeführt in Version: 1.14.0

Standardwert: true

Aktiviert das messwertbasierte Autoscaling von Apigee, wenn der Wert auf true (Standard) festgelegt ist. Legen Sie false fest, um das benutzerdefinierte Autoscaling zu deaktivieren.

Änderungen an customAutoscaling.enabled wenden Sie an, indem Sie das Diagramm apigee-telemetry aktualisieren.

enhanceProxyLimits Erweitert Eingeführt in Version: 1.14.0

Standardwert: false

Erforderlich

enhanceProxyLimits ist für die Funktion „Erweiterte Proxylimits pro Umgebung“ von Apigee erforderlich. Legen Sie diesen Wert auf enhanceProxyLimits: true fest, wenn Ihre Hybridorganisation Anspruch auf erweiterte Proxylimits pro Umgebung hat.

Weitere Informationen:

Die Einstellung enhanceProxyLimits: true ist für die Verkettung von Proxys, Endpunkten und ServiceCallout erforderlich. Weitere Informationen:

Änderungen an enhanceProxyLimits wenden Sie an, indem Sie die Diagramme apigee-org und apigee-virtualhost für jede Umgebungsgruppe aktualisieren.

gcpProjectID Erweitert Deprecated: Verwenden Sie für v1.2.0 und höher stattdessen gcp.projectID.

Eingeführt in Version: 1.0.0

Standardwert: Keiner

Erforderlich

ID Ihres Google Cloud-Projekts. Funktioniert mit k8sClusterName (verworfen) und gcpRegion (verworfen), um das Projekt zu identifizieren und herauszufinden, wohin apigee-logger und apigee-metrics ihre Daten per Push übertragen.

gcpRegion Erweitert Deprecated: Verwenden Sie für v1.2.0 und höher stattdessen gcp.region.

Eingeführt in Version: 1.0.0

Standardwert: us-central1

Erforderlich

Die geschlossene Google Cloud-Region oder ‑Zone Ihres Kubernetes-Clusters. Funktioniert mit gcpProjectID (verworfen) und k8sClusterName (verworfen), um das Projekt zu identifizieren und herauszufinden, wohin apigee-logger und apigee-metrics ihre Daten per Push übertragen.

hub Erweitert Eingeführt in Version: 1.11.0

Standardwert: Keiner

Die URL eines privaten Image-Container-Repositorys, die zum Abrufen von Images für alle Apigee-Komponenten aus einem privaten Repository verwendet wird.

hub bietet einen Standardpfad für alle Apigee Hybrid-Komponenten. Wenn Sie ein privates Repository verwenden, legen Sie die Repository-URL für alle Komponenten mit hub fest, anstatt das Attribut image.url für jede einzelne Komponente zu verwenden. Konfigurieren Sie einzelne URLs nur, wenn Sie ein separates Repository für eine bestimmte Komponente verwenden.

Der Image-Pfad für jede einzelne Komponente ist der Wert von hub plus der Image-Name und das Tag für die Komponente.

Lautet der Wert von hub beispielsweise private-docker-host.example.com, lösen einzelne Komponenten automatisch den Image-Pfad:

hub: private-docker-host.example.com

auf als:

containers:
- name: apigee-udca
  image: private-docker-host.example.com/apigee-udca:1.14.3
  imagePullPolicy: IfNotPresent

Für die anderen Komponenten gilt ein ähnliches Muster.

Mit apigee-pull-push --list können Sie die aktuelle Repository-URL für alle Komponenten aufrufen.

Siehe Privates Image-Repository mit Apigee Hybrid verwenden.

Sie können die Image-URL für einzelne Komponenten mit den folgenden Attributen überschreiben:

imagePullSecrets.name Erweitert Eingeführt in Version: 1.0.0

Standardwert: Keiner

Als Docker-Registry-Typ konfigurierter Kubernetes-Secret-Name zum Abrufen von Images aus einem privaten Repository.

instanceID Einfach Eingeführt in Version: 1.3.0

Standardwert: Keiner

Erforderlich

Eine eindeutige Kennung für diese Installation.

Ein eindeutiger String zur Identifizierung dieser Instanz. Dies kann eine beliebige Kombination aus Buchstaben und Ziffern mit einer Länge von bis zu 63 Zeichen sein.

k8sClusterName Erweitert Deprecated: Verwenden Sie für v1.2.0 und höher stattdessen k8sCluster.name oder k8sCluster.region.

Eingeführt in Version: 1.0.0

Standardwert: Keiner

Name des Kubernetes-Clusters (K8S), in dem Ihr Hybrid-Projekt ausgeführt wird. Funktioniert mit gcpProjectID (verworfen) und gcpRegion (verworfen), um das Projekt zu identifizieren und herauszufinden, wohin apigee-logger und apigee-metrics ihre Daten per Push übertragen.

kmsEncryptionKey Erweitert Eingeführt in Version: 1.0.0

Standardwert: defaults.org.kmsEncryptionKey

Optional. Verwenden Sie kmsEncryptionKey, kmsEncryptionPath oder kmsEncryptionSecret.

Lokaler Dateisystempfad für den Verschlüsselungsschlüssel von Apigee-KMS-Daten.

kmsEncryptionPath Erweitert Eingeführt in Version: 1.2.0

Standardwert: Keiner

Optional. Verwenden Sie kmsEncryptionKey, kmsEncryptionPath oder kmsEncryptionSecret.

Der Pfad zu einer Datei, die einen base64-codierten Verschlüsselungsschlüssel enthält. Siehe Datenverschlüsselung.

kmsEncryptionSecret.key Erweitert Eingeführt in Version: 1.2.0

Standardwert: Keiner

Optional. Verwenden Sie kmsEncryptionKey, kmsEncryptionPath oder kmsEncryptionSecret.

Der Schlüssel eines Kubernetes-Secrets mit einem base64-codierten Verschlüsselungsschlüssel. Siehe Datenverschlüsselung.

kmsEncryptionSecret.name Erweitert Eingeführt in Version: 1.2.0

Standardwert: Keiner

Optional. Verwenden Sie kmsEncryptionKey, kmsEncryptionPath oder kmsEncryptionSecret.

Der Name eines Kubernetes-Secrets mit einem base64-codierten Verschlüsselungsschlüssel. Siehe Datenverschlüsselung.

kvmEncryptionKey Erweitert Eingeführt in Version: 1.0.0

Standardwert: defaults.org.kmsEncryptionKey

Optional. Verwenden Sie kvmEncryptionKey, kvmEncryptionPath oder kvmEncryptionSecret.

Lokaler Dateisystempfad für den Verschlüsselungsschlüssel von Apigee-KVM-Daten.

kvmEncryptionPath Erweitert Eingeführt in Version: 1.2.0

Standardwert: Keiner

Optional. Verwenden Sie kvmEncryptionKey, kvmEncryptionPath oder kvmEncryptionSecret.

Der Pfad zu einer Datei, die einen base64-codierten Verschlüsselungsschlüssel enthält. Siehe Datenverschlüsselung.

kvmEncryptionSecret.key Erweitert Eingeführt in Version: 1.2.0

Standardwert: Keiner

Optional. Verwenden Sie kvmEncryptionKey, kvmEncryptionPath oder kvmEncryptionSecret.

Der Schlüssel eines Kubernetes-Secrets mit einem base64-codierten Verschlüsselungsschlüssel. Siehe Datenverschlüsselung.

kvmEncryptionSecret.name Erweitert Eingeführt in Version: 1.2.0

Standardwert: Keiner

Optional. Verwenden Sie kvmEncryptionKey, kvmEncryptionPath oder kvmEncryptionSecret.

Der Name eines Kubernetes-Secrets mit einem base64-codierten Verschlüsselungsschlüssel. Siehe Datenverschlüsselung.

multiOrgCluster Erweitert Eingeführt in Version: 1.10.0

Standardwert: false

Bei Clustern für mehrere Organisationen können mit diesem Attribut die Messwerte der Organisation in das Projekt exportiert werden, das im Attribut gcp.projectID aufgeführt ist. Wenden Sie diese Einstellung in der Überschreibungsdatei für jede Organisation in einem Cluster für mehrere Organisationen an. Weitere Informationen finden Sie unter Mehrere Hybrid-Organisationen einem Cluster hinzufügen.

namespace Einfach Eingeführt in Version: 1.0.0

Standardwert: apigee

Der Namespace des Kubernetes-Clusters, in dem die Apigee-Komponenten installiert werden.

org Einfach

Eingeführt in Version: 1.0.0

Standardwert: Keiner

Erforderlich

Die Hybrid-fähige Organisation, die von Apigee während der Hybrid-Installation bereitgestellt wurde. Eine Organisation ist der oberste Container in Apigee. Sie enthält alle API-Proxys und die zugehörigen Ressourcen. Wenn der Wert leer ist, müssen Sie ihn nach dem Erstellen mit dem Namen Ihrer Organisation aktualisieren.

orgScopedUDCA Erweitert Eingeführt in Version: 1.8.0

Standardwert: true

Aktiviert den UDCA-Dienst (Universal Data Collection Agent) auf Organisationsebene, der Analysen, Monetarisierung und Fehlerbehebung (Trace) extrahiert und an die Unified Analytics Platform (UAP) sendet, die sich auf der Steuerungsebene befindet.

Der UDCA auf Organisationsebene verwendet ein einziges Google-Dienstkonto für alle Apigee-Umgebungen. Das Dienstkonto muss die Rolle „Apigee Analytics Agent“ (roles/apigee.analyticsAgent) haben.

Geben Sie den Pfad zur Dienstkontoschlüsseldatei mit dem Attribut udca.serviceAccountPath an oder stellen Sie den Schlüssel in einem Kubernetes-Secret mit dem Attribut udca.serviceAccountRef in der Konfigurationsdatei overrides.yaml bereit.

Wenn Sie für jede Umgebung einen separaten UDCA verwenden möchten, legen Sie orgScopedUDCA: false fest und definieren Sie Werte für envs[].serviceAccountPaths.udca und envs[].serviceAccountSecretRefs.udca.

Siehe UDCA.

revision Erweitert Eingeführt in Version: 1.0.0

Standardwert: "1143" (Ihre Apigee Hybrid-Version ohne Punkte. Bei Version 1.12.0 ist der Standardwert beispielsweise "1120".)

Apigee Hybrid unterstützt Rolling Updates von Kubernetes. So können Deployment-Updates ohne Ausfallzeit stattfinden, indem Pod-Instanzen schrittweise aktualisiert werden.

Beim Aktualisieren bestimmter YAML-Überschreibungen, die zu einer Änderung der zugrunde liegenden Kubernetes-PodTemplateSpec führen, muss auch das revision-Überschreibungsattribut in der Datei override.yaml des Kunden geändert werden. Dies ist erforderlich, damit der zugrunde liegende Kubernetes ApigeeDeployment-Controller (AD) ein sicheres Rolling Update von der vorherigen Version auf die neue Version durchführen kann. Sie können beliebige Kleinbuchstaben verwenden, zum Beispiel blue, a, 1.0.0.

Wird das revision-Attribut geändert und angewendet, wird für alle Komponenten ein Rolling Update durchgeführt.

Bei Änderungen an den Attributen der folgenden Objekte muss revision aktualisiert werden:

Weitere Informationen finden Sie unter Rolling Updates.

serviceAccountSecretProviderClass Erweitert Eingeführt in Version: 1.12.0

Standardwert: Keiner

Der Name der organisationsspezifischen Secret-Anbieterklasse (SecretProviderClass), die zum Speichern von Dienstkontoschlüsseln in Vault verwendet wird.

Siehe Dienstkontoschlüssel in Hashicorp Vault speichern.

validateOrg Erweitert Eingeführt in Version: 1.8.0

Standardwert: true

Ermöglicht eine strenge Validierung der Verknüpfung zwischen dem Apigee-Organisations- und dem Google Cloud-Projekt und prüft, ob Umgebungsgruppen vorhanden sind.

Siehe auch org

validateServiceAccounts Erweitert Eingeführt in Version: 1.0.0

Standardwert: true

Ermöglicht eine strenge Validierung von Dienstkontoberechtigungen. Hier wird mithilfe der Cloud Resource Manager API-Methode testIamPermissions geprüft, ob das angegebene Dienstkonto die erforderlichen Berechtigungen hat. Bei Dienstkonten für eine Apigee-Organisation wird die Projekt-ID-Prüfung der Organisation zugeordnet. Für Messwerte und Logger basiert das geprüfte Projekt auf der Konfiguration gcpProjectID overrides.yaml.

Siehe auch gcpProjectID

ao

Apigee Operators (AO) erstellt und aktualisiert untergeordnete Kubernetes- und Istio-Ressourcen, die zur Bereitstellung und Verwaltung einer Komponente erforderlich sind. Beispielsweise führt der Controller den Release von Message Processors aus.

In der folgenden Tabelle werden die Attribute des ao-Objekts von Apigee Operators beschrieben:

Attribut Typ Beschreibung
ao.args.disableIstioConfigInAPIServer Erweitert Eingeführt in Version: 1.8.0

Standardwert: true

Hindert Apigee daran, die Konfiguration für vom Kunden installiertes Cloud Service Mesh bereitzustellen.

  • Legen Sie das Attribut für Hybrid-Installationen mit dem Apigee Ingress-Gateway auf true fest.
  • Legen Sie das Attribut für Hybrid-Installationen mit Cloud Service Mesh (Apigee Hybrid Version 1.8 und früher) auf false fest.
ao.args.disableManagedClusterRoles Erweitert Eingeführt in Version: 1.10.0

Standardwert: true

Wenn das Attribut auf true gesetzt ist (Standardeinstellung), verwaltet Apigee Hybrid ClusterRole und ClursterRoleBinding von Kubernetes nicht direkt. Falls Sie einen Prozess haben, der die Verwaltung dieser Ressourcen erfordert, muss dieser von einem Nutzer mit den entsprechenden Berechtigungen ausgeführt werden.

ao.image.pullPolicy Erweitert Eingeführt in Version: 1.2.0

Standardwert: IfNotPresent

Legt fest, wann kubelet das Docker-Image des Pods abruft. Mögliche Werte:

  • IfNotPresent: Kein neues Image abrufen, wenn es bereits vorhanden ist.
  • Always: Image immer abrufen, unabhängig davon, ob es bereits vorhanden ist.

Weitere Informationen finden Sie unter Updating images.

ao.image.tag Erweitert Eingeführt in Version: 1.2.0

Standardwert: 1.14.3

Das Versionslabel für das Docker-Image dieses Dienstes.

ao.image.url Erweitert Eingeführt in Version: 1.2.0

Standardwert: Keiner

Der Speicherort des Docker-Image für diesen Dienst.

Mit apigee-pull-push --list können Sie die aktuelle Repository-URL für diese Komponente aufrufen.

ao.resources.limits.cpu Erweitert Eingeführt in Version: 1.2.0

Standardwert: 250m

Das CPU-Limit für die Ressource in einem Kubernetes-Container in Millicore.

ao.resources.limits.memory Erweitert Eingeführt in Version: 1.2.0

Standardwert: 256Mi

Das Arbeitsspeicherlimit für die Ressource in einem Kubernetes-Container in Mebibyte.

ao.resources.requests.cpu Erweitert Eingeführt in Version: 1.2.0

Standardwert: 250m

Die CPU in Millicore, die für den normalen Betrieb der Ressource in einem Kubernetes-Container erforderlich ist.

ao.resources.requests.memory Erweitert Eingeführt in Version: 1.2.0

Standardwert: 256Mi

Der Arbeitsspeicher in Mebibyte, der für den normalen Betrieb der Ressource in einem Kubernetes-Container erforderlich ist.

ao.tolerations.effect Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

effect gibt die Auswirkung an, die eine Übereinstimmung einer Toleranz mit einer Markierung hat. effect kann folgende Werte haben:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

ao.tolerations.key Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

key identifiziert Pods, auf die die Toleranz angewendet werden kann.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

ao.tolerations.operator Erweitert Eingeführt in Version: 1.10.1

Standardwert: "Equal"

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

operator gibt den Vorgang an, der zum Auslösen von effect verwendet wird. operator kann folgende Werte haben:

  • Equal: Entspricht dem in value festgelegten Wert.
  • Exists: Ignoriert den in value festgelegten Wert.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

ao.tolerations.tolerationSeconds Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

tolerationSeconds definiert in Sekunden, wie lange ein Pod an einen fehlerhaften oder nicht reagierenden Knoten gebunden ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

ao.tolerations.value Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

value ist der Wert, der effect auslöst, wenn operator auf Equal gesetzt ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

apigeeIngressGateway

Konfiguriert das Apigee Ingress-Gateway für Apigee Hybrid. Verwenden Sie apigeeIngressGateway-Attribute, um eine gemeinsame Konfiguration auf alle Instanzen des Apigee Ingress-Gateways anzuwenden.

Informationen zum Konfigurieren einzelner Instanzen finden Sie unter ingressGateways.

Änderungen an apigeeIngressGateway-Attributen wenden Sie mit dem Diagramm apigee-org an.

In der folgenden Tabelle werden die Attribute des Objekts apigeeIngressGateway beschrieben:

Attribut Typ Beschreibung
apigeeIngressGateway.image.pullPolicy Erweitert Eingeführt in Version: 1.11.0

Standardwert: IfNotPresent

Legt fest, wann kubelet das Docker-Image des Pods abruft. Mögliche Werte:

  • IfNotPresent: Kein neues Image abrufen, wenn es bereits vorhanden ist.
  • Always: Image immer abrufen, unabhängig davon, ob es bereits vorhanden ist.

Weitere Informationen finden Sie unter Updating images.

apigeeIngressGateway.image.tag Erweitert Eingeführt in Version: 1.11.0

Standardwert: 1.14.3

Das Versionslabel für das Docker-Image dieses Dienstes.

apigeeIngressGateway.image.url Erweitert Eingeführt in Version: 1.11.0

Standardwert: Keiner

Der Speicherort des Docker-Image für diesen Dienst.

Mit apigee-pull-push --list können Sie die aktuelle Repository-URL für diese Komponente aufrufen.

apigeeIngressGateway.nodeSelector.key Erweitert Eingeführt in Version: 1.11.0

Standardwert: Keiner

Erforderlich

Labelschlüssel für die Knotenauswahl, um dedizierte Kubernetes-Knoten für Ingress-Gateway-Dienste bereitzustellen.

Siehe Dedizierte Knotenpools konfigurieren.

apigeeIngressGateway.nodeSelector.value Erweitert Eingeführt in Version: 1.11.0

Standardwert: Keiner

Optionaler Labelwert für die Knotenauswahl, um dedizierte Kubernetes-Knoten für Ingress-Gateway-Dienste bereitzustellen und die nodeSelector.apigeeData-Einstellungen zu überschreiben.

Siehe nodeSelector.

apigeeIngressGateway.replicaCountMax Einfach Eingeführt in Version: 1.11.0

Standardwert: 4

Die maximale Anzahl von Pods, die Hybrid automatisch dem Ingress-Gateway hinzufügen kann und die für Autoscaling verfügbar sind.

apigeeIngressGateway.replicaCountMin Einfach Eingeführt in Version: 1.11.0

Standardwert: 2

Die Mindestanzahl der Pods für das Ingress-Gateway, die für Autoscaling verfügbar sind.

apigeeIngressGateway.targetCPUUtilizationPercentage Erweitert Eingeführt in Version: 1.10.5, 1.11.2, 1.12.1

Standardwert: 75

Der Schwellenwert der CPU-Auslastung zur Skalierung der Anzahl der Pods im ReplicaSet als Prozentsatz der insgesamt verfügbaren CPU-Ressourcen.

Wenn die CPU-Auslastung diesen Wert überschreitet, erhöht Hybrid die Anzahl der Pods im ReplicaSet bis zu apigeeIngressGateway.replicaCountMax.

Weitere Informationen zur Skalierung in Kubernetes finden Sie in der Kubernetes-Dokumentation unter Horizontales Pod-Autoscaling.

apigeeIngressGateway.tolerations.effect Erweitert Eingeführt in Version: 1.11.0

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

effect gibt die Auswirkung an, die eine Übereinstimmung einer Toleranz mit einer Markierung hat. effect kann folgende Werte haben:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

apigeeIngressGateway.tolerations.key Erweitert Eingeführt in Version: 1.11.0

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

key identifiziert Pods, auf die die Toleranz angewendet werden kann.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

apigeeIngressGateway.tolerations.operator Erweitert Eingeführt in Version: 1.11.0

Standardwert: "Equal"

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

operator gibt den Vorgang an, der zum Auslösen von effect verwendet wird. operator kann folgende Werte haben:

  • Equal: Entspricht dem in value festgelegten Wert.
  • Exists: Ignoriert den in value festgelegten Wert.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

apigeeIngressGateway.tolerations.tolerationSeconds Erweitert Eingeführt in Version: 1.11.0

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

tolerationSeconds definiert in Sekunden, wie lange ein Pod an einen fehlerhaften oder nicht reagierenden Knoten gebunden ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

apigeeIngressGateway.tolerations.value Erweitert Eingeführt in Version: 1.11.0

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

value ist der Wert, der effect auslöst, wenn operator auf Equal gesetzt ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

cassandra

Definiert den Hybrid-Dienst, der das Laufzeitdaten-Repository verwaltet. In diesem Repository werden Anwendungskonfigurationen, verteilte Kontingentzähler, API-Schlüssel und OAuth-Tokens für Anwendungen gespeichert, die auf dem Gateway ausgeführt werden.

Weitere Informationen finden Sie unter StorageClass-Konfiguration.

In der folgenden Tabelle werden die Attribute des Objekts cassandra beschrieben:

Attribut Typ Beschreibung
cassandra.annotations Erweitert Eingeführt in Version: 1.5.0

Standardwert: Keiner

Optionale Schlüssel/Wert-Zuordnung, die zum Annotieren von Pods verwendet wird. Weitere Informationen finden Sie unter Benutzerdefinierte Annotationen.

cassandra.auth.admin.password Einfach Eingeführt in Version: 1.0.0

Standardwert: iloveapis123

Erforderlich

Passwort für den Cassandra-Administrator. Der Administrator wird für alle Administratoraktivitäten verwendet, die im Cassandra-Cluster ausgeführt werden, wie Sicherung und Wiederherstellung.

cassandra.auth.ddl.password Einfach Eingeführt in Version: 1.0.0

Standardwert: iloveapis123

Erforderlich

Passwort für den Cassandra-DDL-Nutzer (Data Definition Language). Wird von MART für Datendefinitionsaufgaben wie das Erstellen, Aktualisieren und Löschen von Schlüsselbereichen verwendet.

cassandra.auth.default.password Einfach Eingeführt in Version: 1.0.0

Standardwert: iloveapis123

Erforderlich

Das Passwort für den Cassandra-Standardnutzer, der beim Aktivieren der Authentifizierung erstellt wird. Dieses Passwort muss zurückgesetzt werden, wenn Sie die Cassandra-Authentifizierung konfigurieren. Weitere Informationen finden Sie unter TLS für Cassandra konfigurieren.

cassandra.auth.dml.password Einfach Eingeführt in Version: 1.0.0

Standardwert: iloveapis123

Erforderlich

Passwort für den Cassandra-DML-Nutzer (Data Manipulation Language). Der DML-Nutzer wird von der Clientkommunikation verwendet, um Daten in Cassandra zu lesen und zu schreiben.

cassandra.auth.image.pullPolicy Erweitert Eingeführt in Version: 1.0.0

Standardwert: IfNotPresent

Legt fest, wann kubelet das Docker-Image des Pods abruft. Mögliche Werte:

  • IfNotPresent: Kein neues Image abrufen, wenn es bereits vorhanden ist.
  • Always: Image immer abrufen, unabhängig davon, ob es bereits vorhanden ist.

Weitere Informationen finden Sie unter Updating images.

cassandra.auth.image.tag Erweitert Eingeführt in Version: 1.0.0

Standardwert: 1.14.3

Das Versionslabel für das Docker-Image dieses Dienstes.

cassandra.auth.image.url Erweitert Eingeführt in Version: 1.0.0

Standardwert: Keiner

Der Speicherort des Docker-Image für diesen Dienst.

Mit apigee-pull-push --list können Sie die aktuelle Repository-URL für diese Komponente aufrufen.

cassandra.auth.jmx.password Einfach Eingeführt in Version: 1.4.0

Standardwert: iloveapis123

Erforderlich

Passwort für den Nutzer von Cassandra JMX-Vorgängen. Wird zur Authentifizierung und Kommunikation mit der Cassandra JMX-Schnittstelle verwendet.

cassandra.auth.jmx.username Einfach Eingeführt in Version: 1.4.0

Standardwert: jmxuser

Erforderlich

Nutzername für den Nutzer von Cassandra JMX-Vorgängen. Wird zur Authentifizierung und Kommunikation mit der Cassandra JMX-Schnittstelle verwendet.

cassandra.auth.jolokia.password Einfach Eingeführt in Version: 1.4.0

Standardwert: iloveapis123

Erforderlich

Passwort für den Nutzer von Cassandra Jolokia JMX-Vorgängen. Wird zur Authentifizierung und Kommunikation mit der Cassandra JMX API verwendet.

cassandra.auth.jolokia.username Einfach Eingeführt in Version: 1.4.0

Standardwert: apigee

Erforderlich

Nutzername für den Nutzer von Cassandra Jolokia JMX-Vorgängen. Wird zur Authentifizierung und Kommunikation mit der Cassandra JMX API verwendet.

cassandra.auth.secret Einfach Eingeführt in Version: 1.3.3

Standardwert: Keiner

Der Name der Datei, die in einem Kubernetes-Secret gespeichert ist und die Cassandra-Nutzer und ‑Passwörter enthält. Eine Anleitung zum Erstellen des Secrets finden Sie unter Secret erstellen.

Siehe auch:

cassandra.auth.secretProviderClass Erweitert Eingeführt in Version: 1.10.3

Standardwert: Keiner

Die Richtlinie zum Speichern von Cassandra-Secrets. Wenn diese festgelegt ist, muss sie mit der SecretProviderClass übereinstimmen, die auf den externen Secret-Anbieter verweist, zum Beispiel Hashicorp Vault. Wenn sie nicht festgelegt ist, verwendet Apigee Hybrid entweder die hier gespeicherten Nutzernamen und Passwörter:

oder das hier gespeicherte Kubernetes-Secret:

Eine Anleitung zum Erstellen der Richtlinie finden Sie unter Cassandra-Secrets in Hashicorp Vault speichern.

cassandra.backup.cloudProvider Erweitert Eingeführt in Version: 1.0.0

Standardwert: GCP

Der Name eines Sicherungsanbieters. Unterstützte Werte: GCP, HYBRID und CSI. Legen Sie den Wert auf Folgendes fest:

  • GCP zum Speichern von Sicherungsarchiven in Google Cloud Storage.
  • HYBRID zum Speichern von Sicherungsarchiven auf einem Remote-SSH-Server.
  • CSI (empfohlen) zum Verwenden von Kubernetes-CSI-Volume-Snapshots für die Sicherung. Informationen zum Sichern und Wiederherstellen in CSI für Cloud-Plattformen wie Google Cloud, AWS und Azure finden Sie unter CSI-Sicherung und ‑Wiederherstellung.
cassandra.backup.dbStorageBucket Erweitert Eingeführt in Version: 1.0.0

Standardwert: Keiner

Erforderlich, wenn die Sicherung aktiviert ist und cassandra.backup.cloudProvider auf GCP gesetzt ist.

Der Name eines vorhandenen Google Cloud Storage-Buckets, in dem Sicherungsarchive gespeichert werden. Informationen zum Erstellen eines Buckets finden Sie unter Buckets erstellen.

cassandra.backup.enabled Erweitert Eingeführt in Version: 1.0.0

Standardwert: false

Die Datensicherung ist nicht standardmäßig aktiviert. Setzen Sie den Wert auf true, um sie zu aktivieren.

Siehe Cassandra-Sicherungsübersicht.

cassandra.backup.gsa Erweitert Eingeführt in Version: 1.10.0

Standardwert: Keiner

Nur Helm: Die E‑Mail-Adresse des apigee-cassandra-Google IAM-Dienstkontos (GSA), das beim Aktivieren von Workload Identity in GKE-Clustern mit dem Kubernetes-Dienstkonto für Cassandra-Sicherungen verknüpft werden soll. Legen Sie dies fest, wenn Sie für gcp.workloadIdentity.enabled den Wert true und für cassandra.backup.enabled den Wert true festgelegt haben.

GSA-E‑Mail-Adressen haben normalerweise folgendes Format:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Beispiel:

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

Weitere Informationen finden Sie unter Identitätsföderation von Arbeitslasten in der GKE aktivieren.

cassandra.backup.image.pullPolicy Erweitert Eingeführt in Version: 1.0.0

Standardwert: IfNotPresent

Legt fest, wann kubelet das Docker-Image des Pods abruft. Mögliche Werte:

  • IfNotPresent: Kein neues Image abrufen, wenn es bereits vorhanden ist.
  • Always: Image immer abrufen, unabhängig davon, ob es bereits vorhanden ist.

Weitere Informationen finden Sie unter Updating images.

cassandra.backup.image.tag Erweitert Eingeführt in Version: 1.0.0

Standardwert: 1.14.3

Das Versionslabel für das Docker-Image dieses Dienstes.

cassandra.backup.image.url Erweitert Eingeführt in Version: 1.0.0

Standardwert: Keiner

Der Speicherort des Docker-Image für diesen Dienst.

Mit apigee-pull-push --list können Sie die aktuelle Repository-URL für diese Komponente aufrufen.

cassandra.backup.keyfile Erweitert Eingeführt in Version: 1.3.0

Standardwert: Keiner

Erforderlich, wenn die Sicherung aktiviert ist und cassandra.backup.cloudProvider auf HYBRID gesetzt ist.

Der Pfad in Ihrem lokalen Dateisystem zur privaten SSH-Schlüsseldatei.

cassandra.backup.schedule Erweitert Eingeführt in Version: 1.0.0

Standardwert: 0 2 * * *

Der Zeitplan für den Wiederherstellungs-Cronjob.

Siehe Cassandra-Sicherungsübersicht.

cassandra.backup.server Erweitert Eingeführt in Version: 1.3.0

Standardwert: Keiner

Erforderlich, wenn die Sicherung aktiviert ist und cassandra.backup.cloudProvider auf HYBRID gesetzt ist.

Die IP-Adresse Ihres Remote-SSH-Sicherungsservers.

cassandra.backup.serviceAccountPath Erweitert Eingeführt in Version: 1.0.0

Standardwert: Keiner

Pfad zu einer Google-Dienstkonto-Schlüsseldatei mit der Rolle Storage Object Admin (roles/storage.objectAdmin). Dieses Google-Dienstkonto wird zum Hochladen von Sicherungsarchiven in einen angegebenen cassandra.backup.dbStorageBucket verwendet.

Wenn die Sicherung aktiviert und cassandra.backup.cloudProvider auf GCP festgelegt ist, ist eine der folgenden Optionen erforderlich, damit Apigee Hybrid auf den Google Cloud Storage-Bucket zugreifen und Sicherungsarchive hochladen kann:

cassandra.backup.serviceAccountRef Erweitert Eingeführt in Version: 1.2.0

Standardwert: Keiner

Der Name eines vorhandenen Kubernetes-Secrets, in dem der Inhalt einer Google-Dienstkonto-Schlüsseldatei mit der Rolle Storage Object Admin (roles/storage.objectAdmin) gespeichert ist. Dieses Google-Dienstkonto wird zum Hochladen von Sicherungsarchiven in einen angegebenen cassandra.backup.dbStorageBucket verwendet.

Wenn die Sicherung aktiviert und cassandra.backup.cloudProvider auf GCP festgelegt ist, ist eine der folgenden Optionen erforderlich, damit Apigee Hybrid auf den Google Cloud Storage-Bucket zugreifen und Sicherungsarchive hochladen kann:

cassandra.backup.storageDirectory Erweitert Eingeführt in Version: 1.3.0

Standardwert: Keiner

Erforderlich, wenn die Sicherung aktiviert ist und cassandra.backup.cloudProvider auf HYBRID gesetzt ist.

Kann entweder ein absoluter oder relativer Pfad zum Basisverzeichnis des apigee-Nutzers sein.

Der Name des Sicherungsverzeichnisses auf dem SSH-Sicherungsserver.

cassandra.clusterName Einfach Eingeführt in Version: 1.0.0

Standardwert: apigeecluster

Gibt den Namen des Cassandra-Clusters an.

cassandra.datacenter Einfach Eingeführt in Version: 1.0.0

Standardwert: dc-1

Gibt das Rechenzentrum des Cassandra-Knotens an.

cassandra.dnsPolicy Einfach Eingeführt in Version: 1.1.1

Standardwert: Keiner

Wenn Sie hostNetwork auf „true“ setzen, wird die DNS-Richtlinie auf ClusterFirstWithHostNet gesetzt.

cassandra.externalSeedHost Einfach Eingeführt in Version: 1.0.0

Standardwert: Keiner

Hostname oder IP-Adresse eines Cassandra-Clusterknotens. Wenn nicht festgelegt, wird der lokale Kubernetes-Dienst verwendet.

cassandra.heapNewSize Einfach Eingeführt in Version: 1.0.0

Standardwert: 100M

Die Menge des neueren Objekten zugewiesenen JVM-Speichers in Megabyte.

cassandra.hostNetwork Einfach Eingeführt in Version: 1.1.1

Standardwert: false

Aktiviert die Kubernetes-Funktion hostNetwork. Apigee verwendet diese Funktion in multiregionalen Installationen für die Kommunikation zwischen Pods, wenn der Pod-Netzwerk-Namespace keine Verbindung zwischen Clustern hat (die Cluster werden im „Inselmodus“ ausgeführt). Dies ist der Standardfall bei Nicht-GKE-Installationen, einschließlich Google Distributed Cloud auf VMware oder Bare Metal, GKE on AWS, AKS, EKS und OpenShift.

Setzen Sie cassandra.hostNetwork auf false für Installationen in einer einzigen Region und für multiregionale Installationen mit Konnektivität zwischen Pods in verschiedenen Clustern, wie GKE-Installationen.

Setzen Sie cassandra.hostNetwork auf true für multiregionale Installationen, bei denen keine Kommunikation zwischen Pods in verschiedenen Clustern stattfindet, zum Beispiel Google Distributed Cloud auf VMware oder Bare Metal, GKE on AWS, AKS, EKS und OpenShift-Installationen. Weitere Informationen finden Sie unter Multiregionale Bereitstellung: Voraussetzungen.

Wenn Sie die Einstellung true gewählt haben, wird die DNS-Richtlinie automatisch auf ClusterFirstWithHostNet gesetzt.

cassandra.image.pullPolicy Erweitert Eingeführt in Version: 1.0.0

Standardwert: IfNotPresent

Legt fest, wann kubelet das Docker-Image des Pods abruft. Mögliche Werte:

  • IfNotPresent: Kein neues Image abrufen, wenn es bereits vorhanden ist.
  • Always: Image immer abrufen, unabhängig davon, ob es bereits vorhanden ist.

Weitere Informationen finden Sie unter Updating images.

cassandra.image.tag Erweitert Eingeführt in Version: 1.0.0

Standardwert: 1.14.3

Das Versionslabel für das Docker-Image dieses Dienstes.

cassandra.image.url Erweitert Eingeführt in Version: 1.0.0

Standardwert: Keiner

Der Speicherort des Docker-Image für diesen Dienst.

Mit apigee-pull-push --list können Sie die aktuelle Repository-URL für diese Komponente aufrufen.

cassandra.maxHeapSize Erweitert Eingeführt in Version: 1.0.0

Standardwert: 512M

Das obere Limit des JVM-Systemspeichers in Megabyte, der für Cassandra-Vorgänge verfügbar ist.

cassandra.multiRegionSeedHost Einfach Eingeführt in Version: 1.0.0

Standardwert: Keiner

Die IP-Adresse eines vorhandenen Cassandra-Clusters, mit dem der vorhandene Cluster auf eine neue Region erweitert wird. Siehe Seed-Host für mehrere Regionen konfigurieren.

cassandra.nodeSelector.key Erweitert Eingeführt in Version: 1.0.0

Standardwert: Keiner

Erforderlich

Labelschlüssel für die Knotenauswahl, um dedizierte Kubernetes-Knoten für cassandra-Datendienste bereitzustellen.

Siehe Dedizierte Knotenpools konfigurieren.

cassandra.nodeSelector.value Erweitert Eingeführt in Version: 1.0.0

Standardwert: Keiner

Optionaler Labelwert für die Knotenauswahl, um dedizierte Kubernetes-Knoten für cassandra-Datendienste bereitzustellen und die nodeSelector.apigeeData-Einstellungen zu überschreiben.

Siehe nodeSelector.

cassandra.port Erweitert Eingeführt in Version: 1.0.0

Standardwert: 9042

Portnummer zur Verbindung mit Cassandra.

cassandra.rack Einfach Eingeführt in Version: 1.0.0

Standardwert: ra-1

Gibt das Rack des Cassandra-Knotens an.

cassandra.readinessProbe.failureThreshold Erweitert Eingeführt in Version: 1.0.0

Standardwert: 2

Wie oft Kubernetes überprüft, ob die Bereitschaftsprüfungen fehlgeschlagen sind, bevor der Pod als nicht bereit markiert wird. Der Mindestwert beträgt 1.

cassandra.readinessProbe.initialDelaySeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 0

Die Anzahl der Sekunden nach dem Start eines Containers, bevor eine Bereitschaftsprüfung gestartet wird.

cassandra.readinessProbe.periodSeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 10

Bestimmt, wie oft eine Bereitschaftsprüfung durchgeführt werden soll. Angabe in Sekunden. Der Mindestwert beträgt 1.

cassandra.readinessProbe.successThreshold Erweitert Eingeführt in Version: 1.0.0

Standardwert: 1

Wie viele Male hintereinander eine Bereitschaftsprüfung bestanden werden muss, um nach einem Fehler als erfolgreich zu gelten. Der Mindestwert beträgt 1.

cassandra.readinessProbe.timeoutSeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 5

Der Zeitraum in Sekunden, nach dem eine Aktivitätsprüfung das Zeitlimit überschritten hat. Der Mindestwert beträgt 1.

cassandra.replicaCount Einfach Eingeführt in Version: 1.0.0

Standardwert: 1

Cassandra ist eine replizierte Datenbank. Dieses Attribut gibt die Anzahl der Cassandra-Knoten an, die als StatefulSet verwendet werden.

cassandra.resources.requests.cpu Erweitert Eingeführt in Version: 1.0.0

Standardwert: 500m

Die CPU in Millicore, die für den normalen Betrieb der Ressource in einem Kubernetes-Container erforderlich ist.

cassandra.resources.requests.memory Erweitert Eingeführt in Version: 1.0.0

Standardwert: 1Gi

Der Arbeitsspeicher in Mebibyte, der für den normalen Betrieb der Ressource in einem Kubernetes-Container erforderlich ist.

cassandra.restore.cloudProvider Erweitert Eingeführt in Version: 1.0.0

Standardwert: GCP

Der Name eines Wiederherstellungsanbieters. Unterstützte Werte: GCP, HYBRID und CSI. Legen Sie den Wert auf Folgendes fest:

  • GCP, um Daten aus einer Sicherung wiederherzustellen, die in Google Cloud Storage gespeichert ist.
  • HYBRID, um Daten aus einer Sicherung wiederherzustellen, die auf einem Remote-SSH-Server gespeichert ist.
  • CSI (empfohlen) zum Verwenden von Kubernetes-CSI-Volume-Snapshots für die Wiederherstellung. Informationen zum Sichern und Wiederherstellen in CSI für Cloud-Plattformen wie Google Cloud, AWS und Azure finden Sie unter CSI-Sicherung und ‑Wiederherstellung.
cassandra.restore.dbStorageBucket Erweitert Eingeführt in Version: 1.0.0

Standardwert: Keiner

Erforderlich, wenn die Wiederherstellung aktiviert ist und cassandra.restore.cloudProvider auf GCP festgelegt ist.

Der Name eines Google Cloud Storage-Buckets, in dem Sicherungsarchive für die Datenwiederherstellung gespeichert werden.

cassandra.restore.enabled Erweitert Eingeführt in Version: 1.0.0

Standardwert: false

Die Datenwiederherstellung ist nicht standardmäßig aktiviert. Setzen Sie den Wert auf true, um sie zu aktivieren.

Siehe Cassandra-Sicherungsübersicht.

cassandra.restore.gsa Erweitert Eingeführt in Version: 1.10.0

Standardwert: Keiner

Nur Helm: Die E‑Mail-Adresse des apigee-cassandra-Google IAM-Dienstkontos (GSA), das beim Aktivieren von Workload Identity in GKE-Clustern mit dem Kubernetes-Dienstkonto für Cassandra-Wiederherstellungen verknüpft werden soll. Legen Sie dies fest, wenn Sie für gcp.workloadIdentity.enabled den Wert true und für cassandra.restore.enabled den Wert true festgelegt haben.

GSA-E‑Mail-Adressen haben normalerweise folgendes Format:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Beispiel:

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

Weitere Informationen finden Sie unter Identitätsföderation von Arbeitslasten in der GKE aktivieren.

cassandra.restore.image.pullPolicy Erweitert Eingeführt in Version: 1.0.0

Standardwert: IfNotPresent

Legt fest, wann kubelet das Docker-Image des Pods abruft. Mögliche Werte:

  • IfNotPresent: Kein neues Image abrufen, wenn es bereits vorhanden ist.
  • Always: Image immer abrufen, unabhängig davon, ob es bereits vorhanden ist.

Weitere Informationen finden Sie unter Updating images.

cassandra.restore.image.tag Erweitert Eingeführt in Version: 1.0.0

Standardwert: 1.14.3

Das Versionslabel für das Docker-Image dieses Dienstes.

cassandra.restore.image.url Erweitert Eingeführt in Version: 1.0.0

Standardwert: Keiner

Der Speicherort des Docker-Image für diesen Dienst.

Mit apigee-pull-push --list können Sie die aktuelle Repository-URL für diese Komponente aufrufen.

cassandra.restore.serviceAccountPath Erweitert Eingeführt in Version: 1.0.0

Standardwert: Keiner

Pfad zu einer Google-Dienstkonto-Schlüsseldatei mit der Rolle Storage Object Admin (roles/storage.objectAdmin). Dieses Google-Dienstkonto wird zum Herunterladen von Sicherungsarchiven aus einem angegebenen cassandra.restore.dbStorageBucket verwendet.

Wenn die Wiederherstellung aktiviert und cassandra.restore.cloudProvider auf GCP festgelegt ist, ist eine der folgenden Optionen erforderlich, damit Apigee Hybrid auf den Google Cloud Storage-Bucket zugreifen kann, um Sicherungsarchive für die Wiederherstellung herunterzuladen:

cassandra.restore.serviceAccountRef Erweitert Eingeführt in Version: 1.2.0

Standardwert: Keiner

Der Name eines vorhandenen Kubernetes-Secrets, in dem der Inhalt einer Google-Dienstkonto-Schlüsseldatei mit der Rolle Storage Object Admin (roles/storage.objectAdmin) gespeichert ist. Dieses Google-Dienstkonto wird zum Herunterladen von Sicherungsarchiven aus einem angegebenen cassandra.restore.dbStorageBucket verwendet.

Wenn die Wiederherstellung aktiviert und cassandra.restore.cloudProvider auf GCP festgelegt ist, ist eine der folgenden Optionen erforderlich, damit Apigee Hybrid auf den Google Cloud Storage-Bucket zugreifen kann, um Sicherungsarchive für die Wiederherstellung herunterzuladen:

cassandra.restore.snapshotTimestamp Erweitert Eingeführt in Version: 1.0.0

Standardwert: Keiner

Erforderlich, wenn die Wiederherstellung aktiviert ist.

Zeitstempel der Sicherung, die wiederhergestellt werden soll.

cassandra.sslCertPath Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

Der Pfad in Ihrem System zur Datei mit einem TLS-Zertifikat.

cassandra.sslKeyPath Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

Der Pfad in Ihrem System zur privaten TLS-Schlüsseldatei.

cassandra.sslRootCAPath Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

Die Zertifikatskette zur Stamm-CA (Zertifizierungsstelle).

cassandra.storage.capacity Einfach Eingeführt in Version: 1.0.0

Standardwert: 10Gi

Erforderlich, wenn storage.storageclass angegeben ist.

Gibt die erforderliche Laufwerksgröße in Mebibyte (Mi) oder Gibibyte (Gi) an.

cassandra.storage.storageclass Einfach Eingeführt in Version: 1.0.0

Standardwert: Keiner

Gibt die Klasse des verwendeten lokalen Speichers an.

cassandra.storage.storageSize Einfach Eingeführt in Version: 1.0.0

Standardwert: 10Gi

Erforderlich, wenn storage.storageclass angegeben ist.

Gibt die erforderliche Laufwerksgröße in Mebibyte (Mi) oder Gibibyte (Gi) an.

cassandra.terminationGracePeriodSeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 300

Die maximale Zeit zwischen einer Anfrage zum Löschen eines Pods und dem Beenden des Pods in Sekunden. Während dieses Zeitraums werden etwaige Prestop-Hooks ausgeführt und alle laufenden Prozesse sollten ordnungsgemäß beendet werden. Der Pod wird beendet, wenn alle laufenden Prozesse abgeschlossen sind oder am Ende des Kulanzzeitraums, je nachdem, was zuerst eintritt. Wenn keine Prozesse ausgeführt werden, wird der Pod sofort beendet.

cassandra.tolerations.effect Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

effect gibt die Auswirkung an, die eine Übereinstimmung einer Toleranz mit einer Markierung hat. effect kann folgende Werte haben:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

cassandra.tolerations.key Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

key identifiziert Pods, auf die die Toleranz angewendet werden kann.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

cassandra.tolerations.operator Erweitert Eingeführt in Version: 1.10.1

Standardwert: "Equal"

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

operator gibt den Vorgang an, der zum Auslösen von effect verwendet wird. operator kann folgende Werte haben:

  • Equal: Entspricht dem in value festgelegten Wert.
  • Exists: Ignoriert den in value festgelegten Wert.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

cassandra.tolerations.tolerationSeconds Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

tolerationSeconds definiert in Sekunden, wie lange ein Pod an einen fehlerhaften oder nicht reagierenden Knoten gebunden ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

cassandra.tolerations.value Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

value ist der Wert, der effect auslöst, wenn operator auf Equal gesetzt ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

certManager

Apigee verwendet cert-manager für die Zertifikatsprüfung.

In der folgenden Tabelle werden die Attribute des Objekts certManager beschrieben:

Attribut Typ Beschreibung
certManager.namespace Erweitert Eingeführt in Version: 1.9.0

Standardwert: cert-manager

Der Namespace für cert-manager.

Weitere Informationen finden Sie unter cert-manager in einem benutzerdefinierten Namespace ausführen.

connectAgent

Apigee Connect ermöglicht es der Verwaltungsebene von Apigee Hybrid, eine sichere Verbindung zum MART-Dienst auf Laufzeitebene herzustellen, ohne dass Sie den MART-Endpunkt im Internet freigeben müssen.

In der folgenden Tabelle werden die Attribute des Objekts connectAgent beschrieben:

Attribut Typ Beschreibung
connectAgent.annotations Erweitert Eingeführt in Version: 1.5.0

Standardwert: Keiner

Optionale Schlüssel/Wert-Zuordnung, die zum Annotieren von Pods verwendet wird. Weitere Informationen finden Sie unter Benutzerdefinierte Annotationen.

connectAgent.gsa Erweitert Eingeführt in Version: 1.10.0

Standardwert: Keiner

Nur Helm: Die E‑Mail-Adresse des Google IAM-Dienstkontos (GSA) für connectAgent, das mit dem entsprechenden Kubernetes-Dienstkonto verknüpft werden soll, wenn Workload Identity auf GKE-Clustern mithilfe von Helm-Diagrammen aktiviert wird. Legen Sie dies fest, wenn Sie für gcp.workloadIdentity.enabled den Wert true festgelegt haben.

GSA-E‑Mail-Adressen haben normalerweise folgendes Format:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Beispiel:

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

Weitere Informationen finden Sie unter Workload Identity in GKE aktivieren oder Identitätsföderation von Arbeitslasten in AKS und EKS aktivieren.

connectAgent.logLevel Erweitert Eingeführt in Version: 1.2.0

Standardwert: INFO

Die Art der Logberichterstellung. Mögliche Werte sind:

  • INFO: Informationsmeldungen sowie Warnungen und Meldungen von Fehlern und schwerwiegenden Fehlern. Am hilfreichsten für die Fehlerbehebung.
  • WARNING: Nicht schwerwiegende Warnungen sowie Meldungen von Fehlern und schwerwiegenden Fehlern.
  • ERROR: Interne Fehler und Fehler, die dem Nutzer nicht zurückgegeben werden, sowie Meldungen schwerwiegender Fehler.
  • FATAL: Nicht behebbare Fehler und Ereignisse, die zum Absturz von Apigee Connect führen.
connectAgent.image.pullPolicy Erweitert Eingeführt in Version: 1.2.0

Standardwert: IfNotPresent

Legt fest, wann kubelet das Docker-Image des Pods abruft. Mögliche Werte:

  • IfNotPresent: Kein neues Image abrufen, wenn es bereits vorhanden ist.
  • Always: Image immer abrufen, unabhängig davon, ob es bereits vorhanden ist.

Weitere Informationen finden Sie unter Updating images.

connectAgent.image.tag Erweitert Eingeführt in Version: 1.2.0

Standardwert: 1.14.3

Das Versionslabel für das Docker-Image dieses Dienstes.

connectAgent.image.url Erweitert Eingeführt in Version: 1.2.0

Standardwert: Keiner

Der Speicherort des Docker-Image für diesen Dienst.

Mit apigee-pull-push --list können Sie die aktuelle Repository-URL für diese Komponente aufrufen.

connectAgent.replicaCountMax Einfach Eingeführt in Version: 1.2.0

Standardwert: 5

Maximale Anzahl der für das Autoscaling verfügbaren Replikate.

connectAgent.replicaCountMin Einfach Eingeführt in Version: 1.2.0

Standardwert: 1

Mindestanzahl der für das Autoscaling verfügbaren Replikate.

In der Produktion sollten Sie replicaCountMin auf 1 erhöhen, um eine größere Anzahl von Verbindungen zur Steuerungsebene zu ermöglichen und damit die Zuverlässigkeit und Skalierbarkeit zu verbessern.

connectAgent.resources.limits.cpu Erweitert Eingeführt in Version: 1.11.0

Standardwert: 512m

Das CPU-Limit für die Ressource in einem Kubernetes-Container in Millicore.

connectAgent.resources.limits.memory Erweitert Eingeführt in Version: 1.11.0

Standardwert: 512Mi

Das Arbeitsspeicherlimit für die Ressource in einem Kubernetes-Container in Mebibyte.

connectAgent.resources.requests.cpu Erweitert Eingeführt in Version: 1.11.0

Standardwert: 100m

Die CPU in Millicore, die für den normalen Betrieb der Ressource in einem Kubernetes-Container erforderlich ist.

connectAgent.resources.requests.memory Erweitert Eingeführt in Version: 1.2.0

Standardwert: 30Mi

Der Arbeitsspeicher in Mebibyte, der für den normalen Betrieb der Ressource in einem Kubernetes-Container erforderlich ist.

connectAgent.server Erweitert Eingeführt in Version: 1.2.0

Standardwert: apigeeconnect.googleapis.com:443

Der Standort des Servers und des Ports für diesen Dienst.

connectAgent.serviceAccountPath Einfach Eingeführt in Version: 1.1.1

Standardwert: Keiner

Entweder serviceAccountPath oder serviceAccountRef ist erforderlich.

Der Pfad zur Schlüsseldatei des Google-Dienstkontos für das Dienstkonto apigee-mart.

In den meisten Installationen muss der Wert von connectAgent.serviceAccountPath mit dem Wert von mart.serviceAccountPath übereinstimmen.

connectAgent.serviceAccountRef Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

Entweder serviceAccountPath oder serviceAccountRef ist erforderlich.

In den meisten Installationen muss der Wert von connectAgent.serviceAccountRef mit dem Wert von mart.serviceAccountRef übereinstimmen.

connectAgent.targetCPUUtilizationPercentage Erweitert Eingeführt in Version: 1.2.0

Standardwert: 75

CPU-Zielauslastung für den Apigee Connect-Agenten auf dem Pod. Der Wert dieses Feldes bietet Apigee Connect die Möglichkeit zum Autoscaling, wenn die CPU-Auslastung diesen Wert erreicht (bis zu replicaCountMax).

connectAgent.terminationGracePeriodSeconds Erweitert Eingeführt in Version: 1.2.0

Standardwert: 600

Die maximale Zeit zwischen einer Anfrage zum Löschen eines Pods und dem Beenden des Pods in Sekunden. Während dieses Zeitraums werden etwaige Prestop-Hooks ausgeführt und alle laufenden Prozesse sollten ordnungsgemäß beendet werden. Der Pod wird beendet, wenn alle laufenden Prozesse abgeschlossen sind oder am Ende des Kulanzzeitraums, je nachdem, was zuerst eintritt. Wenn keine Prozesse ausgeführt werden, wird der Pod sofort beendet.

connectAgent.tolerations.effect Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

effect gibt die Auswirkung an, die eine Übereinstimmung einer Toleranz mit einer Markierung hat. effect kann folgende Werte haben:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

connectAgent.tolerations.key Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

key identifiziert Pods, auf die die Toleranz angewendet werden kann.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

connectAgent.tolerations.operator Erweitert Eingeführt in Version: 1.10.1

Standardwert: "Equal"

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

operator gibt den Vorgang an, der zum Auslösen von effect verwendet wird. operator kann folgende Werte haben:

  • Equal: Entspricht dem in value festgelegten Wert.
  • Exists: Ignoriert den in value festgelegten Wert.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

connectAgent.tolerations.tolerationSeconds Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

tolerationSeconds definiert in Sekunden, wie lange ein Pod an einen fehlerhaften oder nicht reagierenden Knoten gebunden ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

connectAgent.tolerations.value Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

value ist der Wert, der effect auslöst, wenn operator auf Equal gesetzt ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

defaults

Die Standardverschlüsselungsschlüssel für die Apigee Hybrid-Installation.

In der folgenden Tabelle werden die Attribute des Objekts defaults beschrieben:

Attribut Typ Beschreibung
defaults.org.kmsEncryptionKey Einfach Eingeführt in Version: 1.0.0

Standardwert: aWxvdmVhcGlzMTIzNDU2Nw==

Der Standardverschlüsselungsschlüssel für die Organisation in KMS.

defaults.org.kvmEncryptionKey Einfach Eingeführt in Version: 1.0.0

Standardwert: aWxvdmVhcGlzMTIzNDU2Nw==

Der Standardverschlüsselungsschlüssel für die Organisation in KVM.

defaults.env.kmsEncryptionKey Einfach Eingeführt in Version: 1.0.0

Standardwert: aWxvdmVhcGlzMTIzNDU2Nw==

Der Standardverschlüsselungsschlüssel für die Umgebung in KMS.

defaults.env.kvmEncryptionKey Einfach Eingeführt in Version: 1.0.0

Standardwert: aWxvdmVhcGlzMTIzNDU2Nw==

Der Standardverschlüsselungsschlüssel für die Umgebung in KVM.

defaults.env.cacheEncryptionKey Einfach Eingeführt in Version: 1.0.0

Standardwert: aWxvdmVhcGlzMTIzNDU2Nw==

Der standardmäßige Cache-Verschlüsselungsschlüssel für die Umgebung.

diagnostic

Die Einstellungen für das Tool Diagnose-Collector.

Siehe Diagnose-Collector verwenden

In der folgenden Tabelle werden die Attribute des Objekts diagnostic beschrieben:

Attribut Typ Beschreibung
diagnostic.bucket Einfach Eingeführt in Version: 1.6.0

Standardwert: Keiner

Erforderlich

Der Name des Google Cloud Storage-Buckets, in dem die Diagnosedaten gespeichert werden.

Siehe Storage-Buckets erstellen.

diagnostic.container Einfach Eingeführt in Version: 1.6.0

Standardwert: Keiner

Erforderlich

Damit wird angegeben, aus welchem Pod-Typ Daten erfasst werden. Folgende Werte sind möglich:

  • "apigee-cassandra" erfasst Daten zur Cassandra-Datenbank. Die Istio-Cassandra-Pods werden im Apigee-Namespace ausgeführt.
  • "apigee-mart-server" erfasst Daten zu MART. Die Apigee-Mart-Server-Pods werden im Apigee-Namespace ausgeführt.
  • "apigee-runtime" erfasst Daten zum Message Processor. Die Apigee-Laufzeit-Pods werden im Apigee-Namespace ausgeführt.
  • "apigee-synchronizer" erfasst Daten zum Synchronizer. Die Apigee-Synchronizer-Pods werden im Apigee-Namespace ausgeführt.
  • "apigee-udca" erfasst Daten zu UDCA. Die Apigee-UDCA-Pods werden im Apigee-Namespace ausgeführt.
  • "apigee-watcher" erfasst Daten zum Watcher. Die Apigee-Watcher-Pods werden im Apigee-Namespace ausgeführt.
  • "istio-proxy" erfasst Daten zum Istio-Ingress-Gateway. Die Istio-Proxy-Pods werden im Namespace „istio-system“ ausgeführt.
diagnostic.loggingDetails.logDuration Einfach Eingeführt in Version: 1.6.0

Standardwert: Keiner

Erforderlich, wenn der Vorgang zur Diagnoseerfassung „LOGGING“ lautet (mit operation: "LOGGING" festgelegt).

Die Dauer der erfassten Logdaten in Millisekunden. Ein typischer Wert ist 30000.

Siehe diagnostic.operation

diagnostic.loggingDetails.loggerNames[] Einfach Eingeführt in Version: 1.6.0

Standardwert: Keiner

Erforderlich, wenn der Vorgang zur Diagnoseerfassung „LOGGING“ lautet (mit operation: "LOGGING" festgelegt).

Gibt die Namen der Logger an, von denen Daten erfasst werden sollen. In Apigee Hybrid-Version 1.6.0 ist der einzige unterstützte Wert ALL und umfasst damit alle Logger. Beispiel:

diagnostic:
 loggingDetails:
   loggerNames:
   - ALL
diagnostic.loggingDetails.logLevel Einfach Eingeführt in Version: 1.6.0

Standardwert: Keiner

Erforderlich, wenn der Vorgang zur Diagnoseerfassung „LOGGING“ lautet (mit operation: "LOGGING" festgelegt).

Gibt den Detaillierungsgrad der zu erfassenden Logging-Daten an. In Apigee Hybrid 1.6 wird nur FINE unterstützt.

diagnostic.namespace Einfach Eingeführt in Version: 1.6.0

Standardwert: Keiner

Erforderlich

Der Kubernetes-Namespace, in dem sich die Pods befinden, zu denen Sie Daten erfassen. Der Namespace muss der für den Container sein, den Sie mit diagnostic.container angeben:

apigee für

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

istio-system für

  • istio-proxy
diagnostic.operation Einfach Eingeführt in Version: 1.6.0

Standardwert: Keiner

Erforderlich

Gibt an, ob alle Statistiken oder nur Logs erfasst werden sollen.

Mögliche Werte:

diagnostic.podNames[] Einfach Eingeführt in Version: 1.6.0

Standardwert: Keiner

Erforderlich

Die Namen der Kubernetes-Pods, für die Sie Daten erfassen. Beispiel:

diagnostic:
 podNames:
 - apigee-runtime-eng-hybrid-example-3b2ebf3-150-8vfoj-2wcjn
 - apigee-runtime-eng-hybrid-example-3b2ebf3-150-8vfoj-6xzn2
diagnostic.serviceAccountPath Einfach Eingeführt in Version: 1.6.0

Standardwert: Keiner

Erforderlich

Der Pfad zu einer Dienstkontoschlüsseldatei (.json) für das Dienstkonto mit der Rolle „Storage Admin“ (roles/storage.admin). In den meisten Apigee Hybrid-Installationen ist dies das Dienstkonto apigee-cassandra.

Siehe Informationen zu Dienstkonten.

diagnostic.tcpDumpDetails.maxMsgs Einfach Eingeführt in Version: 1.6.0

Standardwert: Keiner

Entweder diagnostic.tcpDumpDetails.maxMsgs oder diagnostic.tcpDumpDetails.timeoutInSeconds ist erforderlich, wenn Sie diagnostic.tcpDumpDetails verwenden.

Legt die maximale Anzahl der zu erfassenden tcpDump-Nachrichten fest. Apigee empfiehlt einen Höchstwert von 1000.

diagnostic.tcpDumpDetails.timeoutInSeconds Einfach Eingeführt in Version: 1.6.0

Standardwert: Keiner

Entweder diagnostic.tcpDumpDetails.maxMsgs oder diagnostic.tcpDumpDetails.timeoutInSeconds ist erforderlich, wenn Sie diagnostic.tcpDumpDetails verwenden.

Legt fest, wie viele Sekunden gewartet werden soll, bis tcpDump Nachrichten zurückgibt.

diagnostic.threadDumpDetails.delayInSeconds Einfach Eingeführt in Version: 1.6.0

Standardwert: Keiner

Sowohl diagnostic.threadDumpDetails.delayInSeconds als auch diagnostic.threadDumpDetails.iterations ist erforderlich, wenn Sie diagnostic.threadDumpDetails verwenden.

Die Verzögerung zwischen der Erfassung der einzelnen Thread-Dumps in Sekunden.

diagnostic.threadDumpDetails.iterations Einfach Eingeführt in Version: 1.6.0

Standardwert: Keiner

Sowohl diagnostic.threadDumpDetails.delayInSeconds als auch diagnostic.threadDumpDetails.iterations ist erforderlich, wenn Sie diagnostic.threadDumpDetails verwenden.

Die Anzahl der zu erfassenden Jstack-Thread-Dump-Iterationen.

envs

Definiert ein Array von Umgebungen, in denen Sie Ihre API-Proxys bereitstellen können. Eine Umgebung bietet einen isolierten Kontext oder eine Sandbox zum Ausführen von API-Proxys.

Ihre Hybrid-fähige Organisation muss mindestens eine Umgebung haben.

Weitere Informationen finden Sie unter Informationen zu Umgebungen.

In der folgenden Tabelle werden die Attribute des Objekts envs beschrieben:

Attribut Typ Beschreibung
envs[].cacheEncryptionKey Einfach Eingeführt in Version: 1.0.0

Standardwert: Keiner

cacheEncryptionKey, cacheEncryptionPath oder cacheEncryptionSecret ist erforderlich.

Ein base64-codierter Verschlüsselungsschlüssel. Siehe Datenverschlüsselung.

envs[].cacheEncryptionPath Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

cacheEncryptionKey, cacheEncryptionPath oder cacheEncryptionSecret ist erforderlich.

Der Pfad zu einer Datei, die einen base64-codierten Verschlüsselungsschlüssel enthält. Siehe Datenverschlüsselung.

envs[].cacheEncryptionSecret.key Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

cacheEncryptionKey, cacheEncryptionPath oder cacheEncryptionSecret ist erforderlich.

Der Schlüssel eines Kubernetes-Secrets mit einem base64-codierten Verschlüsselungsschlüssel. Siehe Datenverschlüsselung.

envs[].cacheEncryptionSecret.name Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

cacheEncryptionKey, cacheEncryptionPath oder cacheEncryptionSecret ist erforderlich.

Der Name eines Kubernetes-Secrets mit einem base64-codierten Verschlüsselungsschlüssel. Siehe Datenverschlüsselung.

envs[].components.runtime.replicaCountMax Einfach Eingeführt in Version: 1.9.3

Standardwert: 4

Maximale Anzahl der Replikate für das Autoscaling. Überschreibt runtime.replicaCountMax, falls angegeben.

envs[].components.runtime.replicaCountMin Einfach Eingeführt in Version: 1.9.3

Standardwert: 1

Mindestanzahl der Replikate für das Autoscaling. Überschreibt runtime.replicaCountMin, falls angegeben.

envs[].components.synchronizer.replicaCountMax Einfach Eingeführt in Version: 1.9.3

Standardwert: 4

Maximale Anzahl der Replikate für das Autoscaling. Überschreibt synchronizer.replicaCountMax, falls angegeben.

envs[].components.synchronizer.replicaCountMin Einfach Eingeführt in Version: 1.9.3

Standardwert: 1

Mindestanzahl der Replikate für das Autoscaling. Überschreibt synchronizer.replicaCountMin, falls angegeben.

envs[].components.udca.replicaCountMax Einfach Eingeführt in Version: 1.9.3

Standardwert: 4

Maximale Anzahl der Replikate für das Autoscaling. Überschreibt udca.replicaCountMax, falls angegeben.

envs[].components.udca.replicaCountMin Einfach Eingeführt in Version: 1.9.3

Standardwert: 1

Mindestanzahl der Replikate für das Autoscaling. Überschreibt udca.replicaCountMin, falls angegeben.

envs.gsa.runtime Erweitert Eingeführt in Version: 1.10.0

Standardwert: Keiner

Nur Helm: Die E‑Mail-Adresse des Google IAM-Laufzeitdienstkontos, das dem entsprechenden Kubernetes-Dienstkonto zugeordnet werden soll, wenn Workload Identity mithilfe von Helm-Diagrammen in GKE-Clustern aktiviert wird.

Weitere Informationen finden Sie unter Workload Identity in GKE aktivieren oder Identitätsföderation von Arbeitslasten in AKS und EKS aktivieren.

envs.gsa.synchronizer Erweitert Eingeführt in Version: 1.10.0

Standardwert: Keiner

Nur Helm: Die E‑Mail-Adresse des Synchronizer-Google IAM-Dienstkontos, das dem entsprechenden Kubernetes-Dienstkonto zugeordnet werden soll, wenn Workload Identity auf GKE-Clustern mithilfe von Helm-Diagrammen aktiviert wird.

Weitere Informationen finden Sie unter Workload Identity in GKE aktivieren oder Identitätsföderation von Arbeitslasten in AKS und EKS aktivieren.

envs.gsa.udca Erweitert Eingeführt in Version: 1.10.0

Standardwert: Keiner

Nur Helm: Die E‑Mail-Adresse des UDCA-Google IAM-Dienstkontos für den umgebungsbezogenen UDCA, das mit dem entsprechenden Kubernetes-Dienstkonto verknüpft werden soll, wenn Workload Identity auf GKE-Clustern über Helm-Diagramme aktiviert wird.

Weitere Informationen finden Sie unter Workload Identity in GKE aktivieren oder Identitätsföderation von Arbeitslasten in AKS und EKS aktivieren.

envs[].hostAliases[] Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

Deprecated: Ab Hybrid-Version 1.4 erhält die Laufzeitebene diese Informationen von der Verwaltungsebene. Weitere Informationen finden Sie unter Umgebungen und Umgebungsgruppen.

envs[].httpProxy.host Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

Gibt den Hostnamen oder die IP-Adresse an, unter dem beziehungsweise der der HTTP-Proxy ausgeführt wird.

Listen Sie die httpProxy-Attribute in der Reihenfolge scheme, host und port auf. Beispiel:

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

Siehe auch Weiterleitungsproxy für API-Proxys konfigurieren.

envs[].httpProxy.port Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

Gibt den Port an, auf dem der HTTP-Proxy ausgeführt wird. Wenn Sie dieses Attribut weglassen, wird standardmäßig Port 80 für HTTP und Port 443 für HTTPS verwendet.

envs[].httpProxy.scheme Einfach Eingeführt in Version: 1.2.0

Standardwert: HTTPS

Gibt den Typ des HTTP-Proxys als HTTP oder HTTPS an. Standardmäßig wird HTTPS verwendet.

envs[].httpProxy.username Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

Wenn der HTTP-Proxy eine Basisauthentifizierung erfordert, verwenden Sie dieses Attribut, um einen Nutzernamen anzugeben.

envs[].httpProxy.password Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

Wenn der HTTP-Proxy eine Basisauthentifizierung erfordert, verwenden Sie dieses Attribut, um ein Passwort anzugeben.

envs[].name Einfach Eingeführt in Version: 1.0.0

Standardwert: Keiner

Erforderlich

Name der zu synchronisierenden Apigee-Umgebung.

envs[].pollInterval Erweitert Eingeführt in Version: 1.0.0

Standardwert: Keiner

Intervall für die Abfrage von Änderungen an der Organisations- und Umgebungssynchronisierung in Sekunden.

envs[].port Erweitert Eingeführt in Version: 1.0.0

Standardwert: Keiner

TCP-Portnummer für HTTPS-Traffic.

envs[].serviceAccountPaths.runtime Einfach Eingeführt in Version: 1.4.0

Standardwert: Keiner

Dateipfad auf dem lokalen System zu einem Google-Dienstkontoschlüssel mit der Rolle Cloud Trace Agent (normalerweise das Dienstkonto apigee-runtime). Die Standardnamen der Dienstkonten und ihre zugewiesenen Rollen finden Sie unter Informationen zu Dienstkonten.

envs[].serviceAccountPaths.synchronizer Einfach Eingeführt in Version: 1.0

Standardwert: Keiner

Dateipfad auf dem lokalen System zu einem Google-Dienstkontoschlüssel mit der Rolle Apigee Synchronizer Manager.

envs[].serviceAccountPaths.udca Einfach Eingeführt in Version: 1.0

Standardwert: Keiner

Dateipfad auf dem lokalen System zu einem Google-Dienstkontoschlüssel mit der Rolle Apigee Analytic Agent.

Legen Sie dieses Attribut nur fest, wenn orgScopedUDCA auf false gesetzt ist.

envs[].serviceAccountSecretProviderClass Erweitert Eingeführt in Version: 1.12.0

Standardwert: Keiner

Der Name der umgebungsspezifischen Secret-Anbieterklasse (SecretProviderClass), die zum Speichern von Dienstkontoschlüsseln in Vault verwendet wird.

Siehe Dienstkontoschlüssel in Hashicorp Vault speichern.

envs[].serviceAccountSecretRefs.runtime Einfach Eingeführt in Version: 1.4.0

Standardwert: Keiner

Der Name eines Kubernetes-Secrets. Sie müssen das Secret erstellen. Verwenden Sie dazu einen Google-Dienstkontoschlüssel mit der Rolle Cloud Trace Agent als Eingabe.

envs[].serviceAccountSecretRefs.synchronizer Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

Der Name eines Kubernetes-Secrets. Sie müssen das Secret erstellen. Verwenden Sie dazu einen Google-Dienstkontoschlüssel mit der Rolle Apigee Synchronizer Manager als Eingabe.

envs[].serviceAccountSecretRefs.udca Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

Der Name eines Kubernetes-Secrets. Sie müssen das Secret erstellen. Verwenden Sie dazu einen Google-Dienstkontoschlüssel mit der Rolle Apigee Analytic Agent als Eingabe.

Legen Sie dieses Attribut nur fest, wenn orgScopedUDCA auf false gesetzt ist.

envs[].sslCertPath Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

sslCertPath/sslKeyPath oder sslSecret ist erforderlich.

Der Pfad in Ihrem System zu einer TLS-Zertifikatsdatei.

envs[].sslKeyPath Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

sslCertPath/sslKeyPath oder sslSecret ist erforderlich.

Der Pfad in Ihrem System zur privaten TLS-Schlüsseldatei.

envs[].sslSecret Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

sslCertPath/sslKeyPath oder sslSecret ist erforderlich.

Der Name der Datei, die in einem Kubernetes-Secret gespeichert ist und die Cassandra-Nutzer und ‑Passwörter enthält. Eine Anleitung zum Erstellen des Secrets finden Sie unter Secret erstellen.

Siehe auch:

gcp

Gibt die Google Cloud-Projekt-ID (erforderlich für alle Hybrid-Installationen), die Workload Identity-Konfiguration, die föderierte Workload Identity-Konfiguration sowie die Region an, in die apigee-logger und apigee-metrics ihre Daten per Push übertragen.

In der folgenden Tabelle werden die Attribute des Objekts gcp beschrieben:

Attribut Typ Beschreibung
gcp.federatedWorkloadIdentity.audience Einfach Eingeführt in Version: 1.12.0

Standardwert: Keiner

Die zulässige Zielgruppe des Workload Identity Providers auf Nicht-GKE-Plattformen.

Weitere Informationen finden Sie unter Identitätsföderation von Arbeitslasten in AKS und EKS aktivieren.

gcp.federatedWorkloadIdentity.credentialSourceFile Einfach Eingeführt in Version: 1.12.0

Standardwert: Keiner

Der Dateiname und der Pfad zur Anmeldedaten-Quelldatei, die von der Identitätsföderation von Arbeitslasten verwendet wird, um die Anmeldedaten für die Dienstkonten abzurufen. Das ist der Wert, den Sie für credential-source-file angeben, wenn Sie die Identitätsföderation von Arbeitslasten mit dem Befehl create-cred-config konfigurieren.

Weitere Informationen finden Sie unter Identitätsföderation von Arbeitslasten in AKS und EKS aktivieren.

gcp.federatedWorkloadIdentity.enabled Einfach Eingeführt in Version: 1.12.0

Standardwert: false

Aktiviert die Identitätsföderation von Arbeitslasten auf Nicht-GKE-Plattformen. Darf nicht auf true festgelegt werden, wenn gcp.workloadIdentity.enabled im selben Cluster auf true festgelegt ist.

Weitere Informationen finden Sie unter Identitätsföderation von Arbeitslasten in AKS und EKS aktivieren.

gcp.federatedWorkloadIdentity.tokenExpiration Einfach Eingeführt in Version: 1.12.0

Standardwert: 3600

Die Lebensdauer des Tokens in Sekunden.

Weitere Informationen finden Sie unter Identitätsföderation von Arbeitslasten in AKS und EKS aktivieren.

gcp.projectID Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

Erforderlich

Gibt das Google Cloud-Projekt an, in das apigee-logger und apigee-metrics Daten übertragen.

gcp.projectIDRuntime Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

Identifiziert das Projekt des Kubernetes-Laufzeitclusters.

Das Attribut projectIDRuntime ist optional. Wenn es nicht verwendet wird, wird davon ausgegangen, dass der Wert projectID sowohl für das Google Cloud-Projekt der Apigee-Organisation als auch für das Projekt des K8S-Laufzeitclusters verwendet wird.

gcp.region Einfach Eingeführt in Version: 1.2.0

Standardwert: us-central1

Erforderlich

Gibt die Google Cloud-Region an, in die apigee-logger und apigee-metrics ihre Daten per Push übertragen.

gcp.workloadIdentity.enabled Einfach Eingeführt in Version: 1.10.0

Standardwert: false

Nur Helm: Ermöglicht die Verwendung von Workload Identity in der GKE. Über Workload Identity können Arbeitslasten in Ihren GKE-Clustern die Identität von IAM-Dienstkonten (Identity and Access Management) für den Zugriff auf Google Cloud-Dienste annehmen.

Darf nicht auf true festgelegt werden, wenn gcp.federatedWorkloadIdentity.enabled im selben Cluster auf true festgelegt ist.

Wenn enabled den Standardwert false hat, verwendet Apigee für jede Apigee Hybrid-Komponente die IAM-Dienstkonten. Siehe Informationen zu Dienstkonten.

Wenn workloadIdentityEnabled den Wert true hat, verwendet Apigee Kubernetes-Dienstkonten und ordnet sie für jede Komponente den entsprechenden IAM-Dienstkonten zu. Geben Sie die IAM-Dienstkonten, die den Kubernetes-Dienstkonten zugeordnet werden sollen, an mit:

gcp.workloadIdentity.gsa Erweitert Eingeführt in Version: 1.10.0

Standardwert: Keiner

Nur Helm: Die E‑Mail-Adresse des Google IAM-Dienstkontos (GSA) für alle Komponenten, das mit dem entsprechenden Kubernetes-Dienstkonto verknüpft werden soll, wenn Sie Workload Identity auf GKE-Clustern mithilfe von Helm-Diagrammen aktivieren. Legen Sie dies fest, wenn Sie für gcp.workloadIdentity.enabled den Wert true festgelegt haben.

gcp.workloadIdentity.gsa gilt für alle Hybrid-Komponenten. Wenn Sie einen Wert für gcp.workloadIdentity.gsa festlegen, müssen Sie kein GSA für einzelne Hybrid-Komponenten angeben. Wenn Sie ein GSA für eine einzelne Komponente angeben, überschreibt dieses gcp.workloadIdentity.gsa nur für diese Komponente.

GSA-E‑Mail-Adressen haben normalerweise folgendes Format:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Beispiel:

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

Siehe Enabling Workload Identity on GKE.

gcp.workloadIdentityEnabled Einfach Eingeführt in Version: 1.4.0

Standardwert: false

Nur apigeectl: Ermöglicht die Verwendung von Workload Identity. Über Workload Identity können Arbeitslasten in Ihren GKE-Clustern die Identität von IAM-Dienstkonten (Identity and Access Management) für den Zugriff auf Google Cloud-Dienste annehmen.

Wenn workloadIdentityEnabled den Standardwert false hat, verwendet Apigee für jede Apigee Hybrid-Komponente die IAM-Dienstkonten. Siehe Informationen zu Dienstkonten.

Wenn workloadIdentityEnabled den Wert true hat, verwendet Apigee Kubernetes-Dienstkonten anstelle von IAM-Dienstkonten und ignoriert die folgenden Konfigurationsattribute:

httpProxy

httpProxy stellt Konfigurationsparameter für einen HTTP-Weiterleitungsproxyserver bereit. Bei der Konfiguration in overrides.yaml wird die gesamte Internetkommunikation für die Apigee Connect-, Logger-, MART-, Messwert-, Synchronizer- und UDCA-Komponenten über den Proxyserver geleitet.

Siehe auch: connectAgent, logger, mart, metrics, synchronizer und udca.

In der folgenden Tabelle werden die Attribute des Objekts httpProxy beschrieben:

Attribut Typ Beschreibung
httpProxy.host Einfach Eingeführt in Version: 1.1.1

Standardwert: Keiner

Der Hostname des HTTP-Proxys.

httpProxy.port Einfach Eingeführt in Version: 1.1.1

Standardwert: Keiner

Der Port des HTTP-Proxys.

httpProxy.scheme Einfach Eingeführt in Version: 1.1.1

Standardwert: HTTPS

Das vom Proxy verwendete Schema. Werte können HTTP oder HTTPS sein. Es dürfen nur Großbuchstaben verwendet werden.

httpProxy.username Einfach Eingeführt in Version: 1.1.1

Standardwert: Keiner

Wenn der HTTP-Proxy eine Basisauthentifizierung erfordert, verwenden Sie dieses Attribut, um einen Nutzernamen anzugeben.

httpProxy.password Einfach Eingeführt in Version: 1.1.1

Standardwert: Keiner

Wenn der HTTP-Proxy eine Basisauthentifizierung erfordert, verwenden Sie dieses Attribut, um ein Passwort anzugeben.

ingressGateways

Konfiguriert jede einzelne Instanz des Apigee Ingress-Gateways. Verwenden Sie diese Attribute, wenn Sie individuelle Instanzen separat nach ingressGateways[].name verwalten möchten.

Informationen zum Anwenden einer gemeinsamen Konfiguration auf alle Instanzen des Apigee Ingress-Gateways finden Sie unter apigeeIngressGateway.

Änderungen an ingressGateways-Attributen wenden Sie mit dem Diagramm apigee-org an.

In der folgenden Tabelle werden die Attribute des Objekts ingressGateways beschrieben:

Attribut Typ Beschreibung
ingressGateways[].name Einfach Eingeführt in Version: 1.8.0

Standardwert: Keiner

Erforderlich

Der Name des Ingress-Gateways. Andere Dienste verwenden diesen Namen, um den Traffic an das Gateway zu adressieren. Der Name muss die folgenden Anforderungen erfüllen:

  • Darf maximal 17 Zeichen lang sein
  • Darf nur kleingeschriebene alphanumerische Zeichen, „-“ oder „.“ enthalten
  • Muss mit einem alphanumerischen Zeichen beginnen
  • Muss mit einem alphanumerischen Zeichen enden

Weitere Informationen finden Sie in der Kubernetes-Dokumentation unter DNS Subdomain Names.

ingressGateways[].resources.limits.cpu Erweitert Eingeführt in Version: 1.8.0

Standardwert: 2000m

Das CPU-Limit für die Ressource in Millicore.

ingressGateways[].resources.limits.memory Erweitert Eingeführt in Version: 1.8.0

Standardwert: 1Gi

Das Arbeitsspeicherlimit für die Ressource in Mebibyte.

ingressGateways[].resources.requests.cpu Erweitert Eingeführt in Version: 1.8.0

Standardwert: 300m

Die für den normalen Betrieb der Ressource benötigte CPU in Millicore.

ingressGateways[].resources.requests.memory Erweitert Eingeführt in Version: 1.8.0

Standardwert: 128Mi

Der für den normalen Betrieb der Ressource erforderliche Arbeitsspeicher in Mebibyte.

ingressGateways[].replicaCountMax Einfach Eingeführt in Version: 1.8.0

Standardwert: 10

Die maximale Anzahl von Pods, die Hybrid automatisch dem Ingress-Gateway hinzufügen kann und die für Autoscaling verfügbar sind.

ingressGateways[].replicaCountMin Einfach Eingeführt in Version: 1.8.0

Standardwert: 2

Die Mindestanzahl der Pods für das Ingress-Gateway, die für Autoscaling verfügbar sind.

ingressGateways[].svcAnnotations Einfach Eingeführt in Version: 1.8.0

Standardwert: Keiner

Optionale Schlüssel/Wert-Zuordnung zum Annotieren des Ingress-Gateways auf Plattformen, die Annotationen unterstützen. Beispiel:

ingressGateways:
  svcAnnotations:
    networking.gke.io/load-balancer-type: "Internal"
ingressGateways[].svcLoadBalancerIP Einfach Eingeführt in Version: 1.8.0

Standardwert: Keiner

Auf Plattformen, die die Angabe der IP-Adresse des Load Balancers unterstützen, wird der Load Balancer mit dieser IP-Adresse erstellt. Auf Plattformen, auf denen Sie die IP-Adresse des Load Balancers nicht angeben können, wird dieses Attribut ignoriert.

ingressGateways[].svcType Einfach Eingeführt in Version: 1.8.1

Standardwert: LoadBalancer

Wird verwendet, um den Typ des standardmäßigen K8s-Dienstes für die Ingress-Bereitstellung zu ändern. Legen Sie den Wert auf ClusterIP fest, wenn Sie die Erstellung des Standard-Load-Balancers deaktivieren möchten. Mögliche Werte:

  • ClusterIP
  • LoadBalancer
ingressGateways[].targetCPUUtilizationPercentage Erweitert Eingeführt in Version: 1.10.5, 1.11.2, 1.12.1

Standardwert: 75

Der Schwellenwert der CPU-Auslastung zur Skalierung der Anzahl der Pods im ReplicaSet als Prozentsatz der insgesamt verfügbaren CPU-Ressourcen.

Wenn die CPU-Auslastung diesen Wert überschreitet, erhöht Hybrid die Anzahl der Pods im ReplicaSet bis zu ingressGateways[].replicaCountMax.

Weitere Informationen zur Skalierung in Kubernetes finden Sie in der Kubernetes-Dokumentation unter Horizontales Pod-Autoscaling.

ingressGateways[].tolerations.effect Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

effect gibt die Auswirkung an, die eine Übereinstimmung einer Toleranz mit einer Markierung hat. effect kann folgende Werte haben:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

ingressGateways[].tolerations.key Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

key identifiziert Pods, auf die die Toleranz angewendet werden kann.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

ingressGateways[].tolerations.operator Erweitert Eingeführt in Version: 1.10.1

Standardwert: "Equal"

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

operator gibt den Vorgang an, der zum Auslösen von effect verwendet wird. operator kann folgende Werte haben:

  • Equal: Entspricht dem in value festgelegten Wert.
  • Exists: Ignoriert den in value festgelegten Wert.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

ingressGateways[].tolerations.tolerationSeconds Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

tolerationSeconds definiert in Sekunden, wie lange ein Pod an einen fehlerhaften oder nicht reagierenden Knoten gebunden ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

ingressGateways[].tolerations.value Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

value ist der Wert, der effect auslöst, wenn operator auf Equal gesetzt ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

istiod

Konfiguriert den eingehenden Apigee-Traffic.

In der folgenden Tabelle werden die Attribute des Objekts istiod beschrieben:

Attribut Typ Beschreibung
istiod.accessLogFile Erweitert Eingeführt in Version: 1.8.0

Standardwert: /dev/stdout

Die Dateiadresse für das Ingress-Zugriffslog, zum Beispiel /dev/stdout.

Wenn Sie diesen Wert nicht definieren, wird das Zugriffs-Logging deaktiviert.

istiod.accessLogFormat Erweitert Eingeführt in Version: 1.8.0

Das Format für das Ingress-Zugriffslog.

Wenn Sie diesen Wert nicht definieren, wird das standardmäßige Zugriffslogformat des Proxys verwendet.

Standardformat für Zugriffslogs:

'{"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)%"}'

Im Folgenden finden Sie eine Kopie des Standardformats für Zugriffslogs mit zur besseren Lesbarkeit eingefügten Zeilenumbrüchen.

'{"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 Erweitert Eingeführt in Version: 1.9.2

Standardwert: SANITIZE_SET

Bestimmt, wie der Envoy-Proxy (für das Apigee Ingress-Gateway) den HTTP-Header x-forwarded-client-cert (XFCC) verarbeitet.

Folgende Werte sind möglich:

  • SANITIZE_SET (Standard): Wenn die Clientverbindung mTLS ist, wird der XFCC-Header mit den Informationen zum Clientzertifikat zurückgesetzt und an den next Hop gesendet.
  • FORWARD_ONLY: Wenn die Clientverbindung mTLS (gegenseitiges TLS) ist, wird der XFCC-Header nur in der Anfrage weitergeleitet.
  • APPEND_FORWARD: Wenn die Clientverbindung mTLS ist, werden die Informationen des Clientzertifikats an den XFCC-Header der Anfrage angehängt und dieser wird weitergeleitet.
  • SANITIZE: Der XFCC-Header wird nicht weitergeleitet.
  • ALWAYS_FORWARD_ONLY: Der XFCC-Header in der Anfrage wird immer weitergeleitet, unabhängig davon, ob die Clientverbindung mTLS ist.

Weitere Informationen zu diesen Werten finden Sie in der Envoy-Dokumentation unter Enum extensions.filters.network.http_connection_manager.v3.HttpConnectionManager.ForwardClientCertDetails.

Wenn Sie diese Einstellung nach der Installation von Hybrid ändern, wenden Sie sie mit apigeectl init an und starten Sie dann die Apigee Ingress-Gateway-Pods neu.

istiod.healthCheckUserAgents Erweitert Eingeführt in Version: 1.12.0

Standardwerte:

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

Ermöglicht es, dass Nicht-Google Cloud -Load-Balancer die Systemdiagnose-Endpunkte des Ingress-Gateways (/healthz/ingress und /healthz) prüfen, indem die standardmäßige User-Agent-Zulassungsliste in Hybrid überschrieben wird.

Wenn Sie die angegebenen Standard-User-Agenten überschreiben möchten, verwenden Sie die folgende Syntax und fügen Sie die benutzerdefinierten User-Agenten ein:

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

Verwenden Sie Folgendes, um die Anforderung eines User-Agenten zu entfernen:

istiod:
  healthCheckUserAgents: []

istiod.image.pullPolicy Erweitert Eingeführt in Version: 1.8.0

Standardwert: IfNotPresent

Legt fest, wann kubelet das Docker-Image des Pods abruft. Mögliche Werte:

  • IfNotPresent: Kein neues Image abrufen, wenn es bereits vorhanden ist.
  • Always: Image immer abrufen, unabhängig davon, ob es bereits vorhanden ist.

Weitere Informationen finden Sie unter Updating images.

istiod.image.tag Erweitert Eingeführt in Version: 1.8.0

Standardwert: 1.14.3

Das Versionslabel für das Docker-Image dieses Dienstes.

istiod.image.url Erweitert Eingeführt in Version: 1.8.0

Standardwert: Keiner

Der Speicherort des Docker-Image für diesen Dienst.

Mit apigee-pull-push --list können Sie die aktuelle Repository-URL für diese Komponente aufrufen.

istiod.tolerations.effect Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

effect gibt die Auswirkung an, die eine Übereinstimmung einer Toleranz mit einer Markierung hat. effect kann folgende Werte haben:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

istiod.tolerations.key Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

key identifiziert Pods, auf die die Toleranz angewendet werden kann.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

istiod.tolerations.operator Erweitert Eingeführt in Version: 1.10.1

Standardwert: "Equal"

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

operator gibt den Vorgang an, der zum Auslösen von effect verwendet wird. operator kann folgende Werte haben:

  • Equal: Entspricht dem in value festgelegten Wert.
  • Exists: Ignoriert den in value festgelegten Wert.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

istiod.tolerations.tolerationSeconds Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

tolerationSeconds definiert in Sekunden, wie lange ein Pod an einen fehlerhaften oder nicht reagierenden Knoten gebunden ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

istiod.tolerations.value Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

value ist der Wert, der effect auslöst, wenn operator auf Equal gesetzt ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

k8sCluster

Gibt den Kubernetes-Cluster an, in dem die Hybrid-Laufzeit installiert ist.

In der folgenden Tabelle werden die Attribute des Objekts k8sCluster beschrieben:

Attribut Typ Beschreibung
k8sCluster.name Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

Der Name des Kubernetes-Clusters, in dem die Hybrid-Laufzeit installiert ist.

k8sCluster.region Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

Gibt die Google Cloud-Region an, in der Ihr Kubernetes-Cluster erstellt wurde.

kubeRBACProxy

Gibt an, wo Apigee nach rollenbasierten Kubernetes-Zugriffssteuerungen suchen soll.

In der folgenden Tabelle werden die Attribute des Objekts kubeRBACProxy beschrieben:

Attribut Typ Beschreibung
kubeRBACProxy.image.pullPolicy Erweitert Eingeführt in Version: 1.2.0

Standardwert: IfNotPresent

Legt fest, wann kubelet das Docker-Image des Pods abruft. Mögliche Werte:

  • IfNotPresent: Kein neues Image abrufen, wenn es bereits vorhanden ist.
  • Always: Image immer abrufen, unabhängig davon, ob es bereits vorhanden ist.

Weitere Informationen finden Sie unter Updating images.

kubeRBACProxy.image.tag Erweitert Eingeführt in Version: 1.2.0

Standardwert: 1.14.3

Das Versionslabel für das Docker-Image dieses Dienstes.

kubeRBACProxy.image.url Erweitert Eingeführt in Version: 1.2.0

Standardwert: Keiner

Der Speicherort des Docker-Image für diesen Dienst.

Mit apigee-pull-push --list können Sie die aktuelle Repository-URL für diese Komponente aufrufen.

kubeRBACProxy.resources.limits.cpu Erweitert Eingeführt in Version: 1.11.0

Standardwert: 500m

Das CPU-Limit für die Ressource in einem Kubernetes-Container in Millicore.

kubeRBACProxy.resources.limits.memory Erweitert Eingeführt in Version: 1.11.0

Standardwert: 128Mi

Das Arbeitsspeicherlimit für die Ressource in einem Kubernetes-Container in Mebibyte.

kubeRBACProxy.resources.requests.cpu Erweitert Eingeführt in Version: 1.11.0

Standardwert: 5m

Die CPU in Millicore, die für den normalen Betrieb der Ressource in einem Kubernetes-Container erforderlich ist.

kubeRBACProxy.resources.requests.memory Erweitert Eingeführt in Version: 1.11.0

Standardwert: 64Mi

Der Arbeitsspeicher in Mebibyte, der für den normalen Betrieb der Ressource in einem Kubernetes-Container erforderlich ist.

logger

Definiert den Dienst, der Betriebslogs verwaltet. Alle in Ihrem Kubernetes-Cluster ausgeführten Apigee Hybrid-Dienste geben diese Information aus.

Weitere Informationen finden Sie unter Logging-Übersicht.

In der folgenden Tabelle werden die Attribute des Objekts logger beschrieben:

Attribut Typ Beschreibung
logger.annotations Erweitert Eingeführt in Version: 1.5.0

Standardwert: Keiner

Optionale Schlüssel/Wert-Zuordnung, die zum Annotieren von Pods verwendet wird. Weitere Informationen finden Sie unter Benutzerdefinierte Annotationen.

logger.bufferChunkSize Erweitert Eingeführt in Version: 1.12.0

Standardwert: 256.000

Die anfängliche Puffergröße zum Lesen von Logdateien.

logger.bufferMaxSize Erweitert Eingeführt in Version: 1.12.0

Standardwert: 104.857.600

Das Limit für die Puffergröße pro überwachter Datei. Dateien, die dieses Limit überschreiten, werden aus der Liste der überwachten Dateien entfernt.

logger.bufferMemoryLimit Erweitert Eingeführt in Version: 1.12.0

Standardwert: 150 MB

Das Limit für den Arbeitsspeicher, den der Logger verbrauchen darf. Wenn der Grenzwert erreicht ist, wird das Lesen weiterer Daten durch den Logger kurz unterbrochen, bis die vorhandenen Daten im Arbeitsspeicher geleert wurden.

logger.enabled Einfach Eingeführt in Version: 1.0.0

Standardwert: false

Aktiviert oder deaktiviert das Logging auf dem Cluster. Für Nicht-GKE auf true festgelegt, für GKE in Google Cloud oder Google Distributed Cloud auf false festgelegt.

logger.envVars Einfach Eingeführt in Version: 1.8.5

Standardwert: Keiner

Ermöglicht die Aufnahme der Fluent Bit-Umgebungsvariable NO_PROXY, die URLs angibt, für die der Traffic nicht über den HTTP-Proxy weitergeleitet wird. Die Variable NO_PROXY muss als kommagetrennter String von Hostnamen im folgenden Format definiert werden:

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

Beispiel:

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

Verwenden Sie optional envVars: NO_PROXY, wenn Sie den HTTP-Weiterleitungsproxy aktiviert haben.

Weitere Informationen finden Sie unter NO_PROXY in der Fluent Bit-Dokumentation.

logger.flushInterval Erweitert Eingeführt in Version: 1.12.0

Standardwert: 1

Das Intervall in Sekunden, bevor der nächste Zwischenspeicher gelöscht wird.

logger.gsa Erweitert Eingeführt in Version: 1.10.0

Standardwert: Keiner

Nur Helm: Die E‑Mail-Adresse des Google IAM-Dienstkontos (GSA) für apigee-logger, das beim Aktivieren von Workload Identity in GKE-Clustern mithilfe von Helm-Diagrammen mit dem entsprechenden Kubernetes-Dienstkonto verknüpft werden soll. Legen Sie dies fest, wenn Sie für gcp.workloadIdentity.enabled den Wert true festgelegt haben.

GSA-E‑Mail-Adressen haben normalerweise folgendes Format:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Beispiel:

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

Weitere Informationen finden Sie unter Workload Identity in GKE aktivieren oder Identitätsföderation von Arbeitslasten in AKS und EKS aktivieren.

logger.image.pullPolicy Erweitert Eingeführt in Version: 1.0.0

Standardwert: IfNotPresent

Legt fest, wann kubelet das Docker-Image des Pods abruft. Mögliche Werte:

  • IfNotPresent: Kein neues Image abrufen, wenn es bereits vorhanden ist.
  • Always: Image immer abrufen, unabhängig davon, ob es bereits vorhanden ist.

Weitere Informationen finden Sie unter Updating images.

logger.image.tag Erweitert Eingeführt in Version: 1.0.0

Standardwert: 1.14.3

Das Versionslabel für das Docker-Image dieses Dienstes.

logger.image.url Erweitert Eingeführt in Version: 1.0.0

Standardwert: Keiner

Der Speicherort des Docker-Image für diesen Dienst.

Mit apigee-pull-push --list können Sie die aktuelle Repository-URL für diese Komponente aufrufen.

logger.livenessProbe.failureThreshold Erweitert Eingeführt in Version: 1.0.0

Standardwert: 3

Die Häufigkeit, mit der Kubernetes prüft, ob Aktivitätsprüfungen fehlgeschlagen sind, bevor der Container neu gestartet wird. Der Mindestwert beträgt 1.

logger.livenessProbe.initialDelaySeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 0

Die Anzahl der Sekunden nach dem Start eines Containers, bevor eine Aktivitätsprüfung gestartet wird.

logger.livenessProbe.periodSeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 60

Bestimmt, wie oft eine Aktivitätsprüfung durchgeführt werden soll. Angabe in Sekunden. Der Mindestwert beträgt 1.

logger.livenessProbe.successThreshold Erweitert Eingeführt in Version: 1.0.0

Standardwert: 1

Wie viele Male hintereinander eine Aktivitätsprüfung bestanden werden muss, um nach einem Fehler als erfolgreich zu gelten. Der Mindestwert beträgt 1.

logger.livenessProbe.timeoutSeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 1

Der Zeitraum in Sekunden, nach dem eine Aktivitätsprüfung das Zeitlimit überschritten hat. Der Mindestwert beträgt 1.

logger.nodeSelector.key Einfach Eingeführt in Version: 1.0.0

Standardwert: apigee.com/apigee-logger-enabled

Erforderlich

Labelschlüssel für die Knotenauswahl, um dedizierte Kubernetes-Knoten für logger-Laufzeitdienste bereitzustellen.

Siehe Dedizierte Knotenpools konfigurieren.

logger.nodeSelector.value Einfach Eingeführt in Version: 1.0.0

Standardwert: true

Erforderlich

Labelwert für die Knotenauswahl, um dedizierte Kubernetes-Knoten für logger-Laufzeitdienste bereitzustellen.

Siehe Dedizierte Knotenpools konfigurieren.

logger.resources.limits.cpu Erweitert Eingeführt in Version: 1.0.0

Standardwert: 200m

Das CPU-Limit für die Ressource in einem Kubernetes-Container in Millicore.

logger.resources.limits.memory Erweitert Eingeführt in Version: 1.0.0

Standardwert: 500Mi

Das Arbeitsspeicherlimit für die Ressource in einem Kubernetes-Container in Mebibyte.

logger.resources.requests.cpu Erweitert Eingeführt in Version: 1.0.0

Standardwert: 100m

Die CPU in Millicore, die für den normalen Betrieb der Ressource in einem Kubernetes-Container erforderlich ist.

logger.resources.requests.memory Erweitert Eingeführt in Version: 1.0.0

Standardwert: 250Mi

Der Arbeitsspeicher in Mebibyte, der für den normalen Betrieb der Ressource in einem Kubernetes-Container erforderlich ist.

logger.serviceAccountPath Einfach Eingeführt in Version: 1.0.0

Standardwert: Keiner

serviceAccountPath oder serviceAccountRef ist erforderlich.

Der Pfad zur Schlüsseldatei des Google-Dienstkontos mit der Rolle Logs Writer.

logger.serviceAccountRef Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

serviceAccountPath oder serviceAccountRef ist erforderlich.

logger.storageMaxChunks Erweitert Eingeführt in Version: 1.12.0

Standardwert: 128

Die maximale Anzahl von Blöcken, die im Arbeitsspeicher sein können. Blöcke, die das Limit überschreiten, werden im Dateisystem gespeichert.

logger.terminationGracePeriodSeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 30

Die maximale Zeit zwischen einer Anfrage zum Löschen eines Pods und dem Beenden des Pods in Sekunden. Während dieses Zeitraums werden etwaige Prestop-Hooks ausgeführt und alle laufenden Prozesse sollten ordnungsgemäß beendet werden. Der Pod wird beendet, wenn alle laufenden Prozesse abgeschlossen sind oder am Ende des Kulanzzeitraums, je nachdem, was zuerst eintritt. Wenn keine Prozesse ausgeführt werden, wird der Pod sofort beendet.

logger.tolerations.effect Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

effect gibt die Auswirkung an, die eine Übereinstimmung einer Toleranz mit einer Markierung hat. effect kann folgende Werte haben:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

logger.tolerations.key Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

key identifiziert Pods, auf die die Toleranz angewendet werden kann.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

logger.tolerations.operator Erweitert Eingeführt in Version: 1.10.1

Standardwert: "Equal"

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

operator gibt den Vorgang an, der zum Auslösen von effect verwendet wird. operator kann folgende Werte haben:

  • Equal: Entspricht dem in value festgelegten Wert.
  • Exists: Ignoriert den in value festgelegten Wert.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

logger.tolerations.tolerationSeconds Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

tolerationSeconds definiert in Sekunden, wie lange ein Pod an einen fehlerhaften oder nicht reagierenden Knoten gebunden ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

logger.tolerations.value Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

value ist der Wert, der effect auslöst, wenn operator auf Equal gesetzt ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

mart

Definiert den MART-Dienst (Management-API für Laufzeitdaten), der als API-Anbieter für öffentliche Apigee-APIs fungiert, sodass Sie auf Laufzeitdatenentitäten wie KMS (API-Schlüssel und OAuth-Tokens), KVM, Kontingente und API-Produkte zugreifen und diese verwalten können.

In der folgenden Tabelle werden die Attribute des Objekts mart beschrieben:

Attribut Typ Beschreibung
mart.annotations Erweitert Eingeführt in Version: 1.5.0

Standardwert: Keiner

Optionale Schlüssel/Wert-Zuordnung, die zum Annotieren von Pods verwendet wird. Weitere Informationen finden Sie unter Benutzerdefinierte Annotationen.

mart.gsa Erweitert Eingeführt in Version: 1.10.0

Standardwert: Keiner

Nur Helm: Die E‑Mail-Adresse des Google IAM-Dienstkontos (GSA) für apigee-mart, das beim Aktivieren von Workload Identity in GKE-Clustern mithilfe von Helm-Diagrammen mit dem entsprechenden Kubernetes-Dienstkonto verknüpft werden soll. Legen Sie dies fest, wenn Sie für gcp.workloadIdentity.enabled den Wert true festgelegt haben.

GSA-E‑Mail-Adressen haben normalerweise folgendes Format:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Beispiel:

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

Weitere Informationen finden Sie unter Workload Identity in GKE aktivieren oder Identitätsföderation von Arbeitslasten in AKS und EKS aktivieren.

mart.hostAlias Einfach Eingeführt in Version: 1.0.0

Standardwert: Keiner

Der Hostalias, der auf das MART-Objekt verweist. Sie können dieses Attribut auf * oder einen voll qualifizierten Domainnamen festlegen.

mart.image.pullPolicy Erweitert Eingeführt in Version: 1.0.0

Standardwert: IfNotPresent

Legt fest, wann kubelet das Docker-Image des Pods abruft. Mögliche Werte:

  • IfNotPresent: Kein neues Image abrufen, wenn es bereits vorhanden ist.
  • Always: Image immer abrufen, unabhängig davon, ob es bereits vorhanden ist.

Weitere Informationen finden Sie unter Updating images.

mart.image.tag Erweitert Eingeführt in Version: 1.0.0

Standardwert: 1.14.3

Das Versionslabel für das Docker-Image dieses Dienstes.

mart.image.url Erweitert Eingeführt in Version: 1.0.0

Standardwert: Keiner

Der Speicherort des Docker-Image für diesen Dienst.

Mit apigee-pull-push --list können Sie die aktuelle Repository-URL für diese Komponente aufrufen.

mart.initCheckCF.resources.requests.cpu Erweitert Eingeführt in Version: 1.0.0

Standardwert: 10m

Die Menge der CPU-Ressourcen, die der Initialisierungsprüfung des Cloud Foundry-Prozesses zugewiesen wurden.

mart.livenessProbe.failureThreshold Erweitert Eingeführt in Version: 1.0.0

Standardwert: 12

Die Häufigkeit, mit der Kubernetes prüft, ob Aktivitätsprüfungen fehlgeschlagen sind, bevor der Container neu gestartet wird. Der Mindestwert beträgt 1.

mart.livenessProbe.initialDelaySeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 15

Die Anzahl der Sekunden nach dem Start eines Containers, bevor eine Aktivitätsprüfung gestartet wird.

mart.livenessProbe.periodSeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 5

Bestimmt, wie oft eine Aktivitätsprüfung durchgeführt werden soll. Angabe in Sekunden. Der Mindestwert beträgt 1.

mart.livenessProbe.timeoutSeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 1

Der Zeitraum in Sekunden, nach dem eine Aktivitätsprüfung das Zeitlimit überschritten hat. Der Mindestwert beträgt 1.

mart.metricsURL Einfach Eingeführt in Version: 1.0.0

Standardwert: /v1/server/metrics

mart.nodeSelector.key Einfach Eingeführt in Version: 1.0.0

Standardwert: Keiner

Optionaler Labelschlüssel für die Knotenauswahl zum Bereitstellen von Kubernetes-Knoten für mart-Laufzeitdienste. Wenn Sie keinen Schlüssel für mart.nodeselector angeben, verwendet die Laufzeit den im Objekt nodeSelector angegebenen Knoten.

Siehe Dedizierte Knotenpools konfigurieren.

mart.nodeSelector.value Einfach Eingeführt in Version: 1.0.0

Standardwert: Keiner

Optionaler Labelwert für die Knotenauswahl, um Kubernetes-Knoten für mart-Laufzeitdienste bereitzustellen. Siehe auch das Objekt nodeSelector.

Siehe Dedizierte Knotenpools konfigurieren.

mart.readinessProbe.failureThreshold Erweitert Eingeführt in Version: 1.0.0

Standardwert: 2

Wie oft Kubernetes überprüft, ob die Bereitschaftsprüfungen fehlgeschlagen sind, bevor der Pod als nicht bereit markiert wird. Der Mindestwert beträgt 1.

mart.readinessProbe.initialDelaySeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 15

Die Anzahl der Sekunden nach dem Start eines Containers, bevor eine Bereitschaftsprüfung gestartet wird.

mart.readinessProbe.periodSeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 5

Bestimmt, wie oft eine Bereitschaftsprüfung durchgeführt werden soll. Angabe in Sekunden. Der Mindestwert beträgt 1.

mart.readinessProbe.successThreshold Erweitert Eingeführt in Version: 1.0.0

Standardwert: 1

Wie viele Male hintereinander eine Bereitschaftsprüfung bestanden werden muss, um nach einem Fehler als erfolgreich zu gelten. Der Mindestwert beträgt 1.

mart.readinessProbe.timeoutSeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 1

Der Zeitraum in Sekunden, nach dem eine Aktivitätsprüfung das Zeitlimit überschritten hat. Der Mindestwert beträgt 1.

mart.replicaCountMax Einfach Eingeführt in Version: 1.0.0

Standardwert: 5

Maximale Anzahl der für das Autoscaling verfügbaren Replikate.

mart.replicaCountMin Einfach Eingeführt in Version: 1.0.0

Standardwert: 1

Mindestanzahl der für das Autoscaling verfügbaren Replikate.

mart.resources.limits.cpu Erweitert Eingeführt in Version: 1.11.0

Standardwert: 2000m

Das CPU-Limit für die Ressource in einem Kubernetes-Container in Millicore.

mart.resources.limits.memory Erweitert Eingeführt in Version: 1.11.0

Standardwert: 5Gi

Das Arbeitsspeicherlimit für die Ressource in einem Kubernetes-Container in Mebibyte.

mart.resources.requests.cpu Erweitert Eingeführt in Version: 1.0.0

Standardwert: 500m

Die CPU in Millicore, die für den normalen Betrieb der Ressource in einem Kubernetes-Container erforderlich ist.

mart.resources.requests.memory Erweitert Eingeführt in Version: 1.0.0

Standardwert: 512Mi

Der Arbeitsspeicher in Mebibyte, der für den normalen Betrieb der Ressource in einem Kubernetes-Container erforderlich ist.

mart.serviceAccountPath Einfach Eingeführt in Version: 1.1.1

Standardwert: Keiner

Entweder serviceAccountPath oder serviceAccountRef ist erforderlich.

Der Pfad zur Schlüsseldatei des Google-Dienstkontos ohne Rolle.

mart.serviceAccountRef Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

Entweder serviceAccountPath oder serviceAccountRef ist erforderlich.

mart.sslCertPath Einfach Eingeführt in Version: 1.0.0

Standardwert: Keiner

sslCertPath/sslKeyPath oder sslSecret ist erforderlich.

Lokaler Dateisystempfad zum Codieren des SSL-Zertifikats und zum Laden in ein Secret.

mart.sslKeyPath Einfach Eingeführt in Version: 1.0.0

Standardwert: Keiner

sslCertPath/sslKeyPath oder sslSecret ist erforderlich.

Lokaler Dateisystempfad zum Codieren des SSL-Schlüssels und zum Laden in ein Secret.

mart.sslSecret Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

sslCertPath/sslKeyPath oder sslSecret ist erforderlich.

Der Name einer Datei, die in einem Kubernetes-Secret gespeichert ist und das TLS-Zertifikat sowie den privaten Schlüssel enthält. Sie müssen das Secret mit dem TLS-Zertifikat und den Schlüsseldaten als Eingabe erstellen.

Siehe auch:

mart.targetCPUUtilizationPercentage Erweitert Eingeführt in Version: 1.0.0

Standardwert: 75

CPU-Zielauslastung für den MART-Prozess auf dem Pod. Der Wert dieses Felds bietet MART die Möglichkeit zum Autoscaling, wenn die CPU-Auslastung diesen Wert erreicht (bis zu replicaCountMax).

mart.terminationGracePeriodSeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 30

Die maximale Zeit zwischen einer Anfrage zum Löschen eines Pods und dem Beenden des Pods in Sekunden. Während dieses Zeitraums werden etwaige Prestop-Hooks ausgeführt und alle laufenden Prozesse sollten ordnungsgemäß beendet werden. Der Pod wird beendet, wenn alle laufenden Prozesse abgeschlossen sind oder am Ende des Kulanzzeitraums, je nachdem, was zuerst eintritt. Wenn keine Prozesse ausgeführt werden, wird der Pod sofort beendet.

mart.tolerations.effect Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

effect gibt die Auswirkung an, die eine Übereinstimmung einer Toleranz mit einer Markierung hat. effect kann folgende Werte haben:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

mart.tolerations.key Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

key identifiziert Pods, auf die die Toleranz angewendet werden kann.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

mart.tolerations.operator Erweitert Eingeführt in Version: 1.10.1

Standardwert: "Equal"

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

operator gibt den Vorgang an, der zum Auslösen von effect verwendet wird. operator kann folgende Werte haben:

  • Equal: Entspricht dem in value festgelegten Wert.
  • Exists: Ignoriert den in value festgelegten Wert.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

mart.tolerations.tolerationSeconds Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

tolerationSeconds definiert in Sekunden, wie lange ein Pod an einen fehlerhaften oder nicht reagierenden Knoten gebunden ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

mart.tolerations.value Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

value ist der Wert, der effect auslöst, wenn operator auf Equal gesetzt ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

metrics

Definiert den Dienst, der Vorgangsmesswerte erfasst. Mithilfe von Messwertdaten können Sie unter anderem die Integrität von Hybrid-Diensten überwachen und Benachrichtigungen einrichten.

Weitere Informationen finden Sie unter Übersicht über die Messwerterfassung.

In der folgenden Tabelle werden die Attribute des Objekts metrics beschrieben:

Attribut Typ Beschreibung
metrics.adapter.image.pullPolicy Erweitert Eingeführt in Version: 1.8.1

Standardwert: IfNotPresent

Legt fest, wann kubelet das Docker-Image des Pods abruft. Mögliche Werte:

  • IfNotPresent: Kein neues Image abrufen, wenn es bereits vorhanden ist.
  • Always: Image immer abrufen, unabhängig davon, ob es bereits vorhanden ist.

Weitere Informationen finden Sie unter Updating images.

metrics.adapter.image.tag Erweitert Eingeführt in Version: 1.8.1

Standardwert: 1.14.3

Das Versionslabel für das Docker-Image dieses Dienstes.

metrics.adapter.image.url Erweitert Eingeführt in Version: 1.8.1

Standardwert: Keiner

Der Speicherort des Docker-Image für diesen Dienst.

Mit apigee-pull-push --list können Sie die aktuelle Repository-URL für diese Komponente aufrufen.

metrics.adapter.resources.limits.cpu Erweitert Eingeführt in Version: 1.14.1

Standardwert: 500m

Das CPU-Limit für die Adapterressource in einem Kubernetes-Container in Millicore.

metrics.adapter.resources.limits.memory Erweitert Eingeführt in Version: 1.14.1

Standardwert: 4Gi

Das Arbeitsspeicherlimit für die Adapterressource in einem Kubernetes-Container in Gibibyte.

metrics.adapter.resources.requests.cpu Erweitert Eingeführt in Version: 1.14.1

Standardwert: 100m

Die CPU in Millicore, die für den normalen Betrieb des Adapters in einem Kubernetes-Container erforderlich ist.

metrics.adapter.resources.requests.memory Erweitert Eingeführt in Version: 1.14.1

Standardwert: 128Mi

Der Arbeitsspeicher in Mebibyte, der für den normalen Betrieb des Adapters in einem Kubernetes-Container erforderlich ist.

metrics.aggregator.resources.requests.cpu Erweitert Eingeführt in Version: 1.4.0

Standardwert: 500m

Die CPU in Millicore, die für den normalen Betrieb des Aggregators in einem Kubernetes-Container erforderlich ist.

metrics.aggregator.resources.requests.memory Erweitert Eingeführt in Version: 1.4.0

Standardwert: 512Mi

Der Arbeitsspeicher in Mebibyte, der für den normalen Betrieb des Aggregators in einem Kubernetes-Container erforderlich ist.

metrics.aggregator.resources.limits.cpu Erweitert Eingeführt in Version: 1.4.0

Standardwert: 500m

Das CPU-Limit für die Aggregatorressource in einem Kubernetes-Container in Millicore.

metrics.aggregator.resources.limits.memory Erweitert Eingeführt in Version: 1.4.0

Standardwert: 3Gi

Das Arbeitsspeicherlimit für die Aggregatorressource in einem Kubernetes-Container in Gibibyte.

metrics.annotations Erweitert Eingeführt in Version: 1.5.0

Standardwert: Keiner

Optionale Schlüssel/Wert-Zuordnung, die zum Annotieren von Pods verwendet wird. Weitere Informationen finden Sie unter Benutzerdefinierte Annotationen.

metrics.app.resources.requests.cpu Erweitert Eingeführt in Version: 1.4.0

Standardwert: 500m

Die CPU, die für den normalen Betrieb der Ressource in einem Kubernetes-Container in Millicore erforderlich ist.

metrics.app.resources.requests.memory Erweitert Eingeführt in Version: 1.4.0

Standardwert: 512Mi

Der erforderliche Arbeitsspeicher für die Ressource in einem Kubernetes-Container in Mebibyte.

metrics.app.resources.limits.cpu Erweitert Eingeführt in Version: 1.4.0

Standardwert: 500m

Das CPU-Limit für die Ressource in einem Kubernetes-Container in Millicore.

metrics.app.resources.limits.memory Erweitert Eingeführt in Version: 1.4.0

Standardwert: 1Gi

Das Speicherlimit für die Anwendungsressource in einem Kubernetes-Container in Gibibyte.

metrics.appStackdriverExporter.resources.limits.cpu Erweitert Eingeführt in Version: 1.7.0

Standardwert: 500m

Das CPU-Limit für die StackdriverExporter-Ressource in einem Kubernetes-Container in Millicore.

metrics.appStackdriverExporter.resources.limits.memory Erweitert Eingeführt in Version: 1.7.0

Standardwert: 1Gi

Das Arbeitsspeicherlimit für die StackdriverExporter-Ressource in einem Kubernetes-Container in Gibibyte.

metrics.appStackdriverExporter.resources.requests.cpu Erweitert Eingeführt in Version: 1.7.0

Standardwert: 128m

Die CPU in Millicore, die für den normalen Betrieb des StackdriverExporter in einem Kubernetes-Container erforderlich ist.

metrics.appStackdriverExporter.resources.requests.memory Erweitert Eingeführt in Version: 1.7.0

Standardwert: 512Mi

Der Arbeitsspeicher in Mebibyte, der für den normalen Betrieb des StackdriverExporter in einem Kubernetes-Container erforderlich ist.

metrics.collector.envVars Einfach Eingeführt in Version: 1.13

Standardwert: Keiner

Ermöglicht das Übergeben und Überschreiben von Umgebungsvariablen in OpenTelemetry. Sie können beispielsweise HTTP_PROXY, HTTPS_PROXY oder NO_PROXY definieren, damit die Anfragen über den Proxyserver weitergeleitet werden.

Die Variable HTTP_PROXY kann als String mit dem Hostnamen im folgenden Format definiert werden:

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

Beispiel:

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

Die Variable HTTPS_PROXY kann als String mit dem Hostnamen im folgenden Format definiert werden:

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

Beispiel:

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

Die Variable NO_PROXY muss als kommagetrennter String von Hostnamen im folgenden Format definiert werden:

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

Beispiel:

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

Verwenden Sie optional envVars: HTTP_PROXY, envVars: HTTPS_PROXY oder envVars: NO_PROXY, wenn Sie den HTTP-Weiterleitungsproxy aktiviert haben.

Weitere Informationen finden Sie in der OpenTelemetry-Dokumentation unter Proxy support.

metrics.collector.imagePullPolicy Erweitert Eingeführt in Version: 1.12.0

Standardwert: IfNotPresent

Legt fest, wann kubelet das Docker-Image des Pods abruft. Mögliche Werte:

  • IfNotPresent: Kein neues Image abrufen, wenn es bereits vorhanden ist.
  • Always: Image immer abrufen, unabhängig davon, ob es bereits vorhanden ist.

Weitere Informationen finden Sie unter Privates Image-Repository mit Apigee Hybrid verwenden.

metrics.collector.image.tag Einfach Eingeführt in Version: 1.12.0

Standardwert: 1.14.3

Das Versionslabel für das Docker-Image dieses Dienstes.

metrics.collector.image.url Einfach Eingeführt in Version: 1.12.0

Standardwert: Keiner

Der Speicherort des Docker-Image für diesen Dienst.

Mit apigee-pull-push --list können Sie die aktuelle Repository-URL für diese Komponente aufrufen.

metrics.collector.resources.requests.cpu Erweitert Eingeführt in Version: 1.12.0

Standardwert: 500m

Die CPU in Millicore, die für den normalen Betrieb der Anwendung in einem Kubernetes-Container erforderlich ist.

metrics.collector.resources.requests.memory Erweitert Eingeführt in Version: 1.12.0

Standardwert: 512Mi

Der Arbeitsspeicher in Mebibyte, der für den normalen Betrieb der Anwendung in einem Kubernetes-Container erforderlich ist.

metrics.collector.resources.limits.cpu Erweitert Eingeführt in Version: 1.12.0

Standardwert: 500m

Das CPU-Limit für die Anwendungsressource in einem Kubernetes-Container in Millicore.

metrics.collector.resources.limits.memory Erweitert Eingeführt in Version: 1.12.0

Standardwert: 1Gi

Das Arbeitsspeicherlimit für die Anwendungsressource in einem Kubernetes-Container in Gibibyte.

metrics.collector.livenessProbe.failureThreshold Erweitert Eingeführt in Version: 1.12.0

Standardwert: 5

Die Häufigkeit, mit der Kubernetes prüft, ob Aktivitätsprüfungen fehlgeschlagen sind, bevor der Container neu gestartet wird. Der Mindestwert beträgt 1.

metrics.collector.livenessProbe.initialDelaySeconds Erweitert Eingeführt in Version: 1.12.0

Standardwert: 30

Die Anzahl der Sekunden nach dem Start eines Containers, bevor eine Aktivitätsprüfung gestartet wird.

metrics.collector.livenessProbe.periodSeconds Erweitert Eingeführt in Version: 1.12.0

Standardwert: 10

Bestimmt, wie oft eine Aktivitätsprüfung durchgeführt werden soll. Angabe in Sekunden. Der Mindestwert beträgt 1.

metrics.collector.livenessProbe.successThreshold Erweitert Eingeführt in Version: 1.12.0

Standardwert: 1

Wie viele Male hintereinander eine Aktivitätsprüfung bestanden werden muss, um nach einem Fehler als erfolgreich zu gelten. Der Mindestwert beträgt 1.

metrics.collector.livenessProbe.timeoutSeconds Erweitert Eingeführt in Version: 1.12.0

Standardwert: 5

Der Zeitraum in Sekunden, nach dem eine Aktivitätsprüfung das Zeitlimit überschritten hat. Der Mindestwert beträgt 1.

metrics.collector.readinessProbe.failureThreshold Erweitert Eingeführt in Version: 1.12.0

Standardwert: 3

Wie oft Kubernetes überprüft, ob die Bereitschaftsprüfungen fehlgeschlagen sind, bevor der Pod als nicht bereit markiert wird. Der Mindestwert beträgt 1.

metrics.collector.readinessProbe.initialDelaySeconds Erweitert Eingeführt in Version: 1.12.0

Standardwert: 30

Die Anzahl der Sekunden nach dem Start eines Containers, bevor eine Bereitschaftsprüfung gestartet wird.

metrics.collector.readinessProbe.periodSeconds Erweitert Eingeführt in Version: 1.12.0

Standardwert: 10

Bestimmt, wie oft eine Bereitschaftsprüfung durchgeführt werden soll. Angabe in Sekunden. Der Mindestwert beträgt 1.

metrics.collector.readinessProbe.successThreshold Erweitert Eingeführt in Version: 1.12.0

Standardwert: 1

Wie viele Male hintereinander eine Bereitschaftsprüfung bestanden werden muss, um nach einem Fehler als erfolgreich zu gelten. Der Mindestwert beträgt 1.

metrics.collector.readinessProbe.timeoutSeconds Erweitert Eingeführt in Version: 1.12.0

Standardwert: 5

Der Zeitraum in Sekunden, nach dem eine Aktivitätsprüfung das Zeitlimit überschritten hat. Der Mindestwert beträgt 1.

metrics.disablePrometheusPipeline Einfach Eingeführt in Version: 1.12.0

Standardwert: true

Messwerte für die überwachten Ressourcen ProxyV2 und TargetV2 werden nicht ausgegeben, wenn für sie true festgelegt ist. Verwenden Sie stattdessen Messwerte für überwachte Ressourcen vom Typ Proxy und Target.

metrics.enabled Einfach Eingeführt in Version: 1.0.0

Standardwert: true

Aktiviert Apigee-Messwerte. Setzen Sie den Wert auf true, um Messwerte zu aktivieren. Legen Sie false fest, um Messwerte zu deaktivieren.

metrics.gsa Erweitert Eingeführt in Version: 1.10.0

Standardwert: Keiner

Nur Helm: Die E‑Mail-Adresse des Google IAM-Dienstkontos (GSA) für apigee-metrics, das beim Aktivieren von Workload Identity in GKE-Clustern mithilfe von Helm-Diagrammen mit dem entsprechenden Kubernetes-Dienstkonto verknüpft werden soll. Legen Sie dies fest, wenn Sie für gcp.workloadIdentity.enabled den Wert true festgelegt haben.

GSA-E‑Mail-Adressen haben normalerweise folgendes Format:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Beispiel:

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

Weitere Informationen finden Sie unter Workload Identity in GKE aktivieren oder Identitätsföderation von Arbeitslasten in AKS und EKS aktivieren.

metrics.nodeSelector.key Einfach Eingeführt in Version: 1.0.0

Standardwert: Keiner

Erforderlich

Labelschlüssel für die Knotenauswahl, um dedizierte Kubernetes-Knoten für metrics-Laufzeitdienste bereitzustellen.

Siehe Dedizierte Knotenpools konfigurieren.

metrics.nodeSelector.value Einfach Eingeführt in Version: 1.0.0

Standardwert: Keiner

Erforderlich

Labelwert für die Knotenauswahl, um dedizierte Kubernetes-Knoten für metrics-Laufzeitdienste bereitzustellen.

Siehe Dedizierte Knotenpools konfigurieren.

metrics.prometheus.containerPort Erweitert Eingeführt in Version: 1.0.0

Standardwert: 9090

Der Port für die Verbindung zum Prometheus-Messwertdienst.

metrics.prometheus.image.pullPolicy Erweitert Eingeführt in Version: 1.0.0

Standardwert: IfNotPresent

Legt fest, wann kubelet das Docker-Image des Pods abruft. Mögliche Werte:

  • IfNotPresent: Kein neues Image abrufen, wenn es bereits vorhanden ist.
  • Always: Image immer abrufen, unabhängig davon, ob es bereits vorhanden ist.

Weitere Informationen finden Sie unter Updating images.

metrics.prometheus.image.tag Erweitert Eingeführt in Version: 1.0.0

Standardwert: 1.14.3

Das Versionslabel für das Docker-Image dieses Dienstes.

metrics.prometheus.image.url Erweitert Eingeführt in Version: 1.0.0

Standardwert: Keiner

Der Speicherort des Docker-Image für diesen Dienst.

Mit apigee-pull-push --list können Sie die aktuelle Repository-URL für diese Komponente aufrufen.

metrics.prometheus.livenessProbe.failureThreshold Erweitert Eingeführt in Version: 1.0.0

Standardwert: 6

Die Häufigkeit, mit der Kubernetes prüft, ob Aktivitätsprüfungen fehlgeschlagen sind, bevor der Container neu gestartet wird. Der Mindestwert beträgt 1.

metrics.prometheus.livenessProbe.periodSeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 5

Bestimmt, wie oft eine Aktivitätsprüfung durchgeführt werden soll. Angabe in Sekunden. Der Mindestwert beträgt 1.

metrics.prometheus.livenessProbe.timeoutSeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 3

Der Zeitraum in Sekunden, nach dem eine Aktivitätsprüfung das Zeitlimit überschritten hat. Der Mindestwert beträgt 1.

metrics.prometheus.readinessProbe.failureThreshold Erweitert Eingeführt in Version: 1.0.0

Standardwert: 120

Wie oft Kubernetes überprüft, ob die Bereitschaftsprüfungen fehlgeschlagen sind, bevor der Pod als nicht bereit markiert wird. Der Mindestwert beträgt 1.

metrics.prometheus.readinessProbe.periodSeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 5

Bestimmt, wie oft eine Bereitschaftsprüfung durchgeführt werden soll. Angabe in Sekunden. Der Mindestwert beträgt 1.

metrics.prometheus.readinessProbe.timeoutSeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 3

Der Zeitraum in Sekunden, nach dem eine Aktivitätsprüfung das Zeitlimit überschritten hat. Der Mindestwert beträgt 1.

metrics.prometheus.resources.limits.cpu Erweitert Eingeführt in Version: 1.14.1

Standardwert: 500m

Das CPU-Limit für die Prometheus-Ressource in einem Kubernetes-Container in Millicore.

metrics.prometheus.resources.limits.memory Erweitert Eingeführt in Version: 1.14.1

Standardwert: 4Gi

Das Arbeitsspeicherlimit für die Prometheus-Ressource in einem Kubernetes-Container in Gibibyte.

metrics.prometheus.resources.requests.cpu Erweitert Eingeführt in Version: 1.14.1

Standardwert: 128m

Die CPU in Millicore, die für den normalen Betrieb der Prometheus-Ressource in einem Kubernetes-Container erforderlich ist.

metrics.prometheus.resources.requests.memory Erweitert Eingeführt in Version: 1.14.1

Standardwert: 512Mi

Der Arbeitsspeicher in Mebibyte, der für den normalen Betrieb der Prometheus-Ressource in einem Kubernetes-Container erforderlich ist.

metrics.prometheus.sslCertPath Einfach Eingeführt in Version: 1.0.0

Standardwert: Keiner

Erforderlich

Pfad zum SSL-Zertifikat für die Messwerterfassung durch Prometheus. Prometheus ist ein Tool, mit dem Apigee Messwerte erfassen und verarbeiten kann.

Weitere Informationen:

metrics.prometheus.sslKeyPath Einfach Eingeführt in Version: 1.0.0

Standardwert: Keiner

Erforderlich

Pfad zum SSL-Schlüssel für die Messwerterfassung durch Prometheus. Prometheus ist ein Tool, mit dem Apigee Messwerte erfassen und verarbeiten kann.

Weitere Informationen:

metrics.proxy.resources.requests.cpu Erweitert Eingeführt in Version: 1.4.0

Standardwert: 500m

Die CPU in Millicore, die für den normalen Betrieb des Proxys in einem Kubernetes-Container erforderlich ist.

metrics.proxy.resources.requests.memory Erweitert Eingeführt in Version: 1.4.0

Standardwert: 512Mi

Der Arbeitsspeicher in Mebibyte, der für den normalen Betrieb des Proxys in einem Kubernetes-Container erforderlich ist.

metrics.proxy.resources.limits.cpu Erweitert Eingeführt in Version: 1.4.0

Standardwert: 500m

Das CPU-Limit für die Proxy-Ressource in einem Kubernetes-Container in Millicore.

metrics.proxy.resources.limits.memory Erweitert Eingeführt in Version: 1.4.0

Standardwert: 1Gi

Das Arbeitsspeicherlimit für die Proxy-Ressource in einem Kubernetes-Container in Gibibyte.

metrics.proxyStackdriverExporter.resources.requests.cpu Erweitert Eingeführt in Version: 1.7.0

Standardwert: 128m

Die CPU in Millicore, die für den normalen Betrieb des StackdriverExporter in einem Kubernetes-Container erforderlich ist.

metrics.proxyStackdriverExporter.resources.requests.memory Erweitert Eingeführt in Version: 1.7.0

Standardwert: 512Mi

Der Arbeitsspeicher in Mebibyte, der für den normalen Betrieb des StackdriverExporter in einem Kubernetes-Container erforderlich ist.

metrics.proxyStackdriverExporter.resources.limits.cpu Erweitert Eingeführt in Version: 1.7.0

Standardwert: 500m

Das CPU-Limit für die StackdriverExporter-Ressource in einem Kubernetes-Container in Millicore.

metrics.proxyStackdriverExporter.resources.limits.memory Erweitert Eingeführt in Version: 1.7.0

Standardwert: 1Gi

Das Arbeitsspeicherlimit für die StackdriverExporter-Ressource in einem Kubernetes-Container in Gibibyte.

metrics.proxyURL Einfach Eingeführt in Version: 1.0.0

Standardwert: Keiner

Die URL für den Sidecar-Proxy des Messwertprozesses im Kubernetes-Cluster.

metrics.sdSidecar.containerPort Erweitert Eingeführt in Version: 1.0.0

Standardwert: 9091

Der Port für die Verbindung zum Cloud Monitoring-Messwertdienst.

metrics.sdSidecar.image.pullPolicy Erweitert Eingeführt in Version: 1.0.0

Standardwert: IfNotPresent

Legt fest, wann Kubelet das Docker-Image dieses Dienstes abruft. Mögliche Werte:

  • IfNotPresent: Kein neues Image abrufen, wenn es bereits vorhanden ist.
  • Always: Richtlinie immer abrufen, auch wenn sie bereits vorhanden ist.

    Weitere Informationen finden Sie unter Updating images.

metrics.sdSidecar.image.tag Erweitert Eingeführt in Version: 1.0.0

Standardwert: 1.14.3

Das Versionslabel für das Docker-Image dieses Dienstes.

metrics.sdSidecar.image.url Erweitert Eingeführt in Version: 1.0.0

Standardwert: Keiner

Der Speicherort des Docker-Image für diesen Dienst.

Mit apigee-pull-push --list können Sie die aktuelle Repository-URL für diese Komponente aufrufen.

metrics.serviceAccountPath Einfach Eingeführt in Version: 1.0.0

Standardwert: Keiner

serviceAccountPath oder serviceAccountRef ist erforderlich.

Pfad zur Schlüsseldatei des Google-Dienstkontos mit der Rolle Monitoring Metric Writer.

metrics.serviceAccountRef Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

serviceAccountPath oder serviceAccountRef ist erforderlich.

metrics.stackdriverExporter.resources.requests.cpu Erweitert Eingeführt in Version: 1.4.0

Deprecated: Ab Hybrid-Version 1.8 wurde metrics:stackdriverExporter durch metrics:appStackdriverExporter und metrics:proxyStackdriverExporter ersetzt. Weitere Informationen:

metrics.stackdriverExporter.resources.requests.memory Erweitert Eingeführt in Version: 1.4.0

Deprecated: Ab Hybrid-Version 1.8 wurde metrics:stackdriverExporter durch metrics:appStackdriverExporter und metrics:proxyStackdriverExporter ersetzt. Weitere Informationen:

metrics.stackdriverExporter.resources.limits.cpu Erweitert Eingeführt in Version: 1.4.0

Deprecated: Ab Hybrid-Version 1.8 wurde metrics:stackdriverExporter durch metrics:appStackdriverExporter und metrics:proxyStackdriverExporter ersetzt. Weitere Informationen:

metrics.stackdriverExporter.resources.limits.memory Erweitert Eingeführt in Version: 1.4.0

Deprecated: Ab Hybrid-Version 1.8 wurde metrics:stackdriverExporter durch metrics:appStackdriverExporter und metrics:proxyStackdriverExporter ersetzt. Weitere Informationen:

metrics.terminationGracePeriodSeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 300

Die maximale Zeit zwischen einer Anfrage zum Löschen eines Pods und dem Beenden des Pods in Sekunden. Während dieses Zeitraums werden etwaige Prestop-Hooks ausgeführt und alle laufenden Prozesse sollten ordnungsgemäß beendet werden. Der Pod wird beendet, wenn alle laufenden Prozesse abgeschlossen sind oder am Ende des Kulanzzeitraums, je nachdem, was zuerst eintritt. Wenn keine Prozesse ausgeführt werden, wird der Pod sofort beendet.

metrics.tolerations.effect Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

effect gibt die Auswirkung an, die eine Übereinstimmung einer Toleranz mit einer Markierung hat. effect kann folgende Werte haben:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

metrics.tolerations.key Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

key identifiziert Pods, auf die die Toleranz angewendet werden kann.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

metrics.tolerations.operator Erweitert Eingeführt in Version: 1.10.1

Standardwert: "Equal"

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

operator gibt den Vorgang an, der zum Auslösen von effect verwendet wird. operator kann folgende Werte haben:

  • Equal: Entspricht dem in value festgelegten Wert.
  • Exists: Ignoriert den in value festgelegten Wert.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

metrics.tolerations.tolerationSeconds Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

tolerationSeconds definiert in Sekunden, wie lange ein Pod an einen fehlerhaften oder nicht reagierenden Knoten gebunden ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

metrics.tolerations.value Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

value ist der Wert, der effect auslöst, wenn operator auf Equal gesetzt ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

mintTaskScheduler

mintTaskScheduler ist der Cronjob zum Planen von Monetarisierungsaufgaben wie die wiederkehrende Berechnung von Gebühren.

In der folgenden Tabelle werden die Attribute des Objekts mintTaskScheduler beschrieben:

Attribut Typ Beschreibung
mintTaskScheduler.image.pullPolicy Erweitert Eingeführt in Version: 1.7.0

Standardwert: IfNotPresent

Legt fest, wann kubelet das Docker-Image des Pods abruft. Mögliche Werte:

  • IfNotPresent: Kein neues Image abrufen, wenn es bereits vorhanden ist.
  • Always: Image immer abrufen, unabhängig davon, ob es bereits vorhanden ist.

Weitere Informationen finden Sie unter Updating images.

mintTaskScheduler.image.tag Erweitert Eingeführt in Version: 1.7.0

Standardwert: 1.14.3

Das Versionslabel für das Docker-Image dieses Dienstes.

mintTaskScheduler.image.url Erweitert Eingeführt in Version: 1.7.0

Standardwert: Keiner

Der Speicherort des Docker-Image für diesen Dienst.

Mit apigee-pull-push --list können Sie die aktuelle Repository-URL für diese Komponente aufrufen.

mintTaskScheduler.resources.limits.cpu Erweitert Eingeführt in Version: 1.1.0

Standardwert: 2000m

Das CPU-Limit für die Ressource in einem Kubernetes-Container in Millicore.

mintTaskScheduler.resources.limits.memory Erweitert Eingeführt in Version: 1.1.0

Standardwert: 4Gi

Das Arbeitsspeicherlimit für die Ressource in einem Kubernetes-Container in Mebibyte.

mintTaskScheduler.resources.requests.cpu Erweitert Eingeführt in Version: 1.7.0

Standardwert: 500m

Die CPU in Millicore, die für den normalen Betrieb der Ressource in einem Kubernetes-Container erforderlich ist.

mintTaskScheduler.resources.requests.memory Erweitert Eingeführt in Version: 1.7.0

Standardwert: 512Mi

Der Arbeitsspeicher in Mebibyte, der für den normalen Betrieb der Ressource in einem Kubernetes-Container erforderlich ist.

mintTaskScheduler.tolerations.effect Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

effect gibt die Auswirkung an, die eine Übereinstimmung einer Toleranz mit einer Markierung hat. effect kann folgende Werte haben:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

mintTaskScheduler.tolerations.key Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

key identifiziert Pods, auf die die Toleranz angewendet werden kann.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

mintTaskScheduler.tolerations.operator Erweitert Eingeführt in Version: 1.10.1

Standardwert: "Equal"

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

operator gibt den Vorgang an, der zum Auslösen von effect verwendet wird. operator kann folgende Werte haben:

  • Equal: Entspricht dem in value festgelegten Wert.
  • Exists: Ignoriert den in value festgelegten Wert.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

mintTaskScheduler.tolerations.tolerationSeconds Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

tolerationSeconds definiert in Sekunden, wie lange ein Pod an einen fehlerhaften oder nicht reagierenden Knoten gebunden ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

mintTaskScheduler.tolerations.value Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

value ist der Wert, der effect auslöst, wenn operator auf Equal gesetzt ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

newDataPipeline

newDataPipeline bestimmt, ob Apigee Hybrid die neue Datenpipeline für die Laufzeitkomponenten verwendet, um Daten direkt in die Steuerungsebene zu schreiben.

In der folgenden Tabelle werden die Attribute des Objekts newDataPipeline beschrieben:

Attribut Typ Beschreibung
newDataPipeline.analytics Erweitert Eingeführt in Version: 1.13.1

Standardwert: true

Gibt an, ob für Analysen die neue Pub/Sub-Datenpipeline verwendet wird. Legen Sie diese Eigenschaft auf true fest, um die neue Datenpipeline zu verwenden, wenn Sie Hybrid v1.13 mit aktiviertem Datenstandort oder Hybrid v1.14 oder höher verwenden und sie zuvor auf false festgelegt haben.

Legen Sie false fest, um die neue Datenpipeline zu deaktivieren. Weitere Informationen finden Sie unter Hybrid für die Verwendung der neuen Datenpipeline konfigurieren.

newDataPipeline.debugSession Erweitert Eingeführt in Version: 1.13.1

Standardwert:true (ab Hybrid-Version 1.14.0)

Gibt an, ob die neue Pub/Sub-Datenpipeline aktiviert ist. Legen Sie diese Eigenschaft auf true fest, um die neue Datenpipeline zu verwenden, wenn Sie Hybrid v1.13 mit aktiviertem Datenstandort oder Hybrid v1.14 oder höher verwenden und sie zuvor auf false festgelegt haben.

Legen Sie false fest, um die neue Datenpipeline zu deaktivieren. Weitere Informationen finden Sie unter Hybrid für die Verwendung der neuen Datenpipeline konfigurieren.

nodeSelector

Das Objekt nodeSelector definiert den Knoten für Ihre Apigee-Instanz. Im Hintergrund sorgt Apigee Hybrid dafür, dass das Schlüssel/Wert-Paar des Labels für apigeeRuntime und apigeeData den einzelnen Istio- und MART-Komponenten zugeordnet wird, wenn Sie die Diagramme apigee-org und apigee-ingress-manager installieren oder aktualisieren. Sie können diese Einstellung für einzelne Objekte im Attribut mart:nodeSelector überschreiben.

In der folgenden Tabelle werden die Attribute des Objekts nodeSelector beschrieben:

Attribut Typ Beschreibung
nodeSelector.apigeeData.key Erweitert Eingeführt in Version: 1.0.0

Standardwert: cloud.google.com/gke-nodepool

ApigeeData ist der Knoten für die Cassandra-Datenbank. Labelschlüssel für die Knotenauswahl, um Kubernetes-Knoten für die Arbeit mit Apigee-Dienstdaten bereitzustellen.

Siehe Dedizierte Knotenpools konfigurieren.

nodeSelector.apigeeData.value Erweitert Eingeführt in Version: 1.0.0

Standardwert: apigee-data

apigee-data ist der Knoten für die Cassandra-Datenbank. Labelwert für die Knotenauswahl, um Kubernetes-Knoten für die Arbeit mit Apigee-Dienstdaten bereitzustellen.

Siehe Dedizierte Knotenpools konfigurieren.

nodeSelector.apigeeRuntime.key Erweitert Eingeführt in Version: 1.0.0

Standardwert: cloud.google.com/gke-nodepool

Apigee Runtime ist der Knoten für die Laufzeitumgebung für das Projekt. Labelschlüssel für die Knotenauswahl, um Kubernetes-Knoten für Apigee-Laufzeitdienste bereitzustellen.

Siehe Dedizierte Knotenpools konfigurieren.

nodeSelector.apigeeRuntime.value Erweitert Eingeführt in Version: 1.0.0

Standardwert: apigee-runtime

apigee-runtime ist der Knoten für die Laufzeitumgebung für das Projekt. Labelwert für die Knotenauswahl, um Kubernetes-Knoten für Apigee-Laufzeitdienste bereitzustellen.

Siehe Dedizierte Knotenpools konfigurieren.

nodeSelector.requiredForScheduling Erweitert Eingeführt in Version: 1.0.0

Standardwert: true

Das Attribut requiredForScheduling ist standardmäßig auf true gesetzt. Bei true werden keine zugrunde liegenden Pods auf VM-Worker-Knoten geplant, wenn Kubernetes keine Knoten mit dem konfigurierten Schlüssel/Wert-Paar des Labels finden kann.

Für die Produktion sollte nodeSelector.requiredForScheduling auf „true“ gesetzt sein.

Siehe Dedizierte Knotenpools konfigurieren.

redis

In der folgenden Tabelle werden die Attribute des Objekts redis beschrieben:

Attribut Typ Beschreibung
redis.auth.password Einfach Eingeführt in Version: 1.6.0

Standardwert: iloveapis123

Erforderlich

Passwort für den Redis-Administrator. Der Administrator wird für alle Administratoraktivitäten verwendet, die im Redis-Cluster ausgeführt werden.

redis.auth.secret Einfach Eingeführt in Version: 1.9.1

Standardwert: Keiner

Der Name der Datei, die in einem Kubernetes-Secret gespeichert ist und das Passwort für den Redis-Administrator enthält. Die Secret-Datei sollte den Schlüssel enthalten:

data:
    redis.auth.password: encoded_value

Siehe auch:

redis.envoy.image.pullPolicy Erweitert Eingeführt in Version: 1.6.0

Standardwert: IfNotPresent

Legt fest, wann kubelet das Docker-Image des Pods abruft. Mögliche Werte:

  • IfNotPresent: Kein neues Image abrufen, wenn es bereits vorhanden ist.
  • Always: Image immer abrufen, unabhängig davon, ob es bereits vorhanden ist.

Weitere Informationen finden Sie unter Updating images.

redis.envoy.image.tag Erweitert Eingeführt in Version: 1.6.0

Standardwert: 1.14.3

Das Versionslabel für das Docker-Image dieses Dienstes.

redis.envoy.image.url Erweitert Eingeführt in Version: 1.6.0

Standardwert: Keiner

Der Speicherort des Docker-Image für diesen Dienst.

Mit apigee-pull-push --list können Sie die aktuelle Repository-URL für diese Komponente aufrufen.

redis.image.pullPolicy Erweitert Eingeführt in Version: 1.6.0

Standardwert: IfNotPresent

Legt fest, wann kubelet das Docker-Image des Pods abruft. Mögliche Werte:

  • IfNotPresent: Kein neues Image abrufen, wenn es bereits vorhanden ist.
  • Always: Image immer abrufen, unabhängig davon, ob es bereits vorhanden ist.

Weitere Informationen finden Sie unter Updating images.

redis.image.tag Erweitert Eingeführt in Version: 1.6.0

Standardwert: 1.14.3

Das Versionslabel für das Docker-Image dieses Dienstes.

redis.image.url Erweitert Eingeführt in Version: 1.6.0

Standardwert: Keiner

Der Speicherort des Docker-Image für diesen Dienst.

Mit apigee-pull-push --list können Sie die aktuelle Repository-URL für diese Komponente aufrufen.

redis.replicaCount Einfach Eingeführt in Version: 1.6.0

Standardwert: 2

Redis ist ein replizierter Speicher. Dieses Attribut gibt die Anzahl der Redis-Knoten an, die als StatefulSet verwendet werden.

redis.resources.requests.cpu Erweitert Eingeführt in Version: 1.6.0

Standardwert: 500m

Die CPU in Millicore, die für den normalen Betrieb der Ressource in einem Kubernetes-Container erforderlich ist.

redis.tolerations.effect Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

effect gibt die Auswirkung an, die eine Übereinstimmung einer Toleranz mit einer Markierung hat. effect kann folgende Werte haben:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

redis.tolerations.key Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

key identifiziert Pods, auf die die Toleranz angewendet werden kann.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

redis.tolerations.operator Erweitert Eingeführt in Version: 1.10.1

Standardwert: "Equal"

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

operator gibt den Vorgang an, der zum Auslösen von effect verwendet wird. operator kann folgende Werte haben:

  • Equal: Entspricht dem in value festgelegten Wert.
  • Exists: Ignoriert den in value festgelegten Wert.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

redis.tolerations.tolerationSeconds Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

tolerationSeconds definiert in Sekunden, wie lange ein Pod an einen fehlerhaften oder nicht reagierenden Knoten gebunden ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

redis.tolerations.value Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

value ist der Wert, der effect auslöst, wenn operator auf Equal gesetzt ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

runtime

In der folgenden Tabelle werden die Attribute des Objekts runtime beschrieben:

Attribut Typ Beschreibung
runtime.annotations Erweitert Eingeführt in Version: 1.5.0

Standardwert: Keiner

Optionale Schlüssel/Wert-Zuordnung, die zum Annotieren von Pods verwendet wird. Weitere Informationen finden Sie unter Benutzerdefinierte Annotationen.

runtime.envVars Einfach Eingeführt in Version: 1.13.1

Standardwert: Keiner

Ermöglicht es Ihnen, der Laufzeitkomponente zusätzliche Umgebungsvariablen in einem Schlüssel/Wert-Paar zur Verfügung zu stellen:

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

Beispiel:

runtime:
  envVars:
    RUNTIME_ENV_VAR1: "value of runtime env-var 1"
    RUNTIME_ENV_VAR2: "value of runtime env-var 2"
runtime.image.pullPolicy Erweitert Eingeführt in Version: 1.0.0

Standardwert: IfNotPresent

Legt fest, wann kubelet das Docker-Image des Pods abruft. Mögliche Werte:

  • IfNotPresent: Kein neues Image abrufen, wenn es bereits vorhanden ist.
  • Always: Image immer abrufen, unabhängig davon, ob es bereits vorhanden ist.

Weitere Informationen finden Sie unter Updating images.

runtime.hpaBehavior.scaleDown.percent.periodSeconds Erweitert Eingeführt in Version: 1.7.0

Standardwert: 60

Der Zeitraum, für den die Richtlinie gelten soll, wenn ein Prozentsatz der Laufzeitinstanzen herunterskaliert wird.

runtime.hpaBehavior.scaleDown.percent.value Erweitert Eingeführt in Version: 1.7.0

Standardwert: 20

Welcher Prozentsatz sich laut Richtlinie beim Herunterskalieren von Laufzeitinstanzen ändern darf.

runtime.hpaBehavior.scaleDown.pods.periodSeconds Erweitert Eingeführt in Version: 1.7.0

Standardwert: 60

Der Zeitraum, für den die Richtlinie beim Herunterskalieren einer Anzahl von Laufzeitinstanzen gelten soll.

runtime.hpaBehavior.scaleDown.pods.value Erweitert Eingeführt in Version: 1.7.0

Standardwert: 20

Welche Menge sich laut Richtlinie beim Herunterskalieren von Laufzeitinstanzen ändern darf.

runtime.hpaBehavior.scaleDown.selectPolicy Erweitert Eingeführt in Version: 1.7.0

Standardwert: Min

Die Entscheidung, die der Autoscaler zwischen mehreren Autoscaling-Richtlinien trifft. Wenn Sie den Wert auf Min festlegen, wird die Anzahl der Laufzeitinstanzen beim Herunterskalieren um das Minimum geändert. Wenn Sie den Wert auf Max festlegen, wird die Anzahl der Laufzeitinstanzen beim Herunterskalieren um das Maximum geändert.

runtime.hpaBehavior.scaleDown.stabilizationWindowSeconds Erweitert Eingeführt in Version: 1.7.0

Standardwert: 120

Wie lange vergangene Empfehlungen beim Herunterskalieren berücksichtigt werden sollen. Angabe in Sekunden.

runtime.hpaBehavior.scaleUp.percent.periodSeconds Erweitert Eingeführt in Version: 1.7.0

Standardwert: 60

Der Zeitraum, für den die Richtlinie gelten soll, wenn ein Prozentsatz der Laufzeitinstanzen hochskaliert wird.

runtime.hpaBehavior.scaleUp.percent.value Erweitert Eingeführt in Version: 1.7.0

Standardwert: 20

Der Zeitraum, für den die Richtlinie gelten soll, wenn ein Prozentsatz der Laufzeitinstanzen hochskaliert wird.

runtime.hpaBehavior.scaleUp.pods.periodSeconds Erweitert Eingeführt in Version: 1.7.0

Standardwert: 60

Der Zeitraum, für den die Richtlinie beim Hochskalieren einer Anzahl von Laufzeitinstanzen gelten soll.

runtime.hpaBehavior.scaleUp.pods.value Erweitert Eingeführt in Version: 1.7.0

Standardwert: 4

Welche Menge sich laut Richtlinie beim Hochskalieren von Laufzeitinstanzen ändern darf.

runtime.hpaBehavior.scaleUp.selectPolicy Erweitert Eingeführt in Version: 1.7.0

Standardwert: Max

Die Entscheidung, die der Autoscaler zwischen mehreren Autoscaling-Richtlinien trifft. Wenn Sie den Wert auf Min festlegen, wird die Anzahl der Laufzeitinstanzen beim Hochskalieren um das Minimum geändert. Wenn Sie den Wert auf Max festlegen, wird die Anzahl der Laufzeitinstanzen beim Hochskalieren um das Maximum geändert.

runtime.hpaBehavior.scaleUp.stabilizationWindowSeconds Erweitert Eingeführt in Version: 1.7.0

Standardwert: 30

Wie lange vergangene Empfehlungen beim Hochskalieren von Laufzeitinstanzen berücksichtigt werden sollen. Angabe in Sekunden.

runtime.hpaMetrics.serverMainTaskWaitTime Erweitert Eingeführt in Version: 1.7.0

Standardwert: 400 M

Die gewünschte durchschnittliche Wartezeit (in ms) der Verarbeitungswarteschlange in Laufzeitinstanzen für Proxyanfragen in der HTTP-Schicht.

runtime.hpaMetrics.serverNioTaskWaitTime Erweitert Eingeführt in Version: 1.7.0

Standardwert: 400 M

Die gewünschte durchschnittliche Wartezeit (in ms) der Verarbeitungswarteschlange in Laufzeitinstanzen für Proxyanfragen zur Verarbeitung von Richtlinien.

runtime.hpaMetrics.targetCPUUtilizationPercentage Erweitert Eingeführt in Version: 1.7.0

Standardwert: 75

Der gewünschte Prozentsatz der CPU-Auslastung für alle Laufzeitinstanzen.

runtime.image.tag Erweitert Eingeführt in Version: 1.0.0

Standardwert: 1.14.3

Das Versionslabel für das Docker-Image dieses Dienstes.

runtime.image.url Erweitert Eingeführt in Version: 1.0.0

Standardwert: Keiner

Der Speicherort des Docker-Image für diesen Dienst.

Mit apigee-pull-push --list können Sie die aktuelle Repository-URL für diese Komponente aufrufen.

runtime.livenessProbe.failureThreshold Erweitert Eingeführt in Version: 1.0.0

Standardwert: 2

Die Häufigkeit, mit der Kubernetes prüft, ob Aktivitätsprüfungen fehlgeschlagen sind, bevor der Container neu gestartet wird. Der Mindestwert beträgt 1.

runtime.livenessProbe.initialDelaySeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 60

Die Anzahl der Sekunden nach dem Start eines Containers, bevor eine Aktivitätsprüfung gestartet wird.

runtime.livenessProbe.periodSeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 5

Bestimmt, wie oft eine Aktivitätsprüfung durchgeführt werden soll. Angabe in Sekunden. Der Mindestwert beträgt 1.

runtime.livenessProbe.timeoutSeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 1

Der Zeitraum in Sekunden, nach dem eine Aktivitätsprüfung das Zeitlimit überschritten hat. Der Mindestwert beträgt 1.

runtime.nodeSelector.key Einfach Eingeführt in Version: 1.0.0

Standardwert: Keiner

Optionaler Labelschlüssel für die Knotenauswahl zum Bereitstellen von Kubernetes-Knoten für runtime-Dienste.

Siehe Attribut nodeSelector.

runtime.nodeSelector.value Einfach Eingeführt in Version: 1.0.0

Standardwert: Keiner

Labelwert für die Knotenauswahl zum Bereitstellen von Kubernetes-Knoten für runtime-Dienste.

Siehe Dedizierte Knotenpools konfigurieren.

runtime.readinessProbe.failureThreshold Erweitert Eingeführt in Version: 1.0.0

Standardwert: 2

Wie oft Kubernetes überprüft, ob die Bereitschaftsprüfungen fehlgeschlagen sind, bevor der Pod als nicht bereit markiert wird. Der Mindestwert beträgt 1.

runtime.readinessProbe.initialDelaySeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 60

Die Anzahl der Sekunden nach dem Start eines Containers, bevor eine Bereitschaftsprüfung gestartet wird.

runtime.readinessProbe.periodSeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 5

Bestimmt, wie oft eine Bereitschaftsprüfung durchgeführt werden soll. Angabe in Sekunden. Der Mindestwert beträgt 1.

runtime.readinessProbe.successThreshold Erweitert Eingeführt in Version: 1.0.0

Standardwert: 1

Wie viele Male hintereinander eine Bereitschaftsprüfung bestanden werden muss, um nach einem Fehler als erfolgreich zu gelten. Der Mindestwert beträgt 1.

runtime.readinessProbe.timeoutSeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 1

Der Zeitraum in Sekunden, nach dem eine Aktivitätsprüfung das Zeitlimit überschritten hat. Der Mindestwert beträgt 1.

runtime.replicaCountMax Einfach Eingeführt in Version: 1.0.0

Standardwert: 4

Maximale Anzahl der für das Autoscaling verfügbaren Replikate.

Wenn Sie erweiterte Proxylimits pro Umgebung verwenden, wird dies auf alle Replikatsets für die Umgebung angewendet. Jedes Replikatset wird weiterhin unabhängig skaliert.

runtime.replicaCountMin Einfach Eingeführt in Version: 1.0.0

Standardwert: 1

Mindestanzahl der für das Autoscaling verfügbaren Replikate.

Wenn Sie erweiterte Proxylimits pro Umgebung verwenden, wird dies auf alle Replikatsets für die Umgebung angewendet. Jedes Replikatset wird weiterhin unabhängig skaliert.

runtime.resources.limits.cpu Erweitert Eingeführt in Version: 1.11.0

Standardwert: 4000m

Das CPU-Limit für die Ressource in einem Kubernetes-Container in Millicore.

runtime.resources.limits.memory Erweitert Eingeführt in Version: 1.11.0

Standardwert: 6Gi

Das Arbeitsspeicherlimit für die Ressource in einem Kubernetes-Container in Mebibyte (Mi) oder Gibibyte (Gi).

runtime.resources.requests.cpu Erweitert Eingeführt in Version: 1.0.0

Standardwert: 500m

Die CPU in Millicore, die für den normalen Betrieb der Ressource in einem Kubernetes-Container erforderlich ist.

runtime.resources.requests.memory Erweitert Eingeführt in Version: 1.0.0

Standardwert: 512Mi (siehe Hinweis unten)

Der beim normalen Betrieb erforderliche Arbeitsspeicher für die Ressource in einem Kubernetes-Container in Mebibyte (Mi) oder Gibibyte (Gi).

runtime.service.type Erweitert Eingeführt in Version: 1.0.0

Standardwert: ClusterIP

Die Art des Dienstes. Sie können einen anderen Dienst als ClusterIP auswählen, zum Beispiel LoadBalancer.

runtime.targetCPUUtilizationPercentage Erweitert Eingeführt in Version: 1.0.0

Standardwert: 75

CPU-Zielauslastung für den Laufzeitprozess auf dem Pod. Der Wert dieses Feldes ermöglicht der Laufzeit die automatische Skalierung, wenn die CPU-Auslastung diesen Wert erreicht (bis zu replicaCountMax).

runtime.terminationGracePeriodSeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 3600

Die maximale Zeit zwischen einer Anfrage zum Löschen eines Pods und dem Beenden des Pods in Sekunden. Während dieses Zeitraums werden etwaige Prestop-Hooks ausgeführt und alle laufenden Prozesse sollten ordnungsgemäß beendet werden. Der Pod wird beendet, wenn alle laufenden Prozesse abgeschlossen sind oder am Ende des Kulanzzeitraums, je nachdem, was zuerst eintritt. Wenn keine Prozesse ausgeführt werden, wird der Pod sofort beendet.

runtime.tolerations.effect Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

effect gibt die Auswirkung an, die eine Übereinstimmung einer Toleranz mit einer Markierung hat. effect kann folgende Werte haben:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

runtime.tolerations.key Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

key identifiziert Pods, auf die die Toleranz angewendet werden kann.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

runtime.tolerations.operator Erweitert Eingeführt in Version: 1.10.1

Standardwert: "Equal"

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

operator gibt den Vorgang an, der zum Auslösen von effect verwendet wird. operator kann folgende Werte haben:

  • Equal: Entspricht dem in value festgelegten Wert.
  • Exists: Ignoriert den in value festgelegten Wert.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

runtime.tolerations.tolerationSeconds Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

tolerationSeconds definiert in Sekunden, wie lange ein Pod an einen fehlerhaften oder nicht reagierenden Knoten gebunden ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

runtime.tolerations.value Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

value ist der Wert, der effect auslöst, wenn operator auf Equal gesetzt ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

synchronizer

Stellt sicher, dass die Message Processors die zuletzt bereitgestellten API-Proxy-Bundles haben. Hierzu fragt der Synchronizer die Verwaltungsebene ab. Wenn ein neuer Vertrag erkannt wird, sendet der Synchronizer ihn an die Laufzeitebene. Standardmäßig werden die Konfigurationsdaten der Umgebung in Cassandra gespeichert.

Weitere Informationen finden Sie unter Synchronizer konfigurieren.

In der folgenden Tabelle werden die Attribute des Objekts synchronizer beschrieben:

Attribut Typ Beschreibung
synchronizer.annotations Erweitert Eingeführt in Version: 1.5.0

Standardwert: Keiner

Optionale Schlüssel/Wert-Zuordnung, die zum Annotieren von Pods verwendet wird. Weitere Informationen finden Sie unter Benutzerdefinierte Annotationen.

synchronizer.image.pullPolicy Erweitert Eingeführt in Version: 1.0.0

Standardwert: IfNotPresent

Legt fest, wann kubelet das Docker-Image des Pods abruft. Mögliche Werte:

  • IfNotPresent: Kein neues Image abrufen, wenn es bereits vorhanden ist.
  • Always: Image immer abrufen, unabhängig davon, ob es bereits vorhanden ist.

Weitere Informationen finden Sie unter Updating images.

synchronizer.image.tag Erweitert Eingeführt in Version: 1.0.0

Standardwert: 1.14.3

Das Versionslabel für das Docker-Image dieses Dienstes.

synchronizer.image.url Erweitert Eingeführt in Version: 1.0.0

Standardwert: Keiner

Der Speicherort des Docker-Image für diesen Dienst.

Mit apigee-pull-push --list können Sie die aktuelle Repository-URL für diese Komponente aufrufen.

synchronizer.livenessProbe.failureThreshold Erweitert Eingeführt in Version: 1.0.0

Standardwert: 2

Die Häufigkeit, mit der Kubernetes prüft, ob Aktivitätsprüfungen fehlgeschlagen sind, bevor der Container neu gestartet wird. Der Mindestwert beträgt 1.

synchronizer.livenessProbe.initialDelaySeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 0

Die Anzahl der Sekunden nach dem Start eines Containers, bevor eine Aktivitätsprüfung gestartet wird.

synchronizer.livenessProbe.periodSeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 5

Bestimmt, wie oft eine Aktivitätsprüfung durchgeführt werden soll. Angabe in Sekunden. Der Mindestwert beträgt 1.

synchronizer.livenessProbe.timeoutSeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 1

Der Zeitraum in Sekunden, nach dem eine Aktivitätsprüfung das Zeitlimit überschritten hat. Der Mindestwert beträgt 1.

synchronizer.nodeSelector.key Einfach Eingeführt in Version: 1.0.0

Standardwert: Keiner

Erforderlich

Optionaler Labelschlüssel für die Knotenauswahl zum Bereitstellen von Kubernetes-Knoten für synchronizer-Laufzeitdienste.

Siehe nodeSelector.

synchronizer.nodeSelector.value Einfach Eingeführt in Version: 1.0.0

Standardwert: Keiner

Optionaler Labelwert für die Knotenauswahl, um Kubernetes-Knoten für synchronizer-Laufzeitdienste bereitzustellen.

Siehe nodeSelector.

synchronizer.pollInterval Erweitert Eingeführt in Version: 1.0.0

Standardwert: 60

Die Zeitspanne, die der Synchronizer zwischen Abfragevorgängen wartet. Der Synchronizer fragt die Dienste der Apigee-Steuerungsebene ab, um neue Laufzeitverträge zu erkennen und abzurufen.

synchronizer.readinessProbe.failureThreshold Erweitert Eingeführt in Version: 1.0.0

Standardwert: 2

Wie oft Kubernetes überprüft, ob die Bereitschaftsprüfungen fehlgeschlagen sind, bevor der Pod als nicht bereit markiert wird. Der Mindestwert beträgt 1.

synchronizer.readinessProbe.initialDelaySeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 0

Die Anzahl der Sekunden nach dem Start eines Containers, bevor eine Bereitschaftsprüfung gestartet wird.

synchronizer.readinessProbe.periodSeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 5

Bestimmt, wie oft eine Bereitschaftsprüfung durchgeführt werden soll. Angabe in Sekunden. Der Mindestwert beträgt 1.

synchronizer.readinessProbe.successThreshold Erweitert Eingeführt in Version: 1.0.0

Standardwert: 1

Wie viele Male hintereinander eine Bereitschaftsprüfung bestanden werden muss, um nach einem Fehler als erfolgreich zu gelten. Der Mindestwert beträgt 1.

synchronizer.readinessProbe.timeoutSeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 1

Der Zeitraum in Sekunden, nach dem eine Aktivitätsprüfung das Zeitlimit überschritten hat. Der Mindestwert beträgt 1.

synchronizer.replicaCount Einfach Eingeführt in Version: 1.0.0

Deprecated: Ab der Hybrid-Version 1.2 verwalten Sie die Anzahl der Synchronizer-Replikate mit synchronizer.replicaCountMax und synchronizer.replicaCountMin.

synchronizer.replicaCountMax Einfach Eingeführt in Version: 1.2.0

Standardwert: 4

Maximale Anzahl der Replikate für das Autoscaling.

synchronizer.replicaCountMin Einfach Eingeführt in Version: 1.2.0

Standardwert: 1

Mindestanzahl der Replikate für das Autoscaling.

synchronizer.resources.limits.cpu Erweitert Eingeführt in Version: 1.11.0

Standardwert: 2000m

Das CPU-Limit für die Ressource in einem Kubernetes-Container in Millicore.

synchronizer.resources.limits.memory Erweitert Eingeführt in Version: 1.11.0

Standardwert: 5Gi

Das Arbeitsspeicherlimit für die Ressource in einem Kubernetes-Container in Mebibyte.

synchronizer.resources.requests.cpu Erweitert Eingeführt in Version: 1.0.0

Standardwert: 100m

Die CPU in Millicore, die für den normalen Betrieb der Ressource in einem Kubernetes-Container erforderlich ist.

synchronizer.resources.requests.memory Erweitert Eingeführt in Version: 1.0.0

Standardwert: 1Gi

Der Arbeitsspeicher in Gigabyte, der für den normalen Betrieb der Ressource in einem Kubernetes-Container erforderlich ist.

synchronizer.serviceAccountPath Einfach Eingeführt in Version: 1.0.0

Standardwert: Keiner

serviceAccountPath oder serviceAccountRef ist erforderlich.

Der Pfad zur Schlüsseldatei des Google-Dienstkontos mit der Rolle Apigee Synchronizer Manager.

synchronizer.serviceAccountRef Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

serviceAccountPath oder serviceAccountRef ist erforderlich.

synchronizer.serviceAccountSecret Einfach Eingeführt in Version: 1.1.0

Standardwert: Keiner

Der Name eines Kubernetes-Secrets. Sie müssen das Secret erstellen. Verwenden Sie dazu einen Google-Dienstkontoschlüssel mit der Rolle Apigee Synchronizer Manager als Eingabe.

synchronizer.targetCPUUtilizationPercentage Erweitert Eingeführt in Version: 1.0.0

Standardwert: 75

CPU-Zielauslastung für den Synchronizer-Prozess auf dem Pod. Der Wert dieses Felds bietet dem Synchronizer die Möglichkeit zum Autoscaling, wenn die CPU-Auslastung diesen Wert erreicht (bis zu replicaCountMax).

synchronizer.terminationGracePeriodSeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 30

Die maximale Zeit zwischen einer Anfrage zum Löschen eines Pods und dem Beenden des Pods in Sekunden. Während dieses Zeitraums werden etwaige Prestop-Hooks ausgeführt und alle laufenden Prozesse sollten ordnungsgemäß beendet werden. Der Pod wird beendet, wenn alle laufenden Prozesse abgeschlossen sind oder am Ende des Kulanzzeitraums, je nachdem, was zuerst eintritt. Wenn keine Prozesse ausgeführt werden, wird der Pod sofort beendet.

synchronizer.tolerations.effect Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

effect gibt die Auswirkung an, die eine Übereinstimmung einer Toleranz mit einer Markierung hat. effect kann folgende Werte haben:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

synchronizer.tolerations.key Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

key identifiziert Pods, auf die die Toleranz angewendet werden kann.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

synchronizer.tolerations.operator Erweitert Eingeführt in Version: 1.10.1

Standardwert: "Equal"

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

operator gibt den Vorgang an, der zum Auslösen von effect verwendet wird. operator kann folgende Werte haben:

  • Equal: Entspricht dem in value festgelegten Wert.
  • Exists: Ignoriert den in value festgelegten Wert.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

synchronizer.tolerations.tolerationSeconds Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

tolerationSeconds definiert in Sekunden, wie lange ein Pod an einen fehlerhaften oder nicht reagierenden Knoten gebunden ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

synchronizer.tolerations.value Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

value ist der Wert, der effect auslöst, wenn operator auf Equal gesetzt ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

udca

(Universal Data Collection Agent) Definiert den Dienst, der im Datenerfassungs-Pod auf der Laufzeitebene ausgeführt wird. Dieser Dienst extrahiert Analyse- und Bereitstellungsstatusdaten und sendet sie an die Unified Analytics Platform (UAP).

Weitere Informationen finden Sie unter Debugging-, Analyse- und Bereitstellungsstatusdaten erheben.

In der folgenden Tabelle werden die Attribute des Objekts udca beschrieben:

Attribut Typ Beschreibung
udca.annotations Erweitert Eingeführt in Version: 1.5.0

Standardwert: Keiner

Optionale Schlüssel/Wert-Zuordnung, die zum Annotieren von Pods verwendet wird. Weitere Informationen finden Sie unter Benutzerdefinierte Annotationen.

udca.fluentd.image.pullPolicy Erweitert Eingeführt in Version: 1.0.0

Standardwert: IfNotPresent

Legt fest, wann kubelet das Docker-Image des Pods abruft. Mögliche Werte:

  • IfNotPresent: Kein neues Image abrufen, wenn es bereits vorhanden ist.
  • Always: Image immer abrufen, unabhängig davon, ob es bereits vorhanden ist.

Weitere Informationen finden Sie unter Updating images.

udca.fluentd.image.tag Erweitert Eingeführt in Version: 1.0.0

Standardwert: 1.14.3

Das Versionslabel für das Docker-Image dieses Dienstes.

udca.fluentd.image.url Erweitert Eingeführt in Version: 1.0.0

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

Der Speicherort des Docker-Image für diesen Dienst.

udca.fluentd.resources.limits.cpu Erweitert Eingeführt in Version: 1.11.0

Standardwert: 1000m

Das Arbeitsspeicherlimit für die Ressource in einem Kubernetes-Container in Mebibyte.

udca.fluentd.resources.limits.memory Erweitert Eingeführt in Version: 1.11.0

Standardwert: 500Mi

Das Arbeitsspeicherlimit für die Ressource in einem Kubernetes-Container in Mebibyte.

udca.fluentd.resources.requests.cpu Erweitert Eingeführt in Version: 1.0.0

Standardwert: 500m

Die CPU in Millicore, die für den normalen Betrieb der Ressource in einem Kubernetes-Container erforderlich ist.

udca.fluentd.resources.requests.memory Erweitert Eingeführt in Version: 1.0.0

Standardwert: 250Mi

Der Arbeitsspeicher in Mebibyte, der für den normalen Betrieb der Ressource in einem Kubernetes-Container erforderlich ist.

udca.gsa Erweitert Eingeführt in Version: 1.10.0

Standardwert: Keiner

Nur Helm: Die E‑Mail-Adresse des Google IAM-Dienstkontos (GSA) für apigee-udca, das beim Aktivieren von Workload Identity in GKE-Clustern mithilfe von Helm-Diagrammen mit dem entsprechenden Kubernetes-Dienstkonto verknüpft werden soll. Legen Sie dies fest, wenn Sie für gcp.workloadIdentity.enabled den Wert true festgelegt haben.

GSA-E‑Mail-Adressen haben normalerweise folgendes Format:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Beispiel:

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

Weitere Informationen finden Sie unter Workload Identity in GKE aktivieren oder Identitätsföderation von Arbeitslasten in AKS und EKS aktivieren.

udca.image.pullPolicy Erweitert Eingeführt in Version: 1.0.0

Standardwert: IfNotPresent

Legt fest, wann kubelet das Docker-Image des Pods abruft. Mögliche Werte:

  • IfNotPresent: Kein neues Image abrufen, wenn es bereits vorhanden ist.
  • Always: Image immer abrufen, unabhängig davon, ob es bereits vorhanden ist.

Weitere Informationen finden Sie unter Updating images.

udca.image.tag Erweitert Eingeführt in Version: 1.0.0

Standardwert: 1.14.3

Das Versionslabel für das Docker-Image dieses Dienstes.

udca.image.url Erweitert Eingeführt in Version: 1.0.0

Standardwert: Keiner

Der Speicherort des Docker-Image für diesen Dienst.

Mit apigee-pull-push --list können Sie die aktuelle Repository-URL für diese Komponente aufrufen.

udca.jvmXms Erweitert Eingeführt in Version: 1.0.0

Deprecated: Ab Hybrid-Version 1.8 wird udca.jvmXms nicht mehr verwendet.

udca.jvmXmx Erweitert Eingeführt in Version: 1.0.0

Deprecated: Ab Hybrid-Version 1.8 wird udca.jvmXmx nicht mehr verwendet.

udca.livenessProbe.failureThreshold Erweitert Eingeführt in Version: 1.0.0

Standardwert: 2

Die Häufigkeit, mit der Kubernetes prüft, ob Aktivitätsprüfungen fehlgeschlagen sind, bevor der Container neu gestartet wird. Der Mindestwert beträgt 1.

udca.livenessProbe.initialDelaySeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 0

Die Anzahl der Sekunden nach dem Start eines Containers, bevor eine Aktivitätsprüfung gestartet wird.

udca.livenessProbe.periodSeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 5

Bestimmt, wie oft eine Aktivitätsprüfung durchgeführt werden soll. Angabe in Sekunden. Der Mindestwert beträgt 1.

udca.livenessProbe.timeoutSeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 1

Der Zeitraum in Sekunden, nach dem eine Aktivitätsprüfung das Zeitlimit überschritten hat. Der Mindestwert beträgt 1.

udca.nodeSelector.key Einfach Eingeführt in Version: 1.0.0

Standardwert: Keiner

Erforderlich

Labelschlüssel für die Knotenauswahl, um dedizierte Kubernetes-Knoten für udca-Laufzeitdienste bereitzustellen.

Siehe Dedizierte Knotenpools konfigurieren.

udca.nodeSelector.value Einfach Eingeführt in Version: 1.0.0

Standardwert: Keiner

Erforderlich

Labelwert für die Knotenauswahl, um dedizierte Kubernetes-Knoten für udca-Laufzeitdienste bereitzustellen.

Siehe Dedizierte Knotenpools konfigurieren.

udca.pollingIntervalInSec Erweitert Eingeführt in Version: 1.0.0

Standardwert: 1

Die Zeitspanne in Sekunden, die der UDCA zwischen Abfragevorgängen wartet. Der UDCA fragt im Dateisystem des Datenerfassungs-Pods das Datenverzeichnis ab, um neue Dateien zum Hochladen zu erkennen.

udca.replicaCountMax Einfach Eingeführt in Version: 1.0.0

Standardwert: 4

Die maximale Anzahl von Pods, die von Hybrid für die UDCA-Bereitstellung automatisch hinzugefügt werden kann. Da der UDCA als ReplicaSet implementiert ist, sind die Pods Replikate.

Es wird empfohlen, udca.replicaCountMax auf eine maximale Anzahl von Replikaten pro Umgebung mal der Anzahl der Umgebungen in Ihrer Apigee-Organisation festzulegen. Wenn Sie beispielsweise maximal vier Replikate pro Umgebung zulassen möchten und drei Umgebungen haben, legen Sie udca.replicaCountMax: 12 fest.

udca.replicaCountMin Einfach Eingeführt in Version: 1.0.0

Standardwert: 1

Die Mindestanzahl von Pods für die UDCA-Bereitstellung. Da der UDCA als ReplicaSet implementiert ist, sind die Pods Replikate.

Wenn die CPU-Auslastung höher als udca.targetCPUUtilizationPercentage ist, erhöht Hybrid die Anzahl der Pods schrittweise bis zu udca.replicaCountMax.

udca.resources.limits.cpu Erweitert Eingeführt in Version: 1.11.0

Standardwert: 1000m

Das Arbeitsspeicherlimit für die Ressource in einem Kubernetes-Container in Mebibyte.

udca.resources.limits.memory Erweitert Eingeführt in Version: 1.11.0

Standardwert: 2Gi

Das Arbeitsspeicherlimit für die Ressource in einem Kubernetes-Container in Mebibyte.

udca.resources.requests.cpu Erweitert Eingeführt in Version: 1.0.0

Standardwert: 250m

Die CPU in Millicore, die für den normalen Betrieb der Ressource in einem Kubernetes-Container erforderlich ist.

udca.resources.requests.memory Erweitert Eingeführt in Version: 1.0.0

Standardwert: 250Mi

Der Arbeitsspeicher in Mebibyte, der für den normalen Betrieb der Ressource in einem Kubernetes-Container erforderlich ist.

udca.revision Erweitert Eingeführt in Version: 1.0.0

Standardwert: v1

Ein statischer Wert, der in einem Label eingegeben wird, um Canary-Bereitstellungen zu aktivieren.

udca.serviceAccountPath Einfach Eingeführt in Version: 1.0.0

Standardwert: Keiner

serviceAccountPath oder serviceAccountRef ist erforderlich.

Pfad zur Schlüsseldatei des Google-Dienstkontos mit der Rolle Apigee Analytics Agent.

udca.serviceAccountRef Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

serviceAccountPath oder serviceAccountRef ist erforderlich.

udca.targetCPUUtilizationPercentage Erweitert Eingeführt in Version: 1.0.0

Standardwert: 75

Der Schwellenwert der CPU-Auslastung zur Skalierung der Anzahl der Pods im ReplicaSet als Prozentsatz der insgesamt verfügbaren CPU-Ressourcen. Hybrid nutzt die kombinierte Auslastung aller Container im Datenerfassungs-Pod (sowohl fluentd als auch UDCA), um die aktuelle Auslastung zu berechnen.

Wenn die CPU-Auslastung diesen Wert überschreitet, erhöht Hybrid die Anzahl der Pods im ReplicaSet bis zu udca.replicaCountMax.

udca.terminationGracePeriodSeconds Erweitert Eingeführt in Version: 1.0.0

Standardwert: 600

Die maximale Zeit zwischen einer Anfrage zum Löschen eines Pods und dem Beenden des Pods in Sekunden. Während dieses Zeitraums werden etwaige Prestop-Hooks ausgeführt und alle laufenden Prozesse sollten ordnungsgemäß beendet werden. Der Pod wird beendet, wenn alle laufenden Prozesse abgeschlossen sind oder am Ende des Kulanzzeitraums, je nachdem, was zuerst eintritt. Wenn keine Prozesse ausgeführt werden, wird der Pod sofort beendet.

udca.tolerations.effect Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

effect gibt die Auswirkung an, die eine Übereinstimmung einer Toleranz mit einer Markierung hat. effect kann folgende Werte haben:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

udca.tolerations.key Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

key identifiziert Pods, auf die die Toleranz angewendet werden kann.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

udca.tolerations.operator Erweitert Eingeführt in Version: 1.10.1

Standardwert: "Equal"

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

operator gibt den Vorgang an, der zum Auslösen von effect verwendet wird. operator kann folgende Werte haben:

  • Equal: Entspricht dem in value festgelegten Wert.
  • Exists: Ignoriert den in value festgelegten Wert.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

udca.tolerations.tolerationSeconds Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

tolerationSeconds definiert in Sekunden, wie lange ein Pod an einen fehlerhaften oder nicht reagierenden Knoten gebunden ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

udca.tolerations.value Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

value ist der Wert, der effect auslöst, wenn operator auf Equal gesetzt ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

virtualhosts

Das Attribut virtualhosts ist ein erforderliches Konfigurationsattribut. Mit virtuellen Hosts kann Apigee Hybrid API-Anfragen an eine angegebene Umgebungsgruppe verarbeiten.

Weitere Informationen finden Sie unter Virtuelle Hosts konfigurieren.

In der folgenden Tabelle werden die Attribute des Objekts virtualhosts beschrieben:

Attribut Typ Beschreibung
virtualhosts[].additionalGateways Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

Eine Liste der Istio-Gateways, an die Traffic weitergeleitet werden soll.

virtualhosts[].cipherSuites[] Erweitert Eingeführt in Version: 1.9.2

Standardwert: Keiner

Mit diesem Attribut werden die im Ingress-Gateway verwendeten TLS-Chiffren konfiguriert. Unten finden Sie eine Liste der standardmäßig aktivierten Chiffren im OpenSSL-Format. Weitere Informationen zu den unterstützten Chiffren finden Sie in der Dokumentation zum Boring FIPS-Build von Envoy. Ein leerer Wert verwendet standardmäßig die Cipher Suites, die vom Boring FIPS-Build von Envoy unterstützt werden.

Standardmäßig für TLS v.1.3 aktiviert (Cipher Suites für TLS 1.3 können nicht überschrieben werden):

  • TLS_AES_128_GCM_SHA256
  • TLS_AES_256_GCM_SHA384
  • TLS_CHACHA20_POLY1305_SHA256

Standardmäßig für TLS v.1.2 aktiviert:

  • ECDHE-ECDSA-AES128-GCM-SHA256
  • ECDHE-RSA-AES128-GCM-SHA256
  • ECDHE-ECDSA-AES256-GCM-SHA384
  • ECDHE-RSA-AES256-GCM-SHA384

Wenn Sie ältere TLS-Versionen in Ihrer Apigee Ingress-Gateway-Bereitstellung aktivieren möchten, verwenden Sie virtualhosts.minTLSProtocolVersion zusammen mit dem Attribut virtualhosts.cipherSuites.

So aktivieren Sie beispielsweise 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 Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

Erforderlich

Der Name des virtuellen Hosts.

virtualhosts[].maxTLSProtocolVersion Einfach Eingeführt in Version: 1.3.0

Standardwert: Keiner

Die maximale Version des TLS-Protokolls, die Envoy auswählen kann. Envoy verwendet automatisch die optimale TLS-Protokollversion zwischen virtualhosts[].minTLSProtocolVersion und virtualhosts[].maxTLSProtocolVersion.

Der Wert muss eine Zahl sein. Beispiel:

virtualhosts:
  - name: default
    maxTLSProtocolVersion: "1.3"

Die Nummer steht für die TLS-Versionsnummer im Format #.#. Im obigen Beispiel stellt "1.3" die Istio-TLS-Version TLSV1_3 dar.

Siehe auch ServerTLSSettings.TLSProtocol in der Istio-Dokumentation.

virtualhosts[].minTLSProtocolVersion Einfach Eingeführt in Version: 1.3.0

Standardwert: Keiner

Die Mindestversion des TLS-Protokolls, die Envoy auswählen kann. Envoy verwendet automatisch die optimale TLS-Protokollversion zwischen virtualhosts[].minTLSProtocolVersion und virtualhosts[].maxTLSProtocolVersion.

Der Wert muss eine Zahl sein. Beispiel:

virtualhosts:
  - name: default
    minTLSProtocolVersion: "1.2"

Die Nummer steht für die TLS-Versionsnummer im Format #.#. Im obigen Beispiel stellt 1.2 die Istio-TLS-Version TLSV1_2 dar.

Siehe auch ServerTLSSettings.TLSProtocol in der Istio-Dokumentation.

virtualhosts[].selector Einfach Eingeführt in Version: 1.2.0

Standardwert: app: apigee-ingressgateway

Erforderlich

Ein Schlüssel/Wert-Selektor/Wert-Paar, das auf verschiedene Selectors für eingehenden Traffic verweist.

  • apigee-ingressgateway: Für Apigee Hybrid-Installationen mit dem Apigee Ingress-Gateway.
  • istio-ingressgateway: Für Apigee Hybrid-Installationen mit Cloud Service Mesh (Apigee Hybrid-Version 1.8 und früher).

Wenn kein Selectorlabel angegeben ist, wird die Konfiguration an das Apigee Ingress-Gateway gesendet.

virtualhosts[].sslCertPath Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

sslCertPath/sslKeyPath oder sslSecret ist erforderlich.

Der Pfad in Ihrem System zu einer TLS-Zertifikatsdatei.

virtualhosts[].sslKeyPath Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

sslCertPath/sslKeyPath oder sslSecret ist erforderlich.

Der Pfad in Ihrem System zur privaten TLS-Schlüsseldatei.

virtualhosts[].sslSecret Einfach Eingeführt in Version: 1.2.0

Standardwert: Keiner

sslCertPath/sslKeyPath oder sslSecret ist erforderlich.

Der Name der Datei, die in einem Kubernetes-Secret gespeichert ist und die Cassandra-Nutzer und ‑Passwörter enthält. Eine Anleitung zum Erstellen des Secrets finden Sie unter Secret erstellen.

Siehe auch:

watcher

Das Attribut watcher ist ein erforderliches Konfigurationsattribut. Der Watcher ist ein Prozess, der nach Konfigurationsänderungen sucht und deren Anwendung auf die Laufzeitebene auslöst.

In der folgenden Tabelle werden die Attribute des Objekts watcher beschrieben:

Attribut Typ Beschreibung
watcher.annotations Erweitert Eingeführt in Version: 1.5.0

Standardwert: Keiner

Optionale Schlüssel/Wert-Zuordnung, die zum Annotieren von Pods verwendet wird. Weitere Informationen finden Sie unter Benutzerdefinierte Annotationen.

watcher.args.enableIssueScanning Erweitert Eingeführt in Version: 1.10.0

Standardwert: true

Aktiviert oder deaktiviert die automatische Problemsuche. Bei true scannt der Watcher automatisch die Steuerungsebene und den Kubernetes API-Serverstatus, um festzustellen, ob Konfigurationsprobleme vorliegen.

Legen Sie false fest, um die automatische Problemsuche zu deaktivieren. Weitere Informationen finden Sie unter Automatische Problemsuche.

watcher.args.enableLeaderElect Erweitert Eingeführt in Version: 1.13.0

Standardwert: true

Wenn watcher.args.enableLeaderElect auf true (Standard) gesetzt ist, wird ein einzelner Watcher-Pod ausgewählt, um die Routinginformationen zu verwalten und zu melden. Die Beschränkung auf einen einzelnen Pod ist erforderlich, um Ausfallzeiten während Upgrades oder Rollbacks zu vermeiden. Während dieser Ereignisse können mehrere Watcher-Versionen gleichzeitig ausgeführt werden. Jede Watcher-Instanz kann eine andere Logik für die Routenerstellung haben, was zu Ausfallzeiten führen kann.watcher.replicaCountMax

watcher.args.issueScanInterval Erweitert Eingeführt in Version: 1.10.0

Standardwert: 60

Das Intervall in Sekunden, mit dem der Watcher die Laufzeitebene bei der automatischen Problemsuche scannt. Weitere Informationen finden Sie unter Automatische Problemsuche.

watcher.gsa Erweitert Eingeführt in Version: 1.10.0

Standardwert: Keiner

Nur Helm: Die E‑Mail-Adresse des Google IAM-Dienstkontos (GSA) für apigee-watcher, das beim Aktivieren von Workload Identity in GKE-Clustern mithilfe von Helm-Diagrammen mit dem entsprechenden Kubernetes-Dienstkonto verknüpft werden soll. Legen Sie dies fest, wenn Sie für gcp.workloadIdentity.enabled den Wert true festgelegt haben.

GSA-E‑Mail-Adressen haben normalerweise folgendes Format:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Beispiel:

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

Weitere Informationen finden Sie unter Workload Identity in GKE aktivieren oder Identitätsföderation von Arbeitslasten in AKS und EKS aktivieren.

watcher.image.pullPolicy Erweitert Eingeführt in Version: 1.4.0

Standardwert: IfNotPresent

Legt fest, wann kubelet das Docker-Image des Pods abruft. Mögliche Werte:

  • IfNotPresent: Kein neues Image abrufen, wenn es bereits vorhanden ist.
  • Always: Image immer abrufen, unabhängig davon, ob es bereits vorhanden ist.

Weitere Informationen finden Sie unter Updating images.

watcher.image.tag Erweitert Eingeführt in Version: 1.4.0

Standardwert: 1.14.3

Das Versionslabel für das Docker-Image dieses Dienstes.

watcher.image.url Erweitert Eingeführt in Version: 1.4.0

Standardwert: Keiner

Der Speicherort des Docker-Image für diesen Dienst.

Mit apigee-pull-push --list können Sie die aktuelle Repository-URL für diese Komponente aufrufen.

watcher.replicaCountMax Einfach Eingeführt in Version: 1.3.0

Standardwert: 1

Die maximale Anzahl an Watcher-Replikaten. Die Zahl sollte auf 1 belassen werden, um Konflikte zu vermeiden.

Apigee Hybrid verwendet einen Watcher-Pod pro Installation. Bei der Leader-Auswahl wird automatisch ein Watcher-Pod ausgewählt. Zusätzliche Watcher-Pod-Replikate werden in einen instabilen Zustand gezwungen. Weitere Informationen finden Sie unter watcher.args.enableLeaderElect.

watcher.replicaCountMin Einfach Eingeführt in Version: 1.3.0

Standardwert: 1

Die Mindestanzahl an Watcher-Replikaten.

watcher.resources.limits.cpu Erweitert Eingeführt in Version: 1.11.0

Standardwert: 1000m

Das CPU-Limit für die Ressource in einem Kubernetes-Container in Millicore.

watcher.resources.limits.memory Erweitert Eingeführt in Version: 1.11.0

Standardwert: 2Gi

Das Arbeitsspeicherlimit für die Ressource in einem Kubernetes-Container in Mebibyte.

watcher.serviceAccountPath Einfach Eingeführt in Version: 1.3.0

Standardwert: Keiner

Erforderlich.

Der Pfad zur Schlüsseldatei des Google-Dienstkontos mit der Rolle Apigee Runtime Agent.

watcher.serviceAccountRef Erweitert Eingeführt in Version: 1.3.0

Standardwert: Keiner

serviceAccountPath oder serviceAccountRef ist erforderlich.

watcher.tolerations.effect Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

effect gibt die Auswirkung an, die eine Übereinstimmung einer Toleranz mit einer Markierung hat. effect kann folgende Werte haben:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

watcher.tolerations.key Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

key identifiziert Pods, auf die die Toleranz angewendet werden kann.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

watcher.tolerations.operator Erweitert Eingeführt in Version: 1.10.1

Standardwert: "Equal"

Erforderlich, um die Markierungs- und Toleranzfunktion von Kubernetes zu verwenden.

operator gibt den Vorgang an, der zum Auslösen von effect verwendet wird. operator kann folgende Werte haben:

  • Equal: Entspricht dem in value festgelegten Wert.
  • Exists: Ignoriert den in value festgelegten Wert.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

watcher.tolerations.tolerationSeconds Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

tolerationSeconds definiert in Sekunden, wie lange ein Pod an einen fehlerhaften oder nicht reagierenden Knoten gebunden ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.

watcher.tolerations.value Erweitert Eingeführt in Version: 1.10.1

Standardwert: Keiner

Wird von der Markierungs- und Toleranzfunktion von Kubernetes verwendet.

value ist der Wert, der effect auslöst, wenn operator auf Equal gesetzt ist.

Weitere Informationen finden Sie unter Markierungen und Toleranzen: Konzepte.