Estensione di un'architettura distribuibile durante l'onboarding

Quando si inserisce un'architettura distribuibile in un catalogo privato, si può scegliere di estenderla sovrapponendola ad altre architetture. Quando si aggiungono queste altre architetture, si specifica se sono necessarie per distribuire l'architettura come previsto, o se possono essere usate opzionalmente per estendere il caso d'uso. Una volta terminato l'onboarding, il risultato è una solida soluzione end-to-end composta da più architetture implementabili che lavorano insieme.

Le architetture implementabili che si desidera impilare sono già disponibili in un catalogo? In tal caso, è possibile impilare queste architetture in un progetto e inserire la soluzione nel catalogo come voce separata. Attualmente, quando si impilano architetture distribuibili in un progetto, l'inclusione di architetture opzionali o intercambiabili non è supportata. Pertanto, questo approccio funziona meglio se tutte le architetture che si desidera impilare insieme sono necessarie per implementare la soluzione end-to-end.

Perché estendere un'architettura distribuibile?

È possibile estendere un'architettura distribuibile per diversi motivi. Ad esempio, se l'architettura che si sta avviando richiede una dipendenza, è possibile impilarla insieme all'architettura da cui dipende. Se la dipendenza è elencata come necessaria, viene inclusa insieme all'architettura distribuibile quando un utente la configura e la distribuisce.

Allo stesso modo, per incoraggiare la sicurezza di default per un'architettura distribuibile che si sta avviando, è possibile sovrapporre ad essa altre architetture che soddisfano le esigenze di sicurezza. Se le altre architetture distribuibili sono incluse come raccomandato, si può garantire che gli utenti dell'organizzazione distribuiscano l'architettura in un modo specifico con le protezioni di sicurezza in vigore. Le architetture consigliate sono incluse per impostazione predefinita, ma gli utenti possono rimuoverle.

È anche possibile estendere un'architettura distribuibile per fornire più opzioni di personalizzazione agli utenti, in modo che possano trarre vantaggio da un caso d'uso esteso. Forse la vostra architettura funziona bene con un'altra architettura distribuibile che non è necessaria per soddisfare una dipendenza o la conformità. È possibile aggiungere l'architettura distribuibile come opzionale e gli utenti possono scegliere di includerla quando aggiungono l'architettura distribuibile a un progetto.

Prima di iniziare

Una volta completati i passaggi per l'inserimento dell'architettura distribuibile in un catalogo privato, viene richiesto di configurare i dettagli della versione. Andare su Estendi l'architettura per impilare altre architetture distribuibili insieme a quella che si sta installando.

Se l'architettura distribuibile è già stata inserita, modificate la versione nel vostro catalogo privato, quindi andate su Estendi l'architettura.

Preferite lavorare con il codice? Nel file manifest del catalogo è possibile specificare i dettagli di altre architetture distribuibili che si desidera impilare con quella che si sta avviando. Impostare la proprietà dependency_version_2 su true e usare l'array dependencies per specificare quali architetture si vogliono includere in quella che si sta avviando. Per ulteriori informazioni su come strutturare il manifest del catalogo, vedere Modifica locale del file manifest.

Aggiunta di architetture distribuibili

Quando si monta un'architettura distribuibile, è possibile estenderla sovrapponendola ad altre architetture. Specificare una relazione quando si aggiungono altre architetture, quindi definire le variabili che gli utenti possono configurare tra le architetture che si stanno impilando. Completa i seguenti passi:

Quando si inserisce un'architettura distribuibile in un catalogo, nella sezione Estendi l'architettura, fare clic su Aggiungi.
Usare il menu Prodotto per selezionare l'architettura distribuibile che si desidera aggiungere. È possibile selezionare qualsiasi architettura distribuibile a cui l'account ha accesso nei propri cataloghi.
Selezionare un'opzione di relazione per l'architettura distribuibile che si sta aggiungendo. L'architettura è necessaria e non può essere rimossa. È facoltativo e gli utenti possono scegliere se includerlo o meno. Oppure, è raccomandato e incluso per impostazione predefinita, anche se gli utenti possono scegliere di rimuoverlo. Per ulteriori informazioni, vedere Specificare una relazione.
Facoltativo: se si aggiungono due o più architetture distribuibili che sono intercambiabili in base alle preferenze dell'utente, selezionarle nella tabella Estendi l'architettura e fare clic su Raggruppa come intercambiabile. Gli utenti possono scegliere l'architettura da utilizzare in base alle proprie esigenze.
Una volta terminata l'aggiunta delle architetture distribuibili, fare clic su Avanti > Definisci variabili per definire le variabili per gli utenti. Da qui, è possibile collegare le architetture distribuibili tra loro, in modo che gli utenti possano configurare gli input in un'unica interfaccia, invece di configurare le architetture una per una. Per ulteriori informazioni, consultare la sezione Definizione delle variabili per gli utenti.

Specificare una relazione

Quando si impilano architetture distribuibili insieme a quella che si sta avviando, viene chiesto di specificare una relazione. Qual è il rapporto tra l'architettura implementabile che state aggiungendo e la soluzione complessiva che state inserendo nel vostro catalogo privato? È possibile scegliere tra tre opzioni: Richiesto, Opzionale e Consigliato. La tabella seguente descrive e spiega come ciascuna opzione influisce sulla personalizzazione della soluzione end-to-end quando un utente aggiunge l'architettura a un progetto dal catalogo privato:

Le opzioni di relazione spiegate
Opzione	Descrizione
Obbligatorio	Incluso quando un utente aggiunge la vostra architettura a un progetto. L'utente non può rimuovere le architetture richieste, perché sono necessarie affinché la soluzione complessiva funzioni come previsto.
Facoltativo	Non è incluso per impostazione predefinita. Gli utenti possono scegliere di includere architetture opzionali se vogliono sfruttare un caso d'uso esteso.
Consigliato	Incluso per impostazione predefinita, ma gli utenti possono rimuoverlo se lo desiderano. Ad esempio, si vuole incoraggiare le distribuzioni sicure aggiungendo IBM Cloud Secrets Manager come raccomandato alla propria architettura distribuibile. Secrets Manager viene quindi incluso per impostazione predefinita quando un utente aggiunge la propria architettura distribuibile a un progetto. Tuttavia, se l'utente dispone di un altro strumento per la gestione dei segreti o comunque non ha bisogno di Secrets Manager, può scegliere di escluderlo.

Definire le variabili per gli utenti

Dopo aver esteso l'architettura distribuibile impilandovi altre architetture, è necessario definire le variabili per gli utenti. L'obiettivo finale è quello di collegare tra loro le architetture distribuibili, in modo che gli utenti possano configurare gli input in un'unica interfaccia, invece di configurare le architetture una per una. Considera le seguenti domande:

Quali input all'interno delle architetture distribuibili devono essere configurati dagli utenti? Questi ingressi devono essere aggiunti al prodotto in modo che gli utenti possano configurarli senza modificare le singole architetture una per una. Selezionare Aggiungi al prodotto per farlo.
Quali architetture implementabili devono essere collegate tra loro con riferimenti a input o output? Ad esempio, se un ingresso di un'architettura dipende dall'uscita di un'altra, aggiungere un riferimento all'ingresso per collegarlo all'uscita. Selezionare Riferimento a una variabile per farlo.

Solo gli input aggiunti al prodotto possono fare riferimento a un output. Se si è aggiunta un'architettura e uno dei suoi input deve fare riferimento a un output di un'altra architettura, selezionare Aggiungi al prodotto per quell'input. Quindi, selezionare Riferimento a una variabile per l'input aggiunto. Da qui è possibile selezionare l'architettura che contiene l'output. Selezionate Output come tipo di variabile, quindi selezionate il nome dell'uscita a cui volete che l'input faccia riferimento.
Tutti gli input richiesti sono risolti per gli utenti? Per gli input richiesti che non vengono aggiunti al prodotto, fornire un valore fisso o un riferimento per risolvere tali input. In questo modo si collegano le architetture di questa soluzione end-to-end e si facilita la configurazione e l'implementazione da parte degli utenti.

I valori predefiniti non possono essere forniti nella console. Usare la proprietà default_value all'interno della matrice configuration nel file manifest del catalogo per specificare i valori predefiniti. Per ulteriori informazioni, vedere Modifica locale del file manifest.
Gli utenti hanno bisogno di informazioni aggiuntive su una variabile per poterla configurare? Quando si aggiunge una variabile di input al prodotto, è possibile modificare il modo in cui l'input appare agli utenti. Spesso può essere utile fornire un nuovo nome per una variabile o una descrizione, soprattutto se sono incluse due variabili simili. Ad esempio, se l'architettura che si sta inserendo contiene un ingresso region e si aggiunge anche un ingresso region da un'architettura dell'infrastruttura, si consideri di nominare l'ingresso region-infrastructure quando lo si aggiunge al prodotto. Un nome significativo aiuta a identificare l'utilizzo dell'input e ne facilita la configurazione.

Tutti gli input aggiunti al prodotto sono inclusi nella tabella delle variabili di input. Per rimuovere una variabile aggiunta, selezionarla e fare clic su Elimina.

Passi successivi

Dopo aver definito le variabili per i vostri utenti, continuate l'onboarding della vostra architettura distribuibile. Al termine, gli utenti che hanno accesso al catalogo privato possono aggiungere l'architettura distribuibile a un progetto. Quando lo fanno, possono personalizzarlo selezionando le architetture che vogliono includere in base a quanto specificato durante il processo di onboarding.