Importeer en beheer Google Cloud-infrastructuurdata in de Lucid Data Hub

Ondersteunde Google Cloud-bronnen en -lijnen

Voor een uitgebreide lijst van de ondersteunde bronnen en lijnen van Google Cloud die beschikbaar zijn in Lucid, raadpleeg ons artikel over Ondersteunde Google Cloud-bronnen en -lijnen .

Kijken: Google Cloud-infrastructuur importeren

Google Cloud-infrastructuur importeren

je kan Google Cloud infrastructuur importeren via een van de twee methoden: 

• Vertrouwde toegang: bied een Google Cloud Service-account aan met de juiste beleidsregels. Dit serviceaccount kan worden ingesteld met de volgende Toestemmingen-scopes:
  • Importeren via projectniveau toegang om één of meer individuele projecten te importeren
  • Importeren via toegang op organisatieniveau om alle projecten binnen een Google Cloud Organization te importeren
• Bestandsupload: voer een script uit in jouw Google Cloud Command lijnen Interface (CLI), waarbij de gegevens lokaal als JSON-bestand worden verzameld, en upload vervolgens het gegenereerde bestand.
  

Bekijk de volgende tabellen voor details over elke methode en om te bepalen welke het beste is voor jouw gebruikssituatie.

*Resource type 1 is alle toegewezen bronnen die worden vermeld in de sectie Ondersteunde bronnen. Resource type 2 is cloud Inventory: een breed scala aan niet-toegewezen bronnen die je handmatig in jouw model kunt plaatsen.
**Automatische gegevensbronverversingen zijn beschikbaar voor Gebruiker om in te stellen op een terugkerend schema (dagelijks, wekelijks, maandelijks, jaarlijks) via de datahub. Handmatige verversingen worden ook uitgevoerd met één klik via de datahub.

Met vertrouwde toegangsimporten slaat Lucid deze inloggegevens op zodat je jouw gegevens kunt verversen of nieuwe importen kunt starten zonder jouw gegevens opnieuw in te voeren. Deze opslagmogelijkheid stelt Lucid in staat om automatisch gegevensvernieuwing uit te voeren. Inloggegevens kunnen worden verwijderd via het tabblad gegevensinloggegevens.

Als je met een zeer grote omgeving werkt, gebruik dan de instructies in het Projectconfiguratie-gedeelte van dit artikel om de hoeveelheid data die je importeert te verminderen of het aantal API-aanroepen dat Lucid naar Google Cloud maakt te verminderen.

Importeer projecten en maak documenten aan via een Serviceaccount (Aanbevolen)

Om Google Cloud infrastructuur via een serviceaccount te importeren en een Lucidchart documentte renderen, volgt u deze stappen:

1. Selecteer Data hub in het navigatiemenu aan de linkerkant van de Lucid startpagina.
2. Selecteer Google Cloud in de opties aan de linkerkant.
3. Klik op Google Cloud-gegevens importeren.
4. Selecteer Vertrouwde toegang.
5. Klik op Aanmaken van een serviceaccount.
6. Selecteer in Lucid een van de twee opties om een rol aan het serviceaccount toe te wijzen. Klik op de volgende link die overeenkomt met de selectie die u in Lucid heeft gemaakt:
   • Importeer projecten en maak documenten aan via een Serviceaccount (Aanbevolen)
   • Importeer projecten en maak documenten aan via Google Cloud CLI

Stap 2: Wijs een rol toe aan het serviceaccount met behulp van een alleen-lezen rol voor alle resources (aanbevolen)

1. In het volgende venster onder 'Stap 1: Een nieuw serviceaccount maken' klikt u op Serviceaccount maken om een nieuw tabblad te openen en in te loggen op uw Google Cloud-account. Laat het Lucid-browsertabblad open, zodat u er indien nodig naar kunt terugkeren. 
2. Zorg ervoor dat de optie 'Gebruik een alleen-lezen rol voor alle bronnen (aanbevolen)' is geselecteerd.
3. Klik in jouw Google Cloud console op Serviceaccount aanmaken.
4. Voeg de serviceaccountgegevens toe en klik op Maken en doorgaan.
5. Klik op het vervolgkeuzemenu 'Selecteer een rol'.
6. Selecteer Basis.
7. Klik op Kijker.
8. Klik op Gereed.
9. Sla over naar stap 3: Genereer een JSON-sleutel en voeg het serviceaccount toe aan Lucid.

Stap 2: Wijs een rol toe aan het serviceaccount door een aangepaste rol met minimale machtigingen te maken

1. Selecteer op het tabblad Helder de optie ‘Een aangepaste rol maken met minimale machtigingen’.
   
2. Klik op Download luciscale.yaml om het yaml-bestand naar jouw computer te downloaden.
3. Selecteer het tabblad Organisatieniveau of Projectniveau, afhankelijk van welk dataniveau je binnen Lucidchartwilt visualiseren.
   • In dit voorbeeld gebruiken we de optie Projectniveau.
4. Kopieer de resulterende coderegel die wordt weergegeven.
5. Ga naar jouw Google Cloud console en log in.
6. Klik op Activeren cloud Shell.
7. Klik op het driepunt-icoon boven de cloud Shell-terminal en selecteer Uploaden.
8. Blader naar het eerder gedownloade yaml-bestand en upload het.
9. Plak de gekopieerde coderegel (uit stap 4 hierboven) in de terminal en vervang de volgende waarden binnen de coderegel:
   • rol-id = de waarde die u wilt gebruiken voor uw rol-ID
   • project-id = jouw Google Cloud project ID
   • yaml-file-path = pad naar de .yaml bestand
   • De eindresultaten zouden er ongeveer zo uit moeten zien:
     • gcloud iam roles create lucidrole --project=test-project-id --file=lucid.yaml
   • Als je de Organizational niveau lijnen van code gebruikt, zou het voorbeeld er ongeveer zo uitzien:
     • gcloud iam roles create lucidrole --organization=test-organization-id --file=lucid.yaml
10. Klik op Autoriseren.
11. In de terminal krijgt u de vraag “Weet u zeker dat u deze wijziging wilt aanbrengen (J/N)?”. Typ “Y” en klik op Enter.
12. Ga verder met stap 3: Genereer een JSON-sleutel en voeg het Serviceaccount toe aan Lucid hieronder.

Stap 3: Genereer een JSON-sleutel en voeg het Serviceaccount toe aan Lucid

1. Selecteer in jouw Google Cloud console het Serviceaccount dat je hebt aangemaakt in stap 1.8.
2. Klik op het tabblad 'Sleutels'.
3. Selecteer Sleutel toevoegen en klik op Nieuwe sleutel maken.
4. Kies JSON als het “sleuteltype”.
5. Klik op Maken.
6. Er wordt een JSON-bestand naar uw apparaat gedownload.
7. Navigeer terug naar uw geopende Lucid-browsertabblad.
8. Selecteer Bestand kiezen.
9. Zoek en selecteer om het JSON-bestand te uploaden dat u in stap 6 hebt gedownload.
10. Klik op Volgende.

Stap 4: Voeg projecten toe en maak een document aan

1. Selecteer het project(en) dat je wilt importeren in de datahub en gebruik het om een Lucidchart-document te genereren.
   
2. Klik op Volgende.
3. Selecteer de bronnen die u wilt importeren.
   
4. Selecteer Google Cloud-projecten importeren.

je kan de document openen vanuit de statusmodal die direct wordt weergegeven nadat een nieuwe documentis gemaakt. Het document (en eerder aangemaakt document) wordt ook opgeslagen en toegankelijk in de "document"-sectie van jouw Lucid startpagina nadat je het hebt gegenereerd.

Projectconfiguratie met behulp van een serviceaccount

Wanneer je een Google Cloud-project importeert in de Lucid Data Hub met de serviceaccountmethode, kun je gekozen resourcetypes of metadata uit de import weglaten. Dit geeft je de mogelijkheid om alleen de soorten grondstoffen te visualiseren waarin je geïnteresseerd bent en in sommige gevallen kan het de importsnelheid verhogen. Geselecteerde resourcetypes en metadata worden niet geïmporteerd of weergegeven in het diagram.

Importeer projecten en maak documenten aan via Google Cloud CLI

Installeer Python als je het nog niet hebt. Instructies vindt u hier. Zorg ervoor dat u de optie "Add Python to PATH" in het installatieprogramma aanvinkt. Je kunt verifiëren dat Python correct is geïnstalleerd door de opdrachten “python” of “python 3” uit te proberen in een terminal (MAC OS) of opdrachtprompt (Windows).

1. Selecteer Data hub in het navigatiemenu aan de linkerkant van de Lucid startpagina.
2. Selecteer Google Cloud in de opties aan de linkerkant.
3. Klik rechtsboven op Google Cloud-gegevens importeren .
4. Selecteer Bestand uploaden.
5. Open uw terminal of opdrachtprompt en voer de opdracht uit: Pip3 install oauth2client google-api-python-client
6. Initialiseer de Gcloud SDK door de opdracht uit te voeren: gcloud init
7. Verifieer de Gcloud SDK door de opdracht uit te voeren: gcloud auth application-default login
8. In de "New Google Cloud Project"-modal in Lucid klik je opDownload Script.
   • Er wordt een bestand genaamd "gcpcliscript.py" gedownload.
     
      
9. Blader naar de gedownloade locatie van het script en voer het commandopython3 uit gcpcliscript.py --projects [project_id [project_ids...]] [-c] [-o] <output file>
   • project_ids: Project ids, is te vinden op de Google Cloud console onder projectlijst
   • -c: geeft het count.json-bestand uit dat het aantal rekenbronnen bevat in de opgegeven Google Cloud-projecten (optioneel)
   • -o: naam van het uitvoerbestand
   • bijvoorbeeld. python3 gcpcliscript.py --projecten bubbels-xxxxxx-233220 zomer-alliance-254420 gcpdev-272652
10. Ga terug naar de "New Google Cloud Project"-modus in Lucid en klik op Bestand kiezen.
11. Selecteer en upload de gcp.json gegenereerd op basis van het script.
12. Klik op Volgende.
13. bewerken de naam van het project en klik op Volgende.
    • Nadat de import is voltooid, wordt het project vermeld in het Google Cloud-gedeelte van de datahub onder het tabblad "Projecten".
14. Selecteer Nieuw document aanmaken.
15. Bekijk de details en voeg filters toe om onnodige bronnen uit te sluiten.
16. Selecteer Google Cloud-document aanmaken.

De Lucidchart document zal op de achtergrond van jouw Lucid-account worden gegenereerd. We laten je weten zodra het is weergegeven via de statusmodal die rechtsonder op de pagina verschijnt.

je kan de document openen vanuit de statusmodal die direct wordt weergegeven nadat een nieuwe documentis gemaakt. Het document (en eerder aangemaakt document) wordt ook opgeslagen en toegankelijk in de "document"-sectie van jouw Lucid startpagina nadat je het hebt gegenereerd.

Gebruik de data hub om geïmporteerde Google Cloud Infrastructure-gegevens en inloggegevens te beheren

Geïmporteerde projecten

Na het importeren van de Google Cloud-projectgegevens wordt deze weergegeven als een databron met de projectnaam die je hebt opgegeven in de sectie "Google Cloud: Imported Projects" van de Lucid Data Hub. Vanuit deze sectie kun je ook klikken op + Nieuw Project om een nieuw project te importeren in de datahub. De Google Cloud-projecten die je hebt geïmporteerd, worden individueel weergegeven in de datahub.

De projecten die in deze sectie worden genoemd, zijn databronnen die gebruikt kunnen worden om nieuwe Lucidchart documenten te maken. Databronnen ("Projecten") bevatten de Google Cloud projectmetadata die wordt gebruikt om Lucidchartdocument te maken . Het veld "Laatst bijgewerkt" geeft aan wanneer jouw databron voor het laatst is ververst om rekening te houden met eventuele updates in jouw connected Google Cloud project.

De cloud Inventory van elk project is aan de rechterkant te zien nadat een project uit de lijst is geselecteerd. Deze inventaris stelt je in staat om een volledige telling te zien van elk type resource dat is geïmporteerd voordat je een document maakt. je kunt ook een CSV downloaden met de lijst van bronnen en tellen direct vanaf de datahub door te klikken op Download CSV.

In de inventaris staan alle bronnen die toegankelijk zijn voor de rol Toestemmingen die is toegewezen aan jouw Service Account. Als je kiest voor "Gebruik een alleen-lezen rol voor alle bronnen", worden alle typen bronnen in jouw project die toegankelijk zijn met Google Cloud's "Viewer" rol weergegeven in de inventaris. Als je een aangepaste rol maakt, zullen alleen de typen bronnen die in jouw toegewezen rol Toestemmingen zijn gespecificeerd in de inventaris worden weergegeven. 

Selecteer het driepuntmenu dat op een project wordt weergegeven om maximaal zes mogelijke opties te zien: Nieuw document aanmaken, Project bijwerken vanuit Google Cloud, Update plannen, bronnen bewerken, Project hernoemen en Project verwijderen.

Create new document zal beginnen met het renderen van de Google Cloud infrastructuur die bij het project hoort als een diagram in de werkruimte van een nieuw document. De document wordt gegenereerd op de achtergrond van jouw Lucid startpagina en je krijgt een melding zodra deze is weergegeven via de statusmodal die rechtsonder op de pagina verschijnt.

Project updaten vanuit Google Cloud en Schedule update stelt je in staat om handmatig of automatisch de Google Cloud projectgegevens die ik in de datahub heb geïmporteerd bij te werkenom eventuele wijzigingen in het connected Google Cloud project weer te geven. Nieuw document dat na de update uit het project is aangemaakt, weerspiegelt eventuele wijzigingen in het connected Google Cloud project. 

Bewerken resources stelt JE in staat de bronnen in elke dataset te bewerken. Door deze optie te selecteren, opent je een modal waarin je bronnen uit bestaande datasets kan toevoegen of verwijderen. Als je klaar bent met de selectie, klik je op Opslaan en Update Project. Dit zorgt ervoor dat de dataset ververst en documenten die naar die dataset verwijzen worden bijgewerkt met de nieuwste informatie.
 

Met Rename Project kunt u de naam van de geselecteerde dataset wijzigen.

Verwijder Project verwijdert het geïmporteerde project uit de Lucid Data Hub en elk document dat uit dat project wordt gemaakt, verliest de mogelijkheid om data van Google Cloudbij te werken. JE kan hetzelfde Google Cloud project meer dan eens importeren — elk project creëert een onafhankelijke databron. Het verwijderen van een bestaand project is niet nodig voordat het opnieuw wordt geïmporteerd.

Opgeslagen verificatiegegevens

De sectieOpgeslagen inloggegevens in "Data hub > Google Cloud" vermeldt de Google Cloud-serviceaccounts die je kunt gebruiken om Google Cloud-projecten naar de datahubte importeren. Vanuit deze sectie kun je klikken op + Nieuw Service-account om een nieuwe set inloggegevens toe te voegen die gebruikt kunnen worden om een Google Cloud-project te importeren.  

U kunt de serviceaccounts die u hebt gemaakt ook delen met andere gebruikers. Als u op het menu met drie stippen klikt dat op een serviceaccount wordt weergegeven, ziet u twee mogelijke opties: referenties delen en referenties verwijderen.

Delen-credential opent een modal waarin ik een serviceaccount kan delen dat ik heb aangemaakt met een andere gebruiker op jouw Lucid-account door hun e-mailadres op te geven. Door hen toegang te geven tot het service-account kunnen ze het bijbehorende Google Cloud project importeren naar de datahub en Lucidchart document aanmaken. Nadat een inloggegevens zijn gedeeld met een andere Gebruiker, kan je hun toegang tot het inlogement intrekken door op het X naast hun e-mailadres in dezelfde modus te klikken.

Verwijder je de inloggegevens verwijderje een serviceaccount uit de datahub. Na het verwijderen van een serviceaccount verliezen alle projecten die eerder met die inloggegevens zijn geïmporteerd, samen met documenten die uit die projecten zijn gemaakt, de mogelijkheid om gegevens van Google Cloudbij te werken.  

Veelgestelde vragen

Hoe krijgt Lucid toegang tot onze Google Cloud-omgeving? Welk niveau van toegang heeft Lucid?
De aanbevolen methode van Lucid en Google Cloud is via een Google Cloud Service Account. Wij bieden een beleid dat ons toegang geeft tot jouw omgeving met "beschrijven en lijsten", zodat we een inventaris van bronnen kunnen opmaken.

We hebben ook een methode die een python-script gebruikt die ik via de Command lijnen Interface (CLI) kan uitvoeren, wat een JSON-bestand genereert. Gebruiker kan dit JSON-bestand dan uploaden naar Lucid zonder enige inloggegevens in Lucidte vullen. Jouw geïmporteerde JSON zal toegankelijk zijn in de Lucid Data Hub om te gebruiken voor het maken van een Lucid-document.

Welke API's heeft Lucid toegang toe?
We gebruiken voornamelijk beschrijf- en lijst-API-eindpunten.

Kun je kiezen welke metadata (de velden en waarden die in het datapaneel worden getoond) worden geïmporteerd? Zo niet, welke metadata wordt dan geïmporteerd?
Nee, je kunt momenteel niet kiezen welke metadata geïmporteerd wordt. We willen echter in de toekomst een mogelijkheid creëren om dat te doen. Alle metadata van een describe API-aanroep wordt geïmporteerd.

Feedback geven over dit artikel