Kataloge verwalten, veröffentlichen und freigeben

Wenn Sie Anwendungsvorlagen und Komponentenvorlagen in einen Gruppenbereich importieren, können andere Mitglieder des Gruppenbereichs auf Ihre Vorlagen zugreifen. In diesem Dokument erfahren Sie, wie Sie Vorlagen außerhalb Ihres Gruppenbereichs freigeben, indem Sie Vorlagen in einem Katalog veröffentlichen und diesen Katalog für die entsprechenden Gruppenbereiche freigeben.

Jeder Gruppenbereich enthält einen einzelnen Katalog, in dem Sie Vorlagen hinzufügen und die Freigabe steuern können. Sie können einen Katalog aus dem Gruppenbereich, den Sie in Ihrer ursprünglichen Grenze zur Anwendungsverwaltung erstellt haben, für Gruppenbereiche in anderen Grenzen zur Anwendungsverwaltung freigeben.

Hinweis

Bitten Sie Ihren Administrator, Ihnen die erforderlichen Rollen für den Ordner mit aktivierter App oder das Verwaltungsprojekt zuzuweisen, um die Aufgaben in diesem Dokument auszuführen. Die erforderlichen Rollen sind in der folgenden Tabelle aufgeführt:

Aufgabe Erforderliche Rollen
Anwendungsvorlagen in einem Gruppenbereichskatalog veröffentlichen App Design Center-Administrator (roles/designcenter.admin)
Katalog für Zielgruppenbereiche freigeben App Design Center-Administrator (roles/designcenter.admin)

Weitere Informationen zu Rollen finden Sie unter Zugriffssteuerung mit IAM.

Führen Sie die folgenden Schritte aus, bevor Sie Kataloge verwalten:

  • Führen Sie die Ersteinrichtung von App Design Center aus.
  • Informationen zum Erstellen von Gruppenbereichen zusätzlich zu Ihrem ursprünglichen Gruppenbereich finden Sie unter Gruppenbereiche verwalten.

Anwendungsvorlage in einem Katalog veröffentlichen

Bevor Sie eine Vorlage für andere Gruppenbereiche freigeben können, müssen Sie sie in Ihrem Katalog veröffentlichen.

Design-Canvas

  1. Klicken Sie im Navigationsmenü auf Kataloge.

    Zu den Katalogen

  2. Klicken Sie auf Vorlagen hinzufügen.

  3. Gehen Sie im Bereich Vorlagen zum Standardkatalog hinzufügen so vor:

    1. Wenn Sie eine bestimmte Vorlage suchen möchten, geben Sie den Namen der Vorlage in das Feld Filter ein.
    2. Wenn Sie diesem Katalog eine Vorlage hinzufügen möchten, klicken Sie in der Spalte Aktionen auf Zum Katalog hinzufügen.

  4. Klicken Sie auf Fertig. Die Gruppenbereiche, die Zugriff auf den Katalog haben, haben auch Zugriff auf die ausgewählten Vorlagen.

  5. Informationen zum Freigeben des Katalogs finden Sie unter Katalog für einen Gruppenbereich freigeben.

gcloud CLI

  1. Ermitteln Sie die Katalog-ID für den Katalog, dem Sie Ihre Vorlage hinzufügen möchten.

    gcloud design-center spaces catalogs list \
--project=PROJECT \
--location=LOCATION \
--space=SPACE

    Ersetzen Sie Folgendes:

    • PROJECT: Ihre Verwaltungs-Projekt-ID.
    • LOCATION: Die Katalogregion.
    • SPACE: Ihre Gruppenbereichs-ID.

    Weitere Informationen finden Sie unter gcloud design-center spaces catalogs list.

  2. Ermitteln Sie die Vorlagen-ID für die Vorlage, die Sie Ihrem Katalog hinzufügen möchten. Mit dem folgenden Befehl werden beispielsweise Anwendungsvorlagen aufgelistet.

    gcloud design-center spaces application-templates list \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--filter=FILTER

    Ersetzen Sie Folgendes:

    • PROJECT: Ihre Verwaltungs-Projekt-ID.
    • LOCATION: Die Katalogregion.
    • SPACE: Ihre Gruppenbereichs-ID.
    • FILTER: Ein Filter, mit dem Sie die Suchergebnisse eingrenzen können. Beispiel: "displayName:my-app-template*"

    Weitere Informationen finden Sie unter gcloud design-center spaces application-templates list.

  3. Führen Sie einen Commit für die Anwendungsvorlage aus.

     gcloud design-center spaces application-templates commit TEMPLATE \
 --project=PROJECT \
 --location=LOCATION \
 --space=SPACE

    Ersetzen Sie Folgendes:

    • TEMPLATE: Die Vorlagen-ID für die Vorlage, für die ein Commit ausgeführt werden soll.
    • PROJECT: Ihre Verwaltungs-Projekt-ID.
    • LOCATION: Die Region der Anwendungsvorlage.
    • SPACE: Ihre Gruppenbereichs-ID.

    Weitere Informationen finden Sie unter gcloud design-center spaces application-templates commit.

  4. Kopieren Sie die name-Ausgabe aus dem Commit-Befehl. Sie geben diesen Namen als Wert für application-template-revision-source an, wenn Sie Ihre Katalogvorlagenversion erstellen.

  5. Prüfen Sie, ob sich die Anwendungsvorlage noch nicht im Katalog befindet.

    gcloud design-center spaces catalogs templates list \
--catalog=CATALOG \
--project=PROJECT \
--location=LOCATION \
--space=SPACE

    Ersetzen Sie Folgendes:

    • CATALOG: Ihre Katalog-ID. Beispiel: default-catalog.
    • PROJECT: Ihre Verwaltungs-Projekt-ID.
    • LOCATION: Die Katalogregion.
    • SPACE: Ihre Gruppenbereichs-ID.

    Weitere Informationen finden Sie unter gcloud design-center spaces catalogs templates list.

  6. Wenn sich die Anwendungsvorlage nicht im Katalog befindet, erstellen Sie die Katalogvorlage.

    gcloud design-center spaces catalogs templates create CATALOG_TEMPLATE \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--catalog=CATALOG \
--template-category=TEMPLATE_CATEGORY

    Ersetzen Sie Folgendes:

    • CATALOG_TEMPLATE: Die Katalogvorlagen-ID für die Katalogvorlage, die Sie erstellen möchten.
    • PROJECT: Ihre Verwaltungs-Projekt-ID.
    • LOCATION: Die Katalogregion.
    • SPACE: Ihre Gruppenbereichs-ID.
    • CATALOG: Ihre Katalog-ID.
    • TEMPLATE_CATEGORY: Die Vorlagenkategorie. Beispiel: application-template.

    Weitere Informationen finden Sie unter gcloud design-center spaces catalogs templates create.

  7. Erstellen Sie eine Katalogvorlagenversion. Dadurch wird die erste Version erstellt, die Entwickler als Quelle für eine Anwendung verwenden.

    gcloud design-center spaces catalogs templates revisions create REVISION \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--catalog=CATALOG \
--template=CATALOG_TEMPLATE \
--application-template-revision-source=APPLICATION_TEMPLATE_REVISION_SOURCE

    Ersetzen Sie Folgendes:

    • REVISION: Die Versions-ID für die Version, die Sie erstellen möchten. Beispiel: r1.
    • PROJECT: Ihre Verwaltungs-Projekt-ID.
    • LOCATION: Die Katalogregion.
    • SPACE: Ihre Gruppenbereichs-ID.
    • CATALOG: Ihre Katalog-ID.
    • CATALOG_TEMPLATE: Die Vorlagen-ID.
    • APPLICATION_TEMPLATE_REVISION_SOURCE: Die Quelle der Anwendungsvorlagenversion. Sie haben diesen Wert kopiert, als Sie einen Commit für Ihre Anwendungsvorlage ausgeführt haben. Beispiel: projects/my-project/locations/us-central1/spaces/my-space/applicationTemplates/my-app-template/revisions/r1.

    Weitere Informationen finden Sie unter gcloud design-center spaces catalogs templates revisions create.

Überarbeitete Vorlagen freigeben

Wenn Sie Änderungen an einer Vorlage vornehmen, werden diese Änderungen nicht automatisch im Katalog veröffentlicht. Wenn Sie die neueste Version freigeben möchten, veröffentlichen Sie die Vorlage noch einmal im Katalog.

Vorlagen aus einem Katalog entfernen

Wenn Sie eine bestimmte Vorlage nicht mehr für einen Gruppenbereich freigeben möchten, entfernen Sie sie aus dem Katalog.

Design-Canvas

  1. Klicken Sie im Navigationsmenü auf Kataloge.

    Zu den Katalogen

  2. Wenn Sie die Vorlagen in diesem Katalog verwalten möchten, klicken Sie auf Vorlagen im Katalog.

  3. Wenn Sie eine Vorlage entfernen möchten, klicken Sie auf Aktionen und wählen Sie Aus Katalog entfernen aus.

    1. Geben Sie im Feld den Namen der Vorlage ein.
    2. Klicken Sie auf Entfernen.

gcloud CLI

Entfernen Sie eine Vorlage aus Ihrem Katalog.

gcloud design-center spaces catalogs templates delete CATALOG_TEMPLATE \
--catalog=CATALOG \
--project=PROJECT \
--location=LOCATION \
--space=SPACE

Ersetzen Sie Folgendes:

  • CATALOG_TEMPLATE: Die Katalogvorlagen-ID für die Vorlage, die Sie aus dem Katalog entfernen möchten.
  • CATALOG: Ihre Katalog-ID.
  • PROJECT: Ihre Verwaltungs-Projekt-ID.
  • LOCATION: Die Katalogregion.
  • SPACE: Ihre Gruppenbereichs-ID.

Weitere Informationen finden Sie unter gcloud design-center spaces catalogs templates delete.

Katalog für einen Gruppenbereich freigeben

Sie können einen Katalog nur für einen Zielgruppenbereich freigeben, der sich in derselben Region wie der Quellgruppenbereich befindet, aber in einer anderen Grenze zur Anwendungsverwaltung.

So geben Sie Ihren Katalog für einen Gruppenbereich frei:

Design-Canvas

  1. Klicken Sie im Navigationsmenü auf Kataloge.

    Zu den Katalogen

  2. Klicken Sie auf Katalog freigeben.

  3. Wählen Sie im Feld Freigeben für aus, ob sich der Zielgruppenbereich in einem der folgenden Bereiche befindet:

    • Ordner: Eine Grenze zur Anwendungsverwaltung auf Ordnerebene.
    • Projekt: Eine Grenze zur Anwendungsverwaltung auf Projektebene.

  4. Geben Sie im Feld Projekt-/Ordner-ID die Projekt- oder Ordner-ID für die Grenze zur Anwendungsverwaltung ein, in der sich der Zielgruppenbereich befindet.

    Der Gruppenbereich in derselben Region wie Ihr ursprünglicher Gruppenbereich wird automatisch im Feld Name des Gruppenbereichs eingefügt.

  5. Klicken Sie auf Freigeben.

    Entwickler können die Vorlagen aus einem freigegebenen Katalog ansehen, indem sie ihren Gruppenbereich in App Design Center öffnen und im Navigationsmenü auf Freigegebene Vorlagen klicken.

gcloud CLI

Geben Sie einen Katalog für einen Gruppenbereich frei.

gcloud design-center spaces catalogs shares create SHARE \
--project=PROJECT \
--space=SPACE \
--location=LOCATION \
--catalog=CATALOG \
--destination-space=DESTINATION_SPACE

Ersetzen Sie Folgendes:

  • SHARE: Die Freigabe-ID für die Freigabe, die Sie löschen möchten.
  • PROJECT: Ihre Verwaltungs-Projekt-ID.
  • SPACE: Ihre Gruppenbereichs-ID.
  • LOCATION: Die Katalogregion.
  • CATALOG: Die Katalog-ID für den Katalog, den Sie freigeben.
  • DESTINATION_SPACE: Der voll qualifizierte Name des Gruppenbereichs, für den Sie die Freigabe durchführen. Beispiel: projects/my-project/locations/us-central1/spaces/my-space.

Weitere Informationen finden Sie unter gcloud design-center spaces catalogs shares create.

Freigabe eines Katalogs für einen Gruppenbereich beenden

Wenn Sie einen Katalog nicht mehr für einen Gruppenbereich freigeben möchten, beenden Sie die Freigabe des Katalogs. Gehen Sie dazu so vor:

Design-Canvas

  1. Klicken Sie im Navigationsmenü auf Kataloge.

    Zu den Katalogen

  2. Klicken Sie auf Freigegebene Gruppenbereiche.

  3. Wenn Sie die Freigabe dieses Katalogs für einen Gruppenbereich beenden möchten, klicken Sie auf „“.

    Klicken Sie auf Aktionen und wählen Sie Freigabe beenden aus.

    1. Geben Sie im Feld den Namen des Gruppenbereichs ein.
    2. Klicken Sie auf Freigabe beenden.

gcloud CLI

Beenden Sie die Freigabe eines Katalogs für einen Gruppenbereich.

gcloud design-center spaces catalogs shares delete SHARE \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--catalog=CATALOG

Ersetzen Sie Folgendes:

  • SHARE: Die Freigabe-ID für die Freigabe, die Sie löschen möchten.
  • PROJECT: Ihre Verwaltungs-Projekt-ID.
  • LOCATION: Die Katalogregion.
  • SPACE: Ihre Gruppenbereichs-ID.
  • CATALOG: Die Katalog-ID für den Katalog, den Sie freigeben.

Weitere Informationen finden Sie unter gcloud design-center spaces catalogs shares delete.

Katalogmetadaten bearbeiten

Wenn Sie Ihren Katalog verwalten möchten, können Sie ihm einen beschreibenden Namen und eine Beschreibung geben. Gehen Sie dazu so vor:

Design-Canvas

  1. Klicken Sie im Navigationsmenü auf Kataloge.

    Zu den Katalogen

  2. Prüfen Sie die Katalogdetails.

  3. So ändern Sie den Anzeigenamen:

    1. Klicken Sie auf Anzeigenamen bearbeiten.
    2. Geben Sie im Feld Anzeigename den neuen Namen ein.
    3. Klicken Sie auf Speichern.

  4. So ändern Sie die Beschreibung:

    1. Klicken Sie auf Beschreibung bearbeiten.
    2. Geben Sie im Feld Beschreibung die neue Beschreibung ein.
    3. Klicken Sie auf Speichern.

gcloud CLI 

gcloud design-center spaces catalogs update CATALOG \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--description=DESCRIPTION \
--display-name=DISPLAY_NAME

Ersetzen Sie Folgendes:

  • CATALOG: Ihre Katalog-ID.
  • PROJECT: Ihre Verwaltungs-Projekt-ID.
  • LOCATION: Die Katalogregion.
  • SPACE: Ihre Gruppenbereichs-ID.
  • DESCRIPTION: Die Katalogbeschreibung.
  • DISPLAY_NAME: Der Anzeigename des Katalogs.

Weitere Informationen finden Sie unter gcloud design-center spaces catalogs update.

Nächste Schritte