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.

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

Improve "Deploying apps" section of "Getting Started" guide #7748

Merged
merged 5 commits into from
Apr 18, 2020
Merged

Improve "Deploying apps" section of "Getting Started" guide #7748

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
fce7ec3
Getting started: improve LoadBalancer text
tstromberg Apr 17, 2020
6eade99
Update _index.md
tstromberg Apr 17, 2020
29d5545
Clarify LoadBalancer text
tstromberg Apr 17, 2020
f6b2c74
Sharpen LoadBalancer text
tstromberg Apr 17, 2020
2876509
Decrease size of "LoadBalancer deployments"
tstromberg Apr 18, 2020
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
30 changes: 22 additions & 8 deletions site/content/en/docs/start/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -115,32 +115,46 @@ kubectl create deployment hello-minikube --image=k8s.gcr.io/echoserver:1.4
kubectl expose deployment hello-minikube --type=NodePort --port=8080
```

Find your cluster IP:
It may take a moment, but your deployment will soon show up when you run:

```shell
minikube ip
kubectl get services hello-minikube
```

Either navigate to <your ip>:8080 in your web browser, or let minikube do it for you:
The easiest way to access this service is to let minikube launch a web browser for you:

```shell
minikube service hello-minikube
```

To access a LoadBalancer application, use the "minikube tunnel" feature. Here is an example deployment:
Alternatively, use kubectl to forward the port:

```shell
kubectl port-forward service/hello-minikube 8780:8080
```

Tada! Your application is now available at [http://localhost:7080/](http://localhost:7080/)

### LoadBalancer deployments

To access a LoadBalancer deployment, use the "minikube tunnel" command. Here is an example deployment:

```shell
kubectl create deployment balanced --image=k8s.gcr.io/echoserver:1.4
kubectl expose deployment balanced --type=LoadBalancer --port=8081
kubectl expose deployment balanced --type=LoadBalancer --port=8000
```

In another window, start the tunnel to create a routable IP for the deployment:
In another window, start the tunnel to create a routable IP for the 'balanced' deployment:

```shell
minikube tunnel
```

Access the application using the "service" command, or your web browser. If you are using macOS, minikube will also forward DNS requests for you: [http://balanced.default.svc.cluster.local:8081/](http://balanced.default.svc.cluster.local:8081/)
To find the routable IP, run this command and examine the `EXTERNAL-IP` column:

`kubectl get services balanced`

Your deployment is now available at <EXTERNAL-IP>:8000

<h2 class="step"><span class="fa-stack fa-1x"><i class="fa fa-circle fa-stack-2x"></i><strong class="fa-stack-1x text-primary">5</strong></span>Manage your cluster</h2>

Expand Down Expand Up @@ -187,4 +201,4 @@ minikube delete --all
* [Community-contributed tutorials]({{<ref "/docs/tutorials">}})
* [minikube command reference]({{<ref "/docs/commands">}})
* [Contributors guide]({{<ref "/docs/contrib">}})
* Take our [fast 5-question survey](https://forms.gle/Gg3hG5ZySw8c1C24A) to share your thoughts 🙏
* Take our [fast 5-question survey](https://forms.gle/Gg3hG5ZySw8c1C24A) to share your thoughts 🙏