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. 02验证 Google Cloud 身份验证
  3. 03检查 Looker 服务账号 IAM 角色
  4. 04指导处理检查失败

适用场景

  1. 01在 Looker 入门前检查工作环境
  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. 处理检查失败

如果脚本返回非零退出代码，请根据错误输出解决问题：

情况 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 命令，将 roles/bigquery.dataViewer、 roles/bigquery.jobUser 和 roles/serviceusage.serviceUsageConsumer 授予 Looker 服务账号 （service-{project_number}@gcp-sa-looker.iam.gserviceaccount.com）。

评论

支持 Markdown