Lucidscale consente di importare i dati dell'infrastruttura cloud da Google Cloud (ex GCP) e generare diagrammi da tali dati in un modello Lucidscale.

Lucidscale è disponibile per Lucid Suite account aziendali come acquisto aggiuntivo con Cloud Accelerator. Per ulteriori informazioni su Cloud Accelerator, consulta il nostro articolo Panoramica su Cloud Accelerator .

Guarda: Importare l'infrastruttura Google Cloud

Risorse e linee supportate

Lucidscale supporta le seguenti risorse di Google Cloud :

Bigtable Instances
Big Query Datasets
Cloud DNS
Cloud functions
Cloud Routes
Cloud routers
Compute (Autoscalers, Instances, Instance Groups)
Database (SQL Instances)
Firewalls
GKE Cluster View
Google Kubernetes Engine (Google Cloud Side, not Kubernetes depth)
Interconnect ( Dedicated Interconnects + Partner Interconnects)
IPsec VPN
Manage (Project, Zone)
NAT Gateway
Network (Firewall, Network, Subnetwork)
Node Pools
Persistent disk
Shared VPC View
Storage (Bucket)
VLAN Attachments (interconnectAttachments)
VPN tunnels
VPN Gateways

Possiamo tracciare delle linee tra le risorse che fanno esplicito riferimento a un'altra nei metadati:

Google Cloud VPC Network Peering [Network → Network]
Instance to Subnetwork (Shared VPC line)

Nota: Se hai scelto di riassumere le risorse all'interno di una Vista Lucidscale, dovrai disassemblarle per far sì che le linee vengano visualizzate nel modello.

Importare l'infrastruttura Google Cloud

È possibile importare Google Cloud Infrastructure utilizzando uno dei due metodi: fornire un account del servizio Google Cloud con le politiche appropriate; o l'esecuzione di uno script dall'interfaccia della riga di comando (CLI).

Se stai lavorando con un ambiente molto grande, utilizza le istruzioni che si trovano nella sezione Configurazione del progetto di questo articolo per ridurre la quantità di dati che stai importando o ridurre il numero di chiamate API che Lucidscale effettua a Google Cloudx. Il Centro dati supporta fino a cinque importazioni simultanee. Se si desidera importare più di cinque progetti, è necessario attendere il completamento di uno e quindi avviarne un altro.

Nota: Se importi utilizzando il metodo dell'account di servizio, Lucidscale salva gli account di servizio nel Data Hub in modo da poterli utilizzare in futuro senza dover reinserire i dati dell'account.

Per eseguire il rendering dell'infrastruttura Google Cloud in un modello Lucidscale:

Clicca su + New nella Home Page di Lucid.
Passa il cursore su "Lucidscale".
Seleziona Google Cloud Model.
Scegli di creare un modello con un progetto Google Cloud importato in precedenza o fai clic su Apri Centro dati per importare un nuovo progetto.
Clicca su + Nuovo progetto e scegli un metodo di importazione.
- Dopo aver scelto un metodo di importazione e aver completato l'importazione , il progetto verrà elencato come fonte di dati nella sezione "Google Cloud" del Centro dati. Puoi anche trovarlo elencato comeprogetto Google Cloud "importato" nel modale dopo aver fatto clic su + Nuovo > Lucidscale > Google Cloud Model.
Fai clic sul menu a tre punti accanto all'account da cui desideri creare un modello.
Dal menu, seleziona Crea nuovo modello.
Rivedi i dettagli e seleziona le visualizzazioni da aggiungere solo risorse necessarie.
Seleziona Crea Google Cloud Model.

Il modello Lucidscale verrà generato in background dal tuo account Lucid. Ti informeremo una volta che è stato reso attraverso il modale di stato che appare in basso a destra della pagina.

Puoi aprire il modello dalla maschera di stato che viene visualizzata subito dopo la creazione di un nuovo modello. Il modello (e i modelli precedentemente creati) saranno memorizzati e accessibili nella sezione "Documenti" della tua Home Page Lucid dopo averlo generato.

Come

Per saperne di più: Per sapere come lavorare con l'architettura di Google Cloud in un modello Lucidscale una volta eseguito il rendering, consulta l'articolo collegato.

Importazione di progetti e creazione di modelli tramite l'account di servizio (consigliato)

Per importare l'infrastruttura Google Cloud tramite l'account di servizio ed eseguire il rendering di un modello Lucidscale, procedi nel seguente modo:

Nella Home Page di Lucid, clicca su + New.
Passa il cursore su Lucidscale.
Seleziona Google Cloud Model.
Clicca su + Nuovo Progetto.
Seleziona Account del servizio Google Cloud (consigliato).
Clicca su Crea un nuovo account di servizio.
In Lucid, seleziona una delle due opzioni per assegnare un ruolo all'account di servizio. Clicca sul seguente link che corrisponde alla selezione effettuata in Lucid:
- Usa un ruolo di sola lettura per tutte le risorse (consigliato)
- Crea un ruolo personalizzato con autorizzazioni minime

Passo 2: Assegnare un ruolo all'account del servizio utilizzando un ruolo di sola lettura per tutte le risorse (consigliato)

Nella finestra successiva, al punto "Passo 1: Creare un nuovo account di servizio", clicca su Crea account di servizio per aprire una nuova scheda e accedere al tuo account Google Cloud. Lascia aperta la scheda del browser Lucid in modo da potervi tornare quando necessario.
Assicurati che sia selezionata l'opzione "Usa un ruolo di sola lettura per tutte le risorse (consigliato)".
Nella console Google Cloud , fai clic su Crea account di servizio.
Aggiungi i dettagli dell'account di servizio e clicca su Crea e continua.
Clicca sul menu a tendina "Seleziona un ruolo".
Seleziona Basic.
Clicca su Viewer.
Clicca su Fatto.
Passa al punto 3: genera una chiave JSON e aggiungi l'account del servizio a Lucidscale.

Fase 2: Assegnare un ruolo all'account di servizio creando un ruolo personalizzato con permessi minimi.

Nella tua scheda Lucid, seleziona l'opzione "Crea un ruolo personalizzato con permessi minimi".
Clicca su Download luciscale.yaml per scaricare il file yaml sul tuo computer.
Seleziona la scheda Livello organizzazione o Livello progetto a seconda del livello di dati che vuoi visualizzare in Lucidscale.
- In questo esempio, utilizzeremo l'opzione Livello progetto.
Copia la riga di codice risultante visualizzata.
Vai alla tua console Google Cloud e accedi.
Clicca su Attiva Cloud Shell.
Clicca sull'icona con i tre punti sopra il terminale di Cloud Shell e seleziona Upload.
Cerca il file yaml scaricato in precedenza e caricalo.
Incolla la riga di codice copiata (dal punto 4) nel terminale e sostituisci i seguenti valori nella riga di codice:
- role-id = il valore che vuoi usare per l'ID del tuo ruolo
- project-id = l'ID del tuo progetto Google Cloud
- yaml-file-path = percorso del file .yaml file
- Il risultato finale dovrebbe essere simile a questo (utilizzando valori falsi):
  - gcloud iam roles create lucidscalerole --project=test-project-id --file=lucidscale.yaml
- Se utilizzi la linea di codice del Livello Organizzativo, l'esempio sarà simile a questo (utilizzando anche valori falsi):
  - gcloud iam roles create lucidscalerole --organization=test-organization-id --file=lucidscale.yaml
Clicca su Autorizza.
Nel terminale ti verrà chiesto "Sei sicuro di voler fare questa modifica (S/N)?". Digita "Y" e clicca su Invio.
Continua con il Passo 3: Generare una chiave JSON e aggiungere l'account di servizio a Lucidscale.

Passo 3: Generare una chiave JSON e aggiungere l'account del servizio a Lucidscale

Nella console Google Cloud , seleziona l'account di servizio creato nel passaggio 1.8.
Clicca sulla scheda "Chiavi".
Seleziona Aggiungi chiave e clicca su Crea nuova chiave.
Scegli JSON come "tipo di chiave".
Clicca su Crea.
Un file JSON verrà scaricato sul tuo dispositivo.
Torna alla scheda aperta del browser Lucid.
Seleziona Scegli file.
Individua e seleziona per caricare il file JSON che hai scaricato al punto 6.
Clicca su Avanti.

Passo 4: Aggiungere progetti e creare modelli

Seleziona i progetti che desideri importare nel Centro dati e utilizzali per generare un modello Lucidscale.
Clicca su Avanti.
Selezionare le risorse da importare.
Seleziona Importa progetti Google Cloud.

Per saperne di più: Per sapere come lavorare con l'architettura di Google Cloud in un modello Lucidscale una volta eseguito il rendering, consulta l'articolo collegato.

Configurazione del progetto con un account di servizio

Quando si importa un progetto Google Cloud nei dati di Lucid Centro utilizzando il metodo dell'account di servizio, è possibile omettere i tipi di risorse o i metadati scelti dall'importazione. In questo modo è possibile visualizzare solo i tipi di risorse che interessano e, in alcuni casi, aumentare la velocità di importazione. Itipi di risorse e i metadati deselezionati non verranno importati o visualizzati nel diagramma.

google-cloud-lucidscale-project-select-resources-to-import.png

Importa progetti e crea modelli tramite l'interfaccia a riga di comando di Google Cloud

Installa Python se non ce l'hai già. Le istruzioni sono disponibili qui. Assicurati di selezionare l'opzione "Aggiungi Python a PATH" nel programma di installazione. È possibile verificare che Python sia stato installato correttamente provando i comandi "python" o "python 3" in un terminale (MAC OS) o nel prompt dei comandi (Windows).

Nella Home Page di Lucid, clicca su + New.
Passa il cursore su Lucidscale.
Seleziona Google Cloud Model.
Scegli di creare un modello da un progetto Google Cloud esistente o fai clic su Apri Centro dati per importare ed eseguire il rendering di un nuovo progetto.
Clicca su + Nuovo Progetto.
Seleziona lo script CLI di Google Cloud.
Apri il tuo terminale o il prompt dei comandi ed esegui il comando: Pip3 install oauth2client google-api-python-client
Inizializza l'SDK Gcloud eseguendo il comando: gcloud init
Autentica l'SDK Gcloud eseguendo il comando: gcloud auth application-default login
Nella finestra modale "Nuovo progetto Google Cloud " in Lucid, fai clic su Scarica script.
- Un file chiamato "gcpcliscript.py". verrà scaricato.
Naviga nella posizione dello script scaricato ed esegui il comando: python3 gcpcliscript.py --projects [project_id [project_ids...]] [-c] [-o <output file>]
- project_ids: Gli ID del progetto, possono essere trovati nella console Google Cloud nell'elenco dei progetti
- -c: emette il file count.json che contiene il conteggio delle risorse di calcolo nei progetti Google Cloud specificati (opzionale)
- -o: nome del file di output
- ad es. python3 gcpcliscript.py --progetti bubbly-xxxxxx-233220 summer-alliance-254420 gcpdev-272652
Torna alla modalità "Nuovo progetto Google Cloud " in Lucid e fai clic su Scegli file.
Seleziona e carica il file gcp.json generato dallo script.
Clicca su Avanti.
Modifica il nome del progetto e fai clic su Avanti.
- Al termine dell'importazione, il progetto verrà elencato come progetto Google Cloud importato nel modale dopo aver fatto clic su + Nuovo > Lucidscale > Google Cloud Model.
- Il progetto verrà visualizzato anche nella sezione Centro dati > Google Cloud: Progetti importati.
Seleziona Crea nuovo modello.
Esamina i dettagli e aggiungi dei filtri per escludere le risorse non necessarie.
Seleziona Crea Google Cloud Model.

Il modello Lucidscale verrà generato sullo sfondo del tuo account Lucid. Ti informeremo una volta che è stato generato attraverso il modale di stato che appare in basso a destra della pagina.

Per saperne di più: Per sapere come lavorare con l'architettura di Google Cloud in un modello Lucidscale una volta eseguito il rendering, consulta l'articolo collegato.

Utilizzare il Centro dati per gestire i dati e le credenziali importati da Google Cloud Infrastructure

Progetti importati

Dopo aver importato i dati del progetto Google Cloud , questi verranno elencati come fonte di dati con il nome del progetto specificato nella sezione "Google Cloud: Progetti importati" del Centro dati. Da questa sezione è possibile anche cliccare su + Nuovo progetto per importare un nuovo progetto nel Centro dati. I progetti Google Cloud che hai importato saranno elencati singolarmente nel Centro dati.

I progetti elencati in questa sezione sono fonti di dati che possono essere utilizzate per creare nuovi modelli Lucidscale. Le fonti di dati ("Progetti") contengono i metadati del progetto Google Cloud utilizzati per creare i modelli Lucidscale. Il campo "Ultimo aggiornamento" indica la data dell'ultimo aggiornamento dell'origine dati per tenere conto di eventuali aggiornamenti nel progetto Google Cloud connesso.

google-cloud-Centro dati-with-project-details.png

L'Inventario Cloud di ogni progetto può essere visualizzato sul lato destro dopo aver selezionato un progetto dall'elenco. Questo inventario ti permette di vedere il conteggio completo di ogni tipo di risorsa importata prima di creare un modello. Puoi anche scaricare un CSV con l'elenco delle risorse e il conteggio direttamente dal Data Hub cliccando su Download CSV.

L'inventario elenca tutte le risorse a cui è possibile accedere tramite le autorizzazioni del ruolo assegnate all'account di servizio. Se scegli di utilizzare un ruolo di sola lettura per tutte le risorse, tutti i tipi di risorse del tuo progetto accessibili tramite il ruolo "Visualizzatore" di Google Cloud verranno visualizzati nell'inventario. Se si crea un ruolo personalizzato, nell'inventario verrà eseguito il rendering solo dei tipi di risorse specificati nelle autorizzazioni del ruolo assegnate.

Seleziona il menu a tre punti visualizzato su un progetto per visualizzare fino a sei potenziali opzioni: Crea nuovo modello, Aggiorna progetto da Google Cloud, Pianifica aggiornamento, Modifica risorse, Rinomina progetto ed Elimina progetto.

Crea nuovo modello inizierà a eseguire il rendering dell'infrastruttura Google Cloud associata al progetto come diagramma nell'area di lavoro di un nuovo modello. Il modello verrà generato sullo sfondo della tua Home Page Lucid e riceverai una notifica una volta che sarà stato renderizzato attraverso la finestra modale di stato che appare in basso a destra della pagina.

Aggiorna progetto da Google Cloud e Pianifica aggiornamento consente di aggiornare manualmente o automaticamente i dati del progetto Google Cloud importati nel Centro dati per riflettere eventuali modifiche nel progetto Google Cloud collegato. I nuovi modelli creati dal progetto dopo l'aggiornamento rifletteranno eventuali modifiche apportate al progetto Google Cloud connesso.

Per saperne di più: Per ulteriori informazioni sull'aggiornamento dei progetti da Google Cloud, consulta il nostro articoloAggiornamento e sincronizzazione dei dati in Lucidscale .

Modifica risorse ti permette di modificare le risorse incluse in ogni set di dati. Selezionando questa opzione si aprirà una finestra di dialogo in cui potrai aggiungere o rimuovere le risorse dai set di dati esistenti. Una volta terminata la selezione, clicca su Salva e aggiorna il progetto. In questo modo il set di dati verrà aggiornato e i modelli che fanno riferimento al set di dati verranno aggiornati con le informazioni più recenti.

Rinomina progetto ti permette di cambiare il nome del dataset selezionato.

Elimina progetto rimuove il progetto importato dai dati di Lucid Centro e tutti i modelli creati da quel progetto perderebbero la capacità di aggiornare i dati da Google Cloud.

Nota: le opzioni visualizzate sopra variano a seconda del metodo di importazione utilizzato per un account. L'opzione di aggiornamento è disponibile solo con l'importazione dell'account Google Cloud Service. Le importazioni CLI non supportano questa opzione.

Credenziali salvate

credenziali-salvate-da-google-cloud-Centro dati.png

Nella sezioneCredenziali salvate in "Centro dati > Google Cloud" verranno elencati gli account del servizio Google Cloud che è possibile utilizzare per importare i progetti Google Cloud nel Centro dati. Da questa sezione è possibile fare clic su + Nuovo account di servizio per aggiungere un nuovo set di credenziali che possono essere utilizzate per importare un progetto Google Cloud.

Puoi anche condividere gli account di servizio che hai creato con altri utenti. Se fai clic sul menu a tre puntini reso su un account di servizio, vedrai due potenziali opzioni: Condividi la credenziale e Elimina la credenziale.

Condividi credenziali apre una modalità in cui puoi condividere un account di servizio che hai creato con un altro utente sul tuo account Lucid specificando il loro indirizzo email. Concedendo loro l'accesso all'account del servizio, potranno importare il progetto Google Cloud associato al Centro dati e creare modelli Lucidscale. Dopo che una credenziale è stata condivisa con un altro utente, puoi revocare il suo accesso alla credenziale facendo clic sulla X accanto al suo indirizzo e-mail nella stessa modale.

L'eliminazione delle credenziali consente di rimuovere un account di servizio dal Centro dati. Dopo aver eliminato un account di servizio, tutti i progetti importati in precedenza con tali credenziali, insieme ai modelli creati da tali progetti, perderebbero la possibilità di aggiornare i dati da Google Cloud.

Per saperne di più: Puoi condividere le credenziali solo nel Data Hub di cui sei proprietario. Solo gli utenti di Lucidscale con licenza Creator possono importare account e creare modelli. Per maggiori dettagli consulta il nostro articolo Gestione delle credenziali, utilizzo e sicurezza in Lucidscale .

FAQ

Una volta acquistato Lucidscale, tutti gli utenti dell'account avranno accesso?
Se sei un cliente Lucid esistente (attualmente hai un abbonamento Lucidchart o Lucidspark), a seconda delle impostazioni di licenza del tuo account è possibile che non tutti gli utenti dell'account abbiano accesso a Lucidscale per impostazione predefinita. L'amministratore dell'account potrebbe dover assegnare le licenze Lucidscale acquistate a utenti o gruppi individuali tramite la sezione Utenti del Pannello di amministrazione allo stesso modo di Lucidchart e Lucidspark. Agli utenti aggiunti a un account che dispone solo di un abbonamento Lucidscale Team (nessun abbonamento Lucidchart o Lucidspark corrente) verrà automaticamente assegnata una licenza Creator o Explorer a seconda delle licenze acquistate. Per istruzioni su come concedere le licenze, consulta l'articolo Pannello di amministrazione Lucid: Impostazioni delle licenze .

In che modo Lucidscale ottiene l'accesso al nostro ambiente Google Cloud ? Che livello di accesso ha Lucidscale?
Il metodo consigliato da Lucidscale e Google Cloud è tramite un account Google Cloud Service. Forniamo un criterio che ci consente di "descrivere ed elencare" l'accesso al tuo ambiente in modo da poter ottenere un inventario delle risorse.

Abbiamo anche un metodo che utilizza uno script python che puoi eseguire attraverso l'interfaccia a riga di comando (CLI) e che genera un file JSON. Gli utenti possono quindi caricare questo file JSON su Lucidscale e non inserire alcuna informazione sulle credenziali in Lucidscale. Il JSON importato sarà accessibile nel Lucid Data Hub e potrà essere utilizzato per creare modelli Lucidscale.

A quali API accede Lucidscale?
Utilizziamo principalmente endpoint API, descrizioni ed elenchi.

È possibile scegliere quali metadati (i campi e i valori visualizzati nel pannello Dati) vengono importati? In caso contrario, quali metadati vengono importati?
No, al momento non è possibile scegliere quali metadati importare. Tuttavia, stiamo cercando di creare una certa capacità per farlo in futuro. Vengono importati tutti i metadati di una chiamata API di descrizione.

Lascia un feedback su questo articolo

Hai commenti su questo articolo? Raccontaci la tua esperienza qui.

Articoli correlati