Vorbereitung
Führen Sie die folgenden Aufgaben aus, bevor Sie App Hub-Ressourcen ändern:
- Führen Sie die Voraussetzungen aus, um den App Hub einzurichten.
- Je nach Art der Ressource, die Sie ändern möchten, müssen Sie die Schritte zur Einrichtung des App Hubs ausgeführt haben. Weitere Informationen finden Sie unter App Hub einrichten.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für den App-fähigen Ordner zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Ändern von App Hub-Ressourcen benötigen:
-
So erstellen und aktualisieren Sie Anwendungen, registrieren und heben Sie die Registrierung von Diensten und Arbeitslasten auf und aktualisieren Sie die zugehörigen Attribute:
-
App Hub-Administrator (
roles/apphub.admin
) -
App Hub-Bearbeiter (
roles/apphub.editor
)
-
App Hub-Administrator (
-
So rufen Sie Anwendungen, Dienste, Arbeitslasten und ihre Attribute auf:
App Hub-Betrachter (
roles/apphub.viewer
) -
So rufen Sie Anwendungen, Dienste und Arbeitslasten und ihre Attribute in Google Cloud Diensten auf, die die Anwendungsverwaltung unterstützen:
App Hub Management Viewer (
roles/apphub.appManagementViewer
)
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.
Anwendungen auflisten
Sie können Apps in einem app-fähigen Ordner auflisten und filtern.
Console
Wenn Sie Anwendungen in einem für Apps aktivierten Ordner aufrufen möchten, rufen Sie in der Google Cloud Console die Seite Anwendungen des App Hubs auf.
So filtern Sie Anwendungen:
- Wählen Sie im Feld Filter einen Filter aus, z. B. Kritisch.
- Geben Sie einen Wert für den Filter an. Wenn Sie beispielsweise Anwendungen mit hoher Kritikalität anzeigen möchten, wählen Sie Hoch als Wert aus.
Es wird eine Liste der Anwendungen angezeigt, die dem angegebenen Filter entsprechen.
gcloud
So rufen Sie Anwendungen in einem für Apps aktivierten Ordner auf:
gcloud apphub applications list \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Ersetzen Sie Folgendes:
MANAGEMENT_PROJECT_ID
: die ID Ihres Verwaltungsprojekts. Sie finden die ID Ihres Verwaltungsprojekts auf der Seite IAM- und Administratoreinstellungen der Google Cloud Console. Wenn Sie die Verwaltungsprojekt-ID nicht finden, befinden Sie sich möglicherweise nicht in einem App-kompatiblen Ordner. Wählen Sie in der Purview-Auswahl (oder Projektauswahl) den für Anwendungen aktivierten Ordner aus. Weitere Informationen zum Aktivieren eines Ordners für die Anwendungsverwaltung finden Sie unter Anwendungsverwaltung aktivieren.REGION
: die Region der Anwendung. Geben Sie hier je nach--scope-type
der Anwendung den Wertglobal
oder die Region der Anwendung an, z. B.us-east1
. Weitere Informationen zum Festlegen der--scope-type
für die Anwendung finden Sie unter Anwendung erstellen.
Wenn Sie die Anwendungen nach Variablenattributen filtern möchten, verwenden Sie das Flag
--filter
. So listen Sie beispielsweise alle Anwendungen auf, bei denen dasenvironment-type
-Attribut aufPRODUCTION
gesetzt ist:gcloud apphub applications list \ --filter='attributes.environment.type=PRODUCTION' \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Anwendung ansehen
Sie können eine Anwendung in einem App-fähigen Ordner beschreiben.
Console
Rufen Sie in der Google Cloud Console die Seite Anwendungen des App Hubs auf.
Klicken Sie in der Liste der Anwendungen auf die Anwendung, deren Details Sie sehen möchten.
Klicken Sie auf den Tab Details, um die Details der Anwendung aufzurufen.
gcloud
gcloud apphub applications describe APPLICATION_NAME \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Ersetzen Sie APPLICATION_NAME
durch den Namen der Anwendung. Der Name darf nur Kleinbuchstaben und alphanumerische Zeichen ohne Leerzeichen enthalten.
App Hub-Anwendung aktualisieren
Sie können die Attribute Ihrer Anwendung nach dem Erstellen aktualisieren.
Console
Rufen Sie in der Google Cloud Console die Seite Anwendungen des App Hubs auf.
Klicken Sie in der Liste der Anwendungen neben der Anwendung, die Sie aktualisieren möchten, auf
Bearbeiten.Bearbeiten Sie die Felder nach Bedarf.
Klicken Sie auf Speichern.
gcloud
Aktualisieren Sie Ihre Anwendung mit den Attributen
criticality-type
,environment-type
und „Inhabertyp“:gcloud apphub applications update APPLICATION_NAME \ --display-name='APPLICATION_DISPLAY_NAME' \ --criticality-type='CRITICALITY_LEVEL' \ --environment-type='ENVIRONMENT' \ --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \ --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \ --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Ersetzen Sie Folgendes:
APPLICATION_NAME
ist der Name Ihrer Anwendung. Der Name darf nur Kleinbuchstaben und alphanumerische Zeichen ohne Leerzeichen enthalten.REGION
: die Region der Anwendung.
Sie können folgende Angaben aktualisieren:
APPLICATION_DISPLAY_NAME
: Der Anzeigename der Anwendung.CRITICALITY_LEVEL
: Gibt an, wie wichtig eine Anwendung, ein Dienst oder eine Arbeitslast für Ihr Unternehmen ist. Geben Sie einen der folgenden Werte an:MISSION_CRITICAL
HIGH
MEDIUM
LOW
ENVIRONMENT
: gibt die Phasen des Softwarelebenszyklus an. Geben Sie einen der folgenden Werte an:PRODUCTION
STAGING
DEVELOPMENT
TEST
DISPLAY-NAME-DEVELOPER
,DISPLAY-NAME-OPERATOR
undDISPLAY-NAME-BUSINESS
: Anzeigenamen des Entwicklers, Betreibers und Inhabers des Unternehmens.EMAIL-NAME-DEVELOPER
,EMAIL-NAME-OPERATOR
undEMAIL-NAME-BUSINESS
: E-Mail-Adressen des Entwicklers, Betreibers und des Unternehmensinhabers. Diese Werte müssen das Formatusername@yourdomain
haben, z. B.222larabrown@gmail.com
.
Beispiel:
gcloud apphub applications update my-application \ --criticality-type='MEDIUM' \ --environment-type='STAGING' \ --developer-owners=display-name=developer-name,email=username@yourdomain \ --project=google-mpf-FOLDER-ID \ --location=us-east1
Dienste und Arbeitslasten ansehen
Sie können Dienste und Arbeitslasten in einer Anwendung aufrufen, auflisten und filtern.
Console
So listen Sie Dienste und Arbeitslasten auf:
Rufen Sie in der Google Cloud Console die Seite Dienste und Arbeitslasten des App Hubs auf.
Wählen Sie in der Liste Region die Regionen aus, für die Sie die Dienste und Arbeitslasten aufrufen möchten. Wählen Sie beispielsweise us-east1 aus.
Auf der Seite Dienste und Arbeitslasten werden alle Dienste und Arbeitslasten aus den angehängten Dienstprojekten angezeigt, die mit us-east1 verknüpft sind.
So filtern Sie die Dienste oder Arbeitslasten:
- Wählen Sie im Feld Filter einen Filter aus, z. B. Umgebung.
- Geben Sie einen Wert für den Filter an. Wenn Sie beispielsweise Dienste und Arbeitslasten in der Produktion ansehen möchten, wählen Sie Produktion als Wert aus.
Es wird eine Liste der Dienste und Arbeitslasten angezeigt, die dem angegebenen Filter entsprechen.
gcloud
Gefundene Dienste auflisten
Gefundene Dienste können für eine Anwendung registriert werden.
So listen Sie gefundene Dienste auf:
gcloud apphub discovered-services list \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Die Ausgabe sollte in etwa so aussehen:
ID SERVICE_REFERENCE SERVICE_PROPERTIES [DISCOVERED_SERVICE_ID] {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-1'} {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}
Optional: Filtern Sie die Liste der gefundenen Dienste. So filtern Sie beispielsweise die erkannten Dienste mit Weiterleitungsregeln im Ordner, der für die App aktiviert ist:
gcloud apphub discovered-services list \ --filter='service_reference.uri~"forwardingRules"' \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Registrierte Dienste auflisten
Registrierte App Hub-Dienste aus einer Anwendung auflisten und filtern
So listen Sie registrierte Dienste in einer Anwendung auf:
gcloud apphub applications services list \ --application=APPLICATION_NAME \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Die Ausgabe sollte in etwa so aussehen:
ID DISPLAY_NAME SERVICE_REFERENCE CREATE_TIME SERVICE_NAME mywebserver-service1 {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule'} 2023-11-01T21:38:08
Registrierte, aber getrennte Dienste sind durch einen leeren Wert im Feld
SERVICE_REFERENCE
gekennzeichnet.Optional: Filtern Sie die Liste der registrierten Dienste. So filtern Sie beispielsweise die registrierten Dienste in einer Anwendung, in der das
environment-type
-Attribut aufPRODUCTION
gesetzt ist:gcloud apphub applications services list \ --filter='attributes.environment.type=PRODUCTION' \ --application=APPLICATION_NAME \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Gefundene Arbeitslasten auflisten
Erkannte Arbeitslasten können bei einer Anwendung registriert werden.
So listen Sie erkannte Arbeitslasten auf:
gcloud apphub discovered-workloads list \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Die Ausgabe sollte in etwa so aussehen und nicht registrierte MIGs enthalten:
ID WORKLOAD_REFERENCE WORKLOAD_PROPERTIES [DISCOVERED_WORKLOAD_ID] {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/instanceGroups/testing-mig'} {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}
Optional: Filtern Sie die Liste der erkannten Arbeitslasten. So filtern Sie beispielsweise die Liste der erkannten Arbeitslasten mit Rechenressourcen in einem app-fähigen Ordner:
gcloud apphub discovered-workloads list \ --filter='workload_reference.uri~"compute"' --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Registrierte Arbeitslasten auflisten
Registrierte App Hub-Arbeitslasten aus einer Anwendung auflisten und filtern
So listen Sie registrierte Arbeitslasten in einer Anwendung auf:
gcloud apphub applications workloads list \ --application=APPLICATION_NAME \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Die Ausgabe sollte in etwa so aussehen:
ID DISPLAY_NAME WORKLOAD_REFERENCE CREATE_TIME WORKLOAD_NAME mywebserver-deployment1 {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/instanceGroups/testing-mig'} 2023-10-31T18:34:23
Registrierte, aber getrennte Arbeitslasten werden durch einen leeren Wert im Feld
WORKLOAD_REFERENCE
gekennzeichnet. Weitere Informationen zu den Registrierungsstatus finden Sie unter Eigenschaften und Attribute des App Hub.Optional: Filtern Sie die Liste der registrierten Arbeitslasten. So filtern Sie beispielsweise die Arbeitslasten in einer Anwendung, in der das Attribut
environment-type
aufPRODUCTION
festgelegt ist:gcloud apphub applications workloads list \ --filter='attributes.environment.type=PRODUCTION' \ --application=APPLICATION_NAME \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Dienste und Arbeitslasten aktualisieren
Sie können die Dienste und Arbeitslasten aktualisieren, die für eine Anwendung registriert sind.
Console
Rufen Sie in der Google Cloud Console die Seite Anwendungen des App Hubs auf.
Klicken Sie auf den Namen Ihrer Anwendung.
Auf dem Tab Dienste und Arbeitslasten wird eine Liste der registrierten Dienste und Arbeitslasten in Ihren Dienstprojekten angezeigt.Gehen Sie für jeden Dienst oder jede Arbeitslast, die Sie aktualisieren möchten, so vor:
- Klicken Sie auf dem Tab Dienste und Arbeitslasten neben dem Dienst oder der Arbeitslast, den bzw. die Sie aktualisieren möchten, auf das Dreipunkt-Menü und dann auf Dienst bearbeiten oder Arbeitslast bearbeiten.
- Bearbeiten Sie im Bereich Dienst bearbeiten oder Arbeitslast bearbeiten die Felder nach Bedarf und klicken Sie auf Speichern.
gcloud
Aktualisieren Sie Ihren Dienst mit den Attributen
criticality-type
,environment-type
und „owner_type“:gcloud apphub applications services update SERVICE_NAME \ --application=APPLICATION_NAME \ --display-name='SERVICE_DISPLAY_NAME' \ --criticality-type='CRITICALITY_LEVEL' \ --environment-type='ENVIRONMENT' \ --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \ --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \ --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Ersetzen Sie
SERVICE_NAME
durch den Namen des App Hub-Dienstes.Sie können folgende Angaben aktualisieren:
SERVICE_DISPLAY_NAME
: Gibt einen Anzeigenamen für den Dienst an.CRITICALITY_LEVEL
: Gibt an, wie wichtig eine Anwendung, ein Dienst oder eine Arbeitslast für Ihr Unternehmen ist. Geben Sie einen der folgenden Werte an:MISSION_CRITICAL
HIGH
MEDIUM
LOW
ENVIRONMENT
: gibt die Phasen des Softwarelebenszyklus an. Geben Sie einen der folgenden Werte an:PRODUCTION
STAGING
DEVELOPMENT
TEST
DISPLAY-NAME-DEVELOPER
,DISPLAY-NAME-OPERATOR
undDISPLAY-NAME-BUSINESS
: Anzeigenamen des Entwicklers, Betreibers und Inhabers des Unternehmens.EMAIL-NAME-DEVELOPER
,EMAIL-NAME-OPERATOR
undEMAIL-NAME-BUSINESS
: E-Mail-Adressen des Entwicklers, Betreibers und des Unternehmensinhabers. Diese Werte müssen das Formatusername@yourdomain
haben, z. B.222larabrown@gmail.com
.
Beispiel:
gcloud apphub applications workloads update my-application \ --criticality-type='MEDIUM' \ --environment-type='STAGING' \ --developer-owners=display-name=developer-name,email=username@yourdomain \ --project=google-mpf-FOLDER-ID \ --location=us-east1
Aktualisieren Sie Ihre Arbeitslast mit den Attributen
criticality-type
,environment-type
und „Owner Type“:gcloud apphub applications workloads update WORKLOAD_NAME \ --application=APPLICATION_NAME \ --display-name='WORKLOAD_DISPLAY_NAME' \ --criticality-type='CRITICALITY_LEVEL' \ --environment-type='ENVIRONMENT' \ --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \ --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \ --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Ersetzen Sie
WORKLOAD_NAME
durch den Namen der App Hub-Arbeitslast.Sie können folgende Angaben aktualisieren:
WORKLOAD_DISPLAY_NAME
: Gibt einen Anzeigenamen für den Dienst an.CRITICALITY_LEVEL
: Gibt an, wie wichtig eine Anwendung, ein Dienst oder eine Arbeitslast für Ihr Unternehmen ist. Geben Sie einen der folgenden Werte an:MISSION_CRITICAL
HIGH
MEDIUM
LOW
ENVIRONMENT
: gibt die Phasen des Softwarelebenszyklus an. Geben Sie einen der folgenden Werte an:PRODUCTION
STAGING
DEVELOPMENT
TEST
DISPLAY-NAME-DEVELOPER
,DISPLAY-NAME-OPERATOR
undDISPLAY-NAME-BUSINESS
: Anzeigenamen des Entwicklers, Betreibers und Inhabers des Unternehmens.EMAIL-NAME-DEVELOPER
,EMAIL-NAME-OPERATOR
undEMAIL-NAME-BUSINESS
: E-Mail-Adressen des Entwicklers, Betreibers und des Unternehmensinhabers. Diese Werte müssen das Formatusername@yourdomain
haben, z. B.222larabrown@gmail.com
.
Beispiel:
gcloud apphub applications workloads update my-application \ --criticality-type='MEDIUM' \ --environment-type='STAGING' \ --developer-owners=display-name=developer-name,email=username@yourdomain \ --project=google-mpf-FOLDER-ID \ --location=us-east1
Anwendungen, Dienste und Arbeitslasten löschen
Löschen Sie eine vorhandene Anwendung, um registrierte Ressourcen zu entfernen, die mit dem app-fähigen Ordner verknüpft sind. Dazu müssen Sie zuerst die Arbeitslasten und Dienste abmelden, die für die Anwendung registriert sind.
Console
Rufen Sie in der Google Cloud Console die Seite Anwendungen des App Hubs auf.
Klicken Sie auf den Namen einer Anwendung. Eine Liste der für die Anwendung registrierten Dienste und Arbeitslasten wird angezeigt.
Dienst oder Arbeitslast abmelden
- Klicken Sie auf dem Tab Dienste und Arbeitslasten im Bereich Registrierte Dienste und Arbeitslasten auf den Namen des Dienstes oder der Arbeitslast, die Sie abmelden möchten.
- Klicken Sie auf der Seite für den registrierten Dienst oder die registrierte Arbeitslast auf Abmelden, um den Dienst oder die Arbeitslast als Erkannte Ressource zu aktualisieren. Auf dem Tab Dienste und Arbeitslasten wird in einer Benachrichtigung angezeigt, dass die Arbeitslast nicht registriert ist.
- Wiederholen Sie diese Anleitung für jeden Dienst und jede Arbeitslast.
Rufen Sie die Seite Anwendungen im App Hub auf.
Klicken Sie auf den Namen einer Anwendung.
Klicken Sie auf der Seite mit den Anwendungsdetails auf Löschen.
gcloud
Listen Sie die registrierten Dienste in der Anwendung auf:
gcloud apphub applications services list \ --application=APPLICATION_NAME \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Melden Sie den Dienst von der Anwendung ab:
gcloud apphub applications services delete SERVICE_NAME \ --application=APPLICATION_NAME \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Der Dienst ist jetzt ein gefundener Dienst, der für die Anwendung registriert werden kann.
Wiederholen Sie den vorherigen Befehl, um die Registrierung aller verbleibenden registrierten Dienste von der Anwendung aufzuheben.
Listen Sie die registrierten Arbeitslasten in der Anwendung auf:
gcloud apphub applications workloads list \ --application=APPLICATION_NAME \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
So melden Sie die Arbeitslast von der Anwendung ab:
gcloud apphub applications workloads delete WORKLOAD_NAME \ --application=APPLICATION_NAME \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Die Arbeitslast ist jetzt eine erkannte Arbeitslast, die bei der Anwendung registriert werden kann.
Wiederholen Sie den vorherigen Befehl, um alle verbleibenden registrierten Arbeitslasten aus der Anwendung zu löschen.
So löschen Sie die Anwendung:
gcloud apphub applications delete APPLICATION_NAME \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Nächste Schritte
- Anwendungsmonitoring einrichten
- IAM-Rollen und -Berechtigungen für den App Hub
- App Hub – Übersicht
- Fehlerbehebung