Gestire i cataloghi

Quando crei modelli di applicazioni e importi modelli di componenti in uno spazio, gli altri membri dello spazio possono accedere ai tuoi modelli. Questo documento ti aiuta a condividere i modelli al di fuori del tuo spazio pubblicandoli in un catalogo e condividendo quest'ultimo con gli spazi appropriati.

Ogni spazio contiene un singolo catalogo in cui puoi aggiungere modelli e controllare la condivisione. Puoi condividere un catalogo dallo spazio che hai creato nella cartella app iniziale con gli spazi nelle cartelle app discendenti.

Per i passaggi per creare spazi secondari, consulta Creare spazi.

Prima di iniziare

Devi disporre del ruolo Application Design Center Admin (roles/designcenter.admin) nella cartella abilitata per le app o nel progetto di gestione.

Pubblicare un modello di applicazione in un catalogo

Prima di poter condividere un modello con altri spazi, pubblicalo nel tuo catalogo.

Canvas di progettazione

  1. Nel menu di navigazione, fai clic su Cataloghi.

    Vai a Cataloghi

  2. Fai clic su Aggiungi modelli.

  3. Nell'area Aggiungi modelli al catalogo predefinito, segui questi passaggi:

    1. Per trovare un modello specifico, digita il nome del modello nel campo Filtro.
    2. Per aggiungere un modello a questo catalogo, nella colonna Azioni, fai clic su Aggiungi al catalogo.

  4. Fai clic su Fine. Gli spazi che hanno accesso al catalogo hanno accesso ai modelli selezionati.

  5. Per condividere il catalogo, vedi Condividere un catalogo con uno spazio.

Interfaccia a riga di comando gcloud

  1. Identifica l'ID catalogo per il catalogo in cui vuoi aggiungere il modello.

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

    Sostituisci quanto segue:

    • PROJECT: l'ID progetto di gestione.
    • LOCATION: la regione del catalogo.
    • SPACE: il tuo ID spazio.

    Per maggiori informazioni, consulta gcloud design-center spaces catalogs list.

  2. Identifica l'ID modello del modello che vuoi aggiungere al catalogo. Ad esempio, il seguente comando elenca i modelli di applicazioni.

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

    Sostituisci quanto segue:

    • PROJECT: l'ID progetto di gestione.
    • LOCATION: la regione del catalogo.
    • SPACE: il tuo ID spazio.
    • FILTER: un filtro per restringere i risultati di ricerca. Ad esempio, "displayName:my-app-template*"

    Per ulteriori informazioni, vedi gcloud design-center spaces application-templates list.

  3. Esegui il commit del modello di applicazione.

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

    Sostituisci quanto segue:

    • TEMPLATE: l'ID del modello da eseguire.
    • PROJECT: l'ID progetto di gestione.
    • LOCATION: La regione del modello di applicazione.
    • SPACE: il tuo ID spazio.

    Per maggiori informazioni, vedi gcloud design-center spaces application-templates commit.

  4. Copia l'output name dal comando di commit. Specificherai questo nome come valore di application-template-revision-source quando crei la revisione del modello di catalogo.

  5. Assicurati che il modello di applicazione non sia già presente nel catalogo.

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

    Sostituisci quanto segue:

    • CATALOG: il tuo ID catalogo. Ad esempio, default-catalog.
    • PROJECT: l'ID progetto di gestione.
    • LOCATION: la regione del catalogo.
    • SPACE: il tuo ID spazio.

    Per maggiori informazioni, vedi Elenco dei modelli di cataloghi degli spazi del Centro di progettazione gcloud.

  6. Se il modello di applicazione non è presente nel catalogo, crea il modello di catalogo.

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

    Sostituisci quanto segue:

    • CATALOG_TEMPLATE: L'ID del modello di catalogo per il modello di catalogo che vuoi creare.
    • PROJECT: l'ID progetto di gestione.
    • LOCATION: la regione del catalogo.
    • SPACE: il tuo ID spazio.
    • CATALOG: il tuo ID catalogo.
    • TEMPLATE_CATEGORY: la categoria del modello. Ad esempio, application-template.

    Per saperne di più, vedi gcloud design-center spaces catalogs templates create.

  7. Crea una revisione del template di catalogo. Viene creata la prima revisione, che gli sviluppatori utilizzano come origine per un'applicazione.

    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

    Sostituisci quanto segue:

    • REVISION: l'ID revisione della revisione che vuoi creare. Ad esempio, r1.
    • PROJECT: l'ID progetto di gestione.
    • LOCATION: la regione del catalogo.
    • SPACE: il tuo ID spazio.
    • CATALOG: il tuo ID catalogo.
    • CATALOG_TEMPLATE: l'ID del modello.
    • APPLICATION_TEMPLATE_REVISION_SOURCE: l'origine della revisione del modello di applicazione. Hai copiato questo valore quando hai eseguito il commit del modello di applicazione. Ad esempio, projects/my-project/locations/us-central1/spaces/my-space/applicationTemplates/my-app-template/revisions/r1.

    Per saperne di più, consulta gcloud design-center spaces catalogs templates revisions create.

Condividere i modelli riveduti

Se apporti modifiche a un modello, queste non vengono pubblicate automaticamente nel catalogo. Per condividere l'ultima revisione, pubblica di nuovo il modello nel catalogo.

Rimuovere modelli da un catalogo

Se non vuoi più condividere un modello specifico con uno spazio, rimuovilo dal catalogo.

Canvas di progettazione

  1. Nel menu di navigazione, fai clic su Cataloghi.

    Vai a Cataloghi

  2. Per gestire i modelli in questo catalogo, fai clic su Modelli nel catalogo.

  3. Per rimuovere un modello, fai clic su Azioni e seleziona Rimuovi dal catalogo.

    1. Nel campo, inserisci il nome del modello.
    2. Fai clic su Rimuovi.

Interfaccia a riga di comando gcloud

Rimuovere un modello dal catalogo.

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

Sostituisci quanto segue:

  • CATALOG_TEMPLATE: L'ID del modello di catalogo per il modello che vuoi rimuovere dal catalogo.
  • CATALOG: il tuo ID catalogo.
  • PROJECT: l'ID progetto di gestione.
  • LOCATION: la regione del catalogo.
  • SPACE: il tuo ID spazio.

Per saperne di più, consulta gcloud design-center spaces catalogs templates delete.

Condividere un catalogo con uno spazio

Puoi condividere un catalogo dallo spazio iniziale agli spazi discendenti. Ad esempio, puoi creare un catalogo di modelli di applicazioni pertinenti per l'intera organizzazione e condividerlo con tutti gli spazi.

Per i passaggi per creare spazi secondari, consulta Creare spazi.

Per condividere il tuo catalogo con uno spazio:

Canvas di progettazione

  1. Nel menu di navigazione, fai clic su Cataloghi.

    Vai a Cataloghi

  2. Fai clic su Condividi catalogo.

  3. Nel campo Filtro, inserisci il nome dello spazio in cui vuoi condividere il catalogo.

  4. Nella tabella Spazi, fai clic su Condividi catalogo nella colonna Azioni.

    Gli utenti possono visualizzare i template di un catalogo condiviso aprendo il proprio spazio in App Design Center e facendo clic su Template condivisi dal menu di navigazione.

Interfaccia a riga di comando gcloud

Condividere un catalogo con uno spazio.

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

Sostituisci quanto segue:

  • SHARE: l'ID della condivisione che vuoi eliminare.
  • PROJECT: l'ID progetto di gestione.
  • SPACE: il tuo ID spazio.
  • LOCATION: la regione del catalogo.
  • CATALOG: l'ID del catalogo che stai condividendo.
  • DESTINATION_SPACE: Il nome completo dello spazio con cui stai condividendo. Ad esempio, projects/my-project/locations/us-central1/spaces/my-space.

Per saperne di più, consulta gcloud design-center spaces catalogs shares create.

Interrompere la condivisione di un catalogo con uno spazio

Se non vuoi più condividere un catalogo con uno spazio, interrompi la condivisione del catalogo nel seguente modo:

Canvas di progettazione

  1. Nel menu di navigazione, fai clic su Cataloghi.

    Vai a Cataloghi

  2. Fai clic su Spazi condivisi con.

  3. Per interrompere la condivisione di questo catalogo con uno spazio, fai clic su

    Azioni e seleziona Interrompi condivisione.

    1. Nel campo, inserisci il nome dello spazio.
    2. Fai clic su Interrompi condivisione.

Interfaccia a riga di comando gcloud

Interrompi la condivisione di un catalogo con uno spazio.

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

Sostituisci quanto segue:

  • SHARE: l'ID della condivisione che vuoi eliminare.
  • PROJECT: l'ID progetto di gestione.
  • LOCATION: la regione del catalogo.
  • SPACE: il tuo ID spazio.
  • CATALOG: l'ID del catalogo che stai condividendo.

Per saperne di più, vedi gcloud design-center spaces catalogs shares delete.

Modificare i metadati del catalogo

Per gestire il catalogo, puoi assegnargli un nome e una descrizione descrittivi nel seguente modo:

Canvas di progettazione

  1. Nel menu di navigazione, fai clic su Cataloghi.

    Vai a Cataloghi

  2. Esamina i dettagli del catalogo.

  3. Per modificare il Nome visualizzato:

    1. Fai clic su Modifica nome visualizzato.
    2. Nel campo Nome visualizzato, inserisci il nuovo nome.
    3. Fai clic su Salva.

  4. Per modificare la Descrizione:

    1. Fai clic su Modifica descrizione.
    2. Nel campo Descrizione, inserisci la nuova descrizione.
    3. Fai clic su Salva.

Interfaccia a riga di comando gcloud 

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

Sostituisci quanto segue:

  • CATALOG: il tuo ID catalogo.
  • PROJECT: l'ID progetto di gestione.
  • LOCATION: la regione del catalogo.
  • SPACE: il tuo ID spazio.
  • DESCRIPTION: la descrizione del catalogo.
  • DISPLAY_NAME: Il nome visualizzato del catalogo.

Per saperne di più, consulta gcloud design-center spaces catalogs update.

Passaggi successivi