| name | nightly-deploy |
| description | Deploy KMP to the Azure nightly environment. Use when the user asks to deploy to nightly, push updates to nightly, build + deploy the nightly image, reset the nightly database, check nightly health/status, tail nightly logs, or get the nightly URL. Triggers on phrases like "deploy to nightly", "push to nightly", "redeploy nightly", "reset nightly db", "nightly status", "nightly logs", or "nightly health". |
KMP Nightly Azure Deploy
All nightly deploy operations go through deploy/azure/nightly-deploy.sh.
The script talks directly to Azure via az CLI (no dependency on the
nightly-deploy-azure.yml GitHub Actions workflow, which isn't registered
on main). It reuses gh only for the build step, which hits the
well-registered nightly.yml workflow.
Prerequisites
az login --tenant 77070ec3-247c-40ce-9a4f-df875ffe914f (once per codespace)gh auth login (for build/status subcommands)
Live environment
Usage
Always from the repo root.
| Intent | Command |
|---|
Deploy whatever :nightly currently is in GHCR | bash deploy/azure/nightly-deploy.sh deploy |
| Rebuild image from HEAD then deploy | bash deploy/azure/nightly-deploy.sh build |
| Build current local checkout, push to ACR, deploy | bash deploy/azure/nightly-deploy.sh deploy-local |
| Local deploy + Awards recommendation migration | bash deploy/azure/nightly-deploy.sh deploy-local --recommendations |
| Deploy + wipe & reseed DB (all passwords → TestPassword) | bash deploy/azure/nightly-deploy.sh reset |
| Run app + platform migrations on current image | bash deploy/azure/nightly-deploy.sh migrate |
| Run migrations + recommendation migration | bash deploy/azure/nightly-deploy.sh migrate --recommendations |
| Reset tenant member passwords to TestPassword | bash deploy/azure/nightly-deploy.sh reset-passwords |
| Smoke-check custom tenant/platform hosts | bash deploy/azure/nightly-deploy.sh verify-tenants |
| Recent GHCR build run status | bash deploy/azure/nightly-deploy.sh status |
| Tail latest running build | bash deploy/azure/nightly-deploy.sh watch |
| Show Container App revisions | bash deploy/azure/nightly-deploy.sh revisions |
| Tail web container logs | bash deploy/azure/nightly-deploy.sh logs [--tail N] |
Curl /health | bash deploy/azure/nightly-deploy.sh health |
| Print the URL | bash deploy/azure/nightly-deploy.sh url |
| Show help | bash deploy/azure/nightly-deploy.sh help |
Overrides via env: IMAGE_TAG, NIGHTLY_BRANCH, GH_REPO,
AZURE_SUBSCRIPTION_ID, AZURE_RESOURCE_GROUP, AZURE_ACR_NAME,
AZURE_WEB_APP_NAME, AZURE_{MIGRATE,QUEUE,SYNC,RESET}_JOB_NAME,
LOCAL_IMAGE_TAG, LOCAL_BUILD_PLATFORM, TEST_PASSWORD.
What deploy does
az acr import ghcr.io/ansteorra/kmp:nightly → kmp:nightly-YYYY-MM-DD-HHMMSS- Temporarily patches the migrate job to run app migrations, app settings update, and platform migrations, then restores it to
/bin/true
- (if
--recommendations) runs bin/cake awards migrate_award_recommendations --apply --allow-open-manual-review
- (if
--reset) starts the reset job and resets tenant member passwords to TestPassword
az containerapp update --image … on kmpnightly-web — forces a new revisionaz containerapp job update --image … on queue / sync / reset jobs so their next scheduled run uses the new image- Smoke-checks the custom tenant/platform hosts and polls
https://…/health for up to 10 min until 200 OK
Typical flows
"I just pushed — deploy it"
bash deploy/azure/nightly-deploy.sh build
(Script auto-chains into deploy after the GH build finishes.)
"I have uncommitted local changes — push this exact checkout"
bash deploy/azure/nightly-deploy.sh deploy-local --recommendations
"GHCR already has the image I want"
bash deploy/azure/nightly-deploy.sh deploy
"DB is wedged — start over"
bash deploy/azure/nightly-deploy.sh reset
"Something is broken — what's the pod saying?"
bash deploy/azure/nightly-deploy.sh revisions
bash deploy/azure/nightly-deploy.sh logs --tail 500
When NOT to use this skill
- For local dev resets, use
bash reset_dev_database.sh (MySQL) — not nightly.
- For production releases, use the release workflow (
.github/workflows/release.yml).
- For infra / bicep changes, use
deploy/azure/bootstrap.sh.
