Skip to content

Commit 8cd43fb

Browse files
k8s-ci-robotk8s-ci-robot
authored
Merge pull request #48592 from mrgiles/41625_html_tutorials_html_to_md
Rewrite tutorials in Markdown
2 parents fc70d1c + 8a573f4 commit 8cd43fb

File tree

15 files changed

+1239
-1185
lines changed

15 files changed

+1239
-1185
lines changed

Diff for: ‎content/en/docs/tutorials/kubernetes-basics/_index.html

-117
This file was deleted.

Diff for: ‎content/en/docs/tutorials/kubernetes-basics/_index.md

+83
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,83 @@
1+
---
2+
title: Learn Kubernetes Basics
3+
main_menu: true
4+
no_list: true
5+
weight: 20
6+
content_type: concept
7+
card:
8+
name: tutorials
9+
weight: 20
10+
title: Walkthrough the basics
11+
---
12+
13+
## {{% heading "objectives" %}}
14+
15+
This tutorial provides a walkthrough of the basics of the Kubernetes cluster orchestration
16+
system. Each module contains some background information on major Kubernetes features
17+
and concepts, and a tutorial for you to follow along.
18+
19+
Using the tutorials, you can learn to:
20+
21+
* Deploy a containerized application on a cluster.
22+
* Scale the deployment.
23+
* Update the containerized application with a new software version.
24+
* Debug the containerized application.
25+
26+
## What can Kubernetes do for you?
27+
28+
With modern web services, users expect applications to be available 24/7, and developers
29+
expect to deploy new versions of those applications several times a day. Containerization
30+
helps package software to serve these goals, enabling applications to be released and updated
31+
without downtime. Kubernetes helps you make sure those containerized applications run where
32+
and when you want, and helps them find the resources and tools they need to work. Kubernetes
33+
is a production-ready, open source platform designed with Google's accumulated experience in
34+
container orchestration, combined with best-of-breed ideas from the community.
35+
36+
## Kubernetes Basics Modules
37+
38+
<!-- css code to preserve original format -->
39+
<link rel="stylesheet" href="/css/style_tutorials.css">
40+
41+
<div class="tutorials-modules">
42+
<div class="module">
43+
<a href="/docs/tutorials/kubernetes-basics/create-cluster/cluster-intro/">
44+
<img src="/docs/tutorials/kubernetes-basics/public/images/module_01.svg?v=1469803628347" alt="Module 1">
45+
<h5>1. Create a Kubernetes cluster</h5>
46+
</a>
47+
</div>
48+
<div class="module">
49+
<a href="/docs/tutorials/kubernetes-basics/deploy-app/deploy-intro/">
50+
<img src="/docs/tutorials/kubernetes-basics/public/images/module_02.svg?v=1469803628347" alt="Module 2">
51+
<h5>2. Deploy an app</h5>
52+
</a>
53+
</div>
54+
<div class="module">
55+
<a href="/docs/tutorials/kubernetes-basics/explore/explore-intro/">
56+
<img src="/docs/tutorials/kubernetes-basics/public/images/module_03.svg?v=1469803628347" alt="Module 3">
57+
<h5>3. Explore your app</h5>
58+
</a>
59+
</div>
60+
<div class="module">
61+
<a href="/docs/tutorials/kubernetes-basics/expose/expose-intro/">
62+
<img src="/docs/tutorials/kubernetes-basics/public/images/module_04.svg?v=1469803628347" alt="Module 4">
63+
<h5>4. Expose your app publicly</h5>
64+
</a>
65+
</div>
66+
<div class="module">
67+
<a href="/docs/tutorials/kubernetes-basics/scale/scale-intro/">
68+
<img src="/docs/tutorials/kubernetes-basics/public/images/module_05.svg?v=1469803628347" alt="Module 5">
69+
<h5>5. Scale up your app</h5>
70+
</a>
71+
</div>
72+
<div class="module">
73+
<a href="/docs/tutorials/kubernetes-basics/update/update-intro/">
74+
<img src="/docs/tutorials/kubernetes-basics/public/images/module_06.svg?v=1469803628347" alt="Module 6">
75+
<h5>6. Update your app</h5>
76+
</a>
77+
</div>
78+
</div>
79+
80+
## {{% heading "whatsnext" %}}
81+
82+
* Tutorial [Using Minikube to Create a
83+
Cluster](/docs/tutorials/kubernetes-basics/create-cluster/)

Diff for: ‎content/en/docs/tutorials/kubernetes-basics/create-cluster/cluster-intro.html

-105
This file was deleted.

Diff for: ‎content/en/docs/tutorials/kubernetes-basics/create-cluster/cluster-intro.md

+75
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
---
2+
title: Using Minikube to Create a Cluster
3+
weight: 10
4+
---
5+
6+
## {{% heading "objectives" %}}
7+
8+
* Learn what a Kubernetes cluster is.
9+
* Learn what Minikube is.
10+
* Start a Kubernetes cluster on your computer.
11+
12+
## Kubernetes Clusters
13+
14+
{{% alert %}}
15+
_Kubernetes is a production-grade, open-source platform that orchestrates
16+
the placement (scheduling) and execution of application containers
17+
within and across computer clusters._
18+
{{% /alert %}}
19+
20+
**Kubernetes coordinates a highly available cluster of computers that are connected
21+
to work as a single unit.** The abstractions in Kubernetes allow you to deploy
22+
containerized applications to a cluster without tying them specifically to individual
23+
machines. To make use of this new model of deployment, applications need to be packaged
24+
in a way that decouples them from individual hosts: they need to be containerized.
25+
Containerized applications are more flexible and available than in past deployment models,
26+
where applications were installed directly onto specific machines as packages deeply
27+
integrated into the host. **Kubernetes automates the distribution and scheduling of
28+
application containers across a cluster in a more efficient way.** Kubernetes is an
29+
open-source platform and is production-ready.
30+
31+
A Kubernetes cluster consists of two types of resources:
32+
33+
* The **Control Plane** coordinates the cluster
34+
* **Nodes** are the workers that run applications
35+
36+
### Cluster Diagram
37+
38+
{{< figure src="/docs/tutorials/kubernetes-basics/public/images/module_01_cluster.svg" style="width: 100%;" >}}
39+
40+
**The Control Plane is responsible for managing the cluster.** The Control Plane
41+
coordinates all activities in your cluster, such as scheduling applications, maintaining
42+
applications' desired state, scaling applications, and rolling out new updates.
43+
44+
{{% alert %}}
45+
_Control Planes manage the cluster and the nodes that are used to host the running
46+
applications._
47+
{{% /alert %}}
48+
49+
**A node is a VM or a physical computer that serves as a worker machine in a Kubernetes
50+
cluster.** Each node has a Kubelet, which is an agent for managing the node and
51+
communicating with the Kubernetes control plane. The node should also have tools for
52+
handling container operations, such as {{< glossary_tooltip text="containerd" term_id="containerd" >}}
53+
or {{< glossary_tooltip term_id="cri-o" >}}. A Kubernetes cluster that handles production
54+
traffic should have a minimum of three nodes because if one node goes down, both an
55+
[etcd](/docs/concepts/architecture/#etcd) member and a control plane instance are lost,
56+
and redundancy is compromised. You can mitigate this risk by adding more control plane nodes.
57+
58+
When you deploy applications on Kubernetes, you tell the control plane to start
59+
the application containers. The control plane schedules the containers to run on
60+
the cluster's nodes. **Node-level components, such as the kubelet, communicate
61+
with the control plane using the [Kubernetes API](/docs/concepts/overview/kubernetes-api/)**,
62+
which the control plane exposes. End users can also use the Kubernetes API directly
63+
to interact with the cluster.
64+
65+
A Kubernetes cluster can be deployed on either physical or virtual machines. To
66+
get started with Kubernetes development, you can use Minikube. Minikube is a lightweight
67+
Kubernetes implementation that creates a VM on your local machine and deploys a
68+
simple cluster containing only one node. Minikube is available for Linux, macOS,
69+
and Windows systems. The Minikube CLI provides basic bootstrapping operations for
70+
working with your cluster, including start, stop, status, and delete.
71+
72+
## {{% heading "whatsnext" %}}
73+
74+
* Tutorial [Hello Minikube](/docs/tutorials/hello-minikube/).
75+
* Learn more about [Cluster Architecture](/docs/concepts/architecture/).

0 commit comments

Comments
 (0)