Deploy a sample package

Octopus Deploy’s primary purpose is to push software packages, .zip, .jar, .war, .tar, .nupkg, etc., to your deployment targets. Octopus Deploy requires all your assets, binaries, configuration files, CSS files, and more to run your application to be packaged up. Typically this is done by your build server.

Packages must have the following attributes:

  • Package ID. i.e., hello-world.
  • Version number, i.e., 1.0.0.
  • Package format, i.e., .zip.

To learn more about supported formats, versioning, and packaging applications, refer to the packaging documentation.

The following is a sample package that could be deployed with Octopus Deploy:

hello-world.1.0.0.zip

You can manually upload that package to the Octopus built-in repository in the Octopus Web Portal.

  1. Navigating to the Library tab.
  2. Click UPLOAD PACKAGE.
  3. Select the package you want to upload and click UPLOAD.

Add a step to the hello world deployment process to push that package to the desired deployment target.

  1. Click the Projects link in the top menu.
  2. Select the Hello World project.
  3. Click the Process link in the left menu.
  4. Click the ADD STEP button.
  5. Select the Package tile.
  6. Click ADD on the Deploy a Package tile.
  7. Leave the Step Name and the Enabled check-box as is.
  8. Select hello-world as the tag in Target Tags.
  9. Select hello-world as the Package ID.
  10. Click the SAVE button.

Deploy a package step with target tag and package selected

Please create a new release and deploy it to Development. The release will deploy the hello world package to dev-server-01.

Deploy a package results

You have now completed the deployment tutorial! This tutorial has focused on running sample scripts and deploying sample packages to your servers. It is now time to add your applications to Octopus Deploy.

All guides in this tutorial series

  1. First deployment
  2. Define and use variables
  3. Approvals with manual interventions
  4. Add deployment targets
  5. Deploy a sample package (this page)

Further reading for deploying packages and integrating your CI/CD pipeline

Help us continuously improve

Please let us know if you have any feedback about this page.

Send feedback

Page updated on Friday, April 19, 2024