Atlas Best Practices

Atlas supports declarative and versioned schema workflows. Keep this file minimal and load only the reference file needed for the current task.

Workflow Selection

• Use declarative workflow when desired schema state is the source of truth.
• Use versioned workflow when migration files are required for auditing and staged deployments.
• Use baseline workflow when onboarding an existing database.

Default Execution Flow

1. Confirm the target env in atlas.hcl.
2. Confirm dev is configured and isolated from production.
3. Plan first, then lint/test/validate, then apply.
4. Run production changes through CI/CD or approved deployment workflow.

Quick Commands