Set Up Your Laptop Kubectl - Command Line Tool

January 10, 2024

3 min read

Copenhagen, Denmark

Asergo Team

Step 1: Generate your kubernetes config file

Navigate to the ASERGO Dashboard - Kubernetes Overview and download your personalized Kubernetes Config File.

Kubernetes Config Download

Step 2: Set Up Your Environment

Before you can start using Kubernetes, you need to set up your local environment with the necessary tools.

Install kubectl

kubectl is the Kubernetes command-line tool. If you haven’t installed it yet, follow the guide for your operating system:

Configure kubectl

Navigate to the ASERGO Dashboard - Kubernetes Overview and download your personalized Kubernetes Config File.

Place the downloaded config file in the default directory for your operating system:

Operating System Directory
Linux
~/.kube/config
macOS
~/.kube/config
Windows
%USERPROFILE%.kubeconfig

Enable Authentication with kube-oidc

To log in securely using your ASERGO Dashboard credentials, install the kube-oidc plugin for kubectl. This plugin simplifies authentication by managing OIDC token acquisition and renewal.

We recommend using Krew, a plugin manager for kubectl. It makes it easy to discover, install, and manage plugins. Follow the official Krew install guide to get started.

To install the plugin via Krew, run:

kubectl krew install oidc-login

Test kubectl

Run the following command to verify your setup:

kubectl version
  Client Version: v1.33.2
  Kustomize Version: v5.6.0
  Server Version: v1.33.1

Step 2: Deploy Storage Solution in the cluster (optional)

Each ASERGO cluster includes an additional storage disk at /dev/sdb. For persistent storage, we recommend using Rook Ceph. You can find the setup guide and detailed documentation on the Rook Documentation website: Rook Documentation website.