Dienste und Arbeitslasten verwalten

Wenn Sie App Hub einrichten, erstellen Sie eine administrative Grenze für Ihre Anwendungen. Diese Grenze ist je nach Einrichtungsmodell entweder das Verwaltungsprojekt oder die Sammlung von Host- und Dienstprojekten, die Sie für die Anwendungsverwaltung konfiguriert haben. Dienste und Arbeitslasten werden als Anwendungen registriert innerhalb dieser administrativen Grenze.

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

  • Für Anwendungen, die aus einer Application Design Center-Vorlage bereitgestellt wurden: 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 von Ressourcen in App Hub erstellt wurden: Verwalten Sie die Anwendung, ihre 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 als Anwendungen 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 aus einer Vorlage bereitgestellt werden, finden Sie in der Dokumentation zum Application Design Center.

Hinweise

Bevor Sie Dienste und Arbeitslasten in App Hub ansehen, aktualisieren und abmelden können, müssen Sie die folgenden Schritte ausführen:

  1. Richten Sie App Hub ein. Verwenden Sie dazu eines der unterstützten Einrichtungsmodelle.
  2. Unterstützte Ressourcen für eine Anwendung registrieren

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für die administrative Grenze der Anwendung aus Ihrem Einrichtungsmodell (das Verwaltungsprojekt oder die Host- und Dienstprojekte) zuzuweisen, 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)
  • Dienste und Arbeitslasten ansehen: 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 und Registrierungsstatus für eine Anwendung, innerhalb Ihrer App Hub-Administratorengrenze:

Console

Details zu registrierten oder getrennten Diensten und Arbeitslasten einer Anwendung ansehen:

  1. Wählen Sie auf der Seite Willkommen der Google Cloud Console mit der Projektauswahl Ihr Verwaltungsprojekt oder Hostprojekt aus:

    Zur Begrüßungsseite

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

    Wechseln Sie zu „Anwendungen“

    Auf der Seite wird eine Liste Ihrer Anwendungen angezeigt.

  3. Klicken Sie auf den Namen der Anwendung, deren Dienste oder Arbeitslasten Sie 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 für die Ressource können Sie sich Details wie den Anzeigenamen, den Standort, den Registrierungsstatus und die Attribute ansehen.

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

  1. Rufen Sie die App Hub-Seite Dienste und Arbeitslasten 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 Attributen wie Umgebung oder Registrierungsstatus einzugrenzen.

gcloud

Details zu registrierten oder getrennten Diensten und Arbeitslasten einer Anwendung ansehen:

  1. Suchen Sie die Projekt-ID Ihres Verwaltungsprojekts oder Hostprojekts.

  2. Beschreiben Sie einen Dienst oder eine Arbeitslast aus einer Anwendung, um die zugehörigen Details 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 Hostprojekts oder 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 Hostprojekts oder 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 Ressource, z. B. den Anzeigenamen, den Standort, den Registrierungsstatus und die Attribute.

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

Gefundene Ressourcen

Erkannte Ressourcen können für eine Anwendung registriert werden. So listen Sie erkannte Ressourcen auf:

  1. Gefundene Dienste auflisten:

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

    Ersetzen Sie Folgendes:

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

  2. Ermittelte Arbeitslasten auflisten:

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

Registrierte Ressourcen

Registrierte Ressourcen sind Teil einer Anwendung. So listen Sie registrierte Ressourcen einer bestimmten Anwendung auf: 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 Hostprojekts oder Verwaltungsprojekts.
    • LOCATION: Der Speicherort der Ressource. Verwenden Sie global für globale Ressourcen oder eine bestimmte Region, z. B. us-east1, für regionale Ressourcen.
    • Optional: FILTER_EXPRESSION: der Filterausdruck zum Angeben von Attributen. Wenn Sie beispielsweise Ressourcen 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 einer Anwendung kann sich in getrennt ändern, wenn Sie die Organisationsstruktur Ihrer Google Cloud-Ressourcen ändern oder die zugrunde liegende Ressource löschen. Abgetrennte Dienste und Arbeitslasten verbleiben in der Anwendung, bis Sie die Registrierung aufheben. App Hub kann sie dann aber 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 anhand der Ressourcenhierarchie Ihres Einrichtungsmodells registrieren.

Dienst- und Arbeitslastattribute aktualisieren

So ändern Sie die benutzerdefinierten Attribute von Diensten und Arbeitslasten, die für eine Anwendung registriert sind:

Console

  1. Wählen Sie auf der Seite Willkommen der Google Cloud Console mit der Projektauswahl Ihr Verwaltungsprojekt oder Hostprojekt aus:

    Zur Begrüßungsseite

  2. Rufen Sie im App Hub die Seite Anwendungen 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 oder Hostprojekts.

  2. So aktualisieren Sie Dienst- oder Arbeitslastattribute:

    • 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 Hostprojekts oder Verwaltungsprojekts.
      • Erforderlich: LOCATION: Der Standort Ihrer Ressource. Verwenden Sie global für globale Ressourcen oder eine bestimmte Region, z. B. us-east1 für regionale Ressourcen.
      • Optional: DISPLAY_NAME: Der Anzeigename Ihrer Ressource.

      • Optional: CRITICALITY_LEVEL: die Wichtigkeit der Ressource. 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 und wird wieder zu einer erkannten Ressource, die für die Registrierung in einer anderen Anwendung verfügbar ist.

So heben Sie die Registrierung von Diensten und Arbeitslasten auf:

Console

  1. Wählen Sie auf der Seite Willkommen der Google Cloud Console mit der Projektauswahl Ihr Verwaltungsprojekt oder Hostprojekt aus:

    Zur Begrüßungsseite

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

    Wechseln Sie zu „Anwendungen“

    Auf der Seite wird eine Liste Ihrer Anwendungen angezeigt.

  3. Klicken Sie auf den Namen der Anwendung, deren Dienste oder Arbeitslasten Sie abmelden 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 Ressource auf Registrierung aufheben.

gcloud

  1. Suchen Sie die Projekt-ID Ihres Verwaltungsprojekts oder Hostprojekts.

  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 Hostprojekts oder Verwaltungsprojekts.
      • LOCATION: Der Speicherort der Ressource. Verwenden Sie global für globale Ressourcen oder eine bestimmte Region, z. B. us-east1, für regionale Ressourcen.

    • 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 Dienstes oder einer Arbeitslast aufheben möchten, die von Terraform verwaltet wird, 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