From 671544003c0f86476ebe4383a1b483c129da2833 Mon Sep 17 00:00:00 2001 From: Averi Kitsch Date: Wed, 28 Jan 2026 16:18:19 -0800 Subject: [PATCH 1/2] docs: add configuration instructions --- README.md | 34 +++++++++++++++++++++++++++++----- 1 file changed, 29 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index c976415..f2a20b9 100644 --- a/README.md +++ b/README.md @@ -45,8 +45,32 @@ gemini extensions install https://github.com/gemini-cli-extensions/cloud-sql-sql ### Configuration -Set the following environment variables before starting the Gemini CLI. These variables can be loaded from a `.env` file. -This configuration is not required if utilizing the [Admin toolset](#supported-tools). +You will be prompted to configure the following settings during installation. These settings are saved in an `.env` file within the extension's directory. + +* `CLOUD_SQL_MSSQL_PROJECT`: The GCP project ID. +* `CLOUD_SQL_MSSQL_REGION`: The region of your Cloud SQL instance. +* `CLOUD_SQL_MSSQL_INSTANCE`: The ID of your Cloud SQL instance. +* `CLOUD_SQL_MSSQL_DATABASE`: The name of the database to connect to. +* `CLOUD_SQL_MSSQL_USER`: The database username. +* `CLOUD_SQL_MSSQL_PASSWORD`: The password for the database user. +* `CLOUD_SQL_MSSQL_IP_TYPE`: (Optional) Type of the IP address: `PUBLIC` or `PRIVATE`. Defaults to `PUBLIC`. + +> [!NOTE] +> This configuration is primarily for the Data Plane tools (querying). The Admin toolset does not strictly require these to be pre-set if you provide them in your prompts, but it is recommended for a smoother experience. + +To view or update your configuration: + +**List Settings:** +* Terminal: `gemini extensions list` +* Gemini CLI: `/extensions list` + +**Update Settings:** +* Terminal: `gemini extensions config cloud-sql-sqlserver [setting name] [--scope ]` + * `setting name`: (Optional) The single setting to configure. + * `scope`: (Optional) The scope of the setting in (`user` or `workspace`). Defaults to `user`. +* Currently, you must restart the Gemini CLI for changes to take effect. We recommend using `gemini --resume` to resume your session. + +Alternatively, you can manually set these environment variables before starting the Gemini CLI: ```bash export CLOUD_SQL_MSSQL_PROJECT="" @@ -58,10 +82,10 @@ export CLOUD_SQL_MSSQL_PASSWORD="" export CLOUD_SQL_MSSQL_IP_TYPE="PUBLIC" # Optional: `PUBLIC`, `PRIVATE`. Defaults to `PUBLIC`. ``` -Ensure [Application Default Credentials](https://cloud.google.com/docs/authentication/gcloud) are available in your environment. - > [!NOTE] -> If your Cloud SQL for SQL Server instance uses private IPs, you must run Gemini CLI in the same Virtual Private Cloud (VPC) network. +> * Ensure [Application Default Credentials](https://cloud.google.com/docs/authentication/gcloud) are available in your environment. +> * If your Cloud SQL for SQL Server instance uses private IPs, you must run Gemini CLI in the same Virtual Private Cloud (VPC) network. +> * See [Troubleshooting](#troubleshooting) for debugging your configuration. ### Start Gemini CLI From e84e2d2fc51f45ac94212503f8a3f81621760c4a Mon Sep 17 00:00:00 2001 From: Averi Kitsch Date: Fri, 30 Jan 2026 12:45:00 -0800 Subject: [PATCH 2/2] Update README.md --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index f2a20b9..6172951 100644 --- a/README.md +++ b/README.md @@ -47,13 +47,13 @@ gemini extensions install https://github.com/gemini-cli-extensions/cloud-sql-sql You will be prompted to configure the following settings during installation. These settings are saved in an `.env` file within the extension's directory. -* `CLOUD_SQL_MSSQL_PROJECT`: The GCP project ID. +* `CLOUD_SQL_MSSQL_PROJECT`: The GCP project name. * `CLOUD_SQL_MSSQL_REGION`: The region of your Cloud SQL instance. * `CLOUD_SQL_MSSQL_INSTANCE`: The ID of your Cloud SQL instance. * `CLOUD_SQL_MSSQL_DATABASE`: The name of the database to connect to. * `CLOUD_SQL_MSSQL_USER`: The database username. * `CLOUD_SQL_MSSQL_PASSWORD`: The password for the database user. -* `CLOUD_SQL_MSSQL_IP_TYPE`: (Optional) Type of the IP address: `PUBLIC` or `PRIVATE`. Defaults to `PUBLIC`. +* `CLOUD_SQL_MSSQL_IP_TYPE`: (Optional) Instance IP assignment: `PUBLIC`, `PRIVATE`, or `PSC`. Defaults to `PUBLIC`. > [!NOTE] > This configuration is primarily for the Data Plane tools (querying). The Admin toolset does not strictly require these to be pre-set if you provide them in your prompts, but it is recommended for a smoother experience. @@ -79,7 +79,7 @@ export CLOUD_SQL_MSSQL_INSTANCE="" export CLOUD_SQL_MSSQL_DATABASE="" export CLOUD_SQL_MSSQL_USER="" export CLOUD_SQL_MSSQL_PASSWORD="" -export CLOUD_SQL_MSSQL_IP_TYPE="PUBLIC" # Optional: `PUBLIC`, `PRIVATE`. Defaults to `PUBLIC`. +export CLOUD_SQL_MSSQL_IP_TYPE="PUBLIC" # (Optional) Instance IP assignmentL `PUBLIC`, `PRIVATE`, `PSC`. Defaults to `PUBLIC`. ``` > [!NOTE]