Gestire, pubblicare e condividere 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 il catalogo 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 nel confine di gestione delle applicazioni iniziale delle applicazioni con gli spazi in altri confini di gestione delle applicazioni.

Prima di iniziare

Prima di gestire il catalogo:

Pubblicare un modello di applicazione in un catalogo

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

Area di progettazione

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

    Vai a Cataloghi

  2. Fai clic su Aggiungi modelli.

  3. Nell'area Aggiungi modelli al catalogo predefinito:

    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, consulta Condividere un catalogo con uno spazio.

gcloud CLI

  1. Identifica l'ID del 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: l'ID dello spazio.

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

  2. Identifica l'ID 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: l'ID dello spazio.
    • FILTER: un filtro per aiutarti a restringere i risultati di ricerca. Ad esempio, "displayName:my-app-template*"

    Per saperne di più, consulta 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 di cui eseguire il commit.
    • PROJECT: l'ID progetto di gestione.
    • LOCATION: la regione del modello di applicazione.
    • SPACE: l'ID dello spazio.

    Per saperne di più, consulta gcloud design-center spaces application-templates commit.

  4. Copia l'output name dal comando commit. Specificherai questo nome come valore 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: l'ID del catalogo. Ad esempio, default-catalog.
    • PROJECT: l'ID progetto di gestione.
    • LOCATION: la regione del catalogo.
    • SPACE: l'ID dello spazio.

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

  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 che vuoi creare.
    • PROJECT: l'ID progetto di gestione.
    • LOCATION: la regione del catalogo.
    • SPACE: l'ID dello spazio.
    • CATALOG: l'ID del catalogo.
    • TEMPLATE_CATEGORY: la categoria del modello. Ad esempio, application-template.

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

  7. Crea una revisione del modello 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 della revisione che vuoi creare. Ad esempio, r1.
    • PROJECT: l'ID progetto di gestione.
    • LOCATION: la regione del catalogo.
    • SPACE: l'ID dello spazio.
    • CATALOG: l'ID del 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 rivisti

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 i modelli da un catalogo

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

Area di progettazione

  1. Dal 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.

gcloud CLI

Rimuovi 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 che vuoi rimuovere dal catalogo.
  • CATALOG: l'ID del catalogo.
  • PROJECT: l'ID progetto di gestione.
  • LOCATION: la regione del catalogo.
  • SPACE: l'ID dello spazio.

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

Condividere un catalogo con uno spazio

Puoi condividere un catalogo solo con uno spazio di destinazione che si trova nella stessa regione dello spazio di origine, ma in un confine di gestione delle applicazioni diverso.

Per condividere il catalogo con uno spazio:

Area di progettazione

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

    Vai a Cataloghi

  2. Fai clic su Condividi catalogo.

  3. Nel campo Condividi con, seleziona se lo spazio di destinazione si trova in uno dei seguenti:

    • Cartella: un confine di gestione delle applicazioni a livello di cartella.
    • Progetto: un confine di gestione delle applicazioni a livello di progetto.

  4. Nel campo ID progetto/cartella, inserisci l'ID progetto o cartella per il confine di gestione delle applicazioni in cui si trova lo spazio di destinazione.

    Lo spazio nella stessa regione dello spazio di origine viene compilato automaticamente nel campo Nome spazio.

  5. Fai clic su Condividi.

    Gli sviluppatori possono visualizzare i modelli da un catalogo condiviso aprendo il loro spazio in App Design Center e facendo clic su Modelli condivisi dal menu di navigazione.

gcloud CLI

Condividi 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: l'ID dello spazio.
  • LOCATION: la regione del catalogo.
  • CATALOG: l'ID del catalogo che stai condividendo.
  • DESTINATION_SPACE: il nome completo dello spazio che 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:

Area di progettazione

  1. Dal 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.

gcloud CLI

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: l'ID dello spazio.
  • CATALOG: l'ID del catalogo che stai condividendo.

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

Modificare i metadati del catalogo

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

Area di progettazione

  1. Dal 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.

gcloud CLI 

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

Sostituisci quanto segue:

  • CATALOG: l'ID del catalogo.
  • PROJECT: l'ID progetto di gestione.
  • LOCATION: la regione del catalogo.
  • SPACE: l'ID dello 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