Kubernetes API quickstart

1. Pick a cluster type

curl -X GET https://www.pidginhost.com/api/v1/kubernetes/cluster-types/ \
  -H "Authorization: Token $PIDGINHOST_API_TOKEN"

Available types include development and production clusters, with package limits returned by the endpoint.

2. Create the cluster

curl -X POST https://www.pidginhost.com/api/v1/kubernetes/clusters/ \
  -H "Authorization: Token $PIDGINHOST_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "prod-cluster",
    "cluster_type": "prod",
    "resource_pool_package": "cloudv-4",
    "resource_pool_size": 3,
    "kube_version": ""
  }'

3. Download the kubeconfig

curl -X GET https://www.pidginhost.com/api/v1/kubernetes/clusters/<id>/kubeconfig/ \
  -H "Authorization: Token $PIDGINHOST_API_TOKEN" \
  -o kubeconfig.yaml

export KUBECONFIG=$PWD/kubeconfig.yaml
kubectl get nodes

Same flow with phctl CLI

phctl k8s cluster create \
  --name prod-cluster \
  --type prod \
  --package cloudv-4 \
  --pool-size 3 \
  --kube-version 
phctl k8s cluster kubeconfig <id> > kubeconfig.yaml