docs: moved Kind onboarding procedures to the onboarding section (#3991)

Signed-off-by: Fabrice Flore-Thébault <ffloreth@redhat.com>
This commit is contained in:
Fabrice Flore-Thébault 2023-09-20 18:21:49 +02:00 committed by GitHub
parent 3c5a3f019b
commit 3dbff4e2f1
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
17 changed files with 77 additions and 17 deletions

View file

@ -10,7 +10,7 @@ tags: [migrating-to-kubernetes]
Podman Desktop configures the access to Kubernetes clusters automatically when:
- [Creating a Kind-powered local Kubernetes cluster](kind/creating-a-kind-cluster).
- [Creating a Kind-powered local Kubernetes cluster](../onboarding/kubernetes/kind/creating-a-kind-cluster).
- [Creating an OpenShift Local cluster](openshift/creating-an-openshift-local-cluster).
- [Configuring access to a Developer Sandbox](openshift/configuring-access-to-a-developer-sandbox).

View file

@ -14,7 +14,7 @@ With Podman Desktop, you can deploy a container to your Kubernetes cluster.
- Your are using the Podman container engine.
- Your container, running or stopped, is available on the **Containers** page: _<your_container>_.
- You registered the Kubernetes cluster in your kubeconfig file: _<your_kubernetes_cluster>_. For example, [Creating a kind cluster](kind/creating-a-kind-cluster.md).
- You registered the Kubernetes cluster in your kubeconfig file: _<your_kubernetes_cluster>_. For example, [Creating a kind cluster](../onboarding/kubernetes/kind/creating-a-kind-cluster).
- The Kubernetes namespace to deploy to already exists.
#### Procedure

View file

@ -14,7 +14,7 @@ With Podman Desktop, you can deploy a pod to your Kubernetes cluster.
- Your are using the Podman container engine.
- Your pod, running or stopped, is available on the **Pods** page: _<your_pod>_.
- You registered the Kubernetes cluster in your kubeconfig file: _<your_kubernetes_cluster>_. For example, [Creating a kind cluster](kind/creating-a-kind-cluster.md).
- You registered the Kubernetes cluster in your kubeconfig file: _<your_kubernetes_cluster>_. For example, [Creating a kind cluster](../onboarding/kubernetes/kind/creating-a-kind-cluster).
- The Kubernetes namespace to deploy to already exists.
#### Procedure

View file

@ -12,9 +12,9 @@ With Podman Desktop, you can build an image with your container engine, and test
#### Prerequisites
- Podman Desktop has access to:
- A running container engine.
- A running Kind cluster.
- [You onboarded a container engine](/docs/onboarding/containers).
- [You onboarded a Kind cluster](/docs/onboarding/kubernetes/kind).
- [You have set your Kubernetes context to your local Kind-powered Kubernetes cluster](/docs/kubernetes/kind/working-with-your-local-kind-cluster).
- A container definition file: `Containerfile` or `Dockerfile`.
#### Procedure

View file

@ -9,3 +9,13 @@ tags: [migrating-to-kubernetes, kind]
# Running Kubernetes on your workstation with Kind and Podman
Podman Desktop can help you run [Kind-powered](https://kind.sigs.k8s.io/) local Kubernetes clusters on a container engine, such as Podman.
#### Prerequisites
- [You onboarded a Kind cluster](/docs/onboarding/kubernetes/kind).
#### Procedure
1. [Set your Kubernetes context to your local Kind-powered Kubernetes cluster](/docs/kubernetes/kind/working-with-your-local-kind-cluster).
1. [Build an image and test it in Kind](/docs/kubernetes/kind/building-an-image-and-testing-it-in-kind).
1. [Push an image to Kind](/docs/kubernetes/kind/pushing-an-image-to-kind).

View file

@ -12,8 +12,10 @@ With Podman Desktop, you can push an image to your local Kind-powered Kubernetes
#### Prerequisites
- [You onboarded a container engine](/docs/onboarding/containers).
- [You onboarded a Kind cluster](/docs/onboarding/kubernetes/kind).
- [You have set your Kubernetes context to your local Kind-powered Kubernetes cluster](/docs/kubernetes/kind/working-with-your-local-kind-cluster).
- Your image is available on the **Images** page: `<my_image>:<my_tag>`.
- [You created a Kind cluster](creating-a-kind-cluster).
#### Procedure

View file

@ -10,6 +10,11 @@ tags: [migrating-to-kubernetes, kind]
Set your Kubernetes context to your local Kind-powered Kubernetes cluster.
#### Prerequisites
- [You onboarded a Kind cluster](/docs/onboarding/kubernetes/kind).
- [You have set your Kubernetes context to your local Kind-powered Kubernetes cluster](/docs/kubernetes/kind/working-with-your-local-kind-cluster).
#### Procedure
1. Open the Podman Desktop tray.

View file

@ -13,7 +13,7 @@ With Podman Desktop, you can view and select your current Kubernetes context in
#### Prerequisites
- You have a Kubernetes context in your kubeconfig file: _<your_kubernetes_cluster>_.
For example, [Creating a kind cluster](kind/creating-a-kind-cluster).
For example, [Creating a kind cluster](../onboarding/kubernetes/kind/creating-a-kind-cluster).
#### Procedure

View file

@ -16,7 +16,7 @@ With Podman Desktop, you can view and select your current Kubernetes context.
#### Prerequisites
- You have a Kubernetes context in your kubeconfig file: _<your_kubernetes_cluster>_.
For example, [Creating a kind cluster](kind/creating-a-kind-cluster).
For example, [Creating a kind cluster](../onboarding/kubernetes/kind/creating-a-kind-cluster).
#### Procedure

View file

@ -22,7 +22,7 @@ To connect to a remote Kubernetes, you can:
To setup Kubernetes on your workstation, you can:
- [Setup Kind on your container engine](/docs/kubernetes/kind).
- [Setup Kind on your container engine](/docs/onboarding/kubernetes/kind).
- [Setup Minikube on your container engine](/docs/kubernetes/minikube).
- [Setup a Lima machine with Kubernetes](/docs/onboarding/containers/creating-a-lima-instance-with-podman-desktop).
- [Setup Red Hat OpenShift Local with MicroShift or OpenShift](/docs/kubernetes/openshift/creating-an-openshift-local-cluster).

View file

@ -12,8 +12,8 @@ You can create multiple local Kind-powered Kubernetes clusters.
#### Prerequisites
- [You installed Kind](installing-kind).
- [On Windows, you configured Podman](configuring-podman-for-kind-on-windows).
- [You installed Kind](./installing-kind).
- [On Windows, you configured Podman](./configuring-podman-for-kind-on-windows).
#### Procedure

View file

@ -10,7 +10,7 @@ tags: [migrating-to-kubernetes, kind]
#### Prerequisites
- [You configured Podman](creating-a-kind-cluster.md).
- [You configured Podman](./creating-a-kind-cluster).
- [You installed Kind](https://kind.sigs.k8s.io/).
#### Procedure

View file

@ -0,0 +1,23 @@
---
sidebar_position: 10
title: Onboarding Kind
description: Kind is one way to get Kubernetes running on your workstation.
keywords: [podman desktop, podman, containers, migrating, kubernetes, kind]
tags: [migrating-to-kubernetes, kind]
---
# Onboarding Kubernetes on your workstation with Kind and Podman
Podman Desktop can help you run [Kind-powered](https://kind.sigs.k8s.io/) local Kubernetes clusters on a container engine, such as Podman.
#### Procedure
1. [Install the `kind` CLI](/docs/onboarding/kubernetes/kind/installing-kind).
2. [On Windows, configure Podman in rootful mode](/docs/onboarding/kubernetes/kind/configuring-podman-for-kind-on-windows).
3. [Create a Kind cluster](/docs/onboarding/kubernetes/kind/creating-a-kind-cluster).
#### Next steps
1. [Work with your Kind cluster](/docs/kubernetes/kind).
1. [Restart your Kind cluster](/docs/onboarding/kubernetes/kind/restarting-your-kind-cluster).
1. [Delete your Kind cluster](/docs/onboarding/kubernetes/kind/deleting-your-kind-cluster).

View file

@ -11,13 +11,13 @@ tags: [migrating-to-kubernetes, kind]
#### Procedure
- In the status bar, click on **Kind**, and follow the prompts.
![Kind in the status bar](img/kind-status-bar.png)
![Kind in the status bar](../../../kubernetes/kind/img/kind-status-bar.png)
#### Verification
1. The status bar does not display **Kind**.
1. **<icon icon="fa-solid fa-cog" size="lg" /> Settings > Resources** contain a **Kind** tile.
![Kind resource tile](img/kind-resource.png)
![Kind resource tile](../../../kubernetes/kind/img/kind-resource.png)
1. You can run the `kind` CLI:
```shell-session

View file

@ -1,5 +1,5 @@
---
sidebar_position: 7
sidebar_position: 5
title: Restarting your Kind cluster
description: Restarting your local Kind-powered Kubernetes cluster.
keywords: [podman desktop, podman, containers, migrating, kubernetes, kind]
@ -32,4 +32,4 @@ The Kind cluster might not restart successfully.
In that case:
- Consider replacing Kind with a local Kubernetes cluster that you can restart, such as [OpenShift Local](https://developers.redhat.com/products/openshift-local/).
- Consider [deleting your Kind cluster](deleting-your-kind-cluster), and [creating a Kind cluster](creating-a-kind-cluster).
- Consider [deleting your Kind cluster](./deleting-your-kind-cluster), and [creating a Kind cluster](./creating-a-kind-cluster).

View file

@ -60,6 +60,26 @@ const config = {
to: '/docs/onboarding/containers/creating-a-podman-machine-with-podman-desktop',
from: ['/docs/Installation/creating-a-podman-machine-with-podman-desktop'],
},
{
to: '/docs/onboarding/kubernetes/kind/installing-kind',
from: '/docs/kubernetes/kind/installing-kind',
},
{
to: '/docs/onboarding/kubernetes/kind/configuring-podman-for-kind-on-windows',
from: '/docs/kubernetes/kind/configuring-podman-for-kind-on-windows',
},
{
to: '/docs/onboarding/kubernetes/kind/creating-a-kind-cluster',
from: '/docs/kubernetes/kind/creating-a-kind-cluster',
},
{
to: '/docs/onboarding/kubernetes/kind/restarting-your-kind-cluster',
from: '/docs/kubernetes/kind/restarting-your-kind-cluster',
},
{
to: '/docs/onboarding/kubernetes/kind/deleting-your-kind-cluster',
from: '/docs/kubernetes/kind/deleting-your-kind-cluster',
},
{
to: '/docs/working-with-containers',
from: ['/docs/getting-started/getting-started', '/docs/getting-started'],