Glossar

In diesem Abschnitt werden allgemeine Begriffe beschrieben, die Sie bei der Verwendung von Apigee Hybrid kennen sollten.

Begriff Definition
App-Bild Siehe Image.
Apigee-APIs Die Endpunkte, die Sie zum Konfigurieren von Umgebungen, Organisationen, API-Proxys und anderen Hybriddiensten verwenden können. Der Zugriff erfolgt über MART.
App/Anwendung Ein hybrider Dienst, der in einen Container, auf einen Pod, in einen Knoten, in ein Cluster gepackt und bereitgestellt wurde. Auch als Container-Image, Mikrodienst, Dienst oder Containeranwendung bezeichnet. oder Docker-Image (wenn Docker der Container ist)
Cassandra

Das Edge-Laufzeitdaten-Repository, das Anwendungskonfigurationen, verteilte Kontingentzähler, API-Schlüssel und OAuth-Token für Anwendungen speichert, die auf dem Gateway ausgeführt werden.

Dies ist ein ressourcenintensiver StatefulSet und sollte sich auf einem separaten Worker-Knoten vom Nachrichtenprozessor befinden.

Weitere Informationen finden Sie unter Informationen zur Laufzeitebene.

zentrale Verwaltungsinfrastruktur (oder -"Ebene") Siehe Verwaltungsebene.
CNCF Cloud Native Computing Foundation: Sie können die hybride Laufzeit auf jeder CNCF-konformen Implementierung von Kubernetes ausführen, mit Ausnahme von OpenShift.
Konfigurationsvorlage Siehe Vorlage.
Container

In der Regel ein Container in einer Anwendung. Vom Betriebssystem und dem Dateisystem getrennt, mit eigenem Dateisystem, können nicht mit Prozessen anderer Container interagieren, in einem Pod. Docker oder rkt sind Beispiele für Container.

Der hybride Laufzeitprozessor-Container (mp) enthält jedoch sowohl den Router als auch den Nachrichtenprozessor.

Container [-isiertes] -Image Siehe Image.
Steuerungsebene Siehe Verwaltungsebene.
controller Überprüft das System und weist Ressourcen nach Bedarf neu zu.

Es gibt Planer, Deployment, Replikation, Endpunkt, Kubelet und andere Controller.

Bereitstellung Siehe App/Anwendung.
Bereitstellungsspezifikation Die vollständige Konfigurationsdatei für Ihre Laufzeitebene. Es ist die Kombination aus Standardwerten aus der Datei values.yaml und Ihren benutzerdefinierten Einstellungen in der overrides.yaml-Datei.
Umgebung Stellt einen isolierten Kontext oder eine "Sandbox" zur Ausführung von API-Proxys bereit. In einer einzelnen Organisation können mehrere Umgebungen vorhanden sein, wobei jeder Umgebung ein Istio-Ingress-Gateway-Dienst zugeordnet ist. Der gesamte Traffic von außerhalb des Clusters wird über diesen TLS-gesicherten Ingress-Endpunkt geleitet.
GCR Google Container Repository
GKE eine Containeranwendung implementiert. In einer von Google verwalteten, produktionsfertigen Umgebung zur Bereitstellung von Containeranwendungen in Kubernetes. Mit GKE können Sie Kubernetes im Handumdrehen einrichten, indem Sie die eigenen Kubernetes-Cluster nicht installieren, verwalten und betreiben müssen.
image

Ein Bild kann sich auf zwei verschiedene Status einer Anwendung und deren Abhängigkeiten beziehen:

  • App-Image ist eine Version des Quellcodes einer Anwendung sowie der zugehörigen Abhängigkeiten. Sie können z. B. ein Repository- oder Quellcode-Management-Tool wie Git oder Perforce für Ihre Version in einem Build-System verwenden, das die Abhängigkeiten der Anwendung verwaltet.

    Auf ein App-Image verweisen Sie beim Erstellen eines Deployments:

    
    kubectl run kubernetes-bootcamp --image=app_image_location
  • Container-Image: Ein App-Image plus ein Docker-Dateipaket für die Bereitstellung. Auch als Container-Image oder Docker-Image bezeichnet. Apigee Hybrid unterstützt derzeit nur Docker-Anwendungs-Images.

    So erstellen Sie ein Container-Image:

    
    app image -> [package/build utility] -> container image

    Beachten Sie, dass beim Erstellen einer Bereitstellung beim Befehl kubectl run die Option image verwendet wird. Diese Option gibt den Speicherort des Anwendungs-Images an, bevor es containerisiert wird. In den meisten Fällen bezieht sich der Begriff "Image" jedoch auf die containerisierte Anwendung: das Ergebnis des Befehls "run" oder der Ausgabe eines Anwendungs-Images, das von einem Verpackungsdienst verarbeitet wird.

Image-Repository Eine Gruppe freigegebener Container-Images.
Ingress/Ingress-Controller Eine containerisierte Anwendung, die Traffic von außerhalb des Clusters an Dienste innerhalb des Clusters weiterleitet.
KMS Key Management Service. Speichert Schlüssel und OAuth-Tokens zum Ver- und Entschlüsseln von Traffic. Edge KMS verwaltet Schlüssel für Anwendungen, Entwickler und API-Produkte.
KVM Schlüssel/Wert-Zuordnung. Eine benutzerdefinierte Sammlung von Schlüssel/Wert-String-Paaren, die verschlüsselt oder unverschlüsselt sind. Weitere Informationen finden Sie unter Mit Schlüssel/Wert-Zuordnungen arbeiten.
Kubernetes-Administrationscomputer Ihr lokaler Computer, mit dem Sie Befehle für Ihren Kubernetes-Cluster ausführen. Dieser Computer ist in der Regel ein Computer, der Zugriff auf Ihre Kubernetes-VMs hat.
Verwaltungsebene Die von Google gehosteten zentralen Dienste, die über Dienstkonten mit der Laufzeitebene kommunizieren.
MART

Die API für Laufzeitdaten interagiert mit dem lokalen Laufzeitdatenspeicher (Cassandra). Sie dient als API-Anbieter für die öffentliche Apigee API, um auf Laufzeitdaten zuzugreifen und diese zu verwalten.

MART ist eine zustandslose Anwendung wie Nachrichtenprozessoren. Es ist eine containerisierte Anwendung von Kubernetes.

Weitere Informationen finden Sie unter Informationen zur Laufzeitebene.

Master-Knoten Ein Kubernetes-Begriff für einen Knoten, der den APIserver, den Cloud-Controller-Manager (CCM), den Planer und den kube-controller-manager enthält.
Nachrichtenprozessor (MP)

Ein Nachrichtenprozessor verarbeitet die API-Laufzeitanfragen des Kunden und erzwingt Proxyrichtlinien. Auch als API-Gateway bezeichnet.

Der Nachrichtenprozessor wertet eine eingehende Anfrage aus, führt alle Apigee-Richtlinien aus und ruft die Back-End-Systeme und andere Systeme auf, um Daten abzurufen. Nach Erhalt dieser Antworten formatiert der Nachrichtenprozessor eine Antwort und gibt sie an den Client zurück.

MP ist ein Kubernetes-Deployment. Es ist für eine einzelne Edge-Umgebung konfiguriert, die auf ein Unterverzeichnis des freigegebenen Dateisystems verweist, in dem Synchronizer Daten bereitstellt.

Eine MP ist ressourcenintensiv und sollte sich auf einem separaten Worker-Knoten als Cassandra befinden.

Weitere Informationen finden Sie unter Informationen zur Laufzeitebene.

Namespace Virtuelle Cluster, die zur Aufteilung der Clusterressourcen verwendet werden. Namespaces sind für größere Cluster mit vielen Nutzern gedacht. Kleinere Cluster mit nur wenigen Nutzern benötigen in der Regel keine Namespaces.
Knoten Eine Worker-Maschine, die je nach Cluster entweder eine virtuelle Maschine oder eine physische Maschine ist. Kubernetes erstellt Knotenobjekte, aber keine Knoten selbst. Knoten werden von externen Cloud-Anbietern wie Google Compute Engine (GCE) erstellt.
Open-Source-Kubernetes Referenzimplementierung von Kubernetes Siehe Kubernetes. Die Apigee Hybridlaufzeit wird auf Open-Source-Kubernetes und auf Open-Source-Versionen von Kubernetes ausgeführt, die CNCF-konform sind.
Organisation Ein Container für alle Entitäten in einem Apigee-Konto, einschließlich API-Proxys, API-Produkten, API-Paketen, Anwendungen und Entwicklern. In diesem Dokument werden die Begriffe Apigee-Organisation oder hybridfähige Organisation synonym verwendet.

Für die Installation und Verwendung von Hybridsystemen benötigen Sie eine Apigee-Organisation, die an ein Google Cloud-Projekt gebunden ist. Dies geschieht beim Erstellen der Organisation in einer sogenannten Bereitstellung.

Eine Apigee-Organisation ist nicht mit einer GCP-Organisation identisch. Wenn es mögliche Mehrdeutigkeiten gibt, sollte in diesem Dokument angegeben sein, dass es sich bei der Organisation um eine Apigee-Organisation handelt.

Pod Ein Pod ist der grundlegende Baustein von Kubernetes: die kleinste und einfachste Einheit im erstellten Kubernetes-Objektmodell. Ein Pod stellt einen laufenden Prozess auf Ihrem Cluster dar.
proxy Außerdem API-Proxy Ein API-Proxy ist eine Abstraktionsebene, die als "Front" Ihres Back-End-Dienstes fungiert und zusätzliche Funktionen im Bereich Sicherheit, Ratenbegrenzung, Kontingente und Analysen bietet.
Replikations-Controller Plant Pods neu und übernimmt die Selbstreparatur für Pods.
resource Außerdem ist eine Kubernetes API-Ressource enthalten. Objekte, die Sie zur Verwaltung des Clusters verwenden, sowie die darin enthaltenen Container, Anwendungen und anderen Ressourcen.

API-Ressourcen umfassen Dienste für Discovery, Load-Balancing, Konfiguration und Speicher. Ein Beispiel für eine API-Ressource ist ein Ingress-Controller.

Laufzeitebene

Apigee Hybriddienste, die Sie in Ihrem eigenen Kubernetes-Cluster verwalten, sind auf der Laufzeitebene vorhanden. Diese Dienste kommunizieren über Dienstkonten mit der Verwaltungsebene.

Umfasst MART, Synchronizer, Nachrichtenprozessoren und Cassandra.

Weitere Informationen finden Sie unter Informationen zur Laufzeitebene.

Dienst

Allgemeine Bezeichnung für die Containeranwendungen, die auf Ihrem Kubernetes-Cluster auf der Laufzeitebene ausgeführt werden. Dazu gehören MART, Synchronizer, Nachrichtenprozessoren und Cassandra.

Weitere Informationen finden Sie unter Informationen zur Laufzeitebene.

Snuffleupagus Ein großes, sich langsam bewegendes wolliges Mammut, das durch eine Kinderfernsehsendung populär gemacht wurde.
Zustandsorientierter Knoten Ein Clusterknoten, der nichtflüchtigen Speicher zur Aufrechterhaltung des Zustands benötigt. Siehe Dedizierte Knotenpools konfigurieren.
Zustandsloser Knoten Einen Clusterknoten, der keinen nichtflüchtigen Speicher erfordert. Siehe Dedizierte Knotenpools konfigurieren.
Synchronizer

Ein Laufzeitebenendienst, der die Verwaltungsebene für die Bereitstellungskonfiguration und die Ereignisse für jede Umgebung abfragt. Es lädt erforderliche Metadaten zu bereitgestellten Proxys, den Proxy-Konfigurationsdateien und mehr auf die Laufzeitebene herunter.

Der Synchronizer speichert seine Informationen in einem freigegebenen Dateisystem, das vom Nachrichtenprozessor gelesen wird. Dies wird als DaemonSet-Anwendung ausgeführt. Er hat keinen Laufzeit-API-Traffic und kann Daten für mehrere Umgebungen aus einem einzigen Prozess/Kubernetes-Pod synchronisieren.

Weitere Informationen finden Sie unter Informationen zur Laufzeitebene.

vorlage

Eine YAML-Datei, die einen Dienst definiert. Die meisten Hybriddienste haben ihre eigene Vorlage. Beispiel: mp.yaml definiert den Nachrichtenprozessordienst.

Während der Installation führt der Befehl apigeectl die Vorlagen in einer einzigen Datei zusammen, die die Konfigurationsinformationen des Clusters, genannt values.yaml, enthält. Sie können einige Werte in der Datei values.yaml mit der Datei overrides.yaml überschreiben.

Die Hybridkonfigurationsvorlagen befinden sich im Verzeichnis hybrid_install_dir/templates auf der Kubernetes-Verwaltungsmaschine.

UDCA

Der Universal Data Collection Agent ist ein Dienst, der im Datensammlungs-Pod auf der Laufzeitebene ausgeführt wird. Dabei werden Analyse-, Trace- und Bereitstellungsstatusdaten extrahiert und an die UAP gesendet.

Weitere Informationen finden Sie unter Erfassung von Trace-, Analyse- und Bereitstellungsstatusdaten.

UAP

Einheitliche Analyseplattform: Ein Apigee-Dienst auf der Verwaltungsebene, der eingehende Analyse-, Trace- und Bereitstellungsstatusdaten verarbeitet und Ihnen diese über die Apigee Hybrid-Benutzeroberfläche oder die Apigee APIs zur Verfügung stellt.

Weitere Informationen finden Sie unter Erfassung von Trace-, Analyse- und Bereitstellungsstatusdaten.

Volume Freigegebener Speicher, der von allen containerisierten Anwendungen in einem Pod verwendet werden kann.