Dienste und Arbeitslasten verwalten

Mit App Hub können Sie direkt registrierte und erkannte Dienste und Arbeitslasten verwalten, damit Ihre Anwendungsmetadaten korrekt bleiben. Wenn sich Ihre Infrastruktur ändert, können Sie Komponentendetails aufrufen, Attribute aktualisieren oder Komponenten aus einer Anwendung abmelden.

Aktualisieren Sie für Anwendungen, die aus einer Vorlage bereitgestellt wurden, die Komponenten in Application Design Center.

Übersicht

Wenn Sie Ihr Anwendungseinrichtungsmodell auswählen, definieren Sie eine Anwendungsverwaltungsgrenze 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 Verfahren zur 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 wurden: Verwenden Sie Application Design Center, um die Anwendung zu verwalten und zu aktualisieren. Sie können entweder die Vorlage überarbeiten, um Änderungen am Anwendungsdesign vorzunehmen, oder eine Anwendungsversion erstellen, um Einstellungen wie Anwendungs- und Komponentendetails zu aktualisieren.

  Zu Application 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

Hinweis

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 Anwendungsverwaltungsgrenze definiert, um die Berechtigungen zu erhalten, die Sie zum Verwalten von Diensten und Arbeitslasten in App Hub benötigen:

• Dienste und Arbeitslasten aktualisieren und Registrierung aufheben: App Hub Editor (roles/apphub.editor)
• Dienste, Arbeitslasten und ihre Details 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 innerhalb Ihrer Anwendungsverwaltungsgrenze auf, einschließlich der folgenden:

• Standort
• Registrierungsstatus für eine Anwendung
• Eigenschaften und Attribute

Weitere Informationen zu diesen Details finden Sie unter App Hub-Konzepte und -Datenmodell.

Console

Details zu Diensten und Arbeitslasten einer Anwendung mit dem Registrierungsstatus Registriert oder Getrennt ansehen:

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

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 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 den Anzeigenamen, den Standort, den Registrierungsstatus, die Eigenschaften und die Attribute.

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

1. Rufen Sie in App Hub die 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, Attributen oder Status einzugrenzen. Verwenden Sie dazu Werte wie Umgebung, Inhaber oder Registrierungsstatus.

gcloud

Details zu Diensten und Arbeitslasten einer Anwendung mit dem Registrierungsstatus Registriert oder 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 Attribute, zu prüfen:

   • 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, bei der der Dienst registriert ist.
     • LOCATION: der Standort des Dienstes. Verwenden Sie global für globale Ressourcen oder eine bestimmte Region, z. B. 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 der Arbeitslast.
     • 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, z. B. us-east1, für regionale Ressourcen.

In der Ausgabe werden Details zur Komponente angezeigt, z. B. der Anzeigename, der Standort und der Registrierungsstatus. Außerdem sind Properties und Attribute enthalten, 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

Google Cloud -Ressourcen, die innerhalb Ihrer Anwendungsverwaltungsgrenze erkannt wurden, 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 erkennen möchten. Verwenden Sie global für globale Ressourcen oder eine bestimmte Region, z. B. us-east1, für regionale Ressourcen.

2. Listen Sie die erkannten Arbeitslasten auf:

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

Registriert

Registrierte Dienste und Arbeitslasten sind Teil einer Anwendung. So listen Sie registrierte Komponenten einer bestimmten Anwendung auf: Sie können die Liste anhand von Attributen mit dem Flag --filter filtern:

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 Standort 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 der Anwendungsverwaltungsgrenze verschieben oder die zugrunde liegende Ressource löschen. Getrennte Dienste und Arbeitslasten verbleiben in der Anwendung, bis Sie sie abmelden. App Hub kann sie dann 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.

Erweiterte Metadatenschemas ansehen

Vorschau

Dieses Produkt oder diese Funktion unterliegt den „Pre-GA-Angebotsbedingungen“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und -Features sind "im Ist-Zustand" verfügbar und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

App Hub reichert Ihre Dienste und Arbeitslasten mit Metadaten an, um die Auffindbarkeit, Governance und Integration in andere Systeme zu verbessern. Sie können mit der App Hub API nach den verfügbaren Metadatenschemas suchen und deren Definitionen aufrufen.

So rufen Sie die Schemadefinition des erweiterten Metadatenattributs auf, listen alle verfügbaren Schemas auf oder rufen die Details eines bestimmten Schemas ab, falls verfügbar:

Weitere Informationen zum erweiterten Metadatenattribut finden Sie unter Eigenschaften und Attribute. Eine Liste der unterstützten Metadatentypen und ihrer Schemas finden Sie unter Erweiterte Metadatenschemas.

gcloud

• Listen Sie alle verfügbaren erweiterten Metadatenschemas in einem Projekt und an einem Standort auf:

  gcloud alpha apphub extended-metadata-schemas list \
      --project=PROJECT_ID \
      --location=LOCATION \
  

  Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID Ihres Verwaltungsprojekts.
  • LOCATION: der Standort der Komponente. Verwenden Sie global für globale Komponenten oder eine bestimmte Region, z. B. us-east1, für regionale Komponenten.

• Details eines bestimmten Schemas ansehen:

  gcloud alpha apphub extended-metadata-schemas describe SCHEMA_NAME \
      --project=PROJECT_ID \
      --location=LOCATION \
  

  Ersetzen Sie SCHEMA_NAME durch den vollständigen Namen des Schemas, z. B. apphub.googleapis.com/AgentProperties.

Terraform

Sie können eine Datenquelle in Terraform verwenden, um die Details eines bestimmten Schemas abzurufen. Im folgenden Beispiel können Sie die Details des apphub.googleapis.com/AgentProperties-Schemas für eine Arbeitslast mit dem funktionalen Typ AGENT im Projekt my-project-id am Standort us-central1 aufrufen.

data "google_apphub_extended_metadata_schema" "agent_properties" {
  project  = "my-project-id"
  location = "us-central1"
  name     = "apphub.googleapis.com/AgentProperties"
}

Dienst- und Arbeitslastattribute aktualisieren

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

Hinweis: Sie können keine Attribute für freigegebene Dienste ändern.

Console

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

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.

2. Dienst- oder Arbeitslastattribute aktualisieren:

   • Aktualisieren Sie die Dienstattribute:

     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 der Arbeitslast, die 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 Wichtigkeitsstufe 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 und die E-Mail-Adresse des Entwicklerinhabers.

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

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

     Hinweis: E-Mail-Adressen müssen das Format username@yourdomain haben, z. B. [e-mail].

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 für Wichtigkeit und Umgebung von Diensten und Arbeitslasten einer regionalen Anwendung aktualisiert:

• Aktualisieren Sie die Dienstattribute:

  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 einen Dienst oder eine Arbeitslast abmelden, wird er bzw. sie aus einer Anwendung entfernt. Die zugrunde liegende Ressource wird nicht gelöscht. Wenn sie sich noch innerhalb Ihrer Anwendungsverwaltungsgrenze befindet, wird sie zu einer Ressource mit dem Registrierungsstatus Entdeckt, die für die Registrierung bei einer anderen Anwendung verfügbar ist.

So melden Sie Dienste und Arbeitslasten ab:

Console

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

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 Dienste oder Arbeitslasten abmelden möchten.

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

5. Klicken Sie auf der Detailseite der Komponente auf Abmelden.

gcloud

1. Suchen Sie die Projekt-ID Ihres Verwaltungsprojekts.

2. Dienst oder Arbeitslast abmelden:

   • Dienst abmelden:

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

     Ersetzen Sie Folgendes:

     • SERVICE_NAME: der Name des Dienstes, den Sie abmelden 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 Standort 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 der Arbeitslast, die Sie abmelden 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 Ihrer 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

• Anwendungen verwalten
• Anwendung mit Designempfehlungen optimieren
• Anwendungen überwachen