Skip to content
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.

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

Drop or adapt tutorials that rely on Katacoda #40306

Merged
merged 5 commits into from
Mar 31, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 0 additions & 23 deletions content/en/docs/contribute/style/style-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -385,29 +385,6 @@ The output is:
Beware.
{{< /warning >}}

### Katacoda Embedded Live Environment

This button lets users run Minikube in their browser using the Katacoda Terminal.
It lowers the barrier of entry by allowing users to use Minikube with one click instead of going through the complete
Minikube and Kubectl installation process locally.

The Embedded Live Environment is configured to run `minikube start` and lets users complete tutorials in the same window
as the documentation.

{{< caution >}}
The session is limited to 15 minutes.
{{< /caution >}}

For example:

```
{{</* kat-button */>}}
```

The output is:

{{< kat-button >}}

## Common Shortcode Issues

### Ordered Lists
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -17,17 +17,16 @@ This page shows you how to set up a simple Ingress which routes requests to Serv

## {{% heading "prerequisites" %}}

This tutorial assumes that you are using `minikube` to run a local Kubernetes cluster.
Visit [Install tools](/docs/tasks/tools/#minikube) to learn how to install `minikube`.

{{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}
If you are using an older Kubernetes version, switch to the documentation for that version.

### Create a Minikube cluster
### Create a minikube cluster

Using Katacoda
: {{< kat-button >}}
If you haven't already set up a cluster locally, run `minikube start` to create a cluster.

Locally
: If you already [installed Minikube](/docs/tasks/tools/#minikube)
locally, run `minikube start` to create a cluster.

<!-- steps -->

Expand All @@ -41,10 +40,6 @@ Locally

1. Verify that the NGINX Ingress controller is running


{{< tabs name="tab_with_md" >}}
{{% tab name="minikube v1.19 or later" %}}

```shell
kubectl get pods -n ingress-nginx
```
Expand All @@ -61,35 +56,6 @@ Locally
ingress-nginx-admission-patch-rqp78 0/1 Completed 1 11m
ingress-nginx-controller-59b45fb494-26npt 1/1 Running 0 11m
```
{{% /tab %}}

{{% tab name="minikube v1.18.1 or earlier" %}}

```shell
kubectl get pods -n kube-system
```

{{< note >}}
It can take up to a minute before you see these pods running OK.
{{< /note >}}

The output is similar to:

```none
NAME READY STATUS RESTARTS AGE
default-http-backend-59868b7dd6-xb8tq 1/1 Running 0 1m
kube-addon-manager-minikube 1/1 Running 0 3m
kube-dns-6dcb57bcc8-n4xd4 3/3 Running 0 2m
kubernetes-dashboard-5498ccf677-b8p5h 1/1 Running 0 2m
nginx-ingress-controller-5984b97644-rnkrg 1/1 Running 0 1m
storage-provisioner 1/1 Running 0 2m
```

Make sure that you see a Pod with a name that starts with `nginx-ingress-controller-`.

{{% /tab %}}

{{< /tabs >}}

## Deploy a hello, world app

Expand Down Expand Up @@ -142,12 +108,6 @@ Locally
http://172.17.0.15:31637
```

{{< note >}}
Katacoda environment only: at the top of the terminal panel, click the plus sign,
and then click **Select port to view on Host 1**. Enter the NodePort value,
in this case `31637`, and then click **Display Port**.
{{< /note >}}

The output is similar to:

```none
Expand Down Expand Up @@ -197,25 +157,11 @@ The following manifest defines an Ingress that sends traffic to your Service via
example-ingress <none> hello-world.info 172.17.0.15 80 38s
```

1. Add the following line to the bottom of the `/etc/hosts` file on
your computer (you will need administrator access):

```none
172.17.0.15 hello-world.info
```

{{< note >}}
If you are running Minikube locally, use `minikube ip` to get the external IP.
The IP address displayed within the ingress list will be the internal IP.
{{< /note >}}

After you make this change, your web browser sends requests for
`hello-world.info` URLs to Minikube.

1. Verify that the Ingress controller is directing traffic:

```shell
curl hello-world.info
curl --resolve "hello-world.info:80:$( minikube ip )" -i http://hello-world.info
```

You should see:
Expand All @@ -226,9 +172,27 @@ The following manifest defines an Ingress that sends traffic to your Service via
Hostname: web-55b8c6998d-8k564
```

{{< note >}}
If you are running Minikube locally, you can visit `hello-world.info` from your browser.
{{< /note >}}
You can also visit `hello-world.info` from your browser.

* **Optionally**
Look up the external IP address as reported by minikube:
```shell
minikube ip
```

Add line similar to the following one to the bottom of the `/etc/hosts` file on
your computer (you will need administrator access):

```none
172.17.0.15 hello-world.info
```

{{< note >}}
Change the IP address to match the output from `minikube ip`.
{{< /note >}}

After you make this change, your web browser sends requests for
`hello-world.info` URLs to Minikube.

## Create a second Deployment

Expand Down Expand Up @@ -288,7 +252,7 @@ The following manifest defines an Ingress that sends traffic to your Service via
1. Access the 1st version of the Hello World app.

```shell
curl hello-world.info
curl --resolve "hello-world.info:80:$( minikube ip )" -i http://hello-world.info
```

The output is similar to:
Expand All @@ -302,7 +266,7 @@ The following manifest defines an Ingress that sends traffic to your Service via
1. Access the 2nd version of the Hello World app.

```shell
curl hello-world.info/v2
curl --resolve "hello-world.info:80:$( minikube ip )" -i http://hello-world.info/v2
```

The output is similar to:
Expand All @@ -314,7 +278,7 @@ The following manifest defines an Ingress that sends traffic to your Service via
```

{{< note >}}
If you are running Minikube locally, you can visit `hello-world.info` and
If you did the optional step to update `/etc/hosts`, you can also visit `hello-world.info` and
`hello-world.info/v2` from your browser.
{{< /note >}}

Expand Down
Original file line number Diff line number Diff line change
@@ -1,26 +1,34 @@
---
title: "Interactive Tutorial - Configuring a Java Microservice"
title: "Tutorial - Configuring a Java Microservice"
weight: 20
headless: true
toc_hide: true
_build:
list: never
publishResources: false
---

{{% katacoda-removal %}}

<!DOCTYPE html>

<html lang="en">

<body>

<link href="/docs/tutorials/kubernetes-basics/public/css/styles.css" rel="stylesheet">
<link href="/docs/tutorials/kubernetes-basics/public/css/overrides.css" rel="stylesheet">
{{< katacoda-tutorial >}}

<div class="layout" id="top">

<main class="content katacoda-content">
<div class="katacoda">
<div class="katacoda__box" id="inline-terminal-1" data-katacoda-id="kubernetes-bootcamp/9" data-katacoda-color="326de6" data-katacoda-secondary="273d6d" data-katacoda-hideintro="false" data-katacoda-prompt="Kubernetes Bootcamp Terminal" style="height: 600px;"></div>
<div>
<h2 class="katacoda-gone">
Content unavailable
</h2>
<p>
The interactive tutorial for creating a cluster is not available.
For more information, see the
<a href="https://kubernetes.io/blog/2023/02/14/kubernetes-katacoda-tutorials-stop-from-2023-03-31/">
shutdown announcement</a>.
</p>
</div>

</main>

</div>
Expand Down
Loading