Overview

DescriptionAdd a host (slave) to an existing Kubernetes-CoreOS Cluster.
Resource Path/kubernetesClusters/{kubernetesClusterId}/minion
HTTP MethodPOST
Request/Response Formatapplication/json

Sample JSON request

{
  "hostId": "minion-2",
  "hostname": "minion-2.dev.kubernetes.org",
  "privateIPAddress": "172.17.8.103",
  "publicIPAddress": "172.17.8.103",
  "property": [
    
  ]
}

For information on all the properties that can be used in a Kubernetes Host definition, see the Kubernetes Host Resource Definition.

> PUT /api/kubernetesClusters/kubernetes-cluster-1/minion HTTP/1.1
> Authorization: Basic YWRtaW46YWRtaW4=
> User-Agent: curl/7.24.0 (x86_64-apple-darwin12.0) libcurl/7.24.0 OpenSSL/0.9.8| zlib/1.2.5
> Host: localhost:9443
> Accept: */*
> Content-Type: application/json
> Content-Length: 236
>
* upload completely sent off: 236 out of 236 bytes
< HTTP/1.1 201 Created
< Date: Mon, 06 Apr 2015 09:25:02 GMT
< Location: https://localhost:9443/api/kubernetesClusters/kubernetes-cluster-1/minion/minion-2
< Content-Type: application/json
< Transfer-Encoding: chunked
< Server: WSO2 Carbon Server
<
{"status":"success","message":"Kubernetes Host added successfully: [kub-host] minion-2"} 
curl -X POST -H "Content-Type: application/json" -d @'<JSON_PAYLOAD>' -k -v -u admin:admin https://<STRATOS_HOST>:<STRATOS_HTTPS_PORT>/api/kubernetesClusters/{kubernetesClusterId}/minion
  • The path to the JSON file that defines the Kubernetes-CoreOS host needs to be defined as the <JSON_PAYLOAD> value.

  • By default, <STRATOS_HOST> is localhost. However, if you are using a public IP, the respective IP address or domain needs to be specified.
  • By default, <STRATOS_HTTPS_PORT> has been set to 9443. However, if the port offset has been incremented by n, the default port value needs to be incremented by n.

For example:

curl -X POST -H "Content-Type: application/json" -d @'kubernetes-cluster-2.json' -k -v -u admin:admin https://localhost:9443/api/kubernetesClusters/kubernetes-cluster-1/minion

CLI command

add-kubernetes-host

DescriptionAdd a host (slave) to an existing Kubernetes-CoreOS Cluster.
Command format

add-kubernetes-host -p <JSON_FILE_PATH> -c <CLUSTER_ID>

The path to the JSON file that defines the Kubernetes-CoreOS host needs to be defined as the <JSON_FILE_PATH> value.

REST API response

HTTP status code

201, 400, 409, 500

See the descriptions of the HTTP status codes here.

Location header URL

https://<STRATOS_HOST>:<STRATOS_HTTPS_PORT>/api/kubernetesClusters/<KUBERNETES_GROUP_ID>/minion/<MINION_ID>

 

 

  • No labels