Lucidscale で Google Cloud インフラストラクチャ データをインポートして管理する

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

Lucidscale で利用可能な Google Cloud のサポートされているリソースと回線の包括的なリストについては、 サポートされている Google Cloud のリソースと回線の 記事を参照してください。

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

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

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

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

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

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

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

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

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

1. Lucid ホームページで [+新規 ] をクリックします 。
2. 「Lucidscale」の上にカーソルを合わせます。
3. 文書Google Cloud選択 。
4. 以前にインポートしたGoogle Cloud プロジェクト で文書を作成する か、 新しいプロジェクトをインポートするには Open Data Hub をクリックしてください。
5. +新しいプロジェクト をクリックして インポート方法を選択してください。
   
   • インポート方法を選択しインポートを完了 すると 、プロジェクトはDataGoogle Cloud Hubの「 」セクションでデータソースとしてリスト Google Cloudされます 。また、 文書の「+ New >Google Cloud Lucidscale > を クリックすると、モーダル内で「インポート」 プロジェクト として表示されています。
6. 文書を作成したいアカウントの横にある3 ドットメニューをクリックしてください。
7. メニューから「 新しい文書を作成」を選択します。
8. 詳細を確認し、必要なリソースだけを追加するためにビューを選択します。
   
9. 「文書を作成Google Cloud」を選択します。

Lucidscale 文書はあなたのLucidアカウントのバックグラウンドで生成されます。 ページ右下に表示されるステータスモーダルからレンダリングが完了次第、お知らせいたします。

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

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

サービスアカウント経由で Google Cloud インフラを取り込み、Lucidscale 文書を生成するには、以下の手順をフォローしてください:

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

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

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

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

1. [Lucid] タブで、[最小限の権限でカスタムロールを作成する] オプションを選択します。
   
2. 「 Download luciscale.yaml 」をクリックして、yamlファイルをパソコンにダウンロードしてください。
3. Lucidscale 内で視覚化するデータのレベルに応じて、[組織レベル] タブまたは [プロジェクトレベル] タブを選択します。
   • この例では、プロジェクトレベルオプションを使用します。
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 ロールは lucidscalerole を作成します --project=test-project-id --file=lucidscale.yaml
   • 組織レベルのコード行を使用している場合、例は次のようになります (偽の値も使用)。
     • gcloud IAM ロール create lucidscalerole --organization=test-organization-id --file=lucidscale.yaml
10. [ 承認]をクリックします。
11. ターミナルで、「この変更を行ってもよろしいですか(Y / N)」というプロンプトが表示されます。 「Y」と入力して 、Enterをクリックします。
12. 以下の「ステップ 3: JSON キーを生成し、サービスアカウントを Lucidscale に追加する」に進んでください。

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

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

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

1. Data Hubにインポートしたいプロジェクトを選択し、Lucidscale文書を生成します。
   
2. [次へ] をクリックします。
3. インポートするリソースを選択します。
   
4. Google Cloud プロジェクトのインポートを選択します。

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

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

サービスアカウントメソッドを使ってLucid Data Hubに Google Cloud プロジェクトをインポートする際、選択したリソースタイプやメタデータをインポートから省略できます。これにより、興味のある資源タイプだけを可視化でき、場合によってはインポートの速度も向上します。 選択解除されたリソースタイプやメタデータはダイアグラムにインポートまたはレンダリングされません。

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

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

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

Lucidscale 文書はあなたのLucidアカウントのバックグラウンドで生成されます。 ページ右下に表示されるステータスモーダルからレンダリングが完了次第、お知らせいたします。

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

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

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

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

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

各プロジェクトのクラウドインベントリは、リストからプロジェクトを選択すると右側に表示されます。このインベントリは、文書を作成する前にインポートされた各資源の全カウントを確認できます。また、Data Hubから「 Download 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プロジェクトをData HubにインポートできるGoogle Cloudサービスアカウントが表示されます。このセクションから + 新しいサービスアカウント をクリックすると、 Google Cloudプロジェクトをインポートするための新しい認証情報セットを追加できます。

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

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

認証情報を削除すると 、データハブ からサービスアカウントが削除 されます。サービスアカウントを削除すると、その認証情報でインポートされたすべてのプロジェクトと、それらのプロジェクトから作成された文書は、 からデータを更新する機能を失います。Google Cloud

よくある質問 (FAQ)

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

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

LucidscaleはどのようなAPIにアクセスできますか?
私たちは主にAPIエンドポイントを記述・リストしています。

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

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