Add Documentation for expanding the DB PVC of an existing AWX
#1,655 opened on Dec 1, 2023
Repository metrics
- Stars
- (1,488 stars)
- PR merge metrics
- (PR metrics pending)
Description
Feature Summary
Often times a user will try out AWX with the default 8Gi PVC size, then surpass that DB size as their usage of AWX grows. The system job for cleaning out jobs and events can help, but may not always be enough. In this case, the user will need to expand their PostgreSQL db PVC to a larger postgres_storage_requirements size. This is currently not a very easy process, and we should document it.
It would be great to take the time to figure out the steps needed for expanding the db PVC and document them in a markdown file here in the repo. I think we would want to cover two scenarios:
-
A) How to migrate if your storageclass supports dynamic expansion (currently modify the AWX CR spec
postgres_storage_requirementssetting, then delete the StatefulSet and wait for the next reconciliation loop to re-create it) -
B) How to use the migration.md logic to migrate the awx instance to a fresh instance and provision a larger PVC in the process.
Help wanted on this one, if anyone has done this and has information to share on pitfalls they ran into, or wants to open a PR to add these docs, please chime in here! Thanks!
Additional Information
There is additional context provided here about ways in which some of this could be done automatically by the operator: