Gérer, publier et partager des catalogues

Lorsque vous créez des modèles d'application et que vous importez des modèles de composants dans un espace, les autres membres de l'espace peuvent accéder à vos modèles. Ce document vous explique comment partager des modèles en dehors de votre espace en les publiant dans un catalogue et 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 des applications avec des espaces situés dans d'autres limites de gestion des applications.

Avant de commencer

Pour effectuer les tâches décrites dans ce document, demandez à votre administrateur de vous accorder les rôles nécessaires dans le dossier compatible avec les applications ou le projet de gestion, comme indiqué dans le tableau suivant :

Tâche Rôles requis
Publier des modèles d'application dans un catalogue d'espace Administrateur d'App Design Center (roles/designcenter.admin)
Partager un catalogue avec des espaces de destination Administrateur d'App Design Center (roles/designcenter.admin)

Pour en savoir plus sur les rôles, consultez la page Contrôle des accès avec IAM.

Avant de gérer les catalogues, procédez comme suit :

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, cliquez sur Ajouter au catalogue dans la colonne Actions.

  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 la page Partager un catalogue avec un espace.

gcloud CLI

  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 la page gcloud design-center spaces catalogs list.

  2. Identifiez l'ID du modèle que vous souhaitez ajouter à votre catalogue. Par exemple, la commande suivante répertorie 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 la page 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 la page gcloud design-center spaces application-templates commit.

  4. Copiez la sortie name de la commande de validation. 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. Par 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 la page 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. Par exemple, application-template.

    Pour en savoir plus, consultez la page 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 la révision que vous souhaitez créer. Par 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 la révision du modèle d'application. Vous avez copié cette valeur lorsque vous avez validé votre modèle d'application. Par exemple, projects/my-project/locations/us-central1/spaces/my-space/applicationTemplates/my-app-template/revisions/r1.

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

Partager des modèles révisés

Si vous apportez des modifications à un modèle, celles-ci 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.

gcloud CLI

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 la page 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 dans laquelle 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.

gcloud CLI

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. Par exemple, projects/my-project/locations/us-central1/spaces/my-space.

Pour en savoir plus, consultez la page 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.

gcloud CLI

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 de gestion.
  • LOCATION : région du catalogue.
  • SPACE : ID de votre espace.
  • CATALOG : ID du catalogue que vous partagez.

Pour en savoir plus, consultez la page 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, procédez comme suit :

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

gcloud CLI 

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 la page gcloud design-center spaces catalogs update.

Étape suivante