HEhexlet
Swarm

Initialize a new swarm

Changed on
post/swarm/init

Request

  • Base URL
    /v1.57 (relative, and the document was published on a file host, not at the API’s origin)
  • Auth
    none declared

Request body

ListenAddrstring

Listen address used for inter-manager communication, as well as determining the networking interface used for the VXLAN Tunnel Endpoint (VTEP). This can either be an address/port combination in the form 192.168.1.1:4567, or an interface followed by a port number, like eth0:4567. If the port number is omitted, the default swarm listening port is used.

AdvertiseAddrstring

Externally reachable address advertised to other nodes. This can either be an address/port combination in the form 192.168.1.1:4567, or an interface followed by a port number, like eth0:4567. If the port number is omitted, the port number from the listen address is used. If AdvertiseAddr is not specified, it will be automatically detected when possible.

DataPathAddrstring

Address or interface to use for data path traffic (format: <ip|interface>), for example, 192.168.1.1, or an interface, like eth0. If DataPathAddr is unspecified, the same address as AdvertiseAddr is used.

The DataPathAddr specifies the address that global scope network drivers will publish towards other nodes in order to reach the containers running on this node. Using this parameter it is possible to separate the container data traffic from the management traffic of the cluster.

DataPathPortinteger

DataPathPort specifies the data path port number for data traffic. Acceptable port range is 1024 to 49151. if no port is set or is set to 0, default port 4789 will be used.

DefaultAddrPoolstring[]

Default Address Pool specifies default subnet pools for global scope networks.

ForceNewClusterboolean

Force creation of a new swarm.

SubnetSizeinteger

SubnetSize specifies the subnet size of the networks created from the default subnet pool.

Example request

{
  "ListenAddr": "0.0.0.0:2377",
  "AdvertiseAddr": "192.168.1.1:2377",
  "DataPathPort": 4789,
  "DefaultAddrPool": [
    "10.10.0.0/8",
    "20.20.0.0/8"
  ],
  "SubnetSize": 24,
  "ForceNewCluster": false,
  "Spec": {
    "Orchestration": {},
    "Raft": {},
    "Dispatcher": {},
    "CAConfig": {},
    "EncryptionConfig": {
      "AutoLockManagers": false
    }
  }
}

Response

no error

string required

The node ID

Example response

"7v2t30z9blmxuhnyo6s4cpenp"

Changes

  • 6df97b60796cRevision changes
    • breaking

      removed the request body

    • breaking

      removed the media type text/plain for the response with the status

    • info

      api tag Swarm added

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • 31f80d10d31aRevision changes
    • breaking

      removed the media type text/plain from the request body

    • breaking

      the // request property format changed from no format to int32

    • breaking

      the // request property format changed from no format to int32

    • breaking

      removed the media type application/json for the response with the status

    • info

      api tag Swarm removed

    • info

      the request property default value cfssl was removed

    • info

      removed the non-success response with the status

    • info

      removed the non-success response with the status

    • info

      removed the non-success response with the status