Allow manual start/stop of a stack

[f18m]

I'm using doco-CD with a .doco-cd.yaml file containing many stacks.
Sometimes it happens that I perform some system-wide changes that will impact the stacks deployed on my machine, but that are not tracked in git.
In such cases I would like to have a way to tell DOCO-CD "please restart this stack".
As a workaround today I push a small, empty commit, touching the docker-compose.yaml file for that stack... but yeah, this is suboptimal...

[kimdre]

Do you have an idea how this could be implemented? doco-cd was designed just for deployments so this falls somewhat outside the scope of this project.
For restarts I would honestly just do a docker compose -p <project_name> restart

[f18m]

This ability to trigger a start/stop of a doco-cd-owned composition would be useful for me as workaround to some issues with docker "restart:always" policy, see full thread at #573

[kimdre]

Doco-cd does not do a simple restart but a full redeployment. A restart is quite simple since the docker engine is aware of the state of the running compose projects and knows exactly where to look for the container data when you run a docker compose -p <project_name> restart, so you can run the restart command from anywhere.

[f18m]

Do you think exposing some basic API layer on top of doco-cd (so that it allows to carry out basic deployment tasks like start/stop/restart) is something that would be useful to have?
If so, I can also try to raise a PR...

Other continuous deployment tools like ArgoCD have an API layer as well...

[kimdre]

Sure, I can probably start working on it on the weekend.

[f18m]

Thanks in advance then!!!

[kimdre]

The new compose project API will be implemented in #575.
I'm not sure yet whether the webhook token should also be used to authenticate or if I add an additional API token.

[kimdre]

v0.33.0 should be what you wanted. :)

[f18m]

hey @kimdre ,
thank you so much for all this work.
I upgraded and configured API_SECRET to enable the API server.
I can successfully use the /v1/api/project/{projectName}/restart endpoint now to have doco-cd do the restart, eventually re-creating containers with the right labels, thanks!