Everything has run fine for six months and I no longer remember how any of it was set up
About a dozen services on one box. It all works. I have not touched it since spring.
Last week something needed changing and I spent an evening working out where the configuration lived, which of two reverse proxy config files was actually in use, and why a container had an odd environment variable that I must have had a reason for.
Nothing was broken. I simply could not remember any of it, and I built it.
The uncomfortable version of this is that if the box died I am not certain I could rebuild it. What do people actually do here, is it documentation, is it configuration in git, or is there a way to set things up so this does not happen?
@readme_in_the_repo · 3w ago
The answer that fixes it structurally rather than by trying to remember harder: put the configuration in git and treat the box as disposable.
Concretely, one repository containing:
The box then holds only data, and everything else is reproducible. That is the same split you already have for your code, applied to the infrastructure.
What it solves beyond memory:
Your two reverse proxy config files stop being ambiguous, because only one is in the repository and the box is built from it.
The odd environment variable gets a comment next to it at the moment you add it, which is the only time you know why.
Rebuilding becomes clone, restore data, run script: which turns your uncomfortable version into an afternoon.
Changes get a history. Six months from now, why is this here has an answer with a date on it.
Start by copying what is currently on the box into a repository as it is, warts included. Tidying can come later; capturing it is the urgent part.
Reply
Report