Auf dieser Seite erfahren Sie, wie Sie einen Service Directory-Namespace einrichten, dem Namespace einen Dienst hinzufügen und einem Dienst Endpunkte hinzufügen. Bevor Sie die Befehle auf dieser Seite ausführen, sollten Sie sich mit den Konzepten in der Übersicht über Service Directory und den wichtigen Begriffen für Service Directory vertraut machen.
Projekt einrichten
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
Enable the Service Directory API.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
Enable the Service Directory API.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
Service Directory-Ressourcen konfigurieren
Namespace konfigurieren
Erstellen Sie einen Namespace für Ihr Projekt für die ausgewählte Region: Diese Region muss nicht der Ort sein, an dem alle Ihre Dienste und Endpunkte ausgeführt werden, sie sollten aber nach Möglichkeit nah sein. Sie können Ihre Dienste in jeder Service Directory-Region registrieren. sind immer noch global verfügbar. Projekte können mehrere Namespaces innerhalb einer Region haben und mehrere Regionen können Namespaces haben. Ein einzelner Namespace darf keine Regionen umfassen.
Console
- Rufen Sie in der Google Cloud Console die Seite "Service Directory-Namespaces" auf.
Zur Seite "Service Directory-Namespaces" - Klicken Sie auf Namespace erstellen.
- Wählen Sie im Drop-down-Menü Region eine Region für Ihren Namespace aus.
- Geben Sie dem Namespace im Feld Namespace-Name einen Namen.
- Klicken Sie auf Erstellen.
gcloud
Wenn Sie Service Directory in der Befehlszeile verwenden möchten, müssen Sie zuerst die neueste Version des Cloud SDK installieren oder ein Upgrade ausführen.
Namespace erstellen
gcloud service-directory namespaces create NAMESPACE \ --location REGION
Dabei gilt:
NAMESPACE
: Der Name des Namespace, den Sie erstellen.REGION
: Die Google Cloud-Region, die den Namespace enthält.
(Optional) Legen Sie eine IAM-Richtlinie für Ihren Namespace fest. Dadurch wird der angegebene Nutzer oder die angegebene Gruppe für den Namespace und alle Dienste, die zum Namespace gehören, bereitgestellt.
gcloud service-directory namespaces add-iam-policy-binding NAMESPACE \ --member user:someone@example.com \ --role ROLE \ --location REGION
Dabei gilt:
NAMESPACE
: Der Name des von Ihnen erstellten Namespace.ROLE
: Die von Ihnen gewährte Rolle.REGION
: Die Google Cloud-Region, die den Namespace enthält.
C#
Um diesen Code auszuführen, müssen Sie zuerst eine C#-Entwicklungsumgebung einrichten und das Service Directory C# SDK installieren.
Go
Um diesen Code auszuführen, müssen Sie zuerst eine Go-Entwicklungsumgebung einrichten und das Service Directory Go SDK installieren.
Java
Um diesen Code auszuführen, richten Sie zuerst eine Java-Entwicklungsumgebung ein und installieren Sie das Service Directory Java SDK.
Node.js
Um diesen Code auszuführen, richten Sie zuerst eine Node.js-Entwicklungsumgebung ein und installieren Sie das Service Directory Node.js SDK.
PHP
Um diesen Code auszuführen, richten Sie zuerst eine PHP-Entwicklungsumgebung ein und installieren Sie das Service Directory PHP SDK.
Python
Um diesen Code auszuführen, richten Sie zuerst eine Python-Entwicklungsumgebung ein und installieren Sie das Service Directory Python SDK.
Ruby
Um diesen Code auszuführen, richten Sie zuerst eine Ruby-Entwicklungsumgebung ein und installieren Sie das Service Directory Ruby SDK.
Dienst konfigurieren
Erstellen Sie einen Dienst im Namespace. Ein Dienst besteht aus einem Namen und optionalen dienstbezogenen Metadaten. Für das Format von Dienstnamen gelten einige Einschränkungen:
- Dienstnamen müssen innerhalb eines Namespace eindeutig sein.
- Dienstnamen müssen DNS-Labels der Namenskonvention entsprechen.
Console
- Rufen Sie in der Google Cloud Console die Seite "Service Directory-Namespaces" auf.
Zur Seite "Service Directory-Namespaces" - Klicken Sie auf einen Namespace.
- Klicken Sie auf Dienst hinzufügen.
- Geben Sie einen Dienstnamen ein.
- Optional: Wenn Sie dem Dienst Metadaten hinzufügen möchten, gehen Sie so vor:
- Klicken Sie auf Dienstmetadaten.
- Klicken Sie auf Metadaten hinzufügen.
- Fügen Sie einen Schlüssel und einen Wert hinzu.
- Klicken Sie noch einmal auf Add Metadata (Metadaten hinzufügen), um weitere Metadatenpaare hinzuzufügen.
- Klicken Sie auf Erstellen.
gcloud
Wenn Sie Service Directory in der Befehlszeile verwenden möchten, müssen Sie zuerst die neueste Version des Cloud SDK installieren oder ein Upgrade ausführen.
Erstellen Sie einen Dienst in einem Namespace.
gcloud service-directory services create SERVICE \ --metadata KEY_1=VALUE_1,KEY_2=VALUE_2 \ --namespace NAMESPACE \ --location REGION
Dabei gilt:
SERVICE
: der Name des Dienstes, den Sie erstellen.NAMESPACE
: Der Name, den Sie dem Namespace mit Ihrem Dienst gegeben haben.REGION
: Die Google Cloud-Region, die den Namespace enthält.KEY_1
,VALUE_1
,KEY_2
,VALUE_2
: Schlüssel- und Wertstring, der in Paaren festgelegt wurde.
(Optional) Legen Sie eine IAM-Richtlinie für den Dienst fest. Dadurch wird der angegebene Nutzer oder die angegebene Gruppe für den Dienst und alle zum Dienst gehörenden Endpunkte bereitgestellt.
gcloud service-directory services add-iam-policy-binding SERVICE \ --member user:someone@example.com \ --role ROLE \ --namespace NAMESPACE \ --location REGION
Dabei gilt:
SERVICE
: der Name, den Sie Ihrem Dienst gegeben haben.NAMESPACE
: Der Name des von Ihnen erstellten Namespace.ROLE
: Die Rolle, die Sie gewähren.REGION
: Die Google Cloud-Region, die den Namespace enthält.
C#
Um diesen Code auszuführen, müssen Sie zuerst eine C#-Entwicklungsumgebung einrichten und das Service Directory C# SDK installieren.
Go
Um diesen Code auszuführen, müssen Sie zuerst eine Go-Entwicklungsumgebung einrichten und das Service Directory Go SDK installieren.
Java
Um diesen Code auszuführen, richten Sie zuerst eine Java-Entwicklungsumgebung ein und installieren Sie das Service Directory Java SDK.
Node.js
Um diesen Code auszuführen, richten Sie zuerst eine Node.js-Entwicklungsumgebung ein und installieren Sie das Service Directory Node.js SDK.
PHP
Um diesen Code auszuführen, richten Sie zuerst eine PHP-Entwicklungsumgebung ein und installieren Sie das Service Directory PHP SDK.
Python
Um diesen Code auszuführen, richten Sie zuerst eine Python-Entwicklungsumgebung ein und installieren Sie das Service Directory Python SDK.
Ruby
Um diesen Code auszuführen, richten Sie zuerst eine Ruby-Entwicklungsumgebung ein und installieren Sie das Service Directory Ruby SDK.
Endpunkt konfigurieren
Nachdem der Dienst registriert ist, fügen Sie einige Endpunkte hinzu. Ein Endpunkt besteht aus einem eindeutigen Namen und den optionalen Feldern von Adresse, Port und Schlüssel/Wert-Metadaten. Die angegebene Adresse muss eine gültige IPv4- oder IPv6-Adresse sein.
Console
- Rufen Sie in der Google Cloud Console die Seite "Service Directory-Namespaces" auf.
Zur Seite "Service Directory-Namespaces" - Klicken Sie auf einen Namespace.
- Klicken Sie auf einen Dienst.
- Klicken Sie auf Endpunkt hinzufügen.
- Geben Sie einen Endpunktnamen an.
- Geben Sie eine IPv4- oder IPv6-Adresse ein.
- Geben Sie eine Portnummer ein.
- Optional: Wenn Sie dem Endpunkt Metadaten hinzufügen möchten, gehen Sie so vor:
- Klicken Sie auf Endpunktmetadaten.
- Klicken Sie auf Metadaten hinzufügen.
- Fügen Sie einen Schlüssel und einen Wert hinzu.
- Klicken Sie noch einmal auf Add Metadata (Metadaten hinzufügen), um weitere Metadatenpaare hinzuzufügen.
- Klicken Sie auf Erstellen.
gcloud
Wenn Sie Service Directory in der Befehlszeile verwenden möchten, müssen Sie zuerst die neueste Version des Cloud SDK installieren oder ein Upgrade ausführen.
Nachdem der Dienst registriert ist, fügen Sie einige Endpunkte hinzu.
gcloud service-directory endpoints create ENDPOINT \ --address IP_ADDRESS \ --port PORT_NUMBER \ --metadata KEY_1=VALUE_1,KEY_2=VALUE_2 \ --service SERVICE \ --namespace NAMESPACE \ --location REGION
gcloud service-directory endpoints create ENDPOINT2 \ --address IP_ADDRESS2 \ --port PORT_NUMBER2 \ --service SERVICE \ --namespace NAMESPACE \ --location REGION
Ersetzen Sie die folgenden Werte:
ENDPOINT
undENDPOINT2
: die Namen der Endpunkte, die Sie in Ihrem Dienst erstellen.IP_ADDRESS
undIP_ADDRESS2
: die IPv6- und IPv4-Adressen der Endpunkte.PORT_NUMBER
undPORT_NUMBER2
: Die Ports, auf denen die Endpunkte ausgeführt werden.SERVICE
: der Name des Dienstes, den Sie erstellen.NAMESPACE
: Der Name, den Sie dem Namespace mit Ihrem Dienst gegeben haben.REGION
: Die Google Cloud-Region, die den Namespace enthält.KEY_1
,VALUE_1
,KEY_2
,VALUE_2
: Schlüssel- und Wertstring, der in Paaren festgelegt wurde.
C#
Um diesen Code auszuführen, müssen Sie zuerst eine C#-Entwicklungsumgebung einrichten und das Service Directory C# SDK installieren.
Go
Um diesen Code auszuführen, müssen Sie zuerst eine Go-Entwicklungsumgebung einrichten und das Service Directory Go SDK installieren.
Java
Um diesen Code auszuführen, richten Sie zuerst eine Java-Entwicklungsumgebung ein und installieren Sie das Service Directory Java SDK.
Node.js
Um diesen Code auszuführen, richten Sie zuerst eine Node.js-Entwicklungsumgebung ein und installieren Sie das Service Directory Node.js SDK.
PHP
Um diesen Code auszuführen, richten Sie zuerst eine PHP-Entwicklungsumgebung ein und installieren Sie das Service Directory PHP SDK.
Python
Um diesen Code auszuführen, richten Sie zuerst eine Python-Entwicklungsumgebung ein und installieren Sie das Service Directory Python SDK.
Ruby
Um diesen Code auszuführen, erstellen Sie zuerst eine Ruby-Entwicklungsumgebung und installieren Sie das Service Directory Ruby SDK.
Dienst auflösen
Service Directory ermöglicht Clients, Dienste mithilfe von DNS, HTTP und gRPC aufzulösen. Durch das Auflösen des Dienstes werden alle Attribute des Dienstes sowie alle Endpunkte und Metadaten zurückgegeben.
gcloud
Wenn Sie Service Directory in der Befehlszeile verwenden möchten, müssen Sie zuerst die neueste Version des Cloud SDK installieren oder ein Upgrade ausführen.
gcloud service-directory services resolve SERVICE \ --namespace NAMESPACE \ --location REGION
Dabei gilt:
SERVICE
: der Name des Dienstes, den Sie erstellen.NAMESPACE
: Der Name, den Sie dem Namespace angegeben haben, der Ihren Dienst enthält.REGION
: Die Google Cloud-Region, die den Namespace enthält.
C#
Um diesen Code auszuführen, müssen Sie zuerst eine C#-Entwicklungsumgebung einrichten und das Service Directory C# SDK installieren.
Go
Um diesen Code auszuführen, müssen Sie zuerst eine Go-Entwicklungsumgebung einrichten und das Service Directory Go SDK installieren.
Java
Um diesen Code auszuführen, richten Sie zuerst eine Java-Entwicklungsumgebung ein und installieren Sie das Service Directory Java SDK.
Node.js
Um diesen Code auszuführen, richten Sie zuerst eine Node.js-Entwicklungsumgebung ein und installieren Sie das Service Directory Node.js SDK.
PHP
Um diesen Code auszuführen, richten Sie zuerst eine PHP-Entwicklungsumgebung ein und installieren Sie das Service Directory PHP SDK.
Python
Um diesen Code auszuführen, richten Sie zuerst eine Python-Entwicklungsumgebung ein und installieren Sie das Service Directory Python SDK.
Ruby
Um diesen Code auszuführen, richten Sie zuerst eine Ruby-Entwicklungsumgebung ein und installieren Sie das Service Directory Ruby SDK.
Ressourcen löschen
Endpunkt aus einem Dienst löschen
Console
- Rufen Sie in der Google Cloud Console die Seite "Service Directory-Namespaces" auf.
Zur Seite "Service Directory-Namespaces" - Klicken Sie auf den Namespace, aus dem Sie den Endpunkt löschen möchten.
- Klicken Sie auf den Dienst, von dem Sie den Endpunkt löschen möchten.
- Klicken Sie auf das Kästchen neben dem Endpunkt, den Sie löschen möchten.
- Klicken Sie auf Löschen.
- Klicken Sie im Dialogfeld zur Bestätigung noch einmal auf Löschen .
gcloud
Wenn Sie Service Directory in der Befehlszeile verwenden möchten, müssen Sie zuerst die neueste Version des Cloud SDK installieren oder ein Upgrade ausführen.
gcloud service-directory endpoints delete ENDPOINT \ --service=SERVICE \ --namespace=NAMESPACE \ --location=REGION
Dabei gilt:
SERVICE
: der Name des Dienstes, den Sie erstellen.NAMESPACE
: Der Name, den Sie dem Namespace mit Ihrem Dienst gegeben haben.REGION
: Die Google Cloud-Region, die den Namespace enthält.
C#
Um diesen Code auszuführen, müssen Sie zuerst eine C#-Entwicklungsumgebung einrichten und das Service Directory C# SDK installieren.
Go
Um diesen Code auszuführen, müssen Sie zuerst eine Go-Entwicklungsumgebung einrichten und das Service Directory Go SDK installieren.
Java
Um diesen Code auszuführen, richten Sie zuerst eine Java-Entwicklungsumgebung ein und installieren Sie das Service Directory Java SDK.
Node.js
Um diesen Code auszuführen, richten Sie zuerst eine Node.js-Entwicklungsumgebung ein und installieren Sie das Service Directory Node.js SDK.
PHP
Um diesen Code auszuführen, müssen Sie zuerst eine PHP-Entwicklungsumgebung einrichten und das Service Directory PHP SDK installieren.
Python
Um diesen Code auszuführen, richten Sie zuerst eine Python-Entwicklungsumgebung ein und installieren Sie das Service Directory Python SDK.
Ruby
Um diesen Code auszuführen, richten Sie zuerst eine Ruby-Entwicklungsumgebung ein und installieren Sie das Service Directory Ruby SDK.
Dienst aus einem Namespace löschen
Sie können einen Dienst mit Endpunkten löschen. Wenn ein Dienst gelöscht wird, werden auch alle Endpunkte gelöscht.
Sie können einen Dienst löschen, auf den eine Service Directory-Zone verweist. Alle weiteren DNS-Abfragen für diesen Dienst geben NXDOMAIN
zurück.
Console
- Rufen Sie in der Google Cloud Console die Seite "Service Directory-Namespaces" auf.
Zur Seite "Service Directory-Namespaces" - Klicken Sie auf den Namespace, aus dem Sie den Dienst löschen möchten.
- Klicken Sie auf das Kästchen neben dem Dienst, den Sie löschen möchten.
- Klicken Sie auf Löschen.
- Klicken Sie im Bestätigungsdialogfeld noch einmal auf Löschen.
gcloud
Wenn Sie Service Directory in der Befehlszeile verwenden möchten, müssen Sie zuerst die neueste Version des Cloud SDK installieren oder ein Upgrade ausführen.
gcloud service-directory services delete SERVICE \ --namespace=NAMESPACE \ --location=REGION
Dabei gilt:
SERVICE
: der Name des Dienstes, den Sie erstellen.NAMESPACE
: Der Name, den Sie dem Namespace mit Ihrem Dienst gegeben haben.REGION
: Die Google Cloud-Region, die den Namespace enthält.
C#
Um diesen Code auszuführen, müssen Sie zuerst eine C#-Entwicklungsumgebung einrichten und das Service Directory C# SDK installieren.
Go
Um diesen Code auszuführen, müssen Sie zuerst eine Go-Entwicklungsumgebung einrichten und das Service Directory Go SDK installieren.
Java
Um diesen Code auszuführen, richten Sie zuerst eine Java-Entwicklungsumgebung ein und installieren Sie das Service Directory Java SDK.
Node.js
Um diesen Code auszuführen, richten Sie zuerst eine Node.js-Entwicklungsumgebung ein und installieren Sie das Service Directory Node.js SDK.
PHP
Um diesen Code auszuführen, richten Sie zuerst eine PHP-Entwicklungsumgebung ein und installieren Sie das Service Directory PHP SDK.
Python
Um diesen Code auszuführen, richten Sie zuerst eine Python-Entwicklungsumgebung ein und installieren Sie das Service Directory Python SDK.
Ruby
Um diesen Code auszuführen, erstellen Sie zuerst eine Ruby-Entwicklungsumgebung und installieren Sie das Service Directory Ruby SDK.
Namespace löschen
Sie können einen Namespace löschen, der Dienste und Endpunkte enthält. Wenn ein Namespace gelöscht wird, werden auch alle seine Dienste und Endpunkte gelöscht.
Sie können einen Namespace löschen, auf den eine Service Directory-Zone verweist. Alle weiteren DNS-Abfragen (ohne SOA/NS-Anfragen für den Ursprung der Zone) geben NXDOMAIN
zurück.
Console
- Rufen Sie in der Google Cloud Console die Seite "Service Directory-Namespaces" auf.
Zur Seite "Service Directory-Namespaces" - Klicken Sie auf das Kästchen neben dem Namespace, den Sie löschen möchten.
- Klicken Sie auf Löschen.
- Klicken Sie im Bestätigungsdialogfeld noch einmal auf Löschen.
gcloud
Wenn Sie Service Directory in der Befehlszeile verwenden möchten, müssen Sie zuerst die neueste Version des Cloud SDK installieren oder ein Upgrade ausführen.
gcloud service-directory namespaces delete NAMESPACE \ --location=REGION
Dabei gilt:
NAMESPACE
: Der Name, den Sie dem Namespace angegeben haben, der Ihren Dienst enthält.REGION
: Die Google Cloud-Region, die den Namespace enthält.
C#
Um diesen Code auszuführen, müssen Sie zuerst eine C#-Entwicklungsumgebung einrichten und das Service Directory C# SDK installieren.
Go
Um diesen Code auszuführen, müssen Sie zuerst eine Go-Entwicklungsumgebung einrichten und das Service Directory Go SDK installieren.
Java
Um diesen Code auszuführen, richten Sie zuerst eine Java-Entwicklungsumgebung ein und installieren Sie das Service Directory Java SDK.
Node.js
Um diesen Code auszuführen, richten Sie zuerst eine Node.js-Entwicklungsumgebung ein und installieren Sie das Service Directory Node.js SDK.
PHP
Um diesen Code auszuführen, richten Sie zuerst eine PHP-Entwicklungsumgebung ein und installieren Sie das Service Directory PHP SDK.
Python
Um diesen Code auszuführen, richten Sie zuerst eine Python-Entwicklungsumgebung ein und installieren Sie das Service Directory Python SDK.
Ruby
Um diesen Code auszuführen, richten Sie zuerst eine Ruby-Entwicklungsumgebung ein und installieren Sie das Service Directory Ruby SDK.
Nächste Schritte
- Informationen zum Konfigurieren einer Service Directory-Zone für die Abfrage Ihres Dienstes mithilfe von DNS finden Sie unter Dienstverzeichnis-Zone.
- Eine Übersicht über Service Directory finden Sie in der Übersicht über Service Directory.
- Lösungen für häufige Probleme, die bei der Verwendung von Service Directory auftreten können, finden Sie unter Fehlerbehebung.