I deploy applications on servers. While the process itself is automated but there are lot of manual steps involved surrounding the automation due to various reasons.

I manage the manual procedure in Excel. But this is getting cumbersome.

I am wondering if there are any tool where the procedure can be described and easy to manage.


  • Could you add some content of the Excel? – 030 May 18 '18 at 17:21
  • Steps Involved, IF this step Fails what to do, If this step is not abvl what to do, status, who is doing it, etc.. – KK99 May 25 '18 at 9:03

Document the functional process

When I create a new project and want to deploy it I always start to right down the manual steps in a README, but one could also create a txt file or sheet like you did.

Feel the pain

At a certain moment when I have deployed the project manually the pain of certain steps will become clear. For example, I add per step how much time it takes.

Automate the high ROI steps

If for example a certain step takes half an hour an one deploys twice a week, one could investigate how long it will take if one automates this step (investment) and what time it will save (return). One could decide to create issue tickets and automate steps every sprint.

Example deployment plan

For one of my current projects I have to deploy multiple microservices. I will not provide all details, but initially the plan was two pages long. Now I only use a Continuous Integration/Deployment (CI/CD) plan and a lot of abstractions. If the deployment will fail some day I could still read the initial plan so that the functional flow is still clear.

Configuration as Code

Another benefit of automating the manual step is that one could save the code in a Git repository as a pipeline script. When another person reads the scripts then it becomes clear how the project is deployed and one could also trace who made some change, what modifications were done and when.

  • Thanks for sharing your experiences. I have similar stuff but in Excel documented. My trouble here is that it has lot of main and sub steps and it is becoming difficult to track and follow. I was wondering if there are any software which can handle this? – KK99 May 22 '18 at 9:29

Not the answer you're looking for? Browse other questions tagged or ask your own question.