The Tentacle agent can be installed fully automatically from the command line. This is very useful if you're deploying to a large number of servers, or you'll be provisioning servers automatically.
On this page:
Tentacle comes in an MSI that can be deployed via group policy or other means.
To install the MSI silently:
By default, the Tentacle files are installed under %programfiles(x86)%. To change the installation directory, you can specify:
The MSI installer simply extracts files and adds some shortcuts and event log sources. The actual configuration of Tentacle is done later, and this can automated too.
To configure the Tentacle in listening or polling mode, it's easiest to run the installation wizard once, and at the end, use the Show Script option in the setup wizard. This will show you the command-line equivalent to configure a Tentacle.
Example: Listening Tentacle
The following example configures a listening Tentacle, and registers it with an Octopus Deploy server:
You can also register a Tentacle with the Octopus Server after it has been installed by using Octopus.Client (i.e. register-with could be omitted above and the following could be used after the instance has started. See below for how to obtain the tentacle's thumbprint):
Example: Polling Tentacle
The following example configures a polling Tentacle, and registers it with an Octopus Deploy server:
Obtaining the Tentacle Thumbprint
If you don't know the thumbprint for the above PowerShell scripts, it can be obtained with the following command line option:
Desired State Configuration
Tentacles can also be installed via Desired State Configuration (DSC). Using the module from the OctopusDSC GitHub repository, you can add, remove, start and stop Tentacles in either polling or listening mode.
The following PowerShell script will install a Tentacle listening on port
10933 against the Octopus server at
https://YOUR_OCTOPUS, add it to the
Development environment and assign the
DSC can be applied in various ways, such as Group Policy, a DSC Pull Server, Azure Automation, or even via configuration management tools such as Chef or Puppet. A good resource to learn more about DSC is the Microsoft Virtual Academy training course.