Add update-your-app tutorial

Add bulleted lists to whatsnext section

Fix typos/tags

Use numbered list for index.md

Fix index page format

blue boxes test > cluster-intro

fix blue boxes test > cluster-intro

Add animations to scale and update

fix index indentations

tidy up index format

fix indentation

fix img src paths

Author: mrgiles

content/en/docs/tutorials/kubernetes-basics/_index.md

@@ -33,28 +33,49 @@ and when you want, and helps them find the resources and tools they need to work
 is a production-ready, open source platform designed with Google's accumulated experience in
 container orchestration, combined with best-of-breed ideas from the community.
 
-## Kubernetes Basic Modules
-
-### [1. Create a Kubernetes cluster](/docs/tutorials/kubernetes-basics/create-cluster/cluster-intro/)
-
-<!-- {{< figure src="public/images/module_01.svg" class="diagram-small" >}} -->
-
-### [2. Deploy an app](/docs/tutorials/kubernetes-basics/deploy-app/deploy-intro/)
-
-<!-- {{< figure src="public/images/module_02.svg" class="diagram-small" >}} -->
-
-### [3. Explore your app](/docs/tutorials/kubernetes-basics/explore/explore-intro/)
-
-<!-- {{< figure src="public/images/module_03.svg" class="diagram-small" >}} -->
-
-### [4. Expose your app publicly](/docs/tutorials/kubernetes-basics/expose/expose-intro/)
-
-<!-- {{< figure src="public/images/module_04.svg" class="diagram-small" >}} -->
-
-### [5. Scale up your app](/docs/tutorials/kubernetes-basics/scale/scale-intro/)
-
-<!-- {{< figure src="public/images/module_05.svg" class="diagram-small" >}} -->
-
-### [6. Update your app](/docs/tutorials/kubernetes-basics/update/update-intro/)
-
-<!-- {{< figure src="public/images/module_06.svg" class="diagram-small" >}} -->
+## Kubernetes Basics Modules
+
+<!-- this css code is to preserve the original format -->
+<div style="display: flex; flex-wrap: wrap; gap: 20px; justify-content: space-between;">
+  <div style="width: 30%; text-align: center;">
+    <a href="/docs/tutorials/kubernetes-basics/create-cluster/cluster-intro/">
+      <img src="/docs/tutorials/kubernetes-basics/public/images/module_01.svg?v=1469803628347" alt="Module 1" style="width: 100%;">
+      <h5>1. Create a Kubernetes cluster</h5>
+    </a>
+  </div>
+  <div style="width: 30%; text-align: center;">
+    <a href="/docs/tutorials/kubernetes-basics/deploy-app/deploy-intro/">
+      <img src="/docs/tutorials/kubernetes-basics/public/images/module_02.svg?v=1469803628347" alt="Module 2" style="width: 100%;">
+      <h5>2. Deploy an app</h5>
+    </a>
+  </div>
+  <div style="width: 30%; text-align: center;">
+    <a href="/docs/tutorials/kubernetes-basics/explore/explore-intro/">
+      <img src="/docs/tutorials/kubernetes-basics/public/images/module_03.svg?v=1469803628347" alt="Module 3" style="width: 100%;">
+      <h5>3. Explore your app</h5>
+    </a>
+  </div>
+  <div style="width: 30%; text-align: center;">
+    <a href="/docs/tutorials/kubernetes-basics/expose/expose-intro/">
+      <img src="/docs/tutorials/kubernetes-basics/public/images/module_04.svg?v=1469803628347" alt="Module 4" style="width: 100%;">
+      <h5>4. Expose your app publicly</h5>
+    </a>
+  </div>
+  <div style="width: 30%; text-align: center;">
+    <a href="/docs/tutorials/kubernetes-basics/scale/scale-intro/">
+      <img src="/docs/tutorials/kubernetes-basics/public/images/module_05.svg?v=1469803628347" alt="Module 5" style="width: 100%;">
+      <h5>5. Scale up your app</h5>
+    </a>
+  </div>
+  <div style="width: 30%; text-align: center;">
+    <a href="/docs/tutorials/kubernetes-basics/update/update-intro/">
+      <img src="/docs/tutorials/kubernetes-basics/public/images/module_06.svg?v=1469803628347" alt="Module 6" style="width: 100%;">
+      <h5>6. Update your app</h5>
+    </a>
+  </div>
+</div>
+
+## {{% heading "whatsnext" %}}
+
+* Tutorial [Using Minikube to Create a
+Cluster](/docs/tutorials/kubernetes-basics/create-cluster/)

content/en/docs/tutorials/kubernetes-basics/create-cluster/cluster-intro.md

@@ -11,6 +11,14 @@ weight: 10
 
 ## Kubernetes Clusters
 
+<div class="col-md-8">
+  <div class="content__box content__box_fill">
+    <p><i>Kubernetes is a production-grade, open-source platform that orchestrates
+      the placement (scheduling) and execution of application containers
+      within and across computer clusters.</i></p>
+  </div>
+</div>
+
 **Kubernetes coordinates a highly available cluster of computers that are connected
 to work as a single unit.** The abstractions in Kubernetes allow you to deploy
 containerized applications to a cluster without tying them specifically to individual
@@ -29,12 +37,18 @@ A Kubernetes cluster consists of two types of resources:
 
 ### Cluster Diagram
 
-{{< figure src="../../public/images/module_01_cluster.svg" class="diagram-medium" >}}
+{{< figure src="/docs/tutorials/kubernetes-basics/public/images/module_01_cluster.svg" style="width: 100%;" >}}
 
 **The Control Plane is responsible for managing the cluster.** The Control Plane
 coordinates all activities in your cluster, such as scheduling applications, maintaining
 applications' desired state, scaling applications, and rolling out new updates.
 
+<div class="col-md-8">
+  <div style="background-color: #eaf7ff; border-left: 5px solid #3771e3; padding: 15px; margin: 20px 0;">
+    <p><i>Control Planes manage the cluster and the nodes that are used to host the running applications.</i></p>
+  </div>
+</div>
+
 **A node is a VM or a physical computer that serves as a worker machine in a Kubernetes
 cluster.** Each node has a Kubelet, which is an agent for managing the node and
 communicating with the Kubernetes control plane. The node should also have tools for
@@ -60,5 +74,5 @@ working with your cluster, including start, stop, status, and delete.
 
 ## {{% heading "whatsnext" %}}
 
-Now that you know more about what Kubernetes is, visit [Hello Minikube](/docs/tutorials/hello-minikube/)
-to try this out on your computer.
+* Tutorial [Hello Minikube](/docs/tutorials/hello-minikube/).
+* Learn more about [Cluster Architecture](/docs/concepts/architecture/).

content/en/docs/tutorials/kubernetes-basics/deploy-app/deploy-intro.md

@@ -36,7 +36,7 @@ provide a fundamentally different approach to application management.
 
 ## Deploying your first app on Kubernetes
 
-{{< figure src="../../public/images/module_02_first_app.svg" class="diagram-medium" >}}
+{{< figure src="/docs/tutorials/kubernetes-basics/public/images/module_02_first_app.svg" class="diagram-medium" >}}
 
 You can create and manage a Deployment by using the Kubernetes command line interface,
 [kubectl](/docs/reference/kubectl/). `kubectl` uses the Kubernetes API to interact
@@ -110,7 +110,7 @@ we're interacting through an API endpoint to communicate with our application.
 
 We will cover other options on how to expose your application outside the Kubernetes
 cluster later, in [Module 4](/docs/tutorials/kubernetes-basics/expose/).
-Also as a basic tutorial, we're not explaining what <code>Pods</code> are in any
+Also as a basic tutorial, we're not explaining what `Pods` are in any
 detail here, it will be covered in later topics.
 
 The `kubectl proxy` command can create a proxy that will forward communications
@@ -158,4 +158,5 @@ is required which will be explained in [Module 4](/docs/tutorials/kubernetes-bas
 
 ## {{% heading "whatsnext" %}}
 
-Once you're ready, move on to [Viewing Pods and Nodes](/docs/tutorials/kubernetes-basics/explore/explore-intro/).
+* Tutorial [Viewing Pods and Nodes](/docs/tutorials/kubernetes-basics/explore/explore-intro/).
+* Learn more about [Deployments](/docs/concepts/workloads/controllers/deployment/).

content/en/docs/tutorials/kubernetes-basics/explore/explore-intro.md

@@ -37,7 +37,7 @@ the cluster.
 
 ### Pods overview
 
-{{< figure src="../../public/images/module_03_pods.svg" class="diagram-medium" >}}
+{{< figure src="/docs/tutorials/kubernetes-basics/public/images/module_03_pods.svg" class="diagram-medium" >}}
 
 ## Nodes
 
@@ -58,7 +58,7 @@ from a registry, unpacking the container, and running the application.
 
 ### Nodes overview
 
-{{< figure src="../../public/images/module_03_nodes.svg" class="diagram-medium" >}}
+{{< figure src="/docs/tutorials/kubernetes-basics/public/images/module_03_nodes.svg" class="diagram-medium" >}}
 
 ## Troubleshooting with kubectl
 
@@ -160,7 +160,7 @@ kubectl exec -ti $POD_NAME -- bash
 ```
 
 We have now an open console on the container where we run our NodeJS application.
-The source code of the app is in the i`server.js` file:
+The source code of the app is in the `server.js` file:
 
 ```shell
 cat server.js
@@ -182,6 +182,7 @@ To close your container connection, type `exit`.
 
 ## {{% heading "whatsnext" %}}
 
-Once you're ready, move on to
+* Tutorial
 [Using A Service To Expose Your App](/docs/tutorials/kubernetes-basics/expose/expose-intro/).
-
+* Learn more about [Pods](/docs/concepts/workloads/pods/).
+* Learn more about [Nodes](/docs/concepts/architecture/nodes/).

content/en/docs/tutorials/kubernetes-basics/expose/expose-intro.md

@@ -42,7 +42,7 @@ Makes a Service accessible from outside the cluster using `NodeIP:NodePort`. Sup
 * _LoadBalancer_ - Creates an external load balancer in the current cloud (if supported)
 and assigns a fixed, external IP to the Service. Superset of NodePort.
 
-* _ExternalName_ - Maps the Service to the contents of the `externalName` field 
+* _ExternalName_ - Maps the Service to the contents of the `externalName` field
 (e.g. `foo.bar.example.com`), by returning a `CNAME` record with its value.
 No proxying of any kind is set up. This type requires v1.7 or higher of `kube-dns`,
 or CoreDNS version 0.0.8 or higher.
@@ -73,7 +73,7 @@ pairs attached to objects and can be used in any number of ways:
 * Embed version tags
 * Classify an object using tags
 
-{{< figure src="../../public/images/module_04_labels.svg" class="diagram-medium" >}}
+{{< figure src="/docs/tutorials/kubernetes-basics/public/images/module_04_labels.svg" class="diagram-medium" >}}
 
 Labels can be attached to objects at creation time or later on. They can be modified
 at any time. Let's expose our application now using a Service and apply some labels.
@@ -151,7 +151,7 @@ curl 127.0.0.1:51082
 
 And we get a response from the server. The Service is exposed.
 
-### Step 2: Using labels 
+### Step 2: Using labels
 
 The Deployment created automatically a label for our Pod. With the `describe deployment`
 subcommand you can see the name (the _key_) of that label:
@@ -229,11 +229,13 @@ You can confirm that the app is still running with a `curl` from inside the pod:
 ```shell
 kubectl exec -ti $POD_NAME -- curl http://localhost:8080
 ```
+
 We see here that the application is up. This is because the Deployment is managing
 the application. To shut down the application, you would need to delete the Deployment
 as well.
 
 ## {{% heading "whatsnext" %}}
 
-Once you're ready, move on to
+* Tutorial
 [Running Multiple Instances of Your App](/docs/tutorials/kubernetes-basics/scale/scale-intro/).
+* Learn more about [Service](/docs/concepts/services-networking/service/).

content/en/docs/tutorials/kubernetes-basics/scale/scale-intro.md

@@ -9,7 +9,7 @@ weight: 10
 
 ## Scaling an application
 
-Previously we created a [Deployment](/docs/concepts/workloads/controllers/deployment),
+Previously we created a [Deployment](/docs/concepts/workloads/controllers/deployment/),
 and then exposed it publicly via a [Service](/docs/concepts/services-networking/service/).
 The Deployment created only one Pod for running our application. When traffic increases,
 we will need to scale the application to keep up with user demand.
@@ -34,13 +34,33 @@ with its `type` set to `LoadBalancer`:
 ```shell
 kubectl expose deployment/kubernetes-bootcamp --type="LoadBalancer" --port 8080
 ```
+
 {{< /note >}}
 
 ## Scaling overview
 
-<div class="figure-container" style="display: flex; gap: 10px; justify-content: center;">
-  {{< figure src="../../public/images/module_05_scaling1.svg" width="480" >}}
-  {{< figure src="../../public/images/module_05_scaling2.svg" width="480" >}}
+<!-- animation -->
+<div class="col-md-8">
+  <div id="myCarousel" class="carousel" data-ride="carousel" data-interval="3000">
+    <ol class="carousel-indicators">
+      <li data-target="#myCarousel" data-slide-to="0" class="active"></li>
+      <li data-target="#myCarousel" data-slide-to="1"></li>
+    </ol>
+      <div class="carousel-inner" role="listbox">
+        <div class="item carousel-item active">
+          <img src="/docs/tutorials/kubernetes-basics/public/images/module_05_scaling1.svg">
+        </div>
+        <div class="item carousel-item">
+          <img src="/docs/tutorials/kubernetes-basics/public/images/module_05_scaling2.svg">
+        </div>
+      </div>
+      <a class="left carousel-control" href="#myCarousel" role="button" data-slide="prev">
+        <span class="sr-only ">Previous</span>
+      </a>
+      <a class="right carousel-control" href="#myCarousel" role="button" data-slide="next">
+        <span class="sr-only">Next</span>
+      </a>
+  </div>
 </div>
 
 Scaling out a Deployment will ensure new Pods are created and scheduled to Nodes
@@ -65,6 +85,7 @@ To list your Deployments, use the `get deployments` subcommand:
 ```shell
 kubectl get deployments
 ```
+
 The output should be similar to:
 
 ```
@@ -158,7 +179,6 @@ Hello Kubernetes bootcamp! | Running on: kubernetes-bootcamp-644c5687f4-wp67j |
 Hello Kubernetes bootcamp! | Running on: kubernetes-bootcamp-644c5687f4-4hjvf | v=1
 ```
 
-
 {{< note >}}
 If you're running minikube with Docker Desktop as the container driver, a minikube
 tunnel is needed. This is because containers inside Docker Desktop are isolated
@@ -208,6 +228,7 @@ This confirms that 2 Pods were terminated.
 
 ## {{% heading "whatsnext" %}}
 
-Once you're ready, move on to
+* Tutorial
 [Performing a Rolling Update](/docs/tutorials/kubernetes-basics/update/update-intro/).
-
+* Learn more about [ReplicaSet](/docs/concepts/workloads/controllers/replicaset/).
+* Learn more about [Autoscaling](/docs/concepts/workloads/autoscaling/).