Register Worker

Registers this machine as a Worker with an Octopus Server.

Register with options

Usage: tentacle register-worker [<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
      --workerpool=VALUE     The worker pool name to add the machine to - e.-
                               g., 'Windows Pool'; specify this argument
                               multiple times to add to multiple pools

Or one of the common options:

      --help                 Show detailed help for this command

Basic examples

This example registers a listening Tentacle to the worker pool MyWorkerPool:

tentacle register-worker --server="https://your-octopus-url" --apiKey="API-YOUR-KEY" --workerpool="MyWorkerPool"

This example registers a polling Tentacle to the worker pool MyWorkerPool in the space MyNewSpace:

tentacle register-worker --server="https://your-octopus-url" --apiKey="API-YOUR-KEY" --workerpool="MyWorkerPool --space="MyNewSpace" --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