Gérer les 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 depuis l'espace que vous avez créé dans votre dossier compatible avec les applications initial vers les espaces des dossiers compatibles avec les applications descendants.

Pour savoir comment créer des espaces descendants, consultez Créer des espaces.

Avant de commencer

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

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 zone 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 de gestion.
    • 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 de gestion.
    • 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 de gestion.
    • 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 de gestion.
    • 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 modèle de catalogue.

    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 de gestion.
    • 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 de gestion.
    • 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, publiez à nouveau 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 dans le 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 de gestion.
  • 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 pouvez partager un catalogue depuis votre espace initial vers les espaces descendants. Par exemple, vous pouvez créer un catalogue de modèles d'application pertinents pour l'ensemble de votre organisation et le partager avec tous les espaces.

Pour savoir comment créer des espaces descendants, consultez Créer des espaces.

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 Filtre, saisissez le nom de l'espace dans lequel vous souhaitez partager le catalogue.

  4. Dans le tableau Espaces, dans la colonne Actions, cliquez sur Partager le catalogue.

    Pour afficher les modèles d'un catalogue partagé, les utilisateurs peuvent ouvrir leur espace dans le Centre de conception d'applications et cliquer 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 de gestion.
  • 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 le partage 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êter 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 de gestion.
  • 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 de gestion.
  • 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