Skip to content

Commit 5ae11de

Browse files
author
Tim Bannister
committed
Update Hello Minikube for Katacoda EOL
1 parent c70b1de commit 5ae11de

File tree

1 file changed

+34
-32
lines changed

1 file changed

+34
-32
lines changed

content/en/docs/tutorials/hello-minikube.md

Lines changed: 34 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -17,14 +17,8 @@ card:
1717

1818
<!-- overview -->
1919

20-
This tutorial shows you how to run a sample app
21-
on Kubernetes using minikube and Katacoda.
22-
Katacoda provides a free, in-browser Kubernetes environment.
23-
24-
{{< note >}}
25-
You can also follow this tutorial if you've installed minikube locally.
26-
See [minikube start](https://minikube.sigs.k8s.io/docs/start/) for installation instructions.
27-
{{< /note >}}
20+
This tutorial shows you how to run a sample app on Kubernetes using minikube.
21+
The tutorial provides a container image that uses NGINX to echo back all the requests.
2822

2923
## {{% heading "objectives" %}}
3024

@@ -35,31 +29,34 @@ See [minikube start](https://minikube.sigs.k8s.io/docs/start/) for installation
3529
## {{% heading "prerequisites" %}}
3630

3731

38-
This tutorial provides a container image that uses NGINX to echo back all the requests.
32+
This tutorial assumes that you have already set up `minikube`.
33+
See [minikube start](https://minikube.sigs.k8s.io/docs/start/) for installation instructions.
3934

35+
You also need to install `kubectl`.
36+
See [Install tools](/docs/tasks/tools/#kubectl) for installation instructions.
4037

4138

4239
<!-- lessoncontent -->
4340

4441
## Create a minikube cluster
4542

46-
1. Click **Launch Terminal**.
47-
48-
{{< kat-button >}}
49-
50-
{{< note >}}
51-
If you installed minikube locally, run `minikube start`. Before you run `minikube dashboard`, you should open a new terminal, start `minikube dashboard` there, and then switch back to the main terminal.
52-
{{< /note >}}
43+
```shell
44+
minikube start
45+
```
5346

54-
2. Open the Kubernetes dashboard in a browser:
47+
## Open the Dashboard
5548

56-
```shell
57-
minikube dashboard
58-
```
49+
Open the Kubernetes dashboard. You can do this two different ways:
5950

60-
3. Katacoda environment only: At the top of the terminal pane, click the plus sign, and then click **Select port to view on Host 1**.
51+
{{< tabs name="dashboard" >}}
52+
{{% tab name="Launch a browser" %}}
53+
Open a **new** terminal, and run:
54+
```shell
55+
# Start a new terminal, and leave this running.
56+
minikube dashboard
57+
```
6158

62-
4. Katacoda environment only: Type `30000`, and then click **Display Port**.
59+
Now, switch back to the terminal where you ran `minikube start`.
6360

6461
{{< note >}}
6562
The `dashboard` command enables the dashboard add-on and opens the proxy in the default web browser.
@@ -75,14 +72,24 @@ After the command exits, the dashboard remains running in the Kubernetes cluster
7572
You can run the `dashboard` command again to create another proxy to access the dashboard.
7673
{{< /note >}}
7774

78-
## Open Dashboard with URL
75+
{{% /tab %}}
76+
{{% tab name="URL copy and paste" %}}
7977

80-
If you don't want to open a web browser, run the dashboard command with the `--url` flag to emit a URL:
78+
If you don't want minikube to open a web browser fr you, run the dashboard command with the
79+
`--url` flag. `minikube` outputs a URL that you can open in the browser you prefer:
8180

81+
```
82+
Open a **new** terminal, and run:
8283
```shell
84+
# Start a new terminal, and leave this running.
8385
minikube dashboard --url
8486
```
8587

88+
Now, switch back to the terminal where you ran `minikube start`.
89+
90+
{{% /tab %}}
91+
{{< /tabs >}}
92+
8693
## Create a Deployment
8794

8895
A Kubernetes [*Pod*](/docs/concepts/workloads/pods/) is a group of one or more Containers,
@@ -92,8 +99,6 @@ tutorial has only one Container. A Kubernetes
9299
Pod and restarts the Pod's Container if it terminates. Deployments are the
93100
recommended way to manage the creation and scaling of Pods.
94101

95-
1. Katacoda environment only: At the top of the terminal pane, click the plus sign, and then click **Open New Terminal**.
96-
97102
1. Use the `kubectl create` command to create a Deployment that manages a Pod. The
98103
Pod runs a Container based on the provided Docker image.
99104

@@ -187,10 +192,6 @@ Kubernetes [*Service*](/docs/concepts/services-networking/service/).
187192
minikube service hello-node
188193
```
189194

190-
4. Katacoda environment only: Click the plus sign, and then click **Select port to view on Host 1**.
191-
192-
5. Katacoda environment only: Note the 5-digit port number displayed opposite to `8080` in services output. This port number is randomly generated and it can be different for you. Type your number in the port number text box, then click Display Port. Using the example from earlier, you would type `30369`.
193-
194195
This opens up a browser window that serves your app and shows the app's response.
195196
196197
## Enable addons
@@ -287,7 +288,7 @@ kubectl delete service hello-node
287288
kubectl delete deployment hello-node
288289
```
289290
290-
Optionally, stop the Minikube virtual machine (VM):
291+
Stop the minikube cluster:
291292
292293
```shell
293294
minikube stop
@@ -296,10 +297,11 @@ minikube stop
296297
Optionally, delete the Minikube VM:
297298
298299
```shell
300+
# Optional
299301
minikube delete
300302
```
301303
302-
304+
If you want to use minikube again to learn more about Kubernetes, you don't need to delete it.
303305

304306
## {{% heading "whatsnext" %}}
305307

0 commit comments

Comments
 (0)