kubegrid: I deployed my cluster, now what?

This article is intended to follow Introducing kubegrid. You’ve gone through the kubegrid Setup Wizard and deployed your first cluster. Now what?

While Your Cluster Is Deploying

While your cluster is deploying, you can view the logs that are being generated. You can access these by clicking the direct link on the last page of the Setup Wizard. Alternatively, you can find them by clicking Clusters from the Shortcuts menu on the left side of the screen, then the wrench icon for your cluster, then View Logs.

Clusters page
Logs live-streaming as cluster builds

The logs show you the raw output from the underlying tools and let you know where it’s at in the overall process.

Once your cluster is deployed, you’ll also receive an email letting you know your cluster is up.

Update Services

When you commit a change to your Git branch that is associated with a service in kubegrid, kubegrid will detect the change and will redeploy the service on your cluster. You’ll receive an email to remind you this is happening.

Explore Information with the Kubegrid UI


Let’s explore the Services page, linked from the Shortcuts menu.

Services page

Here is a list of all the services that you have defined across all your clusters. Click on the wrench icon to view additional details about the service.

Here, you can give your service a name. You can also modify the configuration file that kubegrid uses to define the service, or point kubegrid to a specific .yml file in your repository to use instead. Also, you can define the environment variables that your service needs.

Cluster List

To see an overview of all your clusters, click the Clusters link from the Shortcuts menu.

Clusters page

From here, you can add a new cluster, delete this cluster, or view additional details.

Cluster Details

Click View Details to view additional details about a specific cluster.

At the top, you can see the overall status of your cluster (in this case, running). Next, you see the Cluster IP address. This is the IP address to use to ssh into your Kubernetes master node, if you want to do so.

Cluster Access

If you do want to directly access your Kubernetes, click on Config. This will show two new buttons — Download SSH Key and Download k8s Config. The first is the ssh key to use to ssh into the master node. The second is the kubeconfig file to use with kubectl.

Cluster Dashboard

If you click K8s Dashboard, you’ll be shown the Kubernetes Dashboard. Click on the icon in the bottom-right corner to expand the view.

Node Summary

The node summary table shows all the nodes in your cluster, their names, IP address, and status.

Pod Summary

The pod summary table shows the status and source of each pod in your cluster. If it runs a public web server, it also contains a link to access that service. From the wrench menu, you can choose to remove this service from this cluster.

Cloud Profiles

The Cloud Profiles page shows you a list of the cloud provider profiles that you have created.

Cloud Profiles page

You can edit the region / access credentials / etc associated with each profile by clicking on the wrench icon. You can add a new cloud profile by clicking the Add New Cloud Profile button.

Repository Profiles

The Repository Profiles page shows you a list of the repositories you have linked to kubegrid.

Repository Profiles page

You can add additional repositories by selecting the provider and following the on-screen instructions. However, no new services will be added to any clusters.

Adding More Clusters

When you’re ready to make more clusters, you can add the repository information, cloud profile information, service definitions, and cluster definition through the corresponding Shortcuts menu pages. However, it is easier to go back through the Setup Wizard again. The cloud profile, repository, and service information that you’ve configured previously will be available to you to re-use.

Getting Help

If you aren’t sure how to do so something, or something isn’t working, please open a support ticket by clicking the Open Ticket button in the top menu.

You can check the status of any support tickets you’ve opened under the Support top menu item.

Providing Feedback

We’d love to hear your suggestions for the future evolution of kubegrid! Please contact us by email using the Contact Us top menu item.