podman-desktop/website/tutorial/running-a-kubernetes-cluster.md
Shipra Singh 07f2d00056
docs(website): added tutorials for running a kube cluster and deployng a kube application (#8893)
* docs(website): added tutorials for running a kube cluster and deploying a kube application
Signed-off-by: Shipra Singh <shipsing@redhat.com>

* docs(website): minor edits
Signed-off-by: Shipra Singh <shipsing@redhat.com>

* docs(website): edited the index file
Signed-off-by: Shipra Singh <shipsing@redhat.com>

* docs(website): added the sidebar position metadata
Signed-off-by: Shipra Singh <shipsing@redhat.com>

* docs(website): fixed comments
Signed-off-by: Shipra Singh <shipsing@redhat.com>

* docs(website): fixed a comment
Signed-off-by: Shipra Singh <shipsing@redhat.com>

* docs(website): added an image
Signed-off-by: Shipra Singh <shipsing@redhat.com>

* docs(website): added an image
Signed-off-by: Shipra Singh <shipsing@redhat.com>

* docs(website): incorporated SME comments
Signed-off-by: Shipra Singh <shipsing@redhat.com>

* docs(website): minor edits
Signed-off-by: Shipra Singh <shipsing@redhat.com>

* docs(website): minor edits
Signed-off-by: Shipra Singh <shipsing@redhat.com>
2024-09-27 10:06:51 +05:30

76 lines
2.9 KiB
Markdown

---
sidebar_position: 3
title: Running a Kubernetes cluster
description: Running a Kubernetes cluster
keywords: [podman desktop, podman, Kubernetes]
tags: [podman-desktop, running-a-kubernetes-cluster, set-up-a-cluster]
---
# Running a Kubernetes cluster
This tutorial covers the following end-to-end tasks required to run a Kubernetes cluster with the help of an extension:
- Installing the extension
- Installing CLI on your local machine
- Applicable on Windows: Configure Podman on WSL
- Creating and running a Kubernetes cluster
You can use extensions, such as Kind and Minikube to start a local Kubernetes development cluster. When you have a running Kubernetes cluster, you can easily develop and test Kubernetes applications before deploying them to production. This tutorial focuses on creating a Kubernetes cluster using the Minikube extension.
## Before you begin
Make sure you have:
- [Installed Podman Desktop](/docs/installation).
- [A running Podman machine](/docs/podman/creating-a-podman-machine).
- A developer role.
## Installing the extension
1. Go to **Extensions > Catalog**.
2. Find the Minikube extension using the search box.
3. Click the **Install** icon.
![install the extension](img/install-icon.png)
4. Select the **Installed** tab to check the Minikube extension is active.
![extension enabled](img/extension-enabled.png)
## Installing CLI on your local machine
1. Click the **Minikube not found on your system** icon in the status bar.
![binary not available](img/minikube-binary-not-available.png)
2. Click **Yes** to download the Minikube binary.
3. Click **Yes** to install the binary system-wide for accessibility on the command line.
4. Enter your system password, if prompted. A notification of successful operation opens.
![binary successfully installed](img/binary-installed.png)
5. Click **OK**.
6. Check the **Minikube not found on your system** icon disappears from the status bar.
## Applicable on Windows: Configure Podman on WSL
To use the Minikube tool on Windows, you must have a Podman machine running in rootful mode.
- By default, the Podman Desktop **Settings** enable you to create a Podman machine that runs in rootful mode.
![root mode enabled](img/root-mode-enabled.png)
## Creating and running a Kubernetes cluster
1. Go to **Settings > Resources**.
2. In the Minikube tile, click **Create new**.
![create a new cluster](img/create-a-new-cluster.png)
3. Optional: Edit the cluster configuration, if required.
![cluster configuration](img/configure-minikube-cluster.png)
4. Click **Create**. A notification of successful operation opens.
5. Click **Go back to resources**.
6. View that your Minikube cluster is running and a new minikube context is added in the status bar.
![Kube context added](img/new-context-added.png)
## Additional resources
- [Working with a Kind cluster](/docs/kind)
- [Working with a Minikube cluster](/docs/minikube)
- [Working with a Lima cluster](/docs/lima)