Dienstlebenszyklen verwalten

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

Für erweiterte Anwendungsfälle können Sie die Service Management API verwenden, um Dienste programmatisch zu verwalten. Weitere Informationen finden Sie unter Erste Schritte mit der Service Management API.

Einführung

Ein verwalteter Dienst ist eine einfache Ressource, die einen in Service Infrastructure integrierten Dienst logisch darstellt, z. B. die Gmail API und die Spanner API. Ein verwalteter Dienst hat nur zwei unveränderliche Attribute, einen Dienstnamen und ein Herstellerprojekt, die Implementierung eines verwalteten Dienstes kann jedoch ein breites Spektrum des Funktionsumfangs abdecken. Beispielsweise bietet die Cloud Storage API Millionen von Entwicklern und Unternehmen einen weltweiten Objektspeicher.

Ein verwalteter Dienst umfasst eine Reihe von Dienstnutzern, einen Verlauf der unveränderlichen Dienstkonfigurationen sowie den Verlauf des unveränderlichen Dienst-Rollouts. Die Dienstkonfigurationen, auf die im letzten Dienst-Rollout verwiesen wird, stellen den aktuellen Status des Dienstes dar. Dieser umfasst alle Bereiche des Dienstes, vom Anzeigenamen bis hin zu Messwertdefinitionen bis zu Ratenbegrenzungen. Die Spezifikation finden Sie unter google.api.Service.

Auf dieser Seite wird beschrieben, wie Sie Ihre Dienstlebenszyklen erstellen und verwalten. Weitere Informationen zum Service Management finden Sie unter Anleitungen.

Dienst erstellen

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

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

  2. Erstellen Sie ein dediziertes Erstellerprojekt, um Ihren Dienst zu hosten. Ein dediziertes Projekt bietet die bestmögliche Sicherheit und Isolation für Ihren Dienst. Sie können damit auch die Inhaberschaft Ihres Dienstes an ein anderes Team oder sogar 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. Wenn Sie Ihren Dienst in Service Infrastructure einbinden möchten, müssen Sie auf verschiedene kostenpflichtige Google Cloud-Produkte zurückgreifen, einschließlich der Service Control API, der Cloud Logging API und der 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, indem Sie eine leere Dienstkonfiguration bereitstellen:

    gcloud endpoints services deploy endpointsapis.yaml
    

Die Erstellung des Dienstes dauert etwa eine Minute. Danach sollte Ihr Dienst in der Google Cloud Console auf der Seite Endpoints aufgeführt sein.

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. Nachdem der Dienst erstellt wurde, müssen Sie unveränderliche Dienstkonfigurationen und Diensteinführungen verschieben, um den gewünschten Status des Dienstes zu erreichen. Ihre Dienstkonfigurationen werden verwendet, um Google Cloud-Infrastrukturdienste zu konfigurieren, die 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-Rollouts verwalten.