Build Server Integration

Last updated

Your continuous integration/build server will package your applications and make them available to Octopus for deployment from a package repository. The following tools are available to integrate your continuous integration/build server with Octopus Deploy:

Build Information

It is often useful to have information flow from your build server to be associated with packages, releases, and deployments in Octopus.

The build information is associated with a package and includes:

  • Build URL: A link to the build which produced the package.
  • Commits: Details of the source commits related to the build.
  • Issues: Issue references parsed from the commit messages.

Passing Build Information to Octopus

Build information is passed to Octopus as a file using a custom format. The recommended way to supply the build information is to add the Build Information step from the Octopus Deploy plugin to your build server.

Build Server support
The Build Information step is currently available in the official Octopus TeamCity and Bamboo plugins. Support for other build servers is coming soon.

Check our downloads page for our latest build server plugins.

The TeamCity version of the Build Information step is shown below.

TeamCity Build Information Step

Viewing Build Information

The build information for a package can be viewed on any release which contains the package.

Build information on release page

For packages pushed to the Octopus built-in repository, the build information can also be viewed in the package version details by navigating to Library ➜ Packages and selecting the package.

Build information on package version page

Using Build Information in Release Notes

The build information associated with packages is available for use in release notes (and release notes templates) as Octopus variables.

See the system variable documentation for the available variables.

Using Build Information in Deployments

Package build information associated with a release will be also captured in deployments of the release.