Skip to content

Issue with /docs/tutorials/kubernetes-basics/expose-interactive/ #2907

Closed
@huyz

Description

This is a...

  • Feature Request
  • Bug Report

Problem:
Step 1 of "Kubernetes Bootcamp - Module 4" is confusing. I'm left more confused than when I started.

Proposed Solution:

Step 1 in the tutorial needs a lot more explanation:

  • what's a cluster IP? who can see the the cluster IP?

  • what's an external IP? who can see the external IP? The tutorial says external IP is "(the IP of the Node)"; why then does the output say "<nodes>" instead of just listing an IP address? What does "<nodes>" mean? does that mean a service has multiple IP addresses and how does that make sense?

  • in the beginning of the tutorial, the service was exposed as port 8080. So then why are we "curl"ing on port "$NODE_PORT" which is different? The text even says "Now we can test that the app is exposed outside of the cluster using curl, the IP of the Node and the externally exposed port". So which port is exposed: 8080 or $NODE_PORT?

  • what is "host01"? where does that come from? why can't I curl either the cluster IP or the external IP of the service? Is either supposed to work?

  • And the page "Using a service to expose your app" doesn't help to clarify any of these issues. The page uses IP addresses 10.10.10.* and 10.10.9.* but this tutorial uses 10.0.0.* and 172.18.0.*. And the diagrams on the page aren't labeled "cluster IP", "external IP", or "node IP". So it's impossible to see what matches up between this tutorial and the page.

Page to Update:

Both:

https://kubernetes.io/docs/tutorials/kubernetes-basics/expose-intro/

and

https://kubernetes.io/docs/tutorials/kubernetes-basics/expose-interactive/

Metadata

Assignees

No one assigned

    Labels

    lifecycle/staleDenotes an issue or PR has remained open with no activity and has become stale.

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions