Octopus Extension Versions
There are three distinct versions (or version ranges) you need to worry about with respect to the Octopus Extension:
- Version 1.2.x - now obsolete, but still usable for older versions of TFS and Azure DevOps
- Version 2.0.199 - a specific "version 2" build for TFS 2015 Update 2, TFS 2015 Update 3, TFS 2015 Update 4, and TFS 2017 RTM
- Version 3.0.x - the current, most recent version of the extension, for Azure DevOps and TFS 2017 Update 1 and above
Extension Compatibility with Azure DevOps/Team Foundation Server
The following table shows compatibility between versions of Azure DevOps, TFS, and the Octopus extension
|Azure DevOps/TFS Version / Extension Version||1.2.x||2.0.199||3.0.x|
|Azure DevOps||Supported||Not supported||Supported|
|TFS 2017 Update 1||Supported||See below||Supported|
|TFS 2017 RTM||Supported||Supported||Not supported|
|TFS 2015 Updates 2,3,4||Supported||Supported||Not supported|
TFS 2017 Update 1 is technically supported with version 2.0.199 of the extension, but we do not recommended it.
Any version older than TFS 2015 Update 2 is not supported by any extension version.
You may have success manually installing the task by following these instructions. Alternatively, D'Arcy Lussier has put together a complete walkthrough that's very easy to follow.
The ease of upgrades depends very much on the version of Azure DevOps/TFS being used, and the extension versions involved.
Extension Upgrades in Azure DevOps and TFS 2017 Update 1 (and above)
In Azure DevOps, extension versions within the same major version (e.g. 2.0.62 to 2.0.63) are applied automatically. These should never be breaking changes. The same applies in TFS 2017.1, the only difference being the need to upload the new extension to TFS manually.
Extension updates that increment major version numbers (e.g. 1.2.28 to 2.0.63) will result in both versions being available. Your administrator will be prompted to update the extension before it's available to users.
Once it's available, you can choose the version you want to use using the dropdown in the task details.
Extension Upgrades in TFS 2015 Updates 2, 3, and 4, and TFS 2017 RTM
Extension updates that increment major versions (e.g. 1.2.28 to 2.0.63) are breaking changes! Your build definitions will need to be updated before they can be successfully run again.
Upgrades within the same major version number (e.g. 2.0.62 to 2.0.63) can be applied safely. These should never be breaking changes.
Upgrades that increment major versions (e.g. 1.2.28 to 2.0.63) are breaking changes and any builds using these tasks will fail until they are fixed. Version 2.x of the extension changed the way TFS connects to Octopus, so the new service connection must be configured before builds or releases will successfully run.