Offline package drop

The offline package drop deployment target makes it possible for Octopus to bundle all the files needed to perform a deployment to a deployment target, even when a direct connection to the deployment target isn’t always possible, for instance, if a security policy, compliance control, or network topology make a direct connection impossible.

You can treat the offline package drop just like any other target, but instead of the application being deployed Octopus will bundle up all of the files needed to perform the deployment on the actual target server.

Configuring the target

Offline package drop is available as a deployment target.

Destination

The executable bundle created when deploying to an offline package drop target can be persisted in one of two modes:

Artifact

The bundle can be zipped and attached as an Octopus Artifact to the deployment. It can then be downloaded when required.

Drop folder

The bundle can alternatively be configured to be written directly to a file-system path.

Configure the drop folder path field with the UNC path to the directory you wish your offline packages to be located.

Sensitive-variables encryption password

As a security measure, any sensitive variables are written to a separate file which is then encrypted. To perform the encryption/decryption, a password is required. If your project does not contain any sensitive-variables, this field may be left un-set. If a project is deployed to an offline package drop target which does not have an encryption password set, the deployment will fail with an indicative error.

Please ensure you store your encryption password in a secure location, as you will require it when executing the batch file to perform the deployment on the target server.

Applications directory

The applications directory is the directory your packages will be extracted to, and is the location applications will execute from by default (if no custom-installation-location is set). On a regular Tentacle, this is set to C:\Applications by default.

Octopus working directory

The Octopus working directory is a location where some supporting files (e.g. the deployment journal XML file) are stored.

Building the offline package

When Octopus deploys to an offline package drop target it doesn’t actually execute the deployment, but will create a folder structure complete with Packages, Scripts, Variable files, Calamari and a batch file to execute the deployment on the actual target server.

Naming conventions

Artifact destination

When using Artifact for the destination, the zip file will be named

{{Project Name}}.{{Environment Name}}.{{Offline Drop Target Name}}.{{Release Number}}.zip

or if it is a tenanted deployment then

{{Project Name}}.{{Environment Name}}.{{Tenant Name}}.{{Offline Drop Target Name}}.{{Release Number}}.zip

For example

OctoFX.Production.PWebOffline01.3.3.10827.zip

The directory structure inside the zip file will resemble:

 |   My Offline Drop Target.OctoFX.Deployments-2.cmd
 |   My Offline Drop Target.OctoFX.Deployments-2.ps1
 |   
 +---Calamari
 |   |   Calamari.exe
 |   |   ...
 |           
 +---Packages
 |       OctoFX.TradingWebsite.3.0.298_B47863CDE8E3F24E95873F4B59FE990E.nupkg
 |       
 +---Scripts
 |       Remove from Load Balancer.ps1
 |       Return to load balancer.ps1
 |       
 \---Variables
         My Offline Drop Target.OctoFX.Remove from Load Balancer.variables.json
         My Offline Drop Target.OctoFX.Return to load balancer.variables.json
         My Offline Drop Target.OctoFX.Trading Website.variables.json

Drop folder destination

An example of the directory structure which will be created when deploying to an offline package drop target configured with a Drop Folder destination is shown below. In this example, the Drop Folder was configured as \\my-share\octopus-drops.

\\my-share
    \---octopus-drops
        \---Development
            \---OctoFX
                \---3.0.298
                    |   My Offline Drop Target.OctoFX.Deployments-2.cmd
                    |   My Offline Drop Target.OctoFX.Deployments-2.ps1
                    |   
                    +---Calamari
                    |   |   Calamari.exe
                    |   |   ...
                    |           
                    +---Packages
                    |       OctoFX.TradingWebsite.3.0.298_B47863CDE8E3F24E95873F4B59FE990E.nupkg
                    |       
                    +---Scripts
                    |       Remove from Load Balancer.ps1
                    |       Return to load balancer.ps1
                    |       
                    \---Variables
                            My Offline Drop Target.OctoFX.Remove from Load Balancer.variables.json
                            My Offline Drop Target.OctoFX.Return to load balancer.variables.json
                            My Offline Drop Target.OctoFX.Trading Website.variables.json

The offline package drop will be built and copied into a folder named by this convention:

    {{YourConfiguredDropFolderPath}}\{{Environment}}\{{ProjectName}}\{{Release}}

For example:

    \\my-share\octopus-drops\Production\Acme.Web\0.1

The batch file to execute the deployment will be named with this convention:

    {{MachineName}}.{{ProjectName}}.{{DeploymentId}}.cmd

For example: AcmeProductionDrop.Acme.Web.Deployments-1.cmd

Deploying the offline package drop

To Deploy the offline package drop simply copy the entire folder for that release to the target server and execute the batch file. This will actually execute the deployment on the target server just like Tentacle would.

Help us continuously improve

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

Send feedback

Page updated on Sunday, January 1, 2023