Deploy a release to environments in Octopus Deploy
deploy_releaseDestructive
Deploy a release to one or more environments in Octopus Deploy, supporting both tenanted and untenanted deployments with automatic type detection.
Instructions
Deploy a release to one or more environments in Octopus Deploy
This tool supports both tenanted and untenanted deployments:
Untenanted: Don't provide tenants or tenantTags. Can deploy to multiple environments at once.
Tenanted: Provide tenants or tenantTags. Can only deploy to ONE environment, but can target multiple tenants.
The tool automatically determines which deployment type to use based on the parameters provided.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| spaceName | Yes | The space name | |
| projectName | Yes | The project name | |
| releaseVersion | Yes | The release version to deploy (e.g., '1.0.0') | |
| environmentNames | Yes | Array of environment names. For tenanted deployments, must contain exactly one environment. | |
| tenants | No | Array of tenant names for tenanted deployment (optional) | |
| tenantTags | No | Array of tenant tags for tenanted deployment (e.g., ['Region/US-West', 'Tier/Production']) | |
| forcePackageRedeployment | No | Force redeployment of packages | |
| updateVariableSnapshot | No | Update the variable snapshot | |
| forcePackageDownload | No | Force package download | |
| specificMachineNames | No | Deploy to specific machines only | |
| excludedMachineNames | No | Exclude specific machines from deployment | |
| skipStepNames | No | Skip specific deployment steps | |
| useGuidedFailure | No | Use guided failure mode | |
| runAt | No | Schedule deployment for later (ISO 8601 date string) | |
| noRunAfter | No | Don't run deployment after this time (ISO 8601 date string) | |
| variables | No | Prompted variable values as key-value pairs | |
| deploymentFreezeOverrideReason | No | Reason for overriding deployment freeze | |
| deploymentFreezeNames | No | Names of deployment freezes to override | |
| confirm | No | Required only when the MCP client does not support elicitation. Set to true to confirm deployment; otherwise the tool aborts. |