Gérer, publier et partager des catalogues

Lorsque vous créez des modèles d'application et importez des modèles de composants dans un espace, les autres membres de l'espace peuvent accéder à vos modèles. Ce document vous aide à partager des modèles en dehors de votre espace en les publiant dans un catalogue, puis en partageant ce catalogue avec les espaces appropriés.

Chaque espace contient un seul catalogue dans lequel vous pouvez ajouter des modèles et contrôler le partage. Vous pouvez partager un catalogue de l'espace que vous avez créé dans votre limite de gestion des applications initiale avec des espaces situés dans d'autres limites de gestion des applications.

Avant de commencer

Avant de gérer votre catalogue, procédez comme suit :

  • Vous devez disposer du rôle Administrateur App Design Center (roles/designcenter.admin) dans le dossier ou le projet de gestion pour lequel les applications sont activées.

  • Effectuez la configuration initiale d'App Design Center.

  • Pour créer des espaces en plus de votre espace initial, consultez Gérer les espaces.

Publier un modèle d'application dans un catalogue

Avant de pouvoir partager un modèle avec d'autres espaces, publiez-le dans votre catalogue.

Canevas de conception

  1. Dans le menu de navigation, cliquez sur Catalogues.

    Accéder aux catalogues

  2. Cliquez sur Ajouter des modèles.

  3. Dans la section Ajouter des modèles au catalogue par défaut, procédez comme suit :

    1. Pour trouver un modèle spécifique, saisissez son nom dans le champ Filtrer.
    2. Pour ajouter un modèle à ce catalogue, dans la colonne Actions, cliquez sur Ajouter au catalogue.

  4. Cliquez sur OK. Les espaces ayant accès au catalogue ont accès aux modèles sélectionnés.

  5. Pour partager le catalogue, consultez Partager un catalogue avec un espace.

CLI gcloud

  1. Identifiez l'ID du catalogue auquel vous souhaitez ajouter votre modèle.

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

    Remplacez les éléments suivants :

    • PROJECT : ID de votre projet.
    • LOCATION : région du catalogue.
    • SPACE : ID de votre espace.

    Pour en savoir plus, consultez gcloud design-center spaces catalogs list.

  2. Identifiez l'ID du modèle que vous souhaitez ajouter à votre catalogue. Par exemple, la commande suivante liste les modèles d'application.

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

    Remplacez les éléments suivants :

    • PROJECT : ID de votre projet.
    • LOCATION : région du catalogue.
    • SPACE : ID de votre espace.
    • FILTER : filtre permettant d'affiner les résultats de recherche. Par exemple, "displayName:my-app-template*".

    Pour en savoir plus, consultez gcloud design-center spaces application-templates list.

  3. Validez le modèle d'application.

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

    Remplacez les éléments suivants :

    • TEMPLATE : ID du modèle à valider.
    • PROJECT : ID de votre projet.
    • LOCATION : région du modèle d'application.
    • SPACE : ID de votre espace.

    Pour en savoir plus, consultez gcloud design-center spaces application-templates commit.

  4. Copiez la sortie name de la commande "commit". Vous spécifierez ce nom comme valeur application-template-revision-source lorsque vous créerez la révision de votre modèle de catalogue.

  5. Assurez-vous que le modèle d'application ne figure pas déjà dans le catalogue.

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

    Remplacez les éléments suivants :

    • CATALOG : ID de votre catalogue. Exemple :default-catalog
    • PROJECT : ID de votre projet.
    • LOCATION : région du catalogue.
    • SPACE : ID de votre espace.

    Pour en savoir plus, consultez gcloud design-center spaces catalogs templates list.

  6. Si le modèle d'application ne figure pas dans le catalogue, créez-le.

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

    Remplacez les éléments suivants :

    • CATALOG_TEMPLATE : ID du modèle de catalogue que vous souhaitez créer.
    • PROJECT : ID de votre projet.
    • LOCATION : région du catalogue.
    • SPACE : ID de votre espace.
    • CATALOG : ID de votre catalogue.
    • TEMPLATE_CATEGORY : catégorie du modèle. Exemple :application-template

    Pour en savoir plus, consultez gcloud design-center spaces catalogs templates create.

  7. Créez une révision du modèle de catalogue. Cela crée la première révision, que les développeurs utilisent comme source pour une application.

    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

    Remplacez les éléments suivants :

    • REVISION : ID de révision de la révision que vous souhaitez créer. Exemple :r1
    • PROJECT : ID de votre projet.
    • LOCATION : région du catalogue.
    • SPACE : ID de votre espace.
    • CATALOG : ID de votre catalogue.
    • CATALOG_TEMPLATE : ID du modèle.
    • APPLICATION_TEMPLATE_REVISION_SOURCE : source de révision du modèle d'application. Vous avez copié cette valeur lorsque vous avez validé votre modèle d'application. Exemple :projects/my-project/locations/us-central1/spaces/my-space/applicationTemplates/my-app-template/revisions/r1

    Pour en savoir plus, consultez gcloud design-center spaces catalogs templates revisions create.

Partager des modèles révisés

Si vous modifiez un modèle, ces modifications ne sont pas automatiquement publiées dans le catalogue. Pour partager la dernière révision, republiez le modèle dans le catalogue.

Supprimer des modèles d'un catalogue

Si vous ne souhaitez plus partager un modèle spécifique avec un espace, supprimez-le du catalogue.

Canevas de conception

  1. Dans le menu de navigation, cliquez sur Catalogues.

    Accéder aux catalogues

  2. Pour gérer les modèles de ce catalogue, cliquez sur Modèles du catalogue.

  3. Pour supprimer un modèle, cliquez sur Actions, puis sélectionnez Supprimer du catalogue.

    1. Dans le champ, saisissez le nom du modèle.
    2. Cliquez sur Supprimer.

CLI gcloud

Supprimez un modèle de votre catalogue.

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

Remplacez les éléments suivants :

  • CATALOG_TEMPLATE : ID du modèle de catalogue que vous souhaitez supprimer du catalogue.
  • CATALOG : ID de votre catalogue.
  • PROJECT : ID de votre projet.
  • LOCATION : région du catalogue.
  • SPACE : ID de votre espace.

Pour en savoir plus, consultez gcloud design-center spaces catalogs templates delete.

Partager un catalogue avec un espace

Vous ne pouvez partager un catalogue qu'avec un espace de destination situé dans la même région que l'espace source, mais dans une limite de gestion des applications différente.

Pour partager votre catalogue avec un espace, procédez comme suit :

Canevas de conception

  1. Dans le menu de navigation, cliquez sur Catalogues.

    Accéder aux catalogues

  2. Cliquez sur Partager le catalogue.

  3. Dans le champ Partager avec, indiquez si l'espace de destination se trouve dans l'un des éléments suivants :

    • Dossier : limite de gestion des applications au niveau du dossier.
    • Projet : limite de gestion des applications au niveau du projet.

  4. Dans le champ ID du projet/dossier, saisissez l'ID du projet ou du dossier pour la limite de gestion des applications où se trouve l'espace de destination.

    L'espace situé dans la même région que votre espace d'origine est automatiquement renseigné dans le champ Nom de l'espace.

  5. Cliquez sur Partager.

    Les développeurs peuvent afficher les modèles d'un catalogue partagé en ouvrant leur espace dans App Design Center et en cliquant sur Modèles partagés dans le menu de navigation.

CLI gcloud

Partagez un catalogue avec un espace.

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

Remplacez les éléments suivants :

  • SHARE : ID du partage que vous souhaitez supprimer.
  • PROJECT : ID de votre projet.
  • SPACE : ID de votre espace.
  • LOCATION : région du catalogue.
  • CATALOG : ID du catalogue que vous partagez.
  • DESTINATION_SPACE : nom complet de l'espace avec lequel vous partagez le fichier. Exemple :projects/my-project/locations/us-central1/spaces/my-space

Pour en savoir plus, consultez gcloud design-center spaces catalogs shares create.

Arrêter de partager un catalogue avec un espace

Si vous ne souhaitez plus partager un catalogue avec un espace, arrêtez de le partager en procédant comme suit :

Canevas de conception

  1. Dans le menu de navigation, cliquez sur Catalogues.

    Accéder aux catalogues

  2. Cliquez sur Espaces partagés avec.

  3. Pour arrêter de partager ce catalogue avec un espace, cliquez sur

    Actions, puis sélectionnez Arrêter le partage.

    1. Dans le champ, saisissez le nom de l'espace.
    2. Cliquez sur Arrêter le partage.

CLI gcloud

Arrêtez de partager un catalogue avec un espace.

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

Remplacez les éléments suivants :

  • SHARE : ID du partage que vous souhaitez supprimer.
  • PROJECT : ID de votre projet.
  • LOCATION : région du catalogue.
  • SPACE : ID de votre espace.
  • CATALOG : ID du catalogue que vous partagez.

Pour en savoir plus, consultez gcloud design-center spaces catalogs shares delete.

Modifier les métadonnées du catalogue

Pour gérer votre catalogue, vous pouvez lui attribuer un nom et une description descriptifs en procédant comme suit :

Canevas de conception

  1. Dans le menu de navigation, cliquez sur Catalogues.

    Accéder aux catalogues

  2. Examinez les détails du catalogue.

  3. Pour modifier le nom à afficher, procédez comme suit :

    1. Cliquez sur Modifier le nom à afficher.
    2. Dans le champ Nom à afficher, saisissez le nouveau nom.
    3. Cliquez sur Enregistrer.

  4. Pour modifier la description :

    1. Cliquez sur Modifier la description.
    2. Dans le champ Description, saisissez la nouvelle description.
    3. Cliquez sur Enregistrer.

CLI gcloud 

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

Remplacez les éléments suivants :

  • CATALOG : ID de votre catalogue.
  • PROJECT : ID de votre projet.
  • LOCATION : région du catalogue.
  • SPACE : ID de votre espace.
  • DESCRIPTION : description du catalogue.
  • DISPLAY_NAME : nom à afficher du catalogue.

Pour en savoir plus, consultez gcloud design-center spaces catalogs update.

Étapes suivantes