mirror of
https://github.com/CopilotKit/CopilotKit.git
synced 2026-09-14 16:26:20 +08:00
Jordan Ritter
83b077db87
Update comment references in showcase scripts (create-integration, redirect-decommission, validate-pins, verify-railway-image-refs), RAILWAY.md docs, aimock/d5-all.json fixture comment, and built-in-agent route comment.
94 lines
3.2 KiB
Markdown
94 lines
3.2 KiB
Markdown
# Showcase Railway Operations
|
|
|
|
## Pending Service Provisioning
|
|
|
|
One service is wired into `showcase_deploy.yml` with placeholder
|
|
`railway_id="PLACEHOLDER-CREATE-RAILWAY-SERVICE"` and needs a real Railway
|
|
service ID filled in before its first successful deploy:
|
|
|
|
- `built-in-agent` → image `showcase-built-in-agent`
|
|
|
|
Single-service Next.js app (`BuiltInAgent` runs in-process; no separate
|
|
agent server). Required env: `OPENAI_API_KEY`. Health probe at
|
|
`/api/health`.
|
|
|
|
Until the Railway service exists, the deploy job for this entry will
|
|
fail loudly on `serviceInstanceRedeploy` — that's intentional. Provision
|
|
it via the "Adding a New Railway Service" flow below, then swap the
|
|
placeholder ID in the matrix.
|
|
|
|
The matching `starter-built-in-agent` is intentionally absent: the
|
|
starter generator (`showcase/scripts/generate-starters.ts`) does not
|
|
yet support single-service packages, so the starter will be added in a
|
|
follow-up PR alongside generator support.
|
|
|
|
## Auto-Updates (Fleet-Wide)
|
|
|
|
All 41 Railway services have `source.autoUpdates.type = "minor"` with no
|
|
schedule restriction (any time, immediately). When a new GHCR `:latest`
|
|
digest is pushed, Railway auto-pulls and redeploys without manual
|
|
intervention.
|
|
|
|
CI (`showcase_deploy.yml`) still triggers an explicit `serviceInstanceRedeploy`
|
|
after each GHCR push for deterministic health-checking. The auto-update is a
|
|
safety net, not the primary deploy path.
|
|
|
|
## Adding a New Railway Service
|
|
|
|
1. **Enable auto-updates** via the GraphQL API:
|
|
|
|
```graphql
|
|
mutation {
|
|
environmentPatchCommit(
|
|
environmentId: "<env-id>"
|
|
patch: {
|
|
"services": {
|
|
"<new-service-id>": {
|
|
"source": { "autoUpdates": { "type": "minor" } }
|
|
}
|
|
}
|
|
}
|
|
commitMessage: "Enable image auto-updates"
|
|
)
|
|
}
|
|
```
|
|
|
|
Or via Dashboard: Settings > Configure Auto Updates > "Automatically
|
|
update to the latest tag" + "At any time, immediately".
|
|
|
|
2. **Add to `showcase_deploy.yml`** `ALL_SERVICES` matrix so CI builds
|
|
and pushes the GHCR image on code changes.
|
|
|
|
3. **Add to `showcase/harness/config/probes/smoke.yml`** so the service is
|
|
monitored by showcase-harness probes.
|
|
|
|
4. **Git-based services**: auto-updates only apply to image-sourced
|
|
services. Skip step 1 for git-deploy services.
|
|
|
|
## Environment IDs
|
|
|
|
- Project: `<project-id>`
|
|
- Environment: `<env-id>`
|
|
- Token: `~/.railway/config.json` -> `.user.token`
|
|
|
|
## Known Quirks
|
|
|
|
- **Polling frequency**: Railway's auto-update polling interval is
|
|
undocumented. Expect seconds to low minutes after a GHCR push.
|
|
|
|
- **API surface**: `environmentPatchCommit` is the only programmatic
|
|
way to configure auto-updates. Typed GraphQL mutations
|
|
(`ServiceSourceInput`) do not expose `autoUpdates`.
|
|
|
|
- **`source.autoUpdates.type` values**: `disabled`, `patch`, `minor`.
|
|
We use `minor` (any semver-compatible tag change, including `:latest`
|
|
digest changes).
|
|
|
|
- **`source.autoUpdates.schedule`**: array of
|
|
`{day, startHour, endHour}`. Omit entirely for "any time, immediately".
|
|
|
|
- **CI still redeploys explicitly**: `showcase_deploy.yml` calls
|
|
`serviceInstanceRedeploy` after GHCR push so the health-check step
|
|
can verify the exact deployment it triggered. Auto-updates are the
|
|
fallback, not a replacement for CI-driven deploy verification.
|