Spostamento delle risorse da un workspace Schematics a un progetto

Puoi gestire il ciclo di vita di un'Enterprise Architecture spostando le risorse da uno spazio di lavoro IBM Cloud® Schematics in un progetto IBM Cloud®. Mentre puoi utilizzare uno spazio di lavoro Schematics per utilizzare Terraform e architetture distribuibili, puoi utilizzare un progetto per gestire l'intero ciclo di vita in scala. Dopo aver completato questa attività, disponi di un riquadro dell'architettura distribuibile nel tuo catalogo privato e puoi gestire il ciclo di vita della tua architettura distribuibile da un progetto.

Durante questo processo, puoi utilizzare i comandi della CLI ibmcloud catalog utility create - product - from - workspace e ibmcloud project config - create per creare un catalogo e un progetto collegati tra loro e quindi spostare le risorse dello spazio di lavoro Schematics nel progetto.

Osservare e apprendere il processo di spostamento delle risorse distribuite in un progetto.

Guarda e impara

Trascrizione video

Sono Gili Mendel, un STSM con il team di sviluppo IBM Cloud. Ti mostrerò come spostare uno spazio di lavoro Schematics nell'architettura distribuibile o in un progetto IBM Cloud.

Uno spazio di lavoro Schematics è il modo in cui esegui un'automazione Terraform su IBM Cloud. Lo spazio di lavoro contiene un collegamento a un repository Git da cui richiama il modello Terraform. Contiene anche la variabile del modello e lo stato delle risorse man mano che lo crea.

È un ottimo modo per eseguire l'automazione di Terraform IaaS sul cloud senza mantenere un bucket IBM Cloud® Object Storage altamente disponibile per lo stato con le integrazioni intime ai provider di risorse cloud.

Tuttavia, questo approccio non viene ridimensionato se si guidano più automazioni. Gestire le risorse e rollup di una nuova versione del template può essere un'attività scoraggiante.

Sebbene un'azienda sfrutta l'automazione Terraform, si tratta solo di architetture distribuibili. È possibile pubblicare un'architettura di riferimento, con una designazione di impronta di conformità, stime dei costi e un modello Terraform che automatizza la distribuzione dell'architettura.

Il repository Git è utilizzato per iterare e creare l'architettura e le relative automazioni. Potrebbe essere visibile o meno agli utenti che distribuiscono l'architettura. L'architettura stessa ha un ciclo di vita che include aggiornamenti di versioni.

Passo 1: utilizza la CLI di gestione dei cataloghi per creare un'architettura distribuibile dallo spazio di lavoro esistente e il ciclo di vita necessario per pubblicare le nuove versioni.

Passo 2: utilizza la CLI del progetto per modificare lo spazio di lavoro in modo che sia gestito come un'architettura distribuibile da parte di un progetto. Pertanto, queste risorse possono essere gestite come una singola configurazione della versione dell'architettura distribuibile e possono essere gestite da un account amministratore in molti ambienti. La migrazione della versione, i costi e l'impronta di conformità sono più semplici e coinvolgono l'architettura distribuita.

Prima di iniziare

  • Assicurati che lo spazio di lavoroIBM Cloud® Schematics sia creato e che sia stato eseguito il provisioning delle risorse nel tuo account. Il progetto e lo spazio di lavoro devono trovarsi nello stesso account.
  • Impostare una variabile d'ambiente GIT_TOKEN per autenticarsi con il repository dei sorgenti Git. Ad esempio, eseguire export GIT_TOKEN="enter your GIT TOKEN". Il token necessita dell'autorizzazione per completare queste attività correlate Git mentre sposti le risorse distribuite nel tuo progetto.
  • Impostare un metodo di autenticazione per collegare il progetto al catalogo. È possibile utilizzare uno dei seguenti metodi:
    • Imposta la variabile di ambiente IC_API_KEY per accedere al tuo account IBM Cloud. Ad esempio, eseguire IC_API_KEY="Your API key".
    • Utilizza i tuoi dettagli trusted-profile-id per accedere al tuo account IBM Cloud. Per ulteriori informazioni, consultare Ricerca dell'ID profilo attendibile. Ad esempio, un ID profilo attendibile potrebbe essere simile a Profile-1bd5eala-000-4a6666-00000.
  • Assicurati che i plug-in CLI Project e Catalogs management siano aggiornati. Eseguire il comando ibmcloud plugin list per visualizzare la versione corrente dei plug-in CLI.
  • Creare un progetto per la distribuzione di produzione e registrare il nome e l'ID del progetto in cui si desidera spostare le risorse.
  • Assicurati che il servizio Projects sia autorizzato nel tuo account a comunicare con altri servizi IBM Cloud. Per ulteriori informazioni, vedi Concessione dell'accesso tra il servizio Projects e altri servizi IBM Cloud.

Creazione di un'architettura distribuibile da un workspace Schematics

Ignora questa sezione se hai già un'architettura distribuibile nel tuo spazio di lavoro Schematics.

Se hai distribuito il software utilizzando uno spazio di lavoro Schematics o tramite un catalogo privato, puoi spostare le risorse distribuite in un progetto utilizzando il comando ibmcloud catalog utility create - product - from - workspace.

Il comando esegue le seguenti attività correlate a Git:

  • Clona il repository di architettura distribuibile.
  • Inserisce il file manifest ibm_catalog.json in un nuovo ramo.
  • Crea un diagramma dell'architettura segnaposto (architecture-diagram-placeholder.drawio.svg).
  • Crea una release Git nel repository.
  • Fornisce l'asset di rilascio URL.

Il comando completa anche le seguenti IBM Cloudattività correlate:

  • Crea un catalogo privato in IBM Cloud.
  • Crea un progetto in cui eseguire lo sviluppo e il test.
  • Collega il progetto e il catalogo utilizzando un ID profilo attendibile o una chiave API.
  • Crea il riquadro del prodotto nel catalogo privato.
  • Aggiunge la versione del prodotto al nuovo catalogo privato.
  • Contrassegna la versione come pronta da condividere.
  • Completa l'onboarding dello spazio di lavoro e dell'architettura distribuibile spostando lo spazio di lavoro nel catalogo.
  • Mostra l'ID progetto, l'ID catalogo, l'ID offerta e l'indicatore di posizione della versione.

Completare la seguente procedura per creare un'architettura distribuibile e spostare tutte le risorse distribuite in una configurazione di progetto:

  1. Eseguire il comando ibmcloud catalog utility create - product - from - workspace.

    ibmcloud catalog utility create-product-from-workspace [--workspace-id ID] [--api-key KEY] [--trusted-profile-id ID] [--catalog-label LABEL] [--offering-label LABEL] [--project-name NAME] [--project-resource-group GROUP] [--target-version VERSION] [--variation-label LABEL]

    --api-key e --trusted-profile-id si escludono a vicenda. Ti serve solo uno o l'altro. Il parametro --project-name crea il progetto in cui eseguire lo sviluppo e il test. Per semplicità, è possibile denominarlo con lo stesso nome dell'ID dello spazio di lavoro.

    Consultare il seguente esempio delle opzioni di comando utility create-product-from-workspace.

    ibmcloud catalog utility create-product-from-workspace --workspace-id us-south.workspace.move.xxxx --api-key $IC_API_KEY --catalog-label myCatalog --offering-label myOffering --project-name myProject --project-resource-group Default --target-version 1.0.0 --variation-label test_standard

    Una volta terminata l'esecuzione del comando, il prompt dei comandi restituisce OK.

  2. Verifica i risultati in Git visualizzando il commit, il repository e la nuova release. È possibile vedere il file .tgz con le versioni.

  3. Verifica i risultati nella console IBM Cloud:

    1. Vai a Manage > Catalogs > Private catalogs.
    2. Selezionare il nuovo catalogo privato.
    3. Selezionare il nuovo prodotto nel catalogo privato, quindi selezionare la scheda Versioni. Verificare di disporre della versione 1.0.0 (o simile) della propria architettura distribuibile. Se vai al tuo catalogo privato, vedi la stessa architettura distribuibile in un tile.
    4. Fare clic su Menu di navigazione Icona del menu di navigazione > Progetti e guardare il nuovo progetto.
    5. Selezionare la scheda Configurazioni per visualizzare l'architettura distribuibile. Verificare che sia nello stato draft.

Creazione della configurazione del progetto

Il comando ibmcloud project config - create crea una configurazione di progetto che esegue lo spazio di lavoro Schematics in un progetto in cui puoi creare un'altra versione dal progetto e modificare l'architettura distribuibile come necessario.

Prima di iniziare questa sezione, assicurati di disporre di un'architettura distribuibile in un catalogo privato e di uno spazio di lavoro Schematics in esecuzione e di conoscerne il CRN. Puoi individuare il CRN dello spazio di lavoro dall'elenco di risorse nella console IBM Cloud o utilizzando la CLI.

  • Console IBM Cloud: nella console IBM Cloud, fai clic sull'icona Menu di navigazione icona menu di navigazione > Elenco risorse > Developer tools > trova lo spazio di lavoro e copia il CRN.
  • CLI IBM Cloud: esegui il comando ibmcloud schematics workspace get per richiamare i dettagli del CRN dello spazio di lavoro. Ad esempio, esegui ibmcloud schematics workspace get --id workspace-id --output destination folder --json output.json per recuperare i dettagli del CRN dello spazio di lavoro Schematics.

Completa la seguente procedura per aggiungere una configurazione di progetto e spostare le risorse dello spazio di lavoro Schematics al progetto:

  1. Eseguire il comando ibmcloud project config - create.

    ibmcloud project config-create --project-id PROJECT-ID [--schematics-workspace-crn SCHEMATICS-WORKSPACE-CRN] [--definition-name DEFINITION-NAME] [--definition-locator-id DEFINITION-LOCATOR-ID]

    Il valore di --project-id è l'ID del progetto creato per la distribuzione di produzione nel passaggio Prima di iniziare. Il valore di --definition-locator-id è lo stesso del localizzatore di versione della sezione precedente.

    Vedere il seguente esempio di opzioni di comandi project config-create.

    ibmcloud project config-create --project-id myProdProject --schematics-workspace-crn MyWorkspaceCRN --definition-name production-deployment --definition-locator-id myVersionLocator

    Una volta terminata l'esecuzione del comando, il prompt dei comandi restituisce il nome, lo stato e il tipo.

  2. Verifica che i tuoi modelli Terraform siano distribuiti nel progetto:

    1. Nella console IBM Cloud, fai clic sull'icona Menu di navigazione Icona del menu di navigazione > Progetti.
    2. Selezionare il progetto creato per la produzione di distribuzione e andare alla scheda Configurazioni.
    3. Fare clic sull'icona Azioni icona Azioni > Visualizza ultima distribuzione.
    4. Nella sezione Distribuzione riuscita, fare clic su Modifiche distribuite correttamente > Log per visualizzare tutte le risorse distribuite nel progetto.

La distribuzione dello spazio di lavoro Schematics è ora inclusa nei log che si trovano all'interno del nuovo progetto.

Se vuoi verificare i risultati utilizzando la CLI, esegui i comandi ibmcloud project get o ibmcloud project list per verificare che il tuo spazio di lavoro sia stato spostato correttamente nel tuo progetto.

Passi successivi

Per completare il resto del processo per l'architettura distribuibile, completare la seguente procedura:

  1. Configurare i dettagli di distribuzione per l'architettura distribuibile.
  2. Definisci l'accesso IAM.
  3. Aggiungere un diagramma dell'architettura, prerequisiti ed evidenziazioni.
  4. Aggiungere informazioni di conformità (controlli).
  5. Riconvalidare per ricevere una stima dei costi.

Per ulteriori informazioni su come completare la procedura, consulta Onboarding di un'architettura distribuibile personalizzata nel tuo catalogo privato.

Per ulteriori informazioni, consultare Adozione dell'architettura aziendale.