mcpField
C
cloud-sql-basics

cloud-sql-basics

github.com/googleクラウド・DevOps21.6k14.9k 回インストール今日更新
リポジトリ

cloud-sql-basics について

Cloud SQL を扱う開発者や運用担当者向けの基礎ガイドです。MySQL、PostgreSQL、SQL Server を対象とし、PostgreSQL インスタンスの作成と接続を説明し、CLI、クライアントライブラリ、セキュリティ、バックアップ、Terraform の資料も案内します。

主な機能

  1. 013 種類のリレーショナルデータベースを解説
  2. 02PostgreSQL インスタンスの作成例
  3. 03データベースとユーザーの設定
  4. 04Cloud SQL Auth Proxy 経由の接続
  5. 05CLI・クライアントライブラリ・Terraform の資料

活用シーン

  1. 01Cloud SQL PostgreSQL インスタンスの作成
  2. 02データベースとデフォルトユーザーのパスワード設定
  3. 03Auth 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 管理者（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. インスタンスの接続名を取得します：

    Cloud SQL Auth Proxy を使用して接続するには、インスタンスの接続名（形式は PROJECT_ID:REGION:INSTANCE_NAME）が必要です。次のコマンドで取得します：

    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 拡張機能の使用方法。

  • Infrastructure as Code：インスタンス、データベース、ユーザーの Terraform 構成。

  • IAM とセキュリティ：事前定義されたロール、SSL/TLS 証明書、Auth Proxy の構成。

  • 障害復旧とバックアップ：バックアップの種類、ポイントインタイムリカバリ（PITR）、レプリカ、読み取りプールの比較、Enterprise Plus Advanced DR。

これらのリファレンスに記載されていない製品情報が必要な場合は、Developer Knowledge MCP サーバーの search_documents ツールを使用してください。

コメント

Markdown 対応