Deploy a Release

Octopus.DeployRelease exported 2026-07-22 by Octopus Deploy belongs to ‘Other’ category.

Deploys a release of an Octopus project.

Parameters

When this step is included in a project’s deployment process, the parameters below can be set.

Project

Octopus.Action.DeployRelease.ProjectId (required)

Select a project that will be deployed.

Release version

Octopus.Action.DeployRelease.ReleaseVersion

The version of the release to deploy. If not specified, the release version will be determined at deployment time.

Deployment condition

Octopus.Action.DeployRelease.DeploymentCondition

Control when this deployment should run.

Allowed values: Always, IfNotCurrentVersion, IfNewer

Default: Always

Variables

Octopus.Action.DeployRelease.Variables

Pass variables through to the child deployment. Specified as key=value pairs.

Step configuration using OCL

Example in Octopus Configuration Language (OCL):

step "deploy-child-project" {
    name = "Deploy Child Project"

    action {
        action_type = "Octopus.DeployRelease"
        properties = {
            Octopus.Action.DeployRelease.DeploymentCondition = "Always"
            Octopus.Action.DeployRelease.ProjectId = "my-child-project"
            Octopus.Action.DeployRelease.Variables = "{}"
            Octopus.Action.RunOnServer = "false"
        }
    }
}

Page updated on Wednesday, July 22, 2026