Lucid Data HubでGoogle Cloudのインフラデータをインポート・管理

サポートされている Google Cloud リソースと回線

Lucidで利用可能なサポートリソースや Google Cloud 線の包括的なリストについては、 サポートド Google Cloud リソースおよび線 の記事をご参照ください。

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

Google Cloud Infrastructureは以下の2つの方法のいずれかでインポートできます:

• 信頼できるアクセス:適切なポリシーを備えたGoogle Cloud Serviceアカウントを提供します。このサービスアカウントは以下の権限範囲で設定可能です:
  • プロジェクトレベルを経由してインポート:1つ以上の個人プロジェクトをインポートできるアクセス
  • 組織レベルのアクセスを通じて、Google Cloud組織内のすべてのプロジェクトをインポートできます
• ファイルアップロード: Google Cloud Command 線インターフェース(CLI)でスクリプトを実行し、データをローカルに集めるJSONファイルとしてまとめ、生成されたファイルをLucidにアップロードします。
  

各方法の詳細や、あなたのユースケースに最適なものを判断するために、以下のテーブルをご覧ください。

*リソースタイプ1は、サポートリソースセクションに一覧されているすべてのマッピングされたリソースです。リソースタイプ2はクラウドインベントリで、モデルに手動で配置できる多様な未マッピング資源です。
**データハブを通じて、ユーザーが毎日、週次、月次、毎年の定期スケジュールで自動データソースの更新が可能です。手動の更新もデータハブをワンクリックで行えます。

信頼アクセスインポートでは、Lucidはこれらの認証情報を保存し、データをリフレッシュしたり新しいインポートを行ったりする際に情報を再入力せずに行えます。 このストレージ機能により、Lucidは自動データ更新を行うことができます。 データハブの認証情報タブから認証情報を削除できます。

非常に大規模な環境を扱う場合は、この記事のプロジェクト設定セクションにある指示を活用して、インポートするデータ量を減らしたり、LucidがGoogle Cloudに行ったAPI呼び出しの数を減らすのに役立ちます。

プロジェクトをインポートし、Service Account経由で文書を作成する(推奨)

サービスアカウント経由でインフラ Google Cloud インポートし、 Lucidchart ドキュメントを発行するには、以下の手順をフォローしてください:

1. Lucid ホームページの左側にあるナビゲーションメニューから 「データハブ 」を選択してください。
2. 左側のオプションから Google Cloud を選択してください。
3. 「 Google Cloudデータをインポート」をクリックします。
4. 「信頼できるアクセス」を選択してください。
5. 「サービスアカウントの作成」をクリックします。
   • これにより、Google Cloudコンソール内の新しいタブに誘導され、そこでサービスアカウントIDをホストしたいプロジェクトを選択します。サービスアカウントの詳細を追加し、 「作成して続行」をクリックします。
6. Lucidブラウザのタブで、2つのオプションからサービスアカウントに役割を割り当てます。Lucidで選択した内容に対応する以下のリンクをクリックしてください。
   • プロジェクトをインポートし、Service Account経由で文書を作成する(推奨)
   • プロジェクトをインポートし、 Google Cloud CLIで文書を作成する

ステップ1：サービスアカウントに、すべてのリソースに対して読み取り専用ロールを割り当てます（推奨）。

1. Lucidでは「すべてのリソースに読み取り専用の役割を使用(推奨)」オプションを選択してください。Google Cloudでは、プロジェクトでResource Manager APIが有効になっていることを確認してください。
2. Google Cloudコンソールで「役割選択」ドロップダウンメニューをクリックします。
3. 検索して 「ビューア」をクリックしてください。
4. 「続行」をクリックしてください。
5. [完了] をクリックします。
6. ステップ3に進んでください：JSONキーを生成し、サービスアカウントをLucidに追加します。

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

1. [Lucid] タブで、[最小限の権限でカスタムロールを作成する] オプションを選択します。
   
2. 「 Download luciscale.yaml 」をクリックして、yamlファイルをパソコンにダウンロードしてください。
3. Lucidchart内で可視化したいデータのレベルに応じて、組織レベルまたはプロジェクトレベルタブを選択してください。
   • この例では、プロジェクトレベルオプションを使用します。
4. 表示された結果のコード行をコピーします。
5. Google Cloudコンソールにアクセスしてサインインしてください。
6. Cloud Shellの アクティベートをクリックしてください。
7. Cloud Shell端末の上にある3点アイコンをクリックし、「 アップロード」を選択してください。
8. 以前にダウンロードした yaml ファイルを参照してアップロードします。
9. コピーしたコード行(上記の手順4)をターミナルに貼り付け、コード行内の次の値を置き換えます。
   • ロール ID = ロール ID に使用する値
   • project-id = あなたのGoogle CloudプロジェクトID
   • yaml-file-path = .yaml へのパス ファイル
   • 最終結果はこんな感じになるはずです。
     • gcloud iam roles create lucidrole --project=test-project-id --file=lucid.yaml
   • もしあなたがOrganizational Level 線のコードを使っている場合、例は次のようなようになります。
     • gcloud iam roles create lucidrole --organization=test-organization-id --file=lucid.yaml
10. [ 承認]をクリックします。
11. ターミナルで、「この変更を行ってもよろしいですか(Y / N)」というプロンプトが表示されます。 「Y」と入力して 、Enterをクリックします。
12. ステップ3に進み、JSONキーを生成して、以下のLucidにサービスアカウントを追加します。

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

1. Google Cloudコンソールで、以前作成したサービスアカウントの設定に移動してください
2. 「キー」タブをクリックします。
3. [ キーの追加 ] を選択し、[ 新しいキーの作成] をクリックします。
4. 「キータイプ」としてJSONを選択します。
5. [ 作成] をクリックします。
6. JSON ファイルがデバイスにダウンロードされます。
7. 開いている Lucid ブラウザタブに戻ります。
8. [ ファイルの選択] を選択します。
9. 手順 6 でダウンロードした JSON ファイルを見つけてアップロードすることを選択します。
10. [次へ] をクリックします。

ステップ4:プロジェクトを追加し文書を作成する

1. データハブにインポートしたいプロジェクトを選択し、 Lucidchart ドキュメントを生成します。
   
2. [次へ] をクリックします。
3. インポートするリソースを選択します。
   
4. Google Cloud プロジェクトのインポートを選択します。

新しい文書を作成する直後に表示されるステータスモーダルから文書を開けることができます。 文書(および以前に作成した文書)も、作成後はLucid ホームページの「文書」セクションに保存・アクセスされます。

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

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

プロジェクトをインポートし、 Google Cloud CLIで文書を作成する

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

1. Lucid ホームページの左側にあるナビゲーションメニューから 「データハブ 」を選択してください。
2. 左側のオプションから Google Cloud を選択してください。
3. 右上隅の 「Google Cloudデータインポート 」をクリックしてください。
4. ファイルアップロードを選択してください。
5. ターミナルまたはコマンドプロンプトを開き、次のコマンドを実行します: Pip3インストールoauth2clientグーグル-api-python-client
6. 次のコマンドを実行して Gcloud SDK を初期化します: gcloud init
7. 次のコマンドを実行して Gcloud SDK を認証します:gcloud 認証アプリケーション - デフォルト ログイン
8. Lucidの「New Google Cloud Project」モードで「スクリプトをダウンロード」をクリックします。
   • 「gcpcliscript.py」という名前のファイルがダウンロードされます。
     
      
9. ダウンロードされたスクリプトの場所に移動し、 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
10. Lucidの「New Google Cloud Project」モーダルに戻り、「ファイル選択」をクリックします。
11. スクリプトから生成された gcp.json を選択してアップロードします。
12. [次へ] をクリックします。
13. プロジェクト名を編集して「次へ」をクリックします。
    • インポートが完了すると、プロジェクトはデータハブのGoogle Cloudセクションの「Projects」タブに掲載されます。
14. 「 新しい文書を作成」を選択します。
15. 詳細を確認し、不要なリソースを除外するために フィルター を追加してください。
16. 「文書を作成Google Cloud」を選択します。

LucidchartのドキュメントはLucidアカウントのバックグラウンドで生成されます。レンダリングが完了すると、ページ右下に表示されるステータスモーダルを通じてお知らせします。

新しい文書を作成する直後に表示されるステータスモーダルから文書を開けることができます。 文書(および以前に作成した文書)も、作成後はLucid ホームページの「文書」セクションに保存・アクセスされます。

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

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

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

このセクションに記載されているプロジェクトは、新しい Lucidchart ドキュメントを作成するために使用できるデータソースです。 データソース(「プロジェクト」)は、Lucidchart文書作成に使用されたGoogle Cloudプロジェクトのメタデータを含みます。「最終更新」フィールドは、接続されたGoogle Cloudプロジェクトの更新を考慮して、データソースが最後に更新された時期を示しています。

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

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

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

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

Google Cloudからのプロジェクト更新 とスケジュール更新 機能により、データハブにインポートしたGoogle Cloudプロジェクトのデータを手動または自動的に更新し、接続されたGoogle Cloudプロジェクトの変更を反映できます。アップデート後にプロジェクトから作成された新しいドキュメントは、接続されたGoogle Cloudプロジェクトの変更を反映します。

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

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

プロジェクトを削除するとインポートされたプロジェクトがLucid Data Hubから削除され、そのプロジェクトから作成された文書はGoogle Cloudからデータを更新する機能を失います。同じGoogle Cloudプロジェクトを複数インポートすることもでき、それぞれ独立したデータソースが作成されます。既存のプロジェクトを再インポートする前に削除する必要はありません。

保存された認証情報

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

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

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

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

よくある質問 (FAQ)

Lucidはどのようにして私たちのGoogle Cloud環境にアクセスしていますか?Lucidはどのレベルのアクセス権を持っているのでしょうか?
LucidやGoogle Cloudで推奨されている方法は、Google Cloud Serviceアカウントを利用することです。私たちは「環境を説明・リスト化」できるポリシーを提供し、リソースのインベントリを取得します。

また、Command 線インターフェース(CLI)を通じて実行できるpythonスクリプトを使ったメソッドもあり、これによりJSONファイルが生成されます。 ユーザーはこのJSONファイルをLucidにアップロードし、認証情報はLucidに入力しなくても済みます。インポートしたJSONはLucid Data Hubでアクセス可能で、Lucidドキュメントの作成に利用できます。

LucidはどのようなAPIにアクセスしますか？
私たちは主に、describe APIエンドポイントとlist APIエンドポイントを使用します。

どのメタデータ(データパネルに表示されるフィールドや値)をインポートするか選べますか?もしそうでなければ、どのようなメタデータがインポートされますか?
いいえ、現在インポートするメタデータを選べません。しかし、将来的にはToDoの機能を作りたいと考えています。APIを記述する呼び出しからのすべてのメタデータがインポートされます。

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