Dienste und Arbeitslasten verwalten

Wenn Sie Ihr Anwendungssetupmodell auswählen, definieren Sie eine Grenze für die Anwendungsverwaltung für Ihre App Hub-Anwendungen in einem Verwaltungsprojekt. Anschließend können Sie Dienste und Arbeitslasten in Anwendungen innerhalb dieser Grenze registrieren. Empfohlene Anwendungsfälle für die Einführung von Best Practices für die Anwendungsverwaltung finden Sie unter Auf die Verwaltung des Anwendungslebenszyklus vorbereiten.

Um Konfigurationsabweichungen zu vermeiden und eine klare „Source of Truth“ beizubehalten, empfehlen wir, Ihre Anwendungskomponenten in der Umgebung zu verwalten, in der sie ursprünglich definiert wurden:

  • Für Anwendungen, die aus einer Application Design Center-Vorlage bereitgestellt werden: Verwenden Sie Application Design Center, um die Anwendung zu verwalten und zu aktualisieren. Sie haben zwei Möglichkeiten: Vorlage überarbeiten, um Änderungen am Anwendungsdesign vorzunehmen, oder Anwendungsrevision erstellen, um Einstellungen wie Anwendungs- und Komponentendetails zu aktualisieren.

    Zum App Design Center

  • Für Anwendungen, die durch Registrieren vorhandener Ressourcen in App Hub erstellt wurden: Verwalten Sie Anwendungen, Dienste und Arbeitslasten direkt in App Hub.

    Zum App Hub

Auf dieser Seite wird beschrieben, wie Sie Dienste und Arbeitslasten verwalten, die direkt in App Hub erkannt oder registriert werden. Sie können diese Aktionen entweder über die Google Cloud -Konsole oder die Google Cloud CLI ausführen. Informationen zu Anwendungen, die über eine Vorlage bereitgestellt werden, finden Sie in der Dokumentation zu Application Design Center.

Hinweise

In diesem Dokument wird davon ausgegangen, dass Sie eine Anwendung mit registrierten unterstützten Ressourcen haben.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Verwaltungsprojekt zuzuweisen, das Ihre Anwendungsgrenze definiert, um die Berechtigungen zu erhalten, die Sie zum Verwalten von Diensten und Arbeitslasten in App Hub benötigen:

  • Dienste und Arbeitslasten aktualisieren und abmelden: App Hub Editor (roles/apphub.editor)
  • So rufen Sie Dienste, Arbeitslasten und ihre Details auf: App Hub Viewer (roles/apphub.viewer)

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Weitere Informationen zu App Hub-Rollen finden Sie unter IAM-Rollen und -Berechtigungen für App Hub.

Details zu Diensten und Arbeitslasten ansehen

So rufen Sie Details zu Diensten und Arbeitslasten auf, einschließlich ihres Standorts, des Registrierungsstatus für eine Anwendung, der Attribute und der Eigenschaften innerhalb Ihrer Anwendungsgrenze: Weitere Informationen zu diesen Details finden Sie unter App Hub-Konzepte und ‑Datenmodell.

Console

Details zu Diensten und Arbeitslasten einer Anwendung mit dem Registrierungsstatus registered (registriert) oder detached (getrennt) ansehen:

  1. Wählen Sie in der Google Cloud -Console mit der Projektauswahl Ihr Verwaltungsprojekt aus.

  2. Rufen Sie die Seite Anwendungen im App Hub auf:

    Wechseln Sie zu „Anwendungen“

    Auf der Seite wird eine Liste Ihrer Anwendungen angezeigt.

  3. Klicken Sie auf den Namen der Anwendung, für die Sie Dienst- oder Arbeitslastdetails aufrufen möchten.

  4. Klicken Sie auf dem Tab Dienste und Arbeitslasten auf den Namen des Dienstes oder der Arbeitslast, die Sie aufrufen möchten.

  5. Auf der Seite Details der Komponente finden Sie Informationen wie Anzeigename, Standort, Registrierungsstatus, Eigenschaften und Attribute.

Alternativ können Sie eine Liste aller Dienste und Arbeitslasten mit dem Registrierungsstatus Erkannt oder Registriert aufrufen:

  1. Rufen Sie die Seite Dienste und Arbeitslasten in App Hub auf:

    Zu „Dienste und Arbeitslasten“

    Auf der Seite wird eine Liste aller erkannten und registrierten Dienste und Arbeitslasten angezeigt.

  2. Verwenden Sie das Feld Filter, um die Ergebnisse nach Properties, Attributen oder Status einzugrenzen. Verwenden Sie dazu Werte wie Umgebung, Inhaber oder Registrierungsstatus.

gcloud

Details zu Diensten und Arbeitslasten einer Anwendung mit dem Registrierungsstatus registered (registriert) oder detached (getrennt) ansehen:

  1. Suchen Sie die Projekt-ID Ihres Verwaltungsprojekts.

  2. Beschreiben Sie einen Dienst oder eine Arbeitslast aus einer Anwendung, um die Details, einschließlich Eigenschaften und Attributen, aufzurufen:

    • Dienst beschreiben:

      gcloud apphub applications services describe SERVICE \
          --project=PROJECT_ID \
          --application=APPLICATION \
          --location=LOCATION
      

      Ersetzen Sie Folgendes:

      • SERVICE: die ID des Dienstes.
      • PROJECT_ID: die ID Ihres Verwaltungsprojekts.
      • APPLICATION: die ID der Anwendung, für die der Dienst registriert ist.
      • LOCATION: Der Standort des Dienstes. Verwenden Sie global für globale Ressourcen oder eine bestimmte Region wie us-east1 für regionale Ressourcen.
    • Arbeitslast beschreiben:

      gcloud apphub applications workloads describe WORKLOAD \
          --project=PROJECT_ID \
          --application=APPLICATION \
          --location=LOCATION
      

      Ersetzen Sie Folgendes:

      • WORKLOAD: die ID des Workloads.
      • PROJECT_ID: die ID Ihres Verwaltungsprojekts.
      • APPLICATION: die ID der Anwendung, bei der die Arbeitslast registriert ist.
      • LOCATION: Der Standort der Arbeitslast. Verwenden Sie global für globale Ressourcen oder eine bestimmte Region wie us-east1 für regionale Ressourcen.

Die Ausgabe enthält Details zur Komponente, z. B. den Anzeigenamen, den Speicherort und den Registrierungsstatus. Es enthält auch Attribute, sofern sie für die Ressource vorhanden sind.

Alternativ können Sie eine Liste aller Dienste und Arbeitslasten mit dem Registrierungsstatus Erkannt oder Registriert aufrufen:

Erkannt

Erkannte Google Cloud Ressourcen innerhalb des Anwendungsverwaltungsbereichs können als Dienste oder Arbeitslasten in einer Anwendung registriert werden. So listen Sie erkannte Ressourcen auf:

  1. Erkannte Dienste auflisten:

    gcloud apphub discovered-services list \
        --project=PROJECT_ID \
        --location=LOCATION
    

    Ersetzen Sie Folgendes:

    • PROJECT_ID: die ID Ihres Verwaltungsprojekts.
    • LOCATION: Der Standort, an dem Sie Ressourcen ermitteln möchten. Verwenden Sie global für globale Ressourcen oder eine bestimmte Region, z. B. us-east1, für regionale Ressourcen.
  2. Erkannte Arbeitslasten auflisten:

    gcloud apphub discovered-workloads list \
        --project=PROJECT_ID \
        --location=LOCATION
    

Registriert

Registrierte Dienste und Arbeitslasten sind Teil einer Anwendung. Gehen Sie so vor, um registrierte Komponenten einer bestimmten Anwendung aufzulisten. Sie können die Liste anhand von Attributen filtern. Verwenden Sie dazu das Flag --filter:

  1. Registrierte Dienste in einer Anwendung auflisten:

    gcloud apphub applications services list \
        --application=APPLICATION_NAME \
        --project=PROJECT_ID \
        --location=LOCATION \
        --filter=FILTER_EXPRESSION
    

    Ersetzen Sie Folgendes:

    • APPLICATION_NAME: der Name Ihrer Anwendung. Sie geben diesen Wert an, wenn Sie eine Anwendung erstellen.
    • PROJECT_ID: die ID Ihres Verwaltungsprojekts.
    • LOCATION: Der Speicherort der Komponente. Verwenden Sie global für globale Komponenten oder eine bestimmte Region, z. B. us-east1 für regionale Komponenten.
    • Optional: FILTER_EXPRESSION: der Filterausdruck zum Angeben von Attributen. Wenn Sie beispielsweise Komponenten mit dem Umgebungstyp PRODUCTION auflisten möchten, verwenden Sie attributes.environment.type=PRODUCTION.
  2. Registrierte Arbeitslasten in einer Anwendung auflisten:

    gcloud apphub applications workloads list \
        --application=APPLICATION_NAME \
        --project=PROJECT_ID \
        --location=LOCATION \
        --filter=FILTER_EXPRESSION
    

Der Registrierungsstatus von Diensten und Arbeitslasten in einer Anwendung kann sich in getrennt ändern, wenn Sie ein Projekt oder einen Ordner aus dem Anwendungsverwaltungsbereich verschieben oder die zugrunde liegende Ressource löschen. Getrennte Dienste und Arbeitslasten verbleiben in der Anwendung, bis Sie die Registrierung aufheben. App Hub kann sie jedoch nicht mehr verwalten oder überwachen. Weitere Informationen finden Sie unter Registrierungsstatus von Diensten und Arbeitslasten.

Wenn Sie Dienste oder Arbeitslasten wieder an eine Anwendung anhängen möchten, müssen Sie sie noch einmal registrieren.

Dienst- und Arbeitslastattribute aktualisieren

So ändern Sie die Attribute von Diensten und Arbeitslasten, die in einer Anwendung registriert sind:

Console

  1. Wählen Sie in der Google Cloud -Console mit der Projektauswahl Ihr Verwaltungsprojekt aus.

  2. Rufen Sie die Seite Anwendungen im App Hub auf:

    Wechseln Sie zu „Anwendungen“

    Auf der Seite wird eine Liste Ihrer Anwendungen angezeigt.

  3. Klicken Sie auf den Namen der Anwendung, für die Sie Dienst- oder Arbeitslastattribute aktualisieren möchten.

  4. Suchen Sie auf dem Tab Dienste und Arbeitslasten nach dem Namen des Dienstes oder der Arbeitslast, die Sie aktualisieren möchten.

  5. Klicken Sie auf more_vert Mehr und dann auf  Dienst bearbeiten oder Arbeitslast bearbeiten.

  6. Bearbeiten Sie im angezeigten Bereich die Felder nach Bedarf und klicken Sie auf Speichern.

gcloud

  1. Suchen Sie die Projekt-ID Ihres Verwaltungsprojekts.

  2. Dienst- oder Arbeitslastattribute aktualisieren:

    • Dienstattribute aktualisieren:

      gcloud apphub applications services update SERVICE_NAME \
          --application=APPLICATION_NAME \
          --project=PROJECT_ID \
          --location=LOCATION \
          --display-name=DISPLAY_NAME \
          --criticality-type=CRITICALITY_LEVEL \
          --environment-type=ENVIRONMENT \
          --developer-owners=display-name=DEV_NAME,email=DEV_EMAIL \
          --operator-owners=display-name=OPERATOR_NAME,email=OPERATOR_EMAIL \
          --business-owners=display-name=BUSINESS_NAME,email=BUSINESS_EMAIL
      

      Ersetzen Sie SERVICE_NAME durch den Namen des Dienstes, den Sie aktualisieren möchten.

    • Arbeitslastattribute aktualisieren:

      gcloud apphub applications workloads update WORKLOAD_NAME \
          --application=APPLICATION_NAME \
          --project=PROJECT_ID \
          --location=LOCATION \
          --display-name=DISPLAY_NAME \
          --criticality-type=CRITICALITY_LEVEL \
          --environment-type=ENVIRONMENT \
          --developer-owners=display-name=DEV_NAME,email=DEV_EMAIL \
          --operator-owners=display-name=OPERATOR_NAME,email=OPERATOR_EMAIL \
          --business-owners=display-name=BUSINESS_NAME,email=BUSINESS_EMAIL
      

      Ersetzen Sie WORKLOAD_NAME durch den Namen des Workloads, den Sie aktualisieren möchten.

      Ersetzen Sie die folgenden erforderlichen und optionalen Flags:

      • Erforderlich: APPLICATION_NAME: der Name Ihrer Anwendung. Sie geben diesen Wert an, wenn Sie eine Anwendung erstellen.
      • Erforderlich: PROJECT_ID: die ID Ihres Verwaltungsprojekts.
      • Erforderlich: LOCATION: Der Speicherort Ihrer Komponente. Verwenden Sie global für globale Komponenten oder eine bestimmte Region, z. B. us-east1, für regionale Komponenten.
      • Optional: DISPLAY_NAME: der Anzeigename Ihrer Komponente.
      • Optional: CRITICALITY_LEVEL: die Wichtigkeit der Komponente. Verwende einen der folgenden Werte:

        • MISSION_CRITICAL
        • HIGH
        • MEDIUM
        • LOW
      • Optional: ENVIRONMENT: die Phase des Softwarelebenszyklus. Verwenden Sie einen der folgenden Werte:

        • PRODUCTION
        • STAGING
        • DEVELOPMENT
        • TEST
      • Optional: DEV_NAME und DEV_EMAIL: der Anzeigename bzw. die E-Mail-Adresse des Entwicklerinhabers.

      • Optional: OPERATOR_NAME und OPERATOR_EMAIL: der Anzeigename bzw. die E-Mail-Adresse des Betreiberinhabers.

      • Optional: BUSINESS_NAME und BUSINESS_EMAIL: der Anzeigename bzw. die E-Mail-Adresse des Geschäftsinhabers.

Terraform

Wenn Sie Dienst- oder Arbeitslastattribute mit Terraform aktualisieren möchten, ändern Sie die Argumente im entsprechenden Ressourcenblock google_apphub_service oder google_apphub_workload in Ihrer Konfigurationsdatei. Wenn Sie die Änderungen anwenden, aktualisiert Terraform die Ressource entsprechend der neuen Konfiguration.

In den folgenden Beispielen werden die Attribute „Wichtigkeit“ und „Umgebung“ von Diensten und Arbeitslasten einer regionalen Anwendung aktualisiert:

  • Dienstattribute aktualisieren:

    resource "google_apphub_service" "example" {
        # ... other arguments
        attributes {
            criticality {
                type = "HIGH" # Updated criticality
            }
            environment {
                type = "PRODUCTION"
            }
            # ... other attributes
        }
    }
    
  • Arbeitslastattribute aktualisieren:

    resource "google_apphub_workload" "example" {
        # ... other arguments
        attributes {
            criticality {
                type = "HIGH" # Updated criticality
            }
            environment {
                type = "PRODUCTION"
            }
            # ... other attributes
        }
    }
    

Dienste und Arbeitslasten abmelden

Wenn Sie die Registrierung eines Dienstes oder einer Arbeitslast aufheben, wird er bzw. sie aus einer Anwendung entfernt. Die zugrunde liegende Ressource wird nicht gelöscht. Wenn sie sich noch innerhalb der Grenzen der Anwendungsverwaltung befindet, wird sie zu einer Ressource mit dem Registrierungsstatuswert discovered (gefunden), die für die Registrierung für eine andere Anwendung verfügbar ist.

So heben Sie die Registrierung von Diensten und Arbeitslasten auf:

Console

  1. Wählen Sie in der Google Cloud -Console mit der Projektauswahl Ihr Verwaltungsprojekt aus.

  2. Rufen Sie die Seite Anwendungen im App Hub auf:

    Wechseln Sie zu „Anwendungen“

    Auf der Seite wird eine Liste Ihrer Anwendungen angezeigt.

  3. Klicken Sie auf den Namen der Anwendung, für die Sie die Registrierung von Diensten oder Arbeitslasten aufheben möchten.

  4. Klicken Sie auf dem Tab Dienste und Arbeitslasten auf den Namen des Dienstes oder der Arbeitslast, deren Registrierung Sie aufheben möchten.

  5. Klicken Sie auf der Detailseite der Komponente auf Registrierung aufheben.

gcloud

  1. Suchen Sie die Projekt-ID Ihres Verwaltungsprojekts.

  2. So melden Sie einen Dienst oder eine Arbeitslast ab:

    • So melden Sie einen Dienst ab:

      gcloud apphub applications services delete SERVICE_NAME \
          --application=APPLICATION_NAME \
          --project=PROJECT_ID \
          --location=LOCATION
      

      Ersetzen Sie Folgendes:

      • SERVICE_NAME: der Name des Dienstes, dessen Registrierung Sie aufheben möchten.
      • APPLICATION_NAME: der Name Ihrer Anwendung. Sie geben diesen Wert an, wenn Sie eine Anwendung erstellen.
      • PROJECT_ID: die ID Ihres Verwaltungsprojekts.
      • LOCATION: Der Speicherort der Komponente. Verwenden Sie global für globale Komponenten oder eine bestimmte Region, z. B. us-east1, für regionale Komponenten.
    • Arbeitslast abmelden:

      gcloud apphub applications workloads delete WORKLOAD_NAME \
          --application=APPLICATION_NAME \
          --project=PROJECT_ID \
          --location=LOCATION
      

      Ersetzen Sie WORKLOAD_NAME durch den Namen des Workloads, dessen Registrierung Sie aufheben möchten.

Terraform

Wenn Sie die Registrierung eines von Terraform verwalteten Dienstes oder einer von Terraform verwalteten Arbeitslast aufheben möchten, entfernen Sie den entsprechenden Ressourcenblock google_apphub_service oder google_apphub_workload aus der Konfigurationsdatei und führen Sie terraform apply aus. Wenn Sie die Änderungen anwenden, entfernt Terraform die Registrierung aus App Hub.

Nachdem Sie alle Dienste und Arbeitslasten abgemeldet haben, können Sie die Anwendung löschen.

Nächste Schritte