Prima di iniziare

Prima di poter inserire la vostra architettura distribuibile, assicuratevi di aver completato i seguenti prerequisiti.

• Scaricare Visual Studio Code
• Verificare che si stia utilizzando un account Pay-As-You-Go o un abbonamento. Per maggiori dettagli, vedere Visualizzazione del tipo di account.
• Verificate di avere l'accesso richiesto per lavorare con i cataloghi privati e le architetture distribuibili.
  • Ruolo di manager sul servizio IBM Cloud Schematics
  • Ruolo di editor nel servizio di gestione del catalogo
  • Ruolo di spettatore su tutti i gruppi di risorse dell'account
  • SecretsReader sul servizio Secrets Manager se si intende memorizzare i valori sicuri in un'istanza di Secrets Manager
  • Ruolo del lettore nel Workload Protection servizio
  • Altri ruoli richiesti per risorse specifiche nell'architettura distribuibile personalizzata.
• Assicurarsi di avere il codice sorgente della propria architettura distribuibile in un GitHub. Per informazioni su come inserire il codice sorgente in un repository, vedere Impostazione del repository del codice sorgente.
• Un modulo Terraform in un repository GitHub pubblico o privato che viene clonato in una cartella locale. Per la sperimentazione, si può creare un fork di questo modulo Terraform di esempio. Se il repository è privato, è necessario un token di accesso personale con permessi repo e read:user.

Ottenere l'estensione VS Code

Per ottenere l'estensione, aprire VS Code, andare su Estensioni, cercare e selezionare IBM Cloud Deployable Architecture Builder da scaricare. Dopo aver effettuato il download, è possibile seguire la procedura guidata per iniziare o utilizzare i seguenti passaggi. Se la guida non si apre automaticamente, potete usare la tavolozza dei comandi. Passare a Visualizza > Tavolozza dei comandi. Cercare Walkthrough, fare clic su Benvenuto: Aprire il percorso..., quindi selezionare Iniziare con IBM Cloud Deployable Architecture Builder.

Onboarding dell'architettura distribuibile

La prima volta che si convalida l'architettura distribuibile, si eseguono i passaggi per l'onboarding su IBM Cloud. Utilizzate i seguenti passaggi per integrare la vostra architettura distribuibile:

1. Esegui l'accesso al tuo account IBM Cloud.
   1. Per accedere al proprio account, fare clic su Visualizza e selezionare Tavolozza dei comandi.
   2. Nel campo di ricerca, cercare IBM Cloud - Log in.
   3. Selezionare IBM Cloud- Log in e accedere con una chiave API, un ID federato o un nome utente e una password.
   4. (Facoltativo) È possibile modificare l'ambiente di accesso. Fare clic su Vista, selezionare Tavolozza dei comandi, cercare IBM Cloud - Log in e selezionare IBM Cloud- Log in > Change login environment. Dal menu, selezionare Produzione o Staging.
2. Assicuratevi di aver effettuato l'accesso a GitHub da VS Code.
   1. Selezionare l'icona > Accedi a Impostazioni di sincronizzazione.
   2. Selezionare il proprio account.
   3. Fate clic su Autorizza Visual-Studio-Code.
3. Clonare il repo e aggiungerlo a un'area di lavoro di VS Code.
   1. Clonare il repo delle architetture distribuibili da GitHub.
   2. Per aggiungerlo all'area di lavoro in VS Code, fare clic su File > Aggiungi cartella all'area di lavoro..., quindi selezionare il repo dai file.
4. Aggiungere i file manifest del catalogo al modulo Terraform.
   1. Per aggiungere il manifesto del catalogo, fare clic con il pulsante destro del mouse sulla cartella del modulo nell'area di lavoro.
   2. Selezionare IBM Cloud > Aggiungere i file manifest dell'architettura distribuibile.
5. Convincere e convalidare l'architettura distribuibile.
   1. Fate clic con il pulsante destro del mouse sul file ibm_catalog.json e selezionate IBM Cloud > Validate a deployable architecture on IBM Cloud.
   2. Selezionare il ramo del repo. Oppure si può fare clic su + e inserire il nome di un nuovo file che verrà creato.
   3. Seleziona un catalogo privato esistente. Oppure si può fare clic su + e inserire il nome di un nuovo file che verrà creato.
   4. Inserire la versione dell'offerta.
   5. Selezionare un progetto esistente. Oppure potete fare clic su + e inserire il nome di un nuovo file che verrà creato per voi.
   6. Inserire la chiave API IBM Cloud per l'account in cui verranno distribuite le risorse.
   7. Inserire il percorso relativo del diagramma architettonico. Se non si dispone di un diagramma, viene fornito un segnaposto.
   8. (Facoltativo) Se il repository GitHub è privato o in GitHub Enterprise, inserire il token di accesso personale.
   9. Il file di input YAML viene aperto. Modificare i valori della proprietà inputs e salvare il file.
   10. Fai clic su Continue

Quando inizia la convalida, viene aperto un canale di output che mostra i log di convalida. In caso contrario, nella vista Output, selezionare il canale DA Validation dal menu. La convalida può richiedere alcuni minuti.