docs: add production database connection guide for admins (#808)
Drafted by Claude Code, reviewed and tested by me. Add instructions for maintainers to connect to the production PostgreSQL database, including Cloud Shell (recommended) and local machine methods, plus read-only session configuration for safety. --------- Co-authored-by: Claude <noreply@anthropic.com>
This commit is contained in:
parent
ca6912cded
commit
8b861e5e1a
1 changed files with 39 additions and 1 deletions
|
|
@ -8,6 +8,7 @@ This is a brief guide for admins and moderators managing content on the registry
|
|||
- If you are a maintainer and would like an account, ask in the Discord
|
||||
- `gcloud` CLI installed and configured
|
||||
- `curl` and `jq` installed
|
||||
- `kubectl` installed with `gke-gcloud-auth-plugin` (for database access)
|
||||
|
||||
## Authentication
|
||||
|
||||
|
|
@ -138,9 +139,46 @@ curl -s "https://registry.modelcontextprotocol.io/v0/servers/${ENCODED_SERVER_NA
|
|||
done
|
||||
```
|
||||
|
||||
## Connecting to the Production Database
|
||||
|
||||
For debugging or data analysis, you can connect directly to the production PostgreSQL database. Use caution and prefer read-only access.
|
||||
|
||||
### Prerequisites
|
||||
|
||||
Install the GKE auth plugin if you haven't already:
|
||||
|
||||
```bash
|
||||
gcloud components install gke-gcloud-auth-plugin
|
||||
```
|
||||
|
||||
### Connect
|
||||
|
||||
```bash
|
||||
# Get cluster credentials
|
||||
gcloud container clusters get-credentials mcp-registry-prod --zone us-central1-b --project mcp-registry-prod
|
||||
|
||||
# Get the database password
|
||||
kubectl get secret registry-pg-app -o jsonpath='{.data.password}' | base64 -d
|
||||
|
||||
# Port-forward and connect (enter the password from above)
|
||||
kubectl port-forward svc/registry-pg-rw 15432:5432 &
|
||||
sleep 2
|
||||
psql -h localhost -p 15432 -U app -d app
|
||||
```
|
||||
|
||||
### Read-Only Access
|
||||
|
||||
To prevent accidental writes, set your session to read-only after connecting:
|
||||
|
||||
```sql
|
||||
SET default_transaction_read_only = on;
|
||||
```
|
||||
|
||||
Any write attempts will fail with an error until you disconnect.
|
||||
|
||||
## Notes
|
||||
|
||||
- **Version-specific changes**: Only affect that particular version
|
||||
- **Server-wide changes**: Must be applied to each version individually
|
||||
- **Server-wide changes**: Must be applied to each version individually
|
||||
- **Content scrubbing**: Use the version-specific edit workflow to scrub sensitive content
|
||||
- **Server name**: Cannot be changed in any version (it's the immutable identifier)
|
||||
|
|
|
|||
Loading…
Reference in a new issue