96c9389c97
Some checks failed
ci/woodpecker/push/woodpecker Pipeline failed
- deploying.md: Add Woodpecker CI section, update constraints - releasing.md: Add automated releases via Woodpecker, Zot registry - RELEASE_CHECKLIST.md: Update build/deploy commands - CLAUDE.md: Update quick reference for automated deploys Images now at registry.threesix.ai/rdev/* instead of ghcr.io Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
136 lines
3.8 KiB
Markdown
136 lines
3.8 KiB
Markdown
# Releasing rdev-api
|
|
|
|
**When to use:** Creating a new versioned release with changelog, container image, and git tag.
|
|
|
|
## Automated Releases (Recommended)
|
|
|
|
Push to main branch triggers Woodpecker CI to build and deploy automatically:
|
|
|
|
```bash
|
|
# Just push - Woodpecker handles the rest
|
|
git push origin main
|
|
|
|
# Or push to both remotes
|
|
GITEA_TOKEN=$(kubectl get secret rdev-credentials -n rdev -o jsonpath='{.data.GITEA_TOKEN}' | base64 -d)
|
|
git push https://jordan:${GITEA_TOKEN}@git.threesix.ai/jordan/rdev.git main
|
|
git push origin main
|
|
```
|
|
|
|
Images are built via kaniko and pushed to `registry.threesix.ai/rdev/*`.
|
|
|
|
## Prerequisites (Manual Releases)
|
|
|
|
- Go installed (for local binary builds if needed)
|
|
- KUBECONFIG set: `export KUBECONFIG=~/.kube/orchard9-k3sf.yaml`
|
|
- Access to Gitea (`git.threesix.ai/jordan/rdev`)
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
# Release and deploy in one command
|
|
./scripts/release.sh v0.8.1 "Fix worker ID config bug" --deploy
|
|
|
|
# Release only (no deploy)
|
|
./scripts/release.sh v0.8.1 "Fix worker ID config bug"
|
|
```
|
|
|
|
## What the Release Script Does
|
|
|
|
The script (`scripts/release.sh`) performs these steps in order:
|
|
|
|
1. **Creates changelog** - Writes `changelog/<version>.md` with date and message
|
|
2. **Updates deployment** - Patches `deployments/k8s/base/rdev-api.yaml` with new image tag
|
|
3. **Commits and pushes** - Commits changelog and deployment changes to main
|
|
4. **Builds binary** - Cross-compiles for linux/amd64 with version embedded
|
|
5. **Builds container** - Creates `ghcr.io/orchard9/rdev-api:<version>` image
|
|
6. **Pushes image** - Uploads to GitHub Container Registry
|
|
7. **Tags release** - Creates annotated git tag and pushes it
|
|
|
|
With `--deploy` flag, it also:
|
|
8. **Runs migrations** - Executes all SQL migrations as `rdev` superuser
|
|
9. **Applies manifest** - `kubectl apply` the deployment YAML
|
|
10. **Restarts deployment** - Triggers rollout with new image
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
./scripts/release.sh <version> "<changelog message>" [--deploy]
|
|
```
|
|
|
|
| Argument | Description | Example |
|
|
|----------|-------------|---------|
|
|
| `version` | Semver tag (with or without `v` prefix) | `v0.8.1` or `0.8.1` |
|
|
| `message` | Changelog entry describing the release | `"Add worker pool support"` |
|
|
| `--deploy` | Also run migrations and deploy to k3s | (optional flag) |
|
|
|
|
## Examples
|
|
|
|
```bash
|
|
# Full release + deploy (recommended)
|
|
./scripts/release.sh v0.9.0 "Add project templates" --deploy
|
|
|
|
# Bug fix release + deploy
|
|
./scripts/release.sh v0.8.2 "Fix nil pointer in command handler" --deploy
|
|
|
|
# Release only (deploy later manually)
|
|
./scripts/release.sh v0.8.3 "Update dependency versions"
|
|
```
|
|
|
|
## Manual Deploy (if not using --deploy)
|
|
|
|
```bash
|
|
export KUBECONFIG=~/.kube/orchard9-k3sf.yaml
|
|
kubectl apply -f deployments/k8s/base/rdev-api.yaml
|
|
kubectl rollout restart -n rdev deployment/rdev-api
|
|
```
|
|
|
|
## Artifacts Created
|
|
|
|
| Artifact | Location |
|
|
|----------|----------|
|
|
| Changelog | `changelog/<version>.md` |
|
|
| Container images | `registry.threesix.ai/rdev/{api,worker,claudebox}:<commit-sha>` |
|
|
| Git tag | `<version>` (annotated) |
|
|
| Updated deployment | `deployments/k8s/base/rdev-api.yaml` |
|
|
|
|
## Image Registry
|
|
|
|
Images are now stored in Zot (`registry.threesix.ai`) instead of ghcr.io:
|
|
|
|
| Image | Path |
|
|
|-------|------|
|
|
| API server | `registry.threesix.ai/rdev/api:latest` |
|
|
| Worker | `registry.threesix.ai/rdev/worker:latest` |
|
|
| Claudebox | `registry.threesix.ai/rdev/claudebox:latest` |
|
|
|
|
Tags: `latest` and `${CI_COMMIT_SHA:0:8}` (8-char commit hash)
|
|
|
|
## Troubleshooting
|
|
|
|
### Docker push fails
|
|
|
|
Ensure you're authenticated to ghcr.io:
|
|
```bash
|
|
echo $GITHUB_TOKEN | docker login ghcr.io -u USERNAME --password-stdin
|
|
```
|
|
|
|
### Build fails
|
|
|
|
Check Go environment:
|
|
```bash
|
|
go version
|
|
go env GOOS GOARCH
|
|
```
|
|
|
|
### Git push rejected
|
|
|
|
Ensure you have push access and main is up to date:
|
|
```bash
|
|
git pull origin main
|
|
```
|
|
|
|
## Related
|
|
|
|
- [Deploying to k3s](./deploying.md)
|
|
- [Credentials Management](./credentials.md)
|