The first time you log into your account you will find a kubectl command pre-fabricated to connect your first Kubernetes cluster to Magalix backend. Copy and paste that command into your console as instructed on the welcome page.
If your Cluster is RBAC enabled, you must have admin access to install the Magalix Agent. To gain admin rights you'll need to execute the following command.
$ kubectl create clusterrolebinding username-cluster-admin-binding --clusterrole=cluster-admin --email@example.com
The username can be case sensitive in some IAM systems, GCP for example. Make sure you are using the right case when you create the ClusterRoleBinding, otherwise the user won't be authorized to deploy the Agent.
Using The Secure URL
In the middle of the page of the define cluster wizard, you'll see a URL and a copy icon to the left. To install the Agent, copy the command and paste it into your terminal. If successful, you'll see an output similar to the one below.
$ kubectl apply -f https://dev1.console.magalix.com/cluster-deployment/6aa6689b-252b-4df0-bf1e-46c1436cf551/2018-09-10T19:58:06Z/5d7e8540597bacf2e26d76dcd1bce1b679cf36676112218d134f8dd2da60a6e4/deployment.ya
Using The Agent YAML
The review page of the "Connect Cluster" wizard provides a "Download" button which you can use to locally save the YAML of the Magalix Agent. To download the YAML, expand the panel and click the blue download button on the left. You can also download the YAML from the cluster dashboard showing after you hit finish.
To install the Agent type the following command in your terminal.
$ Kubectl apply -f \fileName.yaml
Validate The Agent Deployment
To validate if the Magalix Agent pod has been successfully installed, use the following command. You should see something like magalix-agent-865b6d9ffb-n4v9w in the listed pods
$ kubectl get pods --namespace kube-system
NAME READY STATUS RESTARTS AGE event-exporter-v0.1.8-599c8775b7-fprtf 2/2 Running 0 1d fluentd-gcp-v2.0.9-vhg24 2/2 Running 0 1d heapster-v1.4.3-d74857f95-8tz25 3/3 Running 0 1d kube-dns-778977457c-6vkdf 3/3 Running 0 1d kube-dns-autoscaler-7db47cb9b7-w4q49 1/1 Running 0 1d kube-proxy-gke-sandbox-default-pool-a57643f1-s22p 1/1 Running 0 1d kubernetes-dashboard-6bb875b5bc-8jzxn 1/1 Running 0 1d l7-default-backend-6497bcdb4d-4z8g5 1/1 Running 0 1d magalix-agent-865b6d9ffb-n4v9w 1/1 Running 1 1d tiller-deploy-dccdb6fd9-r4b4f 1/1 Running 0 1d
Running the same connection command on multiple clusters will generate unexpected behavior and recommendations, which will eventually mess with your dashboard’s accuracy. Define a new cluster and run its command if you have more than one cluster to connect.