Dienstlebenszyklen verwalten

Auf dieser Seite wird beschrieben, wie Sie die Lebenszyklen von verwalteten Diensten mit den gcloud endpoints services-Befehlen des Cloud SDK verwalten.

Für komplexere Anwendungsfälle können Sie mit der Service Management API Dienste programmatisch verwalten. Weitere Informationen finden Sie unter Erste Schritte mit der Service Management API.

Einführung

Ein verwalteter Dienst ist eine einfache Ressource, die einen Dienst, der in Service Infrastructure eingebunden ist, wie die Gmail API und die Spanner API ähnlich ist. Ein verwalteter Dienst selbst verfügt nur über zwei unveränderliche Attribute, einen Dienstnamen und ein Herstellerprojekt, die Implementierung eines verwalteten Dienstes kann jedoch einen großen Bereich bilden. Funktionalität. Die Cloud Storage API bietet beispielsweise einen Objektspeicher für Planeten auf Millionen von Entwicklern und Unternehmen.

Ein verwalteter Dienst verfügt über eine Reihe vonDienstnutzer , ein Geschichte unveränderlich Dienstkonfigurationen , und eine Geschichte unveränderlicher Geschichte Dienst-Rollouts auf. Die Dienstkonfigurationen, auf die im letzten Diensteinführung verwiesen wird, stellen den aktuellen Status des Dienstes dar. Er deckt alle Aspekte des Dienstes ab, angefangen vom Anzeigenamen bis hin zu Messwertdefinitionen bis zu Ratenlimits. Die Spezifikation finden Sie unter google.api.Service.

Auf dieser Seite wird beschrieben, wie Sie Dienstlebenszyklus erstellen und verwalten. Weitere Informationen zur Dienstverwaltung finden Sie unter Anleitungen.

Dienst erstellen

Führen Sie die folgenden Schritte aus, um einen Dienst zu erstellen:

  1. Installieren und initialisieren Sie Cloud SDK auf Ihrem Computer.

  2. Erstellen Sie ein dediziertes Produzentenprojekt zum Hosten Ihres Dienstes. Ein dediziertes Projekt bietet die beste Sicherheit und Isolierung für Ihren Dienst. Außerdem können Sie die Eigentümerschaft Ihres Dienstes an ein anderes Team oder an ein anderes Unternehmen übertragen.

  3. Aktivieren Sie die Service Management API und die Service Control API für Ihr Projekt.

  4. Aktivieren Sie Cloud Billing für Ihr Projekt. Zur Einbindung Ihres Dienstes in Service Infrastructure sind mehrere kostenpflichtige Google Cloud-Produkte erforderlich, darunter die Service Control API, die Cloud Logging API und die Cloud Monitoring API.

  5. Bereiten Sie eine einfache YAML-Dienstkonfigurationsdatei für Ihren Dienst so vor:

    # Filename: endpointsapis.yaml
    type: google.api.Service
    config_version: 3
    # Update the next line to use your own service name.
    name: endpointsapis.appspot.com
    # Update the next line to use your own producer project id.
    producer_project_id: endpointsapis
    
  6. Führen Sie den Befehl gcloud aus, um den Dienst zu erstellen. Stellen Sie dazu eine leere Dienstkonfiguration bereit:

    gcloud endpoints services deploy endpointsapis.yaml
    

Die Serviceerstellung dauert etwa eine Minute. Danach müssten Sie Ihren Dienst auf der Endpoints-Seite in der Google Cloud Console sehen.

Dienste auflisten

Mit dem folgenden Befehl können Sie Dienste in einem Projekt auflisten:

gcloud endpoints services list --project endpointsapis

Dienst beschreiben

Mit dem folgenden Befehl können Sie einen Dienst und seine Konfiguration beschreiben:

gcloud endpoints services describe endpointsapis.appspot.com

Dienst löschen

Wenn Sie einen Dienst nicht mehr benötigen, können Sie ihn mit dem folgenden Befehl löschen:

gcloud endpoints services delete endpointsapis.appspot.com

HINWEIS: Für jeden Dienst gilt eine obligatorische Aufbewahrungsfrist von 30 Tagen.

Dienst wiederherstellen

Mit dem folgenden Befehl können Sie einen Dienst innerhalb der Aufbewahrungsdauer wiederherstellen:

gcloud endpoints services undelete endpointsapis.appspot.com

Tipp

Die Service Management API verwendet ein deklaratives Modell für die Dienstverwaltung. Nach der Erstellung des Dienstes müssen Sie unveränderliche Dienstkonfigurationen und Dienst-Rollouts verschieben, um den gewünschten Status Ihres Dienstes zu erreichen. In den Dienstkonfigurationen werden Google Cloud-Infrastrukturdienste so konfiguriert, dass sie Ihren Dienst unterstützen, einschließlich Cloud Billing, Cloud Logging, Cloud Monitoring und Identity and Access Management.

Weitere Informationen zu Dienstkonfigurationen finden Sie unter Dienstkonfigurationen verwalten. Weitere Informationen zu Dienst-Rollouts finden Sie unter Dienst-Einführungen verwalten.