App Hub-Anwendungen verwalten

Mit App Hub können Sie Ihre registrierten Anwendungen aufrufen, ihre Attribute aktualisieren und Anwendungen löschen, um Ihr Anwendungsinventar auf dem neuesten Stand zu halten. Um Konfigurationsabweichungen zu vermeiden, sollten Sie App Hub nur zum Aktualisieren oder Löschen von Anwendungen verwenden, die Sie direkt registriert haben. Anwendungen, die auf Vorlagen basieren, sollten Sie im Application Design Center verwalten.

Ü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 Anwendungspraktiken finden Sie unter Anwendungsverwaltung vorbereiten. Informationen zum Erstellen einer Anwendung und zum Registrieren von Ressourcen finden Sie unter Vorhandene Ressourcen bei einer Anwendung registrieren.

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

In App Hub können Sie diese Aktionen entweder über dieGoogle Cloud Console 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.

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 Anwendungen in App Hub benötigen:

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.

Anwendungen auflisten

So listen Sie alle Anwendungen innerhalb Ihrer Anwendungsverwaltungsgrenze auf und filtern sie:

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. Verwenden Sie das Feld Filter, um die Liste zu filtern. Sie können nach Attributen wie Kritikalität oder Umgebung filtern.

gcloud

  1. Suchen Sie die Projekt-ID Ihres Verwaltungsprojekts.

  2. Rufen Sie mit einer der folgenden Optionen eine Liste Ihrer Anwendungen auf:

    • Listen Sie alle Anwendungen auf:

      gcloud apphub applications list \
    --project=PROJECT_ID \
    --location=LOCATION

      Ersetzen Sie Folgendes:

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

    • Filtern Sie die Liste der Anwendungen anhand von Attributen mit dem Flag --filter:

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

      Ersetzen Sie Folgendes:

      • PROJECT_ID: die ID Ihres Verwaltungsprojekts.
      • LOCATION: der Standort Ihrer Anwendungen. Verwenden Sie global für globale Anwendungen oder eine bestimmte Region, z. B. us-east1, für regionale Anwendungen.
      • FILTER_EXPRESSION: der Filterausdruck zum Angeben von Attributen. Wenn Sie beispielsweise alle Anwendungen mit dem Umgebungstyp PRODUCTION auflisten möchten, verwenden Sie attributes.environment.type=PRODUCTION.

Anwendungsdetails ansehen

So rufen Sie die detaillierten Informationen zu einer bestimmten Anwendung, einschließlich ihrer Attribute und Metadaten, auf:

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, die Sie aufrufen möchten.

    Der Tab Details der Anwendung wird angezeigt.

gcloud

  1. Suchen Sie die Projekt-ID Ihres Verwaltungsprojekts.

  2. Anwendung beschreiben:

    gcloud apphub applications describe APPLICATION_NAME \
    --project=PROJECT_ID \
    --location=LOCATION

    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 Ihrer Anwendung. Verwenden Sie global für globale Anwendungen oder eine bestimmte Region, z. B. us-east1, für regionale Anwendungen.

Anwendungsattribute aktualisieren

So ändern Sie die Attribute einer Anwendung, nachdem sie erstellt wurde: Dienste und Arbeitslasten können bei der Registrierung auch dieselben Anwendungsattribute verwenden.

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 für die Anwendung, die Sie aktualisieren möchten, auf Bearbeiten.

  4. Ändern Sie im Bereich Anwendung bearbeiten die Felder nach Bedarf.

  5. Klicken Sie auf Speichern.

gcloud

  1. Suchen Sie die Projekt-ID Ihres Verwaltungsprojekts.

  2. Anwendungsattribute aktualisieren Sie können alle änderbaren Attribute wie display-name, criticality-type, environment-type und „owners“ aktualisieren:

    gcloud apphub applications update 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 Folgendes:

    • 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 Standort Ihrer Anwendung. Verwenden Sie global für globale Anwendungen oder eine bestimmte Region, z. B. us-east1, für regionale Anwendungen.
    • Optional: DISPLAY_NAME: der Anzeigename Ihrer Anwendung.

    • Optional: CRITICALITY_LEVEL: die Wichtigkeitsstufe der Anwendung. Verwenden Sie 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.

Terraform

Wenn Sie Anwendungsattribute mit Terraform aktualisieren möchten, ändern Sie die Argumente im Block der Ressource google_apphub_application in Ihrer Konfigurationsdatei. Wenn Sie die Änderungen anwenden, aktualisiert Terraform die Anwendung entsprechend der neuen Konfiguration.

Im folgenden Beispiel werden die Attribute für Wichtigkeit und Umgebung einer regionalen Anwendung in us-central1 aktualisiert:

resource "google_apphub_application" "example" {
    project        = "my-project-id"
    location       = "us-central1"
    application_id = "my-application"
    display_name   = "My Application"
    description    = "This application represents our platform."
    attributes {
        criticality {
            type = "HIGH" # Updated criticality
        }
        environment {
            type = "PRODUCTION"
        }
        # ... other attributes
    }
}

Anwendung löschen

Bevor Sie eine Anwendung löschen können, müssen Sie zuerst alle ihre Dienste und Arbeitslasten abmelden. Führen Sie dann die folgenden Schritte aus, um die Anwendung zu löschen:

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, die Sie löschen möchten.

  4. Rufen Sie den Tab Dienste und Arbeitslasten auf und prüfen Sie, ob Sie alle Anwendungskomponenten abgemeldet haben. Weitere Informationen finden Sie unter Dienste und Arbeitslasten abmelden.

  5. Nachdem alle Dienste und Arbeitslasten abgemeldet wurden, rufen Sie die Anwendungsdetails auf und klicken Sie auf Löschen.

gcloud

  1. Suchen Sie die Projekt-ID Ihres Verwaltungsprojekts.

  2. Prüfen Sie, ob Sie alle Anwendungskomponenten abgemeldet haben. Weitere Informationen finden Sie unter Registrierung von Diensten und Arbeitslasten aufheben.

  3. Wenn die Anwendung keine registrierten Komponenten mehr hat, löschen Sie sie:

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

    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 Ihrer Anwendung. Verwenden Sie global für globale Anwendungen oder eine bestimmte Region, z. B. us-east1, für regionale Anwendungen.

Terraform

Wenn Sie eine von Terraform verwaltete Anwendung löschen möchten, haben Sie folgende Möglichkeiten:

  • Ressource aus der Konfiguration entfernen: Löschen Sie den Ressourcenblock google_apphub_application aus der Terraform-Datei und führen Sie dann terraform apply aus. Terraform erkennt, dass die Ressource nicht mehr in der Konfiguration enthalten ist, und löscht sie aus Ihrem Projekt.
  • Alle Ressourcen beenden: Führen Sie den Befehl terraform destroy aus, um alle von Ihrer Terraform-Konfiguration verwalteten Ressourcen zu beenden, einschließlich der Anwendung.

Nächste Schritte