New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

New "Learning Environment" Page #49299

Open

jayphan14 wants to merge 1 commit into kubernetes:main from jayphan14:new-learning-environment-page

jayphan14 commented Jan 6, 2025

Issue Summary:

Existing Learning Environment Page get directed to tasks/install-tools

Description:

Created a new learning environment page with these suggested content.
Remove existing redirects

Closes: #36048

linux-foundation-easycla bot commented Jan 6, 2025 •

edited

Loading

The committers listed above are authorized under a signed CLA.

✅ login: jayphan14 / name: Jay Phan (83109f8)

k8s-ci-robot added the cncf-cla: no label

Contributor

k8s-ci-robot commented Jan 6, 2025

Welcome @jayphan14!

It looks like this is your first PR to kubernetes/website 🎉. Please refer to our pull request process documentation to help your PR have a smooth ride to approval.

You will be prompted by a bot to use commands during the review process. Do not be afraid to follow the prompts! It is okay to experiment. Here is the bot commands documentation.

You can also check if kubernetes/website has its own contribution guidelines.

You may want to refer to our testing guide if you run into trouble with your tests not passing.

If you are having difficulty getting your pull request seen, please follow the recommended escalation practices. Also, for tips and tricks in the contribution process you may want to read the Kubernetes contributor cheat sheet. We want to make sure your contribution gets all the attention it needs!

Thank you, and welcome to Kubernetes. 😃

Contributor

k8s-ci-robot commented Jan 6, 2025

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign tengqm for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Needs approval from an approver in each of these files:

OWNERS
content/en/docs/OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

k8s-ci-robot added the language/en label

k8s-ci-robot requested review from brendandburns and mickeyboxell

January 6, 2025 17:16

k8s-ci-robot added sig/docs size/M labels

netlify bot commented Jan 6, 2025 •

edited

Loading

✅ Pull request preview available for checking

Built without sensitive environment variables

Name	Link
🔨 Latest commit	`83109f8`
🔍 Latest deploy log	https://app.netlify.com/sites/kubernetes-io-main-staging/deploys/677c42f9041dbc0008e9156a
😎 Deploy Preview	https://deploy-preview-49299--kubernetes-io-main-staging.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

sftim reviewed

View reviewed changes

static/_redirects Outdated Show resolved Hide resolved

jayphan14 closed this

jayphan14 reopened this

jayphan14 force-pushed the new-learning-environment-page branch from 8e6e6f6 to 8acc78c Compare

January 6, 2025 20:51


          add new page and remove old redirects

83109f8

jayphan14 force-pushed the new-learning-environment-page branch from 8acc78c to 83109f8 Compare

January 6, 2025 20:54

k8s-ci-robot added cncf-cla: yes and removed cncf-cla: no labels

jayphan14 requested a review from sftim

January 7, 2025 03:33

sftim reviewed

View reviewed changes

Contributor

sftim left a comment

Thanks for the PR. Please have a look at this inline feedback.

content/en/docs/setup/learning-environment/_index.md

-              The kind [Quick Start](https://kind.sigs.k8s.io/docs/user/quick-start/) page
-              shows you what you need to do to get up and running with kind.
+              ## How to communicate with a Kubernetes cluster?
+              When working with Kubernetes, you need a way to interact with and manage your cluster. This involves tasks such as deploying applications, inspecting resources, and debugging issues. The `kubectl` command-line tool serves as the primary interface for communicating with a configured Kubernetes cluster, allowing you to send commands and receive responses to and from the cluster's API server.

Contributor

sftim Jan 15, 2025

Suggested change

      
            You'll need to [install kubectl](/docs/tasks/tools/#kubectl) unless you choose a learning environment
          
            that provides it for you.

content/en/docs/setup/learning-environment/_index.md

+              ## Options for trying out Kubernetes locally
+              To experiment with Kubernetes locally, you need tools that allow you to simulate a Kubernetes cluster on your machine. These tools create lightweight clusters for testing, development, or learning purposes without requiring extensive infrastructure.
+              ### 1. kind

Contributor

sftim Jan 15, 2025

As a project, we recommend minikube over kind. kind was originally a tool for development rather than learning (but is still a viable option).

You could also make a heading that combines them, listing them in alphabetical order; that is:

Suggested change

      
            ### 1. kind
          
            ### 1. kind and minikube {#kind-and-minikube}

content/en/docs/setup/learning-environment/_index.md


		You can follow the official [Get Started](https://minikube.sigs.k8s.io/docs/start/) guide to set it up.

		### 3. Other 3rd party tools

Contributor

sftim Jan 15, 2025

Suggested change

      
            ### 3. Other 3rd party tools
          
            ### 3. Other 3rd party tools {#third-party-tools}

Avoid putting the number into the fragment identifier.

content/en/docs/setup/learning-environment/_index.md

+              You can follow the official [Get Started](https://minikube.sigs.k8s.io/docs/start/) guide to set it up.
+              ### 3. Other 3rd party tools
+              There are additional tools like [MicroK8s](https://microk8s.io/docs) and [k3d](https://k3d.io/stable/) for running Kubernetes clusters locally.

Contributor

sftim Jan 15, 2025

This needs a third party content marker. How about:

Suggested change

      
            There are additional tools like [MicroK8s](https://microk8s.io/docs) and [k3d](https://k3d.io/stable/) for running Kubernetes clusters locally.
          
            {{% thirdparty-content %}}
          
            There are additional tools such as [MicroK8s](https://microk8s.io/docs) and [k3d](https://k3d.io/stable/) for running Kubernetes clusters locally. You can use the [CNCF Landscape(https://landscape.cncf.io/)
          
            to find a tool that for deploying certified Kubernetes locally.

content/en/docs/setup/learning-environment/_index.md

+              ### 3. Other 3rd party tools
+              There are additional tools like [MicroK8s](https://microk8s.io/docs) and [k3d](https://k3d.io/stable/) for running Kubernetes clusters locally.
+              ### 4. Online Playground Environment

Contributor

sftim Jan 15, 2025

(nit)

Suggested change

      
            ### 4. Online Playground Environment
          
            ### 4. Online playground environments {#online-playgrounds}

content/en/docs/setup/learning-environment/_index.md

+              ### 4. Online Playground Environment
+              If you don’t want to install Kubernetes locally, you can use online environments to practice.
+              - [Killer Coda](https://killercoda.com/): Interactive Kubernetes labs for various scenarios.

Contributor

sftim Jan 15, 2025

Suggested change

      
            - [Killer Coda](https://killercoda.com/): Interactive Kubernetes labs for various scenarios.
          
            - [Killercoda](https://killercoda.com/): Interactive Kubernetes labs for various scenarios.

content/en/docs/setup/learning-environment/_index.md

		- [Play With Kubernetes](https://labs.play-with-k8s.com/): Browser-based Kubernetes playground to spin up clusters on demand.


		## What's next: Practice setting up a production-like cluster

Contributor

sftim Jan 15, 2025

Try this:

Suggested change

      
            ## What's next: Practice setting up a production-like cluster
          
            ## {{% heading "whatsnext" %}}
          
            ### Install local tools
          
            - [Install kubectl](/docs/tasks/tools/#kubectl) if you didn't already do that
          
              -  and you can [add plugins to kubectl](/docs/tasks/extend-kubectl/kubectl-plugins/#installing-kubectl-plugins) if you'd like to
          
            - You will also need a `.kubeconfig` configuration file
          
            ### Tutorials
          
            Try a [tutorial](/docs/tutorials/)  to learn more about Kubernetes.
          
            ### Training
          
            Look into the [training](/training/) that's available to help you learn Kubernetes.
          
            ### Practice setting up a production-like cluster

Also see #38681 - we don't yet have a task page about setting up kubeconfig. Once we do, other pages can link to it.

content/en/docs/setup/learning-environment/_index.md


		While the tools above are great for learning, setting up a production-like cluster provides deeper insights into how Kubernetes operates in real-world scenarios.

		[Kubeadm]() is a tool designed to help you set up a secure and functional cluster with minimal complexity.

Contributor

sftim Jan 15, 2025

Suggested change

      
            [Kubeadm]() is a tool designed to help you set up a secure and functional cluster with minimal complexity.
          
            The `kubeadm` tool is designed to help you [set up a production-grade cluster](/docs/setup/production-environment/tools/kubeadm/) with minimal complexity.
          
            Once you've deployed a baseline cluster with kubeadm, typically you'll want to customize it or extend it
          
            to deliver a cloud-native platform.
          
            Read [production considerations](/docs/setup/production-environment/#production-considerations)
          
            when you're ready to learn more.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cncf-cla: yes language/en sig/docs size/M