mcpField
C
cloud-sql-basics

cloud-sql-basics

github.com/google云与 DevOps21.6k14.9k 次安装今天更新
代码仓库

关于 cloud-sql-basics

面向使用 Cloud SQL 的开发者和运维人员的基础指南，覆盖 MySQL、PostgreSQL 和 SQL Server。提供 PostgreSQL 实例创建与连接步骤，并指向命令行、客户端库、安全、备份和 Terraform 参考资料。

主要功能

  1. 01介绍三种关系型数据库引擎
  2. 02演示 PostgreSQL 实例创建
  3. 03说明数据库和用户设置
  4. 04通过 Cloud SQL Auth Proxy 连接
  5. 05提供 CLI、客户端库和 Terraform 参考

适用场景

  1. 01创建 Cloud SQL PostgreSQL 实例
  2. 02配置数据库及默认用户密码
  3. 03通过 Auth Proxy 连接数据库
  4. 04查找备份、IAM 或 Terraform 指引

MCP 相关

指南提及 Cloud SQL 远程 MCP 服务及 Gemini CLI 扩展的使用，并建议在需要额外产品信息时查询 Developer Knowledge MCP Server。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/google/skills --skill cloud-sql-basics

安装后在 Claude Code 中输入/cloud-sql-basics确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
attribution.md
cli-usage.md
client-library-usage.md
core-concepts.md
dr-backups.md
iac-usage.md
iam-security.md
mcp-usage.md

详细介绍

Cloud SQL 基础知识

Cloud SQL 是一项完全托管的关系型数据库服务，适用于 MySQL、PostgreSQL 和 SQL Server。它可自动处理补丁、更新、备份和副本等耗时任务，同时为您的应用提供高性能和高可用性。

归属信息

务必阅读：在执行任何 gcloud、REST API 或 MCP 命令之前，您必须先阅读使用归属信息。对于直接在终端中执行的命令（绝不在生成的脚本、Terraform 或用户代码中执行），请在 gcloud 前添加 CLOUDSDK_METRICS_REQUEST_ATTRIBUTION="agent-skills/1.0 (skill:cloud-sql-basics)"，并在 User-Agent 标头中追加 agent-skills/1.0 (skill:cloud-sql-basics)。

前提条件

确保您拥有创建和管理 Cloud SQL 实例所需的 IAM 权限。Cloud SQL Admin（roles/cloudsql.admin）角色可完全访问 Cloud SQL 资源。

快速入门（PostgreSQL）

  1. 启用 API：

    gcloud services enable sqladmin.googleapis.com --quiet

  2. 创建实例：

    gcloud sql instances create INSTANCE_NAME \
  --database-version=POSTGRES_18 \
  --cpu=2 \
  --memory=7680MiB \
  --region=REGION \
  --quiet

  3. 为默认用户设置密码：

    由于这是 Cloud SQL for PostgreSQL 实例，默认管理员用户为 postgres：

    gcloud sql users set-password postgres \
  --instance=INSTANCE_NAME --password=PASSWORD \
  --quiet

  4. 创建数据库：

    gcloud sql databases create DATABASE_NAME \
  --instance=INSTANCE_NAME \
  --quiet

  5. 获取实例连接名称：

    您需要实例连接名称（格式为 PROJECT_ID:REGION:INSTANCE_NAME），才能使用 Cloud SQL Auth Proxy 进行连接。运行以下命令获取：

    gcloud sql instances describe INSTANCE_NAME \
  --format="value(connectionName)" \
  --quiet

  6. 连接到实例：

    必须先运行 Cloud SQL Auth Proxy，才能连接到实例。在另一个终端中，使用连接名称启动代理：

    ./cloud-sql-proxy INSTANCE_CONNECTION_NAME

    代理运行后，在另一个终端中使用 psql 连接：

    psql "host=127.0.0.1 port=5432 user=postgres dbname=DATABASE_NAME password=PASSWORD sslmode=disable"

参考目录

  • 核心概念：Cloud SQL 版本（Enterprise 和 Enterprise Plus）、实例架构、读取池、高可用性（HA）以及支持的数据库引擎。

  • CLI 用法：用于管理实例、数据库和用户的基本 gcloud sql 命令。

  • 客户端库和连接器：使用 Python、Java、Node.js 和 Go 连接到 Cloud SQL。

  • MCP 用法：使用 Cloud SQL 远程 MCP 服务和 Gemini CLI 扩展程序。

  • 基础设施即代码：用于配置实例、数据库和用户的 Terraform 配置。

  • IAM 和安全性：预定义角色、SSL/TLS 证书和 Auth Proxy 配置。

  • 灾难恢复和备份：备份类型、时间点恢复（PITR）、副本、读取池对比，以及 Enterprise Plus Advanced DR。

如果您需要这些参考资料中未提供的产品信息，请使用 Developer Knowledge MCP 服务的 search_documents 工具。

评论

支持 Markdown