Deploy Lifecycle Hooks - Kool Cloud


You have the ability to define hooks to run before or after every deploy you make.

These hooks will run using the very same image that is being deployed. This is usually needed for common routines, such as running database migrations, sending alerts of updates to some other service, etc.

Before and After

To illustrate the options you have in the file:

services: app: # ... # The 'before' hook is a special section where we can define commands to be executed # right before a new deployment happens. # ATTENTION: current limitation - can only have a 'before' hook after a first deploy has created the environment. before: - [ sh,, arg1, arg2 ] # The 'after' hook is a special section where we can define procedures to be executed # right after a new deployment finishes. after: - [ sh,, arg1, arg2 ]

Please notice that these lifecycle hooks are required for the new deploy to be successful—this means that if any of them fail—either before or after newly deployed container versions are running—the whole deploy is going to be rolled back. As you can imagine, this poses a challenge, especially on database migrations since they can be problematic and not backwards compatible with the previously running container version.

The before hook can only be used after a first deploy has succeded for your environment - that is a limitation that should be lifted in the future, but currently can halt your first deploy if it includes a before hook.
By choosing "Accept all cookies" you agree to the use of cookies to help us provide you with a better user experience and to analyse website usage. Only the essential cookies are necessary for the proper functioning of our website and cannot be refused.
Check out our Cookie Policy and Privacy Policy for more information.