🚢 Operator Quickstart

Operate the Firebase, app, web, docs, launchpad, and API surfaces.

:::warning Scope GPU provider operations are excluded. Escalate them to the owner of the GPU repository/provider configuration. :::

First checks

firebase login
firebase use acesense-prod
firebase projects:list
firebase functions:log --project acesense-prod

All Cloud Functions are in europe-west1. The Firebase project is acesense-prod.

Deploy map

Surface	Owner directory	Target
Flutter web/rules	acesense-frontend	hosting:app,firestore:rules,storage
Functions	acesense-auth-function	functions
Admin	acesense-admin	hosting:admin
Landing	acesense-landing	hosting:landing
Public API rewrites	acesense-api-hosting	hosting:api
Docs	acesense-docs	functions:docs:docsServer,hosting:docs
Launchpad	acesense-launchpad	functions:launchpad:launchpadServer,hosting:launchpad

Use the deployment guide for build and verification commands. Docs and launchpad must deploy their gate Function with the copied site; deploying Hosting alone does not update the private bundle.

Monitor

Signal	Source
Function health	health endpoint and firebase functions:log
Job state	Firestore jobs/{jobId} and Admin Jobs
Dispatch retry	dispatchGpuJob task/function logs
Stuck cleanup	reconcileStuckJobs logs
Storage lifecycle	purgeExpiredSessions logs
Private-site access	docsServer / launchpadServer logs
API rewrite	https://api.acesense.io/v1/healthz

Rollback

• Hosting: Firebase Hosting release history.
• Function: rebuild and deploy a known-good revision.
• Rules: restore or redeploy the reviewed rules files.
• Private sites: roll back Function and Hosting together if their bundle changed.

Related

• Deployment
• Observability
• Runbooks