Register with

Registers this machine as a deployment target with an Octopus Server.

Register with options

Usage: tentacle register-with [<options>]

Where [<options>] is any of:

      --instance=VALUE       Name of the instance to use
      --config=VALUE         Configuration file to use
      --server=VALUE         The Octopus Server - e.g., 'http://octopus'
      --apiKey=VALUE         Your API key; you can get this from the Octopus
                               web portal
  -u, --username, --user=VALUE
                             If not using API keys, your username
  -p, --password=VALUE       If not using API keys, your password
      --name=VALUE           Name of the machine when registered; the default
                               is the hostname
      --policy=VALUE         The name of a machine policy that applies to
                               this machine
  -h, --publicHostName=VALUE An Octopus-accessible DNS name/IP address for
                               this machine; the default is the hostname
  -f, --force                Allow overwriting of existing machines
      --comms-style=VALUE    The communication style to use - either
                               TentacleActive or TentaclePassive; the default
                               is TentaclePassive
      --proxy=VALUE          When using passive communication, the name of a
                               proxy that Octopus should connect to the
                               Tentacle through - e.g., 'Proxy ABC' where the
                               proxy name is already configured in Octopus; the
                               default is to connect to the machine directly
      --space=VALUE          The name of the space within which this command
                               will be executed. E.g. 'Finance Department'
                               where Finance Department is the name of an
                               existing space. The default space will be used
                               if omitted.
      --server-comms-port=VALUE
                             When using active communication, the comms port
                               on the Octopus Server; the default is 10943. If
                               specified, this will take precedence over any
                               port number in server-comms-address.
      --server-comms-address=VALUE
                             When using active communication, the comms
                               address on the Octopus Server; the address of
                               the Octopus Server will be used if omitted.
      --server-web-socket=VALUE
                             When using active communication over websockets,
                               the address of the Octopus Server, eg
                               'wss://example.com/OctopusComms'. Refer to
                               [http://g.octopushq.com/WebSocketComms](http://g.octopushq.com/WebSocketComms)
      --tentacle-comms-port=VALUE
                             When using passive communication, the comms port
                               that the Octopus Server is instructed to call
                               back on to reach this machine; defaults to the
                               configured listening port
      --env, --environment=VALUE
                             The environment name to add the machine to - e.-
                               g., 'Production'; specify this argument multiple
                               times to add multiple environments
  -r, --role=VALUE           The machine role that the machine will assume -
                               e.g., 'web-server'; specify this argument
                               multiple times to add multiple roles
      --tenant=VALUE         A tenant who the machine will be connected to;
                               specify this argument multiple times to add
                               multiple tenants
      --tenanttag=VALUE      A tenant tag which the machine will be tagged
                               with - e.g., 'CustomerType/VIP'; specify this
                               argument multiple times to add multiple tenant
                               tags
      --tenanted-deployment-participation=VALUE
                             How the machine should participate in tenanted
                               deployments. Allowed values are Untenanted,
                               TenantedOrUntenanted and Tenanted.

Or one of the common options:

      --help                 Show detailed help for this command

Basic examples

This example registers a listening Tentacle to the Octopus Server with the Development environment and OctoFX-Web role:

tentacle register-with --server="https://your-octopus-url" --apiKey="API-YOUR-KEY" --environment="Development" --role="OctoFX-Web"

This example registers a polling Tentacle with the Development environment and OctoFX-Web role in the OctoFX space:

tentacle register-with --server="https://your-octopus-url" --apiKey="API-YOUR-KEY" --environment="Development" --role="OctoFX-Web" --space="OctoFX" --comms-style="TentacleActive"

Help us continuously improve

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

Send feedback

Page updated on Tuesday, June 25, 2024