A smoke test checklist after changing environment variables

After changing environment variables, a smoke test should verify startup, configuration loading, external connections, and one user-visible path.

Environment changes fail in quiet ways. The app may boot with a default value, connect to the wrong service, disable a feature flag, or pass tests that never touch the changed configuration. A useful smoke test proves that the new value is read where it matters, not merely that the process starts.

Start with configuration visibility. Log a redacted presence check, not the secret itself: key exists, expected mode, expected region, expected host label, or expected feature flag state. Then test startup and health endpoints. If the variable controls an external dependency, verify one minimal read or write path against the intended target.

Next, test the user-visible behavior linked to the variable. If the change affects email, send a test message to a safe mailbox. If it affects storage, upload and read a small file. If it affects payment, use a sandbox transaction. If it affects analytics, verify that an event arrives in the expected environment.

Finally, check rollback assumptions. Know which old value would be restored, whether caches need clearing, and whether workers or scheduled jobs read the variable at boot or per request. The checklist should catch wrong-environment mistakes before users do.

A smoke test checklist after changing environment variables

// COMMENTS

ON THIS PAGE