Lucidscale を使用すると、 Google Cloud (旧名 GCP) からクラウドインフラストラクチャデータをインポートし、Lucidscale モデルでそのデータからダイアグラムを生成できます。

Lucidscale で利用できる機能の詳細については、 Lucidscale プランの記事をご覧ください。

視聴: Google Cloud インフラストラクチャのインポート

サポートされているリソースと行

Lucidscale は次の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

メタデータ内の別のリソースを明示的に参照するリソース間に線を引くことができます。

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

注: Lucidscale ビュー内でリソースを集計することを選択した場合、モデルに線をレンダリングするには、リソースの集計を解除する必要があります。

Google Cloudインフラストラクチャをインポートする

Google Cloud Infrastructure をインポートするには、適切なポリシーを持つGoogle Cloudサービスアカウントを提供する方法と、コマンドラインインターフェース (CLI) からスクリプトを実行する方法の 2 つがあります。

非常に大規模な環境で作業している場合は、この記事のプロジェクト構成セクションの手順を使用して、インポートするデータの量を減らすか、Lucidscale がGoogle Cloudxに対して行う API 呼び出しの数を減らしてください。データハブは最大 5 つの同時インポートをサポートします。 5 つ以上のプロジェクトをインポートする場合は、1 つのプロジェクトが終了するまで待ってから、別のプロジェクトを開始する必要があります。

注: サービスアカウントを使用してインポートすると、Lucidscale はサービスアカウントをデータハブに保存するため、アカウント情報を再入力しなくても今後使用できます。

Google Cloudインフラストラクチャを Lucidscale モデルでレンダリングするには:

Google-cloud-モデル-from-Lucid ホームページ.png

Lucid ホームページで [+新規 ] をクリックします。
「Lucidscale」の上にカーソルを合わせます。
Google Cloud モデルを選択します。
以前にインポートした Google Cloud プロジェクトを使用してモデルを作成する か、[Open Data Hub] をクリックして新しいプロジェクトをインポートするかを選択します。
[+ 新し いプロジェクト ] をクリックし、インポート方法を選択します

。
- インポート方法を選択してインポートを完了すると、プロジェクトはデータハブの「Google Cloud」セクションにデータソースとしてリストされます。また、「+ 新規」>「Lucidscale」>「Google Cloud モデル」をクリックすると、モーダルに「インポートされた」Google Cloud プロジェクトとしてリストされることもあります。
モデルを作成するアカウントの横にある 3 ドットメニューをクリックします。
メニューから「新しいモデルの作成」を選択します。
詳細を確認し、ビューを選択して、必要なリソースのみを追加します。
「Google Cloud モデルの作成」を選択します。

Lucidscale モデルは、Lucid アカウントのバックグラウンドで生成されます。ページの右下に表示されるステータスモーダルを通じてレンダリングされると、通知されます。

新しいモデルを作成した直後にレンダリングされるステータスモーダルからモデルを開くことができます。モデル(および以前に作成したモデル) も保存され、生成後にLucidホームページの「ドキュメント」セクションからアクセスできます。

詳細: レンダリングされた Lucidscale モデルで Google Cloud アーキテクチャを操作する方法については、リンク先の記事をご覧ください。

プロジェクトをインポートし、サービスアカウントを介してモデルを作成する(推奨)

サービスアカウント経由でGoogle Cloudインフラストラクチャをインポートし、Lucidscale モデルをレンダリングするには、次の手順に従います。

Lucid ホームページで、[ + 新規] をクリックします。
カーソルを Lucidscaleの上に置きます。
Google Cloud モデルを選択します 。
[ + 新しい プロジェクト] をクリックします。
Google Cloud サービスアカウント (推奨) を選択します。
[ 新しいサービスアカウントの作成] をクリックします。
Lucid で、2 つのオプションのいずれかを選択して、サービスアカウントにロールを割り当てます。 Lucidで行った選択に対応する次のリンクをクリックします。
- すべてのリソースに読み取り専用ロールを使用する (推奨)
- 最小限の権限を持つカスタムロールを作成

手順 2: すべてのリソースに対して読み取り専用ロールを使用してサービスアカウントにロールを割り当てる (推奨)

次のモーダルの [ステップ 1: 新しいサービスアカウントを作成する] で、[ サービスアカウントを作成 ] をクリックして新しいタブを開き、Google Cloud アカウントにログインします。Lucid ブラウザタブは開いたままにして、必要に応じて戻ることができるようにします。
[すべてのリソースに読み取り専用ロールを使用する (推奨)] オプションが選択されていることを確認します。
Google Cloudコンソールで、 [サービスアカウントの作成]をクリックします。
サービスアカウントの詳細を追加し、[ 作成して続行] をクリックします。
[役割を選択]ドロップダウンメニューをクリックします。
[ 基本] を選択します。
[ ビューア] をクリックします。
[完了] をクリックします。
「ステップ 3: JSON キーを生成してサービスアカウントを Lucidscale に追加する」に進んでください。

手順 2: 最小限のアクセス許可を持つカスタムロールを作成して、サービスアカウントにロールを割り当てる

[Lucid] タブで、[最小限の権限でカスタムロールを作成する] オプションを選択します。
[ luciscale.yaml のダウンロード] をクリックして、yaml ファイルをコンピューターにダウンロードします。
Lucidscale 内で視覚化するデータのレベルに応じて、[組織レベル] タブまたは [プロジェクトレベル] タブを選択します。
- この例では、プロジェクトレベルオプションを使用します。
表示された結果のコード行をコピーします。
Google Cloudコンソールに移動してログインします。
「 クラウド・シェルのアクティブ化」をクリックします。
Cloud Shell ターミナルの上にある 3 つのドットのアイコンをクリックし、[アップロード]を選択します。
以前にダウンロードした yaml ファイルを参照してアップロードします。
コピーしたコード行(上記の手順4)をターミナルに貼り付け、コード行内の次の値を置き換えます。
- ロール ID = ロール ID に使用する値
- project-id = Google Cloudプロジェクト ID
- yaml-file-path = .yaml へのパスファイル
- 最終結果は次のようになります(偽の値を使用)。
  - gCloud IAM ロールは lucidscalerole を作成します --project=test-project-id --file=lucidscale.yaml
- 組織レベルのコード行を使用している場合、例は次のようになります (偽の値も使用)。
  - gcloud IAM ロール create lucidscalerole --organization=test-organization-id --file=lucidscale.yaml
[ 承認]をクリックします。
ターミナルで、「この変更を行ってもよろしいですか(Y / N)」というプロンプトが表示されます。「Y」と入力して 、Enterをクリックします。
以下の「ステップ 3: JSON キーを生成し、サービスアカウントを Lucidscale に追加する」に進んでください。

ステップ 3: JSON キーを生成してサービスアカウントを Lucidscale に追加する

Google Cloudコンソールで、手順 1.8 で作成したサービスアカウントを選択します。
「キー」タブをクリックします。
[ キーの追加 ] を選択し、[ 新しいキーの作成] をクリックします。
「キータイプ」としてJSONを選択します。
[ 作成] をクリックします。
JSON ファイルがデバイスにダウンロードされます。
開いている Lucid ブラウザタブに戻ります。
[ ファイルの選択] を選択します。
手順 6 でダウンロードした JSON ファイルを見つけてアップロードすることを選択します。
[次へ] をクリックします。

ステップ 4: プロジェクトを追加してモデルを作成する

データハブにインポートして Lucidscale モデルの生成に使用するプロジェクトを選択します。
[次へ] をクリックします。
インポートするリソースを選択します。
Google Cloud プロジェクトのインポートを選択します。

詳細: レンダリングされた Lucidscale モデルで Google Cloud アーキテクチャを操作する方法については、リンク先の記事をご覧ください。

サービスアカウントを使用したプロジェクト構成

サービスアカウント方式を使用してGoogle Cloudプロジェクトを Lucid Data Hub にインポートする場合、選択したリソースタイプまたはメタデータをインポートから省略できます。これにより、関心のあるリソースタイプのみを視覚化できるようになり、場合によってはインポートの速度が向上します。選択解除されたリソースタイプとメタデータは、ダイアグラムにインポートまたはレンダリングされません。

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

Google Cloud CLI 経由でプロジェクトをインポートし、モデルを作成する

Python をまだお持ちでない場合は、インストールします。手順については、こちらを参照してください。インストーラーの「PythonをPATHに追加」オプションにチェックを入れてください。Pythonが正しくインストールされたことを確認するには、ターミナル(MAC OS)またはコマンドプロンプト(Windows)でコマンド「python」または「python 3」を試します。

Lucid ホームページで、[ + 新規] をクリックします。
カーソルを Lucidscaleの上に置きます。
Google Cloud モデルを選択します 。
既存のGoogle Cloudプロジェクトからモデルを作成するか、[ Open Data Hub]をクリックして新しいプロジェクトをインポートしてレンダリングするかを選択します。
[ + 新しい プロジェクト ]をクリックします。
Google Cloud CLI スクリプトを選択します 。
ターミナルまたはコマンドプロンプトを開き、次のコマンドを実行します: Pip3インストールoauth2clientグーグル-api-python-client
次のコマンドを実行して Gcloud SDK を初期化します: gcloud init
次のコマンドを実行して Gcloud SDK を認証します:gcloud 認証アプリケーション - デフォルトログイン
Lucid の「新しいGoogle Cloudプロジェクト」モーダルで、 「スクリプトのダウンロード」をクリックします。
- "gcpcliscript.py" という名前のファイルがダウンロードされます。
スクリプトのダウンロードされた場所を参照し、次のコマンドを実行します。 python3 gcpcliscript.py --projects [project_id [project_ids...]] [- c] [-o <output file>]
- project_ids: プロジェクト ID。Google Cloudコンソールのプロジェクトリストで確認できます。
- -c: 指定されたGoogle Cloudプロジェクト内のコンピューティングリソースの数を含む count.json ファイルを出力します (オプション)
- -o:出力ファイルの名前
- 例えば python3 gcpcliscript.py --projects bubbly-xxxxxx-233220 summer-alliance-254420 gcpdev-272652
Lucid の「新しいGoogle Cloudプロジェクト」モーダルに戻り、 「ファイルを選択」をクリックします。
スクリプトから生成された gcp.json を選択してアップロードします。
[次へ] をクリックします。
プロジェクトの名前を編集し、 「次へ」をクリックします。
- インポートが完了すると、 「+ 新規」>「Lucidscale」>「Google Cloud モデル」をクリックすると、プロジェクトがモーダルにインポートされた Google Cloud プロジェクトとして表示されます。
- プロジェクトは、「データハブ > Google Cloud : インポートされたプロジェクト」セクションにも表示されます。
新しいモデルの作成を選択します。
詳細を確認し、除外する
フィルターを追加する不要なリソース。
「Google Cloud モデルの作成」を選択します。

詳細: レンダリングされた Lucidscale モデルで Google Cloud アーキテクチャを操作する方法については、リンク先の記事をご覧ください。

データハブを使用して、インポートされたGoogle Cloud Infrastructure のデータと認証情報を管理する

インポート済みのプロジェクト

Google Cloud プロジェクトデータをインポートすると、 Lucid Data Hub の「Google Cloud: インポートされたプロジェクト」セクションに、指定したプロジェクト名でデータ ソースとしてリストされます。このセクションから、[+ 新しい プロジェクト] をクリックして、新しいプロジェクトを Data Hub にインポートすることもできます。インポートした Google Cloud プロジェクトは、 Data Hub に個別にリストされます。

このセクションにリストされているプロジェクトは、新しい Lucidscale モデルを作成するために使用できるデータソースです。データソース (「プロジェクト」) には、Lucidscale モデルの作成に使用されるGoogle Cloudプロジェクトメタデータが含まれます。「最終更新日」フィールドには、接続されたGoogle Cloudプロジェクトの更新を反映するためにデータソースが最後に更新された日時が表示されます。

Google クラウドデータハブとプロジェクトの詳細.png

各プロジェクトのクラウドインベントリは、リストからプロジェクトを選択すると右側に表示されます。このインベントリを使用すると、モデルを作成する前にインポートされた各タイプのリソースの完全な数を確認できます。 [CSV のダウンロード] をクリックして、リソースとカウントの一覧を含む CSV をデータハブから直接ダウンロードすることもできます。

インベントリには、サービスアカウントに割り当てられたロール権限でアクセスできるすべてのリソースがリストされます。「すべてのリソースに読み取り専用ロールを使用する」を選択した場合、 Google Cloud の「ビューア」ロールでアクセスできるプロジェクト内のすべてのリソースタイプがインベントリに表示されます。カスタムロールを作成すると、割り当てられたロール権限で指定されたリソースタイプのみがインベントリに表示されます。

プロジェクトにレンダリングされた 3 つのドットメニューを選択すると、最大 6 つのオプション（新しいモデルの作成、Google Cloud からのプロジェクトの更新、更新のスケジュール設定、リソースの編集、プロジェクト名の変更、プロジェクトの削除）が表示されます。

新しいモデルを作成すると、プロジェクトに関連付けられたGoogle Cloudインフラストラクチャが新しいモデルのワークスペースにダイアグラムとしてレンダリングされます。モデルは Lucid ホームページのバックグラウンドで生成され、レンダリングされると、ページの右下に表示されるステータスモーダルを通じて通知されます。

Google Cloud からプロジェクトを更新し、更新をスケジュールする データハブにインポートしたGoogle Cloudプロジェクトデータを手動または自動で更新して、接続されたGoogle Cloud プロジェクトの変更を反映できます。更新後にプロジェクトから作成された新しいモデルには、接続されたGoogle Cloudプロジェクトの変更が反映されます。

詳細: Google Cloud からプロジェクトを更新する方法の詳細については、 Lucidscale でのデータの更新と同期に関する記事をご覧ください。

[リソースの編集 ] では、各データセットに含まれるリソースを編集できます。このオプションを選択すると、既存のデータセットにリソースを追加または削除できるモーダルが開きます。選択が完了したら、[ プロジェクトの保存と更新] をクリックします。これにより、データセットが更新され、そのデータセットを参照するモデルが最新の情報に更新されます。

インポートする Google クラウドリソースタイプ.png

[プロジェクト名の変更 ] では、選択したデータセットの名前を変更できます。

プロジェクトを削除すると、インポートされたプロジェクトが Lucid Data Hub から削除され、そのプロジェクトから作成されたモデルはGoogle Cloudからのデータ更新機能が失われます。

注:上記に表示されるオプションは、アカウントに使用したインポート方法によって異なります。更新オプションは、 Google Cloudサービスアカウントのインポートでのみ使用できます。CLI インポートではこのオプションはサポートされていません。

保存された認証情報

Google Cloud Data Hub から保存された認証情報.png

「データハブ > Google Cloud 」の「保存された認証情報」セクションには、 Google Cloud プロジェクトをデータハブにインポートするために使用できる Google Cloud サービスアカウントが一覧表示されます。このセクションから、 「+ 新しいサービス アカウント」をクリックして、 Google Cloud プロジェクトのインポートに使用できる新しい認証情報セットを追加できます。

作成したサービスアカウントを他のユーザーと共有することもできます。サービスアカウントにレンダリングされる 3 つのドットのメニューをクリックすると、[ 資格情報の共有] と [資格情報の削除] の 2 つのオプションが表示されます。

認証情報を共有する と、作成したサービスアカウントを Lucid アカウント上の他のユーザーのメールアドレスを指定して共有できるモーダルが開きます。サービスアカウントへのアクセスを許可すると、関連付けられている Google Cloud プロジェクトを データ ハブにインポートし、Lucidscale モデルを作成できるようになります 。認証情報を他のユーザーと共有した後は、同じモーダルでそのユーザーのメールアドレスの横にある[X] をクリックして、認証情報へのアクセスを取り消すことができます。

Google Cloud サービスアカウント認証情報を共有します。png

認証情報を削除すると、 データハブ からサービスアカウントが削除されます。サービスアカウントを削除すると、その認証情報を使用して以前にインポートされたすべてのプロジェクトと、それらのプロジェクトから作成されたモデルは、 Google Cloud からデータを更新できなくなります。

詳細情報: 資格情報を共有できるのは、自分が所有するデータハブのみです。Creator ライセンスが割り当てられた Lucidscale ユーザーのみが、アカウントのインポートとモデルの作成を行うことができます。詳しくは、Lucidscale での認証情報の管理、使用方法、セキュリティに関する記事をご覧ください。

よくある質問 (FAQ)

Lucidscale を購入すると、アカウントのすべてのユーザーがアクセスできるようになりますか?
既存の Lucid 顧客 (現在LucidchartまたはLucidsparkサブスクリプションをお持ちの場合) の場合、アカウントのライセンス設定によっては、アカウントのすべてのユーザーがデフォルトで Lucidscale にアクセスできるわけではない可能性があります。アカウント管理者は、 LucidchartおよびLucidsparkと同じ方法で、管理者パネルの「ユーザー」セクションを通じて、購入した Lucidscale ライセンスを個々のユーザーまたはグループに割り当てる必要がある場合があります。Lucidscaleチームサブスクリプションのみを持つアカウント (現在のLucidchartまたはLucidsparkサブスクリプションがない) に追加されたユーザーには、購入したライセンスに応じて、クリエーターライセンスまたはエクスプローラーライセンスが自動的に割り当てられます。ライセンスを付与する方法については、「Lucid 管理者パネル: ライセンス設定」の記事を参照してください。

Lucidscale はどのようにしてGoogle Cloud環境にアクセスするのでしょうか? Lucidscale のアクセスレベルはどの程度ですか?
Lucidscale とGoogle Cloudが推奨する方法は、 Google Cloudサービスアカウントを使用することです。リソースのインベントリを取得できるように、お客様の環境への「説明と一覧表示」アクセス権を付与するポリシーを提供しています。

JSONファイルを生成するコマンドラインインターフェイス(CLI)を介して実行できるPythonスクリプトを使用するメソッドもあります。ユーザーはこの JSON ファイルを Lucidscale にアップロードでき、認証情報を Lucidscale に入力することはできません。インポートした JSON は、Lucid データハブでアクセスでき、Lucidscale モデルの作成に使用できます。

Lucidscale はどの API にアクセスしますか?
主に、記述およびリスト API エンドポイントを使用します。

どのメタデータ (データパネルに表示されるフィールドと値) をインポートするか選択できますか? 選択できない場合は、どのメタデータがインポートされますか?
いいえ、現在、インポートするメタデータを選択することはできません。ただし、将来的にはそれができる機能を作成する予定です。describe API 呼び出しからのすべてのメタデータがインポートされます。

この記事へのフィードバックをお寄せください

この記事に関するフィードバックはありますか？体験の内容についてこちらから教えてください。

関連記事