Octopus Deploy Documentation

Run multiple processes on a Tentacle simultaneously

Last updated

By default, Octopus will only run one process on each target at a time, queuing the rest. There may be reasons that you need to run multiple, and that's okay we have a setting for that!

OctopusBypassDeploymentMutex must be set at the project variable stage. It will allow for multiple processes to run at once on the target. Having said that, deployments of the same project to the same environment (and, if applicable, the same tenant) are not able to be run in parallel even when using this variable.

Multiple projects If you require multiple steps to run on a target, by multiple Projects in parallel, you need to add this variable to ALL of your projects.

When this variable is enabled, Octopus will be able to run multiple deployments simultaneously on the same machine. This can cause deployments to fail if the same file is modified more than once at the same time.

If you use OctopusBypassDeploymentMutex, make sure that your projects will not conflict with each other on the same machine.

Max Parallelism When enabling OctopusBypassDeploymentMutex there are a couple of special variables that may impact the number of parallel tasks that are run.

  • Octopus.Acquire.MaxParallelism:
    • This variable limits the maximum number of packages that can be concurrently deployed to multiple targets.
    • By default, this is set to 10.
  • Octopus.Action.MaxParallelism:
    • This variable limits the maximum number of machines on which the action will concurrently execute.
    • By default, this is set to 10.

Given five projects with the OctopusBypassDeploymentMutex set as True, True, False, True and True respectively. Then assuming they are started in that order, the first two will run in parallel, but the third will wait until they have finished. The last two will then also be blocked until project three completes at which point they both will run in parallel.

Need support? We're here to help.