Connect Your First Cluster

How to install the Magalix agent to connect your Kubernetes cluster

Your First Cluster

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.

FUE  Connect Cluster - Magalix

 

Connecting More Clusters

Creating the YAML can be initiated through the "Connect Cluster" wizard, by clicking the "Start" button on the homepage.

 

Home dashboard connect additional kubernetes clusters

 

The wizard will guide you through the process, follow the workflow and hit "Finish" when you are done.

Magalix connect a Kubernetes cluster

At this point, the cluster has been defined and waiting for a connection with the Agent to start communication.

To finish the process, the YAML needs to be applied to your cluster, you can achieve that in one of two ways. Using the automatically generated URL or manually downloading and applying the YAML to your cluster.

Magalix connect a Kubernetes cluster - confirmation

Permissions And Admin Access

RBAC

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 --user=username@company.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 in your terminal. If successful, you'll see 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.yaml

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 <LocalPath>\fileName.yaml

Delete Cluster Definition

If you no longer need to connect the cluster, you can select "Delete Cluster Definition", it will remove the cluster definition.

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

If you run the same connection command on multiple clusters, this will push the data concurrently from all of them, which will generate unexpected behavior and recommendations. Define a new cluster and run its command if you have than one cluster to connect.


What's Next

Now that you connected your cluster, explore what you can do with Magalix Console

Connect Your First Cluster