docs: Add releases administration guide (#764)

Add comprehensive documentation for the release process including
version bumping, changelog generation, and deployment steps.
This commit is contained in:
adam jones 2025-11-13 18:21:22 +00:00 • committed by GitHub
commit d9c2e506a9
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -0,0 +1,28 @@
# Releases
## Creating a Release
1. Create a new release on [GitHub](https://github.com/modelcontextprotocol/registry/releases) with a semver tag (e.g., `v1.3.9`)
2. This triggers the [release workflow](.github/workflows/release.yml) which:
- Builds `registry` and `mcp-publisher` binaries for all platforms using GoReleaser
- Signs artifacts with cosign
- Generates SBOMs
- Builds and pushes container images to `ghcr.io/modelcontextprotocol/registry`
## Deploying to Production
1. Update `deploy/Pulumi.gcpProd.yaml` (e.g., through a PR or by pushing directly to main):
```yaml
mcp-registry:imageTag: 1.3.9
```
2. The [deploy-production workflow](.github/workflows/deploy-production.yml) automatically deploys
## Staging
Staging auto-deploys from `main` via [deploy-staging.yml](.github/workflows/deploy-staging.yml). It always runs the latest `main` branch code.
## Rollback
To rollback production, update `deploy/Pulumi.gcpProd.yaml` to the previous version and push.
**Note:** Rollbacks may not work as expected if the release included database migrations, since migrations are not automatically reversed.