mcpField
O
onboarding-preflight-check

onboarding-preflight-check

github.com/looker-open-sourceクラウド・DevOps43102 回インストール2 週間前に更新
リポジトリ

onboarding-preflight-check について

Looker 開発者のオンボーディング向けスキルです。セットアップ前にローカル環境の要件と Google Cloud IAM 権限を確認し、システムと IAM の事前チェックや問題への対処方法を示します。

主な機能

  1. 01ローカル必須ツールの確認
  2. 02Google Cloud 認証の確認
  3. 03Looker サービスアカウントの IAM ロール確認
  4. 04チェック失敗への対処ガイド

活用シーン

  1. 01Looker 導入前の作業環境確認
  2. 02接続設定時の BigQuery アクセス権確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/looker-open-source/looker-skills --skill onboarding-preflight-check

インストール後、Claude Code で/onboarding-preflight-checkを入力して読み込まれたか確認します。

同梱ファイルscripts/preflight_check_test.shscripts/preflight_check.sh

詳細

Looker 開発者のオンボーディング：事前チェック

このスキルでは、オンボーディングを開始する前に、ローカル環境で必要なツールと認証が設定されていることを確認します。

手順

1. システムの事前チェックを実行する

system モードで事前チェック スクリプトを実行します。Looker CLI のインストール先として予定しているパスを指定してください（通常は ~/.local/bin またはワークスペースのパスです）。

./skills/onboarding-preflight-check/scripts/preflight_check.sh --mode system --install-dir ~/.local/bin
2. チェックでエラーが発生した場合の対応

スクリプトが 0 以外の終了コードを返した場合は、エラー出力に基づいて問題を解決します。

ケース A：gcloud CLI is not installed
  1. Google Cloud SDK をインストールします。自動でインストールできない場合（システムのパッケージマネージャーがない、または権限がない場合など）は、ユーザーに Google Cloud SDK のインストールを依頼してください。
ケース B：gcloud is not authenticated

  1. ユーザーに、ターミナルで対話型ログインを実行するよう依頼します。

    gcloud auth login

  2. ユーザーがログインを完了するまで待ち、その後チェックを再実行します。

ケース C：bq CLI is not installed

  1. bq コンポーネントをインストールします。

    gcloud components install bq
ケース D：Installation directory ... is not writable
  1. インストール先ディレクトリが存在しない場合は作成します。権限が制限されている場合は、ワークスペース内のサブディレクトリ（例：./bin）を使用してインストールし、そのパスを --install-dir に指定します。
3. IAM の事前チェックを実行する（接続設定中）

iam モードで事前チェック スクリプトを実行し、Looker Core サービス アカウントに、対象の GCP プロジェクトで必要な最小権限のロール（roles/bigquery.dataViewer、roles/bigquery.jobUser、roles/serviceusage.serviceUsageConsumer）が付与されていることを確認します。

./skills/onboarding-preflight-check/scripts/preflight_check.sh --mode iam --looker-project {looker_gcp_project_id} --bq-project {bigquery_gcp_project_id}

重要

roles/serviceusage.serviceUsageConsumer が必要な理由： Looker インスタンスから BigQuery 接続を通じてクエリを実行するとき、Google Cloud は、Looker サービス アカウントに対して、課金対象プロジェクト内のリソースを計算／使用する権限を要求します。 roles/serviceusage.serviceUsageConsumer ロール（serviceusage.services.use を含む）がないと、Looker は BigQuery への認証やクエリジョブの送信を行えず、実行時に 400 Bad Request 権限エラーが発生します。

不足しているロールが報告された場合は、適切な gcloud projects add-iam-policy-binding コマンドを実行し、Looker サービス アカウント （service-{project_number}@gcp-sa-looker.iam.gserviceaccount.com）に roles/bigquery.dataViewer、roles/bigquery.jobUser、roles/serviceusage.serviceUsageConsumer を付与します。

コメント

Markdown 対応