Importera och hantera Google Cloud-infrastrukturdata i Lucid Data Hub

Stödda Google Cloud-resurser och -linjer

För en omfattande lista över de resurser och linjer som stöds från Google Cloud och som finns tillgängliga i Lucid, se vår artikel om resurser och linjer som stöds i Google Cloud .

Titta: Importera Google Cloud-infrastruktur

Importera Google Cloud-infrastruktur

Du kan importera Google Cloud Infrastructure med en av två metoder: 

• Betrodd åtkomst: ange rätt policyer för ett Google Cloud-tjänstkonto. Det här tjänstkontot kan ställas in med följande behörighetsomfång:
  • Importera via åtkomst på projektnivå för att importera ett eller flera individuella projekt
  • Importera via åtkomst på organisationsnivå för att importera alla projekt inom en Google Cloud-organisation
• Filuppladdning: kör ett skript i ditt Google Cloud-kommandoradsgränssnitt (CLI), som samlar in data lokalt som en JSON-fil, och ladda sedan upp den genererade filen.
  

Kolla in följande tabell för detaljer om varje metod och för att avgöra vilken som är bäst för ditt användningsfall.

*Resurstyp 1 är alla mappade resurser som anges i avsnittet Resurs som stöds. Resurstyp 2 är Cloud Inventory: ett brett utbud av omappade resurser som du kan placera manuellt i dina modeller.
**Automatiska datakällsuppdateringar är tillgängliga för användare att ställa in på ett återkommande schema (dagligen, veckovis, månadsvis, årligen) via datahubben. Manuella uppdateringar utförs också med ett enda klick genom datahubben.

Med import av betrodd åtkomst sparar Lucid dessa inloggningsuppgifter så att du kan uppdatera dina data eller starta nya importer utan att behöva ange din information igen. Denna lagringsfunktion gör det möjligt för Lucid att utföra automatiska datauppdateringar. Inloggningsuppgifter kan raderas via fliken Inloggningsuppgifter i datahubben.

Om du arbetar med en mycket stor miljö kan du använda instruktionerna i avsnittet Projektkonfiguration i den här artikeln för att minska mängden data du importerar eller antalet API-anrop som Lucid gör till Google Cloud. 

Importera projekt och skapa dokument via Servicekonto (rekommenderas)

För att importera Google Cloud-infrastruktur via ett tjänstkonto och rendera ett Lucidchart-dokument, följ dessa steg:

1. Välj Datahubb från navigeringsmenyn till vänster på Lucids hemsida.
2. Välj Google Cloud bland alternativen till vänster.
3. Klicka på Importera Google Cloud-data.
4. Välj Tillförlitlig åtkomst.
5. Klicka på Skapa servicekonto.
6. I Lucid väljer du mellan de två alternativen för att tilldela en roll till tjänstekontot. Klicka på följande länk som motsvarar det val du gjorde i Lucid:
   • Importera projekt och skapa dokument via Servicekonto (rekommenderas)
   • Importera projekt och skapa dokument via Google Cloud CLI

Steg 2: Tilldela en roll till tjänstekontot med en skrivskyddad roll för alla resurser (rekommenderas)

1. I nästa modal under ”Steg 1: Skapa ett nytt servicekonto” klickar du på Skapa tjänstekonto för att öppna en ny flik och logga in på ditt Google Cloud-konto. Lämna Lucid-webbläsarfliken öppen så att du kan återgå till den efter behov. 
2. Se till att alternativet ”Använd en skrivskyddad roll för alla resurser (rekommenderas)” är markerat.
3. Klicka på Skapa tjänstkonto i din Google Cloud-konsol.
4. Lägg till servicekontoinformationen och klicka på Skapa och fortsätt.
5. Klicka på rullgardinsmenyn ”Välj en roll”.
6. Välj Grundläggande.
7. Klicka på Viewer.
8. Klicka på Klar.
9. Hoppa till steg 3: Generera en JSON-nyckel och lägg till servicekontot i Lucid.

Steg 2: Tilldela en roll till tjänstekontot genom att skapa en anpassad roll med minsta behörigheter

1. På din Lucid-flik väljer du alternativet ”Skapa en anpassad roll med minsta behörigheter”.
   
2. Klicka på Ladda ner luciscale.yaml för att ladda ner yam l-filen till din dator.
3. Välj fliken Organisationsnivå eller Projektnivå beroende på vilken datanivå du vill visualisera i Lucidchart.
   • I det här exemplet använder vi alternativet Projektnivå.
4. Kopiera den resulterande kodraden som visas.
5. Navigera till din Google Cloud-konsol och logga in.
6. Klicka på Aktivera Cloud Shell.
7. Klicka på ikonen med tre punkter ovanför Cloud Shell-terminalen och välj Ladda upp.
8. Bläddra till den tidigare nedladdade yaml-filen och ladda upp den.
9. Klistra in den kopierade kodraden (från steg 4 ovan) i terminalen och ersätt följande värden inom kodraden:
   • role-id = det värde som du vill använda för ditt roll-ID
   • projekt-id = ditt Google Cloud-projekt-ID
   • yaml-file-path = sökväg till.yaml fil
   • Slutresultatet bör se ut ungefär så här:
     • gcloud iam roller skapa lucidrole --project=test-project-id --file=lucid.yaml
   • Om du använder kodraden på organisationsnivå skulle exemplet se ut ungefär så här:
     • gcloud iam roller skapa lucidrole --organisation=test-organisations-id --fil=lucid.yaml
10. Klicka på Auktorisera.
11. I terminalen får du prompten ”Är du säker på att du vill göra den här ändringen (Y/N)?”. Skriv in ”Y” och klicka på Enter.
12. Fortsätt till steg 3: Generera en JSON-nyckel och lägg till servicekontot i Lucid nedan.

Steg 3: Generera en JSON-nyckel och lägg till servicekontot i Lucid

1. I din Google Cloud-konsol väljer du det tjänstkonto du skapade i steg 1.8.
2. Klicka på fliken ”Nycklar”.
3. Välj Lägg till nyckel och klicka på Skapa ny nyckel.
4. Välj JSON som ”nyckeltyp”.
5. Klicka på Skapa.
6. En JSON-fil laddas ner till din enhet.
7. Navigera tillbaka till din öppna Lucid-webbläsarflik.
8. Välj Välj fil.
9. Leta reda på och välj att ladda upp JSON-filen du laddade ner i steg 6.
10. Klicka på Nästa.

Steg 4: Lägg till projekt och skapa dokument

1. Välj det/de projekt du vill importera till datahubben och använd för att generera ett Lucidchart-dokument.
   
2. Klicka på Nästa.
3. Välj resurser som ska importeras.
   
4. Välj Importera Google Cloud-projekt.

Du kan öppna dokumentet från statusmodalen som återges direkt efter att du har skapat ett nytt dokument. Dokumentet (och tidigare skapade dokument) kommer också att lagras och nås i avsnittet " Dokument " på din Lucid-startsida efter att du har skapat det.

Projektkonfiguration med hjälp av ett servicekonto

När du importerar ett Google Cloud-projekt till Lucid Data Hub med hjälp av tjänstkontometoden kan du utelämna valda resurstyper eller metadata från importen. Detta ger dig möjlighet att visualisera endast de resurstyper du är intresserad av och kan i vissa fall öka importhastigheten. Avmarkerade resurstyper och metadata kommer inte att importeras eller renderas i diagrammet.

Importera projekt och skapa dokument via Google Cloud CLI

Installera Python om du inte redan har det. Instruktioner finns här. Se till att du markerar alternativet "Lägg till Python till PATH" i installationsprogrammet. Du kan verifiera att Python var korrekt installerat genom att prova kommandona "python" eller "python 3" i en terminal (MAC OS) eller kommandotolken (Windows).

1. Välj Datahubb från navigeringsmenyn till vänster på Lucids hemsida.
2. Välj Google Cloud bland alternativen till vänster.
3. Klicka på Importera Google Cloud-data i det övre högra hörnet.
4. Välj Filuppladdning.
5. Öppna din terminal eller kommandotolk och kör kommandot: Pip3 install oauth2client google-api-python-client
6. Initiera Gcloud SDK genom att köra kommandot: gcloud init
7. Autentisera Gcloud SDK genom att köra kommandot: gcloud auth application-default login
8. I modalfönstret ”Nytt Google Cloud-projekt” i Lucid klickar du på Ladda ner skript. 
   • En fil med namnet ”gcpcliscript.py” kommer att laddas ner.
     
      
9. Bläddra till den nedladdade platsen för skriptet och kör kommandot: python3 gcpcliscript.py --projects [project_id [project_ids...]] [-c] [-o] <output file>
   • project_ids: Projekt-id:n, finns i Google Cloud-konsolen under projektlistan
   • -c: matar ut filen count.json som innehåller antalet beräkningsresurser i de angivna Google Cloud-projekten (valfritt)
   • -o: namn på utdatafilen
   • t.ex. python3 gcpcliscript.py --projekt bubbly-xxxxxx-233220 sommar-allians-254420 gcpdev-272652
10. Gå tillbaka till modalfönstret ”Nytt Google Cloud-projekt” i Lucid och klicka på Välj fil.
11. Välj och ladda upp gcp.json som genereras från skriptet.
12. Klicka på Nästa.
13. Redigera projektets namn och klicka på Nästa.
    • När importen är klarlistasprojekteti Google Cloud-avsnittet i datahubben under fliken "Projekt".
14. Välj Skapa nytt dokument.
15. Granska detaljerna och lägg till filter för att utesluta onödiga resurser.
16. Välj Skapa Google Cloud-dokument.

Lucidchart-dokumentet genereras i bakgrunden av ditt Lucid-konto. Vi meddelar dig när den har renderats via statusmodalen som visas längst ner till höger på sidan.

Du kan öppna dokumentet från statusmodalen som återges direkt efter att du har skapat ett nytt dokument. Dokumentet (och tidigare skapade dokument) kommer också att lagras och nås i avsnittet " Dokument " på din Lucid-startsida efter att du har skapat det.

Använd datahubben för att hantera importerade Google Cloud Infrastructure-data och inloggningsuppgifter

Importerade projekt

Efter att du har importerat Google Cloud-projektdata kommer den att listas som en datakälla med det projektnamn du angav i avsnittet "Google Cloud: Importerade projekt" i Lucid Data Hub. Från det här avsnittet kan du också klicka på + Nytt projekt för att importera ett nytt projekt till datahubben. De Google Cloud-projekt du har importerat kommer att listas individuellt i datahubben.

Projekt som listas i det här avsnittet är datakällor som kan användas för att skapa nya Lucidchart-dokument. Datakällor ("Projekt") innehåller Google Cloud-projektets metadata som används för att skapa Lucidchart -dokument. Fältet "Senast uppdaterad" anger när din datakälla senast uppdaterades för att ta hänsyn till eventuella uppdateringar i ditt anslutna Google Cloud-projekt.

Molninventeringen för varje projekt kan ses till höger efter att du har valt ett projekt från listan. Den här inventeringen låter dig se en fullständig lista över varje typ av resurs som har importerats innan du skapar ett dokument. Du kan också ladda ner en CSV-fil med listan över resurser och räknare direkt från datahubben genom att klicka på Ladda ner CSV.

Inventeringen visar en lista över alla resurser som kan nås av de rollbehörigheter som tilldelats ditt tjänstkonto. Om du väljer att "Använd en skrivskyddad roll för alla resurser" kommer alla resurstyper i projektet som är tillgängliga för Google Clouds roll "Läsare" att återges i inventeringen. Om du skapar en anpassad roll återges endast de resurstyper som anges i dina tilldelade rollbehörigheter i inventeringen. 

Välj trepunktsmenynsom visas i ett projekt för att se upp till sex möjliga alternativ: Skapa nytt dokument, Uppdatera projekt från Google Cloud, Schemalägg uppdatering, Redigera resurser, Byt namn på projekt och Ta bort projekt.

Skapa nytt dokument börjar rendera Google Cloud-infrastrukturen som är kopplad till projektet som ett diagram i ett nytt dokuments arbetsyta. Dokumentet genereras i bakgrunden på din Lucid-startsida och du får ett meddelande när det har renderats via statusmodalen som visas längst ner till höger på sidan.

Med Uppdatera projekt från Google Cloud och schemalägg uppdatering kan du manuellt eller automatiskt uppdatera Google Cloud-projektdata som du har importerat till datahubben för att återspegla eventuella ändringar i det anslutna Google Cloud-projektet. Nya dokument som skapas från projektet efter uppdateringen kommer att återspegla eventuella ändringar i det anslutna Google Cloud-projektet. 

Redigera resurser låter dig redigera resurserna som ingår i varje dataset. Om du väljer det här alternativet öppnas en modal där du kan lägga till eller ta bort resurser från befintliga datamängder. När du är klar med markeringen klickar du på Spara och uppdatera Project. Detta kommer att säkerställa att datauppsättningen uppdateras och dokument som refererar till den datauppsättningen uppdateras till den senaste informationen.
 

Byt namn på projekt låter dig ändra namnet på den valda datasetet.

Om du väljer Ta bort projekt tas det importerade projektet bort från Lucid Data Hub och alla dokument som skapas från det projektet förlorar du möjligheten att uppdatera data från Google Cloud. Du kan importera samma Google Cloud-projekt mer än en gång – varje gång skapas en oberoende datakälla. Det är inte nödvändigt att ta bort ett befintligt projekt innan du importerar det igen.

Sparade inloggningsuppgifter

Avsnittet Sparade inloggningsuppgifter i "Datahub > Google Cloud" listar de Google Cloud-tjänstkonton som du kan använda för att importera Google Cloud-projekt till datahubben. I det här avsnittet kan du klicka på + Nytt tjänstkonto för att lägga till en ny uppsättning inloggningsuppgifter som kan användas för att importera ett Google Cloud-projekt.  

Du kan också dela de tjänstkonton du har skapat med andra användare. Om du klickar på trepunktsmenyn som återges på ett servicekonto, du kommer att se två potentiella alternativ: Delareferens och Ta bort referens .

Dela inloggningsuppgifter öppnar en modal där du kan dela ett tjänstkonto som du skapat med en annan användare på ditt Lucid-konto genom att ange deras e-postadress. Om du ger dem åtkomst till tjänstkontot kan de importera det associerade Google Cloud-projektet till datahubben . och skapa Lucidchart- dokument. När en autentiseringsuppgifter har delats med en annan användare kan du återkalla deras åtkomst till autentiseringsuppgifterna genom att klicka på X bredvid deras e-postadress i samma modal.

Om du tar bort autentiseringsuppgifter tas ett tjänstkonto bort från datahubben. Efter att du tagit bort ett tjänstkonto kommer alla projekt som tidigare importerats med den autentiseringsuppgiftern, tillsammans med dokument som skapats från dessa projekt, att förlora möjligheten att uppdatera data från Google Cloud.  

Vanliga frågor

Hur får Lucid åtkomst till vår Google Cloud-miljö? Vilken åtkomstnivå har Lucid?
Den rekommenderade metoden från Lucid och Google Cloud är via ett Google Cloud-tjänstkonto. Vi tillhandahåller en policy som ger oss åtkomst till din miljö med "beskriv och lista"-funktion så att vi kan få en inventering av resurser.

Vi har också en metod som använder ett Python-skript som du kan köra via kommandoradsgränssnittet (CLI) vilket genererar en JSON-fil. Användare kan sedan ladda upp denna JSON-fil till Lucid utan att fylla i någon autentiseringsinformation i Lucid. Din importerade JSON kommer att vara tillgänglig i Lucid Data Hub för att använda för att skapa Lucid -dokument.

Vilka API:er har Lucid åtkomst till?
Vi använder främst API-slutpunkter för att beskriva och lista.

Kan du välja vilka metadata (fälten och värdena som visas i datapanelen) som ska importeras? Om inte, vilka metadata importeras?
Nej, du kan för närvarande inte välja vilka metadata som ska importeras. Vi vill dock skapa en viss förmåga att göra det i framtiden. Alla metadata från ett beskrivande API-anrop importeras.

Ge feedback på den här artikeln