In dieser Anleitung wird erklärt, wie Sie eine Beispiel-API und den Extensible Service Proxy (ESP) zur Ausführung in vordefinierten Docker-Containern in Compute Engine konfigurieren und bereitstellen. Die REST API des Beispielcodes wird mit der OpenAPI-Spezifikation beschrieben. Sie erfahren außerdem, wie Sie einen API-Schlüssel erstellen und in Anfragen an die API verwenden.
Eine Übersicht über Cloud Endpoints finden Sie in den Abschnitten Über Cloud Endpoints und Endpoints-Architektur.
Lernziele
Orientieren Sie sich beim Durcharbeiten der Anleitung an der folgenden Aufgabenliste. Alle Aufgaben sind erforderlich, um Anfragen sicher an die API senden zu können.
- Richten Sie ein Google Cloud-Projekt ein. Siehe Vorbereitung.
- Compute Engine-VM-Instanz erstellen: Siehe Compute Engine-Instanz erstellen.
- Beispielcode herunterladen: Siehe Beispielcode abrufen.
- Konfigurieren Sie die Datei
openapi.yaml
, mit der Endpoints konfiguriert wird. Siehe Endpoints konfigurieren. - Die Endpoints-Konfiguration bereitstellen, um einen Endpoints-Dienst zu erstellen: Siehe Endpoints-Konfiguration bereitstellen.
- Stellen Sie die API und den ESP auf der Compute Engine-VM bereit. Siehe API-Backend bereitstellen.
- Über eine IP-Adresse eine Anfrage an die API senden: Siehe Anfrage über eine IP-Adresse senden.
- Konfigurieren Sie einen DNS-Eintrag für die Beispiel-API. Siehe DNS für Endpoints konfigurieren.
- Unter Verwendung des vollständig qualifizierten Domainnamens eine Anfrage an die API senden: Siehe Anfrage über FQDN senden.
- API-Aktivitäten verfolgen: Siehe API-Aktivitäten verfolgen.
- Vermeiden Sie Gebühren, die Ihrem Google Cloud-Konto in Rechnung gestellt werden. Siehe Bereinigen.
Kosten
In diesem Dokument verwenden Sie die folgenden kostenpflichtigen Komponenten von Google Cloud:
Mit dem Preisrechner können Sie eine Kostenschätzung für Ihre voraussichtliche Nutzung vornehmen.
Nach Abschluss der in diesem Dokument beschriebenen Aufgaben können Sie weitere Kosten vermeiden, indem Sie die erstellten Ressourcen löschen. Weitere Informationen finden Sie unter Bereinigen.
Hinweise
- Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
-
Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
- Notieren Sie sich die Projekt-ID, da sie später benötigt wird.
-
Sie benötigen eine Anwendung, um Anfragen an die Beispiel-API zu senden.
- Nutzer von Linux und macOS: Diese Anleitung enthält ein Beispiel, bei dem
curl
verwendet wird. Das Tool ist normalerweise auf Ihrem Betriebssystem vorinstalliert. Wenncurl
nicht installiert ist, können Sie es von der Seite Releases und Downloads fürcurl
herunterladen. - Nutzer von Windows: Diese Anleitung enthält ein Beispiel, bei dem
Invoke-WebRequest
verwendet wird. Der Befehl wird in PowerShell ab Version 3.0 unterstützt.
- Nutzer von Linux und macOS: Diese Anleitung enthält ein Beispiel, bei dem
- Laden Sie die Google Cloud CLI herunter.
-
Aktualisieren Sie die gcloud CLI und installieren Sie die Endpoints-Komponenten.
gcloud components update
-
Die Google Cloud CLI (
gcloud
) muss berechtigt sein, auf Ihre Daten und Dienste in Google Cloud zuzugreifen:gcloud auth login
Ein neuer Browsertab wird geöffnet. Wählen Sie dort ein Konto aus. -
Legen Sie für das Standardprojekt Ihre Projekt-ID fest:
gcloud config set project YOUR_PROJECT_ID
Ersetzen Sie YOUR_PROJECT_ID durch Ihre Projekt-ID. Wenn Sie weitere Google Cloud-Projekte mit
gcloud
verwalten möchten, lesen Sie gcloud CLI-Konfigurationen verwalten.
Nach Abschluss der in diesem Dokument beschriebenen Aufgaben können Sie weitere Kosten vermeiden, indem Sie die erstellten Ressourcen löschen. Weitere Informationen finden Sie unter Bereinigen.
Compute Engine-Instanz erstellen
- Rufen Sie in der Google Cloud Console die Seite Instanz erstellen auf.
- Wählen Sie im Bereich Firewall die Option HTTP-Traffic zulassen und HTTPS-Traffic zulassen.
- Klicken Sie auf Erstellen, um die VM zu erstellen.
- Bestätigen Sie, dass Sie eine Verbindung zu Ihrer VM-Instanz herstellen können.
- Klicken Sie in der Liste der VM-Instanzen in der Zeile der Instanz, zu der Sie eine Verbindung herstellen möchten, auf SSH.
- Sie können jetzt über das Terminal Linux-Befehle auf Ihrer Debian-Instanz ausführen.
- Geben Sie
exit
ein, um die Verbindung zur Instanz zu trennen.
- Notieren Sie den Instanznamen, die Zone und die externe IP-Adresse, da sie später benötigt werden.
So erstellen Sie eine Compute Engine-Instanz:
Warten Sie, bis die Instanz gestartet ist. Anschließend wird sie auf der Seite der VM-Instanzen mit einem grünen Statussymbol angezeigt.
Beispielcode herunterladen
Laden Sie den Beispielcode auf Ihren lokalen Rechner herunter.
So klonen Sie die Beispiel-API oder laden diese herunter:
- Klonen Sie das Repository der Beispiel-App auf Ihren lokalen Computer:
git clone https://github.com/GoogleCloudPlatform/java-docs-samples
Sie können auch das Beispiel als ZIP-Datei herunterladen und entpacken.
- Wechseln Sie in das Verzeichnis, das den Beispielcode enthält:
cd java-docs-samples/endpoints/getting-started
So klonen Sie die Beispiel-API oder laden diese herunter:
- Klonen Sie das Repository der Beispiel-App auf Ihren lokalen Computer:
git clone https://github.com/GoogleCloudPlatform/python-docs-samples
Sie können auch das Beispiel als ZIP-Datei herunterladen und entpacken.
- Wechseln Sie in das Verzeichnis, das den Beispielcode enthält:
cd python-docs-samples/endpoints/getting-started
So klonen Sie die Beispiel-API oder laden diese herunter:
- Prüfen Sie, ob die Umgebungsvariable
GOPATH
festgelegt ist. - Klonen Sie das Repository der Beispiel-App auf Ihren lokalen Computer:
go get -d github.com/GoogleCloudPlatform/golang-samples/endpoints/getting-started
- Wechseln Sie in das Verzeichnis, das den Beispielcode enthält:
cd $GOPATH/src/github.com/GoogleCloudPlatform/golang-samples/endpoints/getting-started
So klonen Sie die Beispiel-API oder laden diese herunter:
- Klonen Sie das Repository der Beispiel-App auf Ihren lokalen Computer:
git clone https://github.com/GoogleCloudPlatform/php-docs-samples
Sie können auch das Beispiel als ZIP-Datei herunterladen und entpacken.
- Wechseln Sie in das Verzeichnis, das den Beispielcode enthält:
cd php-docs-samples/endpoints/getting-started
So klonen Sie die Beispiel-API oder laden diese herunter:
- Klonen Sie das Repository der Beispiel-App auf Ihren lokalen Computer:
git clone https://github.com/GoogleCloudPlatform/ruby-docs-samples
Sie können auch das Beispiel als ZIP-Datei herunterladen und entpacken.
- Wechseln Sie in das Verzeichnis, das den Beispielcode enthält:
cd ruby-docs-samples/endpoints/getting-started
So klonen Sie die Beispiel-API oder laden diese herunter:
- Klonen Sie das Repository der Beispiel-App auf Ihren lokalen Computer:
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples
Sie können auch das Beispiel als ZIP-Datei herunterladen und entpacken.
- Wechseln Sie zu dem Verzeichnis, das den Beispielcode enthält:
cd nodejs-docs-samples/endpoints/getting-started
Endpoints konfigurieren
Der Beispielcode enthält die OpenAPI-Konfigurationsdatei openapi.yaml
, die auf der OpenAPI-Spezifikation Version 2.0 beruht.
Konfigurieren Sie die Datei openapi.yaml
und stellen Sie sie auf Ihrem lokalen Rechner bereit.
So konfigurieren Sie Endpoints:
- Öffnen Sie im Verzeichnis mit dem Beispielcode die Konfigurationsdatei
openapi.yaml
.Java Python Go PHP Ruby NodeJS Wichtige Hinweise:
- Im Konfigurationsbeispiel sind die Zeilen in der Nähe des Feldes
host
zu sehen, die Sie ändern müssen. Zum Bereitstellen der Dateiopenapi.yaml
für Endpoints ist das vollständige OpenAPI-Dokument erforderlich. - Die Beispieldatei
openapi.yaml
enthält einen Abschnitt zum Konfigurieren der Authentifizierung, der für diese Anleitung nicht benötigt wird. Die Zeilen mit YOUR-SERVICE-ACCOUNT-EMAIL und YOUR-CLIENT-ID müssen Sie nicht konfigurieren. - OpenAPI ist eine sprachunabhängige Spezifikation. Die Datei
openapi.yaml
für das Beispielgetting-started
ist im GitHub-Repository aller Sprachen die gleiche.
- Im Konfigurationsbeispiel sind die Zeilen in der Nähe des Feldes
- Ersetzen Sie im Feld
host
den Text durch den Namen des Endpoints-Dienstes, der das folgende Format haben sollte:host: "echo-api.endpoints.YOUR_PROJECT_ID.cloud.goog"
Ersetzen Sie YOUR_PROJECT_ID durch Ihre Google Cloud-Projekt-ID. Beispiel:
host: "echo-api.endpoints.example-project-12345.cloud.goog"
echo-api.endpoints.YOUR_PROJECT_ID.cloud.goog
ist der Name des Endpoints-Diensts. Sie verwenden nicht den vollständig qualifizierten Domainnamen (FQDN) zum Senden von Anfragen an die API.
Informationen zu den Feldern im OpenAPI-Dokument, die für Endpoints erforderlich sind, finden Sie unter Endpoints konfigurieren.
Wenn Sie die folgenden Konfigurationsschritte durchgeführt haben und Anfragen erfolgreich über eine IP-Adresse an die Beispiel-API senden können, erfahren Sie unter DNS für Endpoints konfigurieren, wie echo-api.endpoints.YOUR_PROJECT_ID.cloud.goog
als FQDN konfiguriert wird.
Endpoints-Konfiguration bereitstellen
Die Endpoints-Konfiguration wird mit dem Befehl gcloud endpoints
services deploy
bereitgestellt. Dieser Befehl erstellt mithilfe von Service Management einen verwalteten Dienst.
So stellen Sie die Endpoints-Konfiguration bereit:
- Sie müssen sich im Verzeichnis
endpoints/getting-started
befinden. - Laden Sie die Konfiguration hoch und erstellen Sie einen verwalteten Dienst:
gcloud endpoints services deploy openapi.yaml
Der Befehl gcloud
ruft dann die Service Management API auf, um einen verwalteten Dienst mit dem Namen zu erstellen, den Sie im Feld host
der Datei openapi.yaml
angegeben haben.
In der Service Management API wird der Dienst gemäß den Einstellungen in der Datei openapi.yaml
konfiguriert. Wenn Sie Änderungen an openapi.yaml
openapi.yaml vornehmen, müssen Sie die Datei noch einmal bereitstellen, um den Endpoints-Dienst zu aktualisieren.
Beim Erstellen und Konfigurieren des Dienstes gibt Service Management Informationen an das Terminal aus. Warnungen mit dem Hinweis, dass für die Pfade in der Datei openapi.yaml
kein API-Schlüssel erforderlich ist, können Sie ignorieren.
Nach Abschluss der Dienstkonfiguration wird von Service Management eine Meldung mit der Dienstkonfigurations-ID und dem Dienstnamen angezeigt, die etwa so aussieht:
Service Configuration [2017-02-13r0] uploaded for service [echo-api.endpoints.example-project-12345.cloud.goog]
Im vorherigen Beispiel ist 2017-02-13r0
die Dienstkonfigurations-ID und echo-api.endpoints.example-project-12345.cloud.goog
der Name des Endpoints-Dienstes. Die Dienstkonfigurations-ID besteht aus einem Datumsstempel und einer Überarbeitungsnummer. Wenn Sie die Datei openapi.yaml
am selben Tag noch einmal bereitstellen, erhöht sich die Überarbeitungsnummer in der Dienstkonfigurations-ID. Sie können die Konfiguration des Endpoints-Dienstes in der Google Cloud Console auf der Seite Endpunkte > Dienste ansehen.
Wenn Sie eine Fehlermeldung erhalten, lesen Sie Fehlerbehebung bei der Endpoints-Konfigurationsbereitstellung.
Erforderliche Dienste prüfen
Für Endpoints und den ESP müssen mindestens die folgenden Google-Dienste aktiviert sein:Name | Titel |
---|---|
servicemanagement.googleapis.com |
Service Management API |
servicecontrol.googleapis.com |
Service Control API |
endpoints.googleapis.com |
Google Cloud Endpoints |
In der Regel werden die erforderlichen Dienste mit dem Befehl gcloud endpoints services deploy
aktiviert. Unter folgenden Umständen kann es vorkommen, dass der Befehl gcloud
erfolgreich ausgeführt wird, die erforderlichen Dienste jedoch nicht aktiviert werden:
Wenn Sie eine Drittanbieteranwendung wie Terraform verwendet haben und Sie diese Dienste nicht hinzufügen.
Wenn Sie die Endpoints-Konfiguration für ein vorhandenes Google Cloud-Projekt bereitgestellt haben, in dem diese Dienste explizit deaktiviert wurden.
Prüfen Sie mit dem folgenden Befehl, ob die erforderlichen Dienste aktiviert sind:
gcloud services list
Wenn die erforderlichen Dienste nicht aufgeführt sind, müssen Sie sie aktivieren:
gcloud services enable servicemanagement.googleapis.comgcloud services enable servicecontrol.googleapis.com
gcloud services enable endpoints.googleapis.com
Aktivieren Sie auch Ihren Endpoints-Dienst:
gcloud services enable ENDPOINTS_SERVICE_NAME
Zum Ermitteln des ENDPOINTS_SERVICE_NAME haben Sie folgende Möglichkeiten:
Rufen Sie nach der Bereitstellung der Endpoints-Konfiguration die Seite Endpunkte in der Cloud Console auf. Die Liste der möglichen ENDPOINTS_SERVICE_NAME wird in der Spalte Dienstname angezeigt.
Bei OpenAPI ist ENDPOINTS_SERVICE_NAME der Wert, den Sie im Feld
host
Ihrer OpenAPI-Spezifikation angegeben haben. Bei gRPC ist der ENDPOINTS_SERVICE_NAME das, was Sie im Feldname
Ihrer gRPC-Endpoints-Konfiguration angegeben haben.
Weitere Informationen zu den gcloud
-Befehlen finden Sie unter gcloud
-Dienste.
API-Backend bereitstellen
Bisher haben Sie zwar das OpenAPI-Dokument für Service Management bereitgestellt, den Code für das API-Back-End haben Sie jedoch noch nicht implementiert. In diesem Abschnitt erfahren Sie, wie Sie Docker für Ihre VM-Instanz einrichten und den API-Backend-Code sowie den ESP in einem Docker-Container ausführen.
Erforderliche Berechtigungen prüfen
- Rufen Sie in der Google Cloud Console die Seite „Compute Engine-Instanzen“ auf.
- Wählen Sie Ihre Instanz aus der Liste aus.
- Sie sehen das zugehörige Dienstkonto und die zugehörigen Berechtigungen.
Gewähren Sie Berechtigungen für das Dienstkonto.
gcloud projects add-iam-policy-binding PROJECT_NAME
--member "serviceAccount:SERVICE_ACCOUNT"
--role roles/servicemanagement.serviceControllerWeitere Informationen finden Sie unter Was sind Rollen und Berechtigungen?
Docker auf der VM-Instanz installieren
So installieren Sie Docker auf der VM-Instanz:
- Legen Sie mit dem folgenden Befehl die Zone für Ihr Projekt fest:
gcloud config set compute/zone YOUR_INSTANCE_ZONE
Ersetzen Sie YOUR_INSTANCE_ZONE durch die Zone, in der die Instanz ausgeführt wird.
- Stellen Sie mit dem folgenden Befehl eine Verbindung zu Ihrer Instanz her:
gcloud compute ssh INSTANCE_NAME
Ersetzen Sie INSTANCE_NAME durch den Namen Ihrer VM-Instanz.
- Richten Sie anhand der Docker-Dokumentation das Docker-Repository ein. Folgen Sie dabei den Anleitungen für die Version und Architektur Ihrer VM-Instanz:
- Jessie oder neuer
- x86_64/amd64
Beispiel-API und ESP in einem Docker-Container ausführen
Der ESP ist ein nginx
-basierter Proxy, der vor Ihrem Back-End-Code implementiert wird. Er verarbeitet eingehenden Traffic und führt die Authentifizierung, die API-Schlüsselverwaltung, das Logging und weitere Endpoints API-Verwaltungsfunktionen aus.
So installieren Sie die Beispiel-API und den ESP in einem Docker-Container oder führen sie aus:
- Erstellen Sie Ihr eigenes Containernetzwerk namens
esp_net
.sudo docker network create --driver bridge esp_net
- Führen Sie den Echo-Beispielserver aus, der die Beispiel-API bereitstellt:
Java sudo docker run --detach --name=echo --net=esp_net gcr.io/google-samples/echo-java:1.0
Python sudo docker run --detach --name=echo --net=esp_net gcr.io/google-samples/echo-python:1.0
Go sudo docker run --detach --name=echo --net=esp_net gcr.io/google-samples/echo-go:1.0
PHP sudo docker run --detach --name=echo --net=esp_net gcr.io/google-samples/echo-php:1.0
Ruby sudo docker run --detach --name=echo --net=esp_net gcr.io/google-samples/echo-ruby:1.0
NodeJS sudo docker run --detach --name=echo --net=esp_net gcr.io/google-samples/echo-node:1.0
- Führen Sie den vorkonfigurierten ESP-Docker-Container aus.
Ersetzen Sie in den ESP-Startoptionen SERVICE_NAME durch den Namen Ihres Diensts. Dies ist der Name, den Sie im Feld
host
Ihres OpenAPI-Dokuments konfiguriert haben.sudo docker run \ --name=esp \ --detach \ --publish=80:8080 \ --net=esp_net \ gcr.io/endpoints-release/endpoints-runtime:1 \ --service=SERVICE_NAME \ --rollout_strategy=managed \ --backend=echo:8080
Mit der Option
--rollout_strategy=managed
legen Sie fest, dass der ESP die zuletzt bereitgestellte Dienstkonfiguration verwendet. Wenn Sie diese Option innerhalb von 5 Minuten nach der Bereitstellung einer neuen Dienstkonfiguration angeben, erkennt der ESP die Änderung und verwendet automatisch die neue Konfiguration. Wir empfehlen, diese Option anstelle einer konkreten Konfigurations-ID anzugeben, die vom ESP verwendet werden soll. Informationen zu den oben verwendeten ESP-Optionen finden Sie unter ESP-Startoptionen.
Wenn Sie eine Fehlermeldung erhalten, lesen Sie die Informationen unter Fehlerbehebung bei Endpoints auf Compute Engine.
Weitere Informationen finden Sie unter API-Back-End bereitstellen.
Anfrage über eine IP-Adresse senden
Sobald die Beispiel-API und der ESP auf der Compute Engine-Instanz ausgeführt werden, können Sie Anfragen an die API senden.
API-Schlüssel erstellen und Umgebungsvariable festlegen
Für den Beispielcode ist ein API-Schlüssel erforderlich. Zur Vereinfachung der Anfrage legen Sie eine Umgebungsvariable für den API-Schlüssel fest.
Erstellen Sie in dem Google Cloud-Projekt, das Sie für Ihre API verwendet haben, auf der Seite mit den API-Anmeldedaten einen API-Schlüssel. Informationen zum Erstellen eines API-Schlüssels in einem anderen Google Cloud-Projekt finden Sie unter API im Google Cloud-Projekt aktivieren.
- Klicken Sie auf Anmeldedaten erstellen und wählen Sie anschließend API-Schlüssel aus.
- Kopieren Sie den Schlüssel in die Zwischenablage.
- Klicken Sie auf Schließen.
- Fügen Sie den API-Schlüssel auf Ihrem lokalen Computer ein, um ihn einer Umgebungsvariablen zuzuweisen:
- In Linux oder macOS:
export ENDPOINTS_KEY=AIza...
- In Windows PowerShell:
$Env:ENDPOINTS_KEY="AIza..."
- In Linux oder macOS:
Anfrage senden
Linux oder macOS
Senden Sie mit curl
eine HTTP-Anfrage unter Verwendung der zuvor festgelegten Umgebungsvariablen ENDPOINTS_KEY. Ersetzen Sie IP_ADDRESS durch die externe IP-Adresse Ihrer Instanz.
curl --request POST \ --header "content-type:application/json" \ --data '{"message":"hello world"}' \ "http://IP_ADDRESS:80/echo?key=${ENDPOINTS_KEY}"
Im vorherigen curl
gilt Folgendes:
- Durch die Option
--data
werden die an die API zu übertragenden Daten festgelegt. - Durch die Option
--header
wird angegeben, dass die Daten im JSON-Format vorliegen.
PowerShell
Senden Sie mit Invoke-WebRequest
eine HTTP-Anfrage unter Verwendung der zuvor festgelegten Umgebungsvariablen ENDPOINTS_KEY
. Ersetzen Sie IP_ADDRESS durch die externe IP-Adresse Ihrer Instanz.
(Invoke-WebRequest -Method POST -Body '{"message": "hello world"}' ` -Headers @{"content-type"="application/json"} ` -URI "http://IP_ADDRESS:80/echo?key=$Env:ENDPOINTS_KEY").Content
In diesem Beispiel enden die ersten beiden Zeilen mit einem Graviszeichen. Achten Sie beim Einfügen des Beispiels in PowerShell darauf, dass nach dem Graviszeichen kein Leerzeichen folgt. Informationen zu den in der Beispielanfrage verwendeten Optionen finden Sie in der Microsoft-Dokumentation unter Invoke-WebRequest.
Drittanbieteranwendung
Sie können eine Drittanbieteranwendung wie die Chrome-Browsererweiterung Postman zum Senden der Anfrage verwenden:
- Wählen Sie
POST
als HTTP-Verb aus. - Wählen Sie für den Header den Schlüssel
content-type
und den Wertapplication/json
aus. - Geben Sie als Text Folgendes ein:
{"message":"hello world"}
-
Verwenden Sie in der URL den tatsächlichen API-Schlüssel und nicht die Umgebungsvariable.
Beispiel:
http://192.0.2.0:80/echo?key=AIza...
Die API gibt die von Ihnen gesendete Meldung zurück und reagiert mit folgender Zeile:
{
"message": "hello world"
}
Wenn Sie als Antwort einen Fehler erhalten haben, lesen Sie die Informationen unter Fehlerbehebung bei Antwortfehlern.
Sie haben gerade eine API in Cloud Endpoints bereitgestellt und getestet!
DNS für Endpoints konfigurieren
Da sich der Name des Endpoints-Diensts für die API in der Domain .endpoints.YOUR_PROJECT_ID.cloud.goog
befindet, können Sie ihn als vollständig qualifizierten Domainnamen verwenden. Dazu nehmen Sie eine kleine Konfigurationsänderung in Ihrer openapi.yaml
-Datei vor. Sie können dadurch Anfragen an die Beispiel-API über echo-api.endpoints.YOUR_PROJECT_ID.cloud.goog
senden, anstatt die IP-Adresse zu verwenden.
So konfigurieren Sie das DNS für Endpoints:
- Öffnen Sie die OpenAPI-Konfigurationsdatei
openapi.yaml
und fügen Sie das Attributx-google-endpoints
auf der obersten Ebene der Datei ein (nicht eingerückt oder verschachtelt), wie im folgenden Snippet gezeigt:host: "echo-api.endpoints.YOUR_PROJECT_ID.cloud.goog" x-google-endpoints: - name: "echo-api.endpoints.YOUR_PROJECT_ID.cloud.goog" target: "IP_ADDRESS"
- Ersetzen Sie im Attribut
name
den Platzhalter YOUR_PROJECT_ID durch Ihre Projekt-ID. - Ersetzen Sie im Attribut
target
den Parameter IP_ADDRESS durch die IP-Adresse, die Sie beim Senden einer Anfrage an die Beispiel-API verwendet haben. - Stellen Sie Ihre aktualisierte OpenAPI-Konfigurationsdatei für Service Management bereit:
gcloud endpoints services deploy openapi.yaml
Angenommen, für die Datei openapi.yaml
ist Folgendes konfiguriert:
host: "echo-api.endpoints.example-project-12345.cloud.goog" x-google-endpoints: - name: "echo-api.endpoints.example-project-12345.cloud.goog" target: "192.0.2.1"
Wenn Sie die Datei openapi.yaml
mit dem vorherigen gcloud
-Befehl bereitstellen, wird in der Service Management API der DNS-A-Eintrag echo-api.endpoints.my-project-id.cloud.goog
erstellt und in die Ziel-IP-Adresse 192.0.2.1
aufgelöst. Es kann einige Minuten dauern, bis die neue DNS-Konfiguration verteilt wurde.
SSL konfigurieren
Weitere Informationen zum Konfigurieren von DNS und SSL finden Sie unter SSL für Endpoints aktivieren.
Anfrage über FQDN senden
Nachdem Sie den DNS-Eintrag für die Beispiel-API konfiguriert haben, senden Sie über den FQDN eine Anfrage (ersetzen Sie YOUR_PROJECT_ID durch Ihre Projekt-ID) und die zuvor festgelegte Umgebungsvariable ENDPOINTS_KEY:- In Linux oder macOS:
curl --request POST \ --header "content-type:application/json" \ --data '{"message":"hello world"}' \ "http://echo-api.endpoints.YOUR_PROJECT_ID.cloud.goog:80/echo?key=${ENDPOINTS_KEY}"
- In Windows PowerShell:
(Invoke-WebRequest -Method POST -Body '{"message": "hello world"}' -Headers @{"content-type"="application/json"} -URI "http://echo-api.endpoints.[YOUR_PROJECT_ID].cloud.goog:80/echo?key=$Env:ENDPOINTS_KEY").Content
API-Aktivität nachverfolgen
So verfolgen Sie API-Aktivitäten:
Sehen Sie sich auf der Seite Endpoints > Dienste die Aktivitätsgrafiken für Ihre API an.
Es kann einen Moment dauern, bis die Anfrage in den Grafiken angezeigt wird.Sehen Sie sich auf der Seite "Log Explorer" die Anfragelogs an.
Entwicklerportal für die API erstellen
Sie können mit dem Cloud Endpoints-Portal ein Entwicklerportal erstellen. Das ist eine Website zur Interaktion mit der Beispiel-API. Weitere Informationen finden Sie unter Übersicht über das Cloud Endpoints-Portal.
Bereinigen
Damit Ihrem Google Cloud-Konto die in dieser Anleitung verwendeten Ressourcen nicht in Rechnung gestellt werden, löschen Sie entweder das Projekt, das die Ressourcen enthält, oder Sie behalten das Projekt und löschen die einzelnen Ressourcen.
- Löschen Sie die API:
gcloud endpoints services delete SERVICE_NAME
Ersetzen Sie
SERVICE_NAME
durch den Namen Ihres Diensts. - Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.
- Klicken Sie auf das Kästchen für die Die Instanz, die Sie löschen möchten.
- Klicken Sie zum Löschen der Instanz auf Weitere Aktionen, dann auf Löschen, und folgen Sie dann der Anleitung.