Operate the Worker

Run these commands from the repository root. They use the Worker name and account in apps/api/wrangler.jsonc.

Check the deployment

pnpm --filter @nobg/api exec wrangler deployments status
pnpm --filter @nobg/api exec wrangler deployments list

Set NOBG_URL to your deployed API’s base URL and check that it responds:

curl --fail-with-body "$NOBG_URL/api/health"

Health checks do not call Images or verify quota storage. Use the deployment guide to check the upload route without processing an image.

Inspect logs

pnpm --filter @nobg/api exec wrangler tail

Run requests from another terminal while the tail session is open. Press Ctrl+C to stop streaming logs.

Keep the X-Request-Id response header or error.requestId from a failed request. Unexpected application errors log a request_failed event with that ID. Handled errors, including rejected uploads and Images failures, may only appear in the response rather than as application error logs.

The handler does not log image bytes or raw IPs. Cloudflare observability can also record platform request metadata.

Adjust quotas

Edit the three quota variables in apps/api/wrangler.jsonc and deploy. See configuration for counting and reset rules. Limits apply to the existing counters; increasing a limit allows more requests in the same window.

Preserve the Durable Object binding, class, and object naming when upgrading. Renaming or deleting the quota namespace starts fresh counters and can bypass the monthly cap. Do not clear storage to resolve a routine rate-limit response.

Upgrade the Worker

Update your checkout to the version you want to deploy. Preserve your Worker name, account, domain, limits, and Durable Object namespace when merging changes to apps/api/wrangler.jsonc.

pnpm install --frozen-lockfile
pnpm --filter @nobg/api typecheck
pnpm --filter @nobg/api test
pnpm --filter @nobg/api build
pnpm --filter @nobg/api run deploy

Record the version ID Wrangler prints and check /api/health. Normal code deployments retain quota counters.

Roll back a code deployment

List deployments and choose a known working version:

pnpm --filter @nobg/api exec wrangler deployments list
pnpm --filter @nobg/api exec wrangler rollback VERSION_ID

Replace VERSION_ID with the version to restore and review Wrangler’s confirmation. Cloudflare can restrict rollbacks across binding or secret changes. Review configuration and storage migrations before rolling back. A rollback does not undo quota usage.

Monitor usage

Review Workers, Durable Objects, and Images usage in your Cloudflare account. The monthly cap bounds image-processing attempts, including failed attempts. It does not cap Workers requests, Durable Object operations, or other account usage.