Software Architect's Handbook

Administrative processes

Periodically, there will be reasons that administrative tasks will need to be executed. Examples include a database migration, cleaning up bad data, or executing analytics for a report. When these needs arise, they should be executed as one-off processes in an identical environment as production. This means the scripts need to run against the same code and the same configuration as any other process executed using that release.

Administrative/management scripts for one-off tasks should be committed to the same code repository as the rest of the application and should ship with the rest of the code in order to maintain consistency and avoid synchronization issues between environments.