From ce46f1ca74181a2d0c1c591b158fca905b4b01da Mon Sep 17 00:00:00 2001 From: Tim Bannister Date: Wed, 8 Dec 2021 18:50:01 +0000 Subject: [PATCH 1/2] Move "Connecting Applications with Services" to tutorials section Co-authored-by: Rolfe Dlugy-Hegwer --- content/en/docs/concepts/services-networking/_index.md | 4 ++-- .../docs/concepts/services-networking/endpoint-slices.md | 2 +- .../concepts/services-networking/service-traffic-policy.md | 2 +- content/en/docs/concepts/services-networking/service.md | 2 +- .../concepts/services-networking/topology-aware-hints.md | 2 +- .../create-external-load-balancer.md | 2 +- .../service-access-application-cluster.md | 7 +++---- .../tasks/administer-cluster/enabling-service-topology.md | 3 +-- content/en/docs/tutorials/_index.md | 1 + .../tutorials/kubernetes-basics/expose/expose-intro.html | 2 +- .../services}/connect-applications-service.md | 6 +++--- content/en/docs/tutorials/services/source-ip.md | 4 ++-- .../stateless-application/expose-external-ip-address.md | 2 +- .../en/docs/tutorials/stateless-application/guestbook.md | 2 +- static/_redirects | 3 ++- 15 files changed, 22 insertions(+), 22 deletions(-) rename content/en/docs/{concepts/services-networking => tutorials/services}/connect-applications-service.md (99%) diff --git a/content/en/docs/concepts/services-networking/_index.md b/content/en/docs/concepts/services-networking/_index.md index f1cdbd5ed5..02c0a993db 100644 --- a/content/en/docs/concepts/services-networking/_index.md +++ b/content/en/docs/concepts/services-networking/_index.md @@ -49,8 +49,8 @@ blind to the existence or non-existence of host ports. Kubernetes networking addresses four concerns: - Containers within a Pod [use networking to communicate](/docs/concepts/services-networking/dns-pod-service/) via loopback. - Cluster networking provides communication between different Pods. -- The [Service](/docs/concepts/services-networking/service/) resource lets you - [expose an application running in Pods](/docs/concepts/services-networking/connect-applications-service/) +- The [Service](/docs/concepts/services-networking/service/) API lets you + [expose an application running in Pods](/docs/tutorials/services/connect-applications-service/) to be reachable from outside your cluster. - [Ingress](/docs/concepts/services-networking/ingress/) provides extra functionality specifically for exposing HTTP applications, websites and APIs. diff --git a/content/en/docs/concepts/services-networking/endpoint-slices.md b/content/en/docs/concepts/services-networking/endpoint-slices.md index 5e55637ff2..ef987438bd 100644 --- a/content/en/docs/concepts/services-networking/endpoint-slices.md +++ b/content/en/docs/concepts/services-networking/endpoint-slices.md @@ -273,4 +273,4 @@ networking and topology-aware routing. ## {{% heading "whatsnext" %}} -* Read [Connecting Applications with Services](/docs/concepts/services-networking/connect-applications-service/) +* Follow the [Connecting Applications with Services](/docs/tutorials/services/connect-applications-service/) tutorial diff --git a/content/en/docs/concepts/services-networking/service-traffic-policy.md b/content/en/docs/concepts/services-networking/service-traffic-policy.md index 01bcc08223..9342da3cbc 100644 --- a/content/en/docs/concepts/services-networking/service-traffic-policy.md +++ b/content/en/docs/concepts/services-networking/service-traffic-policy.md @@ -69,4 +69,4 @@ When the [feature gate](/docs/reference/command-line-tools-reference/feature-gat * Read about [Topology Aware Hints](/docs/concepts/services-networking/topology-aware-hints) * Read about [Service External Traffic Policy](/docs/tasks/access-application-cluster/create-external-load-balancer/#preserving-the-client-source-ip) -* Read [Connecting Applications with Services](/docs/concepts/services-networking/connect-applications-service/) +* Follow the [Connecting Applications with Services](/docs/tutorials/services/connect-applications-service/) tutorial diff --git a/content/en/docs/concepts/services-networking/service.md b/content/en/docs/concepts/services-networking/service.md index 0631f019e0..56b3c8fa9e 100644 --- a/content/en/docs/concepts/services-networking/service.md +++ b/content/en/docs/concepts/services-networking/service.md @@ -1557,6 +1557,6 @@ followed by the data from the client. ## {{% heading "whatsnext" %}} -* Read [Connecting Applications with Services](/docs/concepts/services-networking/connect-applications-service/) +* Follow the [Connecting Applications with Services](/docs/tutorials/services/connect-applications-service/) tutorial * Read about [Ingress](/docs/concepts/services-networking/ingress/) * Read about [EndpointSlices](/docs/concepts/services-networking/endpoint-slices/) diff --git a/content/en/docs/concepts/services-networking/topology-aware-hints.md b/content/en/docs/concepts/services-networking/topology-aware-hints.md index 76e308aa1e..8d298d2627 100644 --- a/content/en/docs/concepts/services-networking/topology-aware-hints.md +++ b/content/en/docs/concepts/services-networking/topology-aware-hints.md @@ -159,4 +159,4 @@ zone. ## {{% heading "whatsnext" %}} -* Read [Connecting Applications with Services](/docs/concepts/services-networking/connect-applications-service/) +* Follow the [Connecting Applications with Services](/docs/tutorials/services/connect-applications-service/) tutorial diff --git a/content/en/docs/tasks/access-application-cluster/create-external-load-balancer.md b/content/en/docs/tasks/access-application-cluster/create-external-load-balancer.md index 23f6f91a2c..d0ac36881a 100644 --- a/content/en/docs/tasks/access-application-cluster/create-external-load-balancer.md +++ b/content/en/docs/tasks/access-application-cluster/create-external-load-balancer.md @@ -198,6 +198,6 @@ balancer, the control plane looks up that external IP address and populates it i ## {{% heading "whatsnext" %}} +* Follow the [Connecting Applications with Services](/docs/tutorials/services/connect-applications-service/) tutorial * Read about [Service](/docs/concepts/services-networking/service/) * Read about [Ingress](/docs/concepts/services-networking/ingress/) -* Read [Connecting Applications with Services](/docs/concepts/services-networking/connect-applications-service/) diff --git a/content/en/docs/tasks/access-application-cluster/service-access-application-cluster.md b/content/en/docs/tasks/access-application-cluster/service-access-application-cluster.md index 1aac479563..c0d964bd9c 100644 --- a/content/en/docs/tasks/access-application-cluster/service-access-application-cluster.md +++ b/content/en/docs/tasks/access-application-cluster/service-access-application-cluster.md @@ -153,7 +153,6 @@ the Hello World application, enter this command: ## {{% heading "whatsnext" %}} - -Learn more about -[connecting applications with services](/docs/concepts/services-networking/connect-applications-service/). - +Follow the +[Connecting Applications with Services](/docs/tutorials/services/connect-applications-service/) +tutorial. diff --git a/content/en/docs/tasks/administer-cluster/enabling-service-topology.md b/content/en/docs/tasks/administer-cluster/enabling-service-topology.md index 8fd39a7e50..550772d80c 100644 --- a/content/en/docs/tasks/administer-cluster/enabling-service-topology.md +++ b/content/en/docs/tasks/administer-cluster/enabling-service-topology.md @@ -50,6 +50,5 @@ To enable service topology, enable the `ServiceTopology` * Read about [Topology Aware Hints](/docs/concepts/services-networking/topology-aware-hints/), the replacement for the `topologyKeys` field. * Read about [EndpointSlices](/docs/concepts/services-networking/endpoint-slices/) * Read about the [Service Topology](/docs/concepts/services-networking/service-topology/) concept -* Read [Connecting Applications with Services](/docs/concepts/services-networking/connect-applications-service/) - +* Read [Connecting Applications with Services](/docs/tutorials/services/connect-applications-service/) diff --git a/content/en/docs/tutorials/_index.md b/content/en/docs/tutorials/_index.md index 01bb9a6552..61dfc8fe37 100644 --- a/content/en/docs/tutorials/_index.md +++ b/content/en/docs/tutorials/_index.md @@ -49,6 +49,7 @@ Before walking through each tutorial, you may want to bookmark the ## Services +* [Connecting Applications with Services](/docs/tutorials/services/connect-applications-service/) * [Using Source IP](/docs/tutorials/services/source-ip/) ## Security diff --git a/content/en/docs/tutorials/kubernetes-basics/expose/expose-intro.html b/content/en/docs/tutorials/kubernetes-basics/expose/expose-intro.html index a826fbd18f..680c45bdad 100644 --- a/content/en/docs/tutorials/kubernetes-basics/expose/expose-intro.html +++ b/content/en/docs/tutorials/kubernetes-basics/expose/expose-intro.html @@ -37,7 +37,7 @@ weight: 10
  • 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 (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.
    • -

    More information about the different types of Services can be found in the Using Source IP tutorial. Also see Connecting Applications with Services.

    +

    More information about the different types of Services can be found in the Using Source IP tutorial. Also see Connecting Applications with Services.

    Additionally, note that there are some use cases with Services that involve not defining a selector in the spec. A Service created without selector will also not create the corresponding Endpoints object. This allows users to manually map a Service to specific endpoints. Another possibility why there may be no selector is you are strictly using type: ExternalName.

    diff --git a/content/en/docs/concepts/services-networking/connect-applications-service.md b/content/en/docs/tutorials/services/connect-applications-service.md similarity index 99% rename from content/en/docs/concepts/services-networking/connect-applications-service.md rename to content/en/docs/tutorials/services/connect-applications-service.md index 631ff44ae2..dfa3023063 100644 --- a/content/en/docs/concepts/services-networking/connect-applications-service.md +++ b/content/en/docs/tutorials/services/connect-applications-service.md @@ -4,8 +4,8 @@ reviewers: - lavalamp - thockin title: Connecting Applications with Services -content_type: concept -weight: 40 +content_type: tutorial +weight: 20 --- @@ -17,7 +17,7 @@ Now that you have a continuously running, replicated application you can expose Kubernetes assumes that pods can communicate with other pods, regardless of which host they land on. Kubernetes gives every pod its own cluster-private IP address, so you do not need to explicitly create links between pods or map container ports to host ports. This means that containers within a Pod can all reach each other's ports on localhost, and all pods in a cluster can see each other without NAT. The rest of this document elaborates on how you can run reliable services on such a networking model. -This guide uses a simple nginx server to demonstrate proof of concept. +This tutorial uses a simple nginx web server to demonstrate the concept. diff --git a/content/en/docs/tutorials/services/source-ip.md b/content/en/docs/tutorials/services/source-ip.md index 5639b982c1..ddcdd861c6 100644 --- a/content/en/docs/tutorials/services/source-ip.md +++ b/content/en/docs/tutorials/services/source-ip.md @@ -2,7 +2,7 @@ title: Using Source IP content_type: tutorial min-kubernetes-server-version: v1.5 -weight: 10 +weight: 40 --- @@ -416,5 +416,5 @@ kubectl delete deployment source-ip-app ## {{% heading "whatsnext" %}} -* Learn more about [connecting applications via services](/docs/concepts/services-networking/connect-applications-service/) +* Learn more about [connecting applications via services](/docs/tutorials/services/connect-applications-service/) * Read how to [Create an External Load Balancer](/docs/tasks/access-application-cluster/create-external-load-balancer/) diff --git a/content/en/docs/tutorials/stateless-application/expose-external-ip-address.md b/content/en/docs/tutorials/stateless-application/expose-external-ip-address.md index 5b01913859..8603fd39da 100644 --- a/content/en/docs/tutorials/stateless-application/expose-external-ip-address.md +++ b/content/en/docs/tutorials/stateless-application/expose-external-ip-address.md @@ -175,4 +175,4 @@ kubectl delete deployment hello-world ## {{% heading "whatsnext" %}} Learn more about -[connecting applications with services](/docs/concepts/services-networking/connect-applications-service/). +[connecting applications with services](/docs/tutorials/services/connect-applications-service/). diff --git a/content/en/docs/tutorials/stateless-application/guestbook.md b/content/en/docs/tutorials/stateless-application/guestbook.md index 78e19ad34a..82c43e6edc 100644 --- a/content/en/docs/tutorials/stateless-application/guestbook.md +++ b/content/en/docs/tutorials/stateless-application/guestbook.md @@ -418,5 +418,5 @@ labels to delete multiple resources with one command. * Complete the [Kubernetes Basics](/docs/tutorials/kubernetes-basics/) Interactive Tutorials * Use Kubernetes to create a blog using [Persistent Volumes for MySQL and Wordpress](/docs/tutorials/stateful-application/mysql-wordpress-persistent-volume/#visit-your-new-wordpress-blog) -* Read more about [connecting applications](/docs/concepts/services-networking/connect-applications-service/) +* Read more about [connecting applications with services](/docs/tutorials/services/connect-applications-service/) * Read more about [Managing Resources](/docs/concepts/cluster-administration/manage-deployment/#using-labels-effectively) diff --git a/static/_redirects b/static/_redirects index e3f37a2545..06da29f58d 100644 --- a/static/_redirects +++ b/static/_redirects @@ -120,6 +120,7 @@ /docs/concepts/jobs/run-to-completion-finite-workloads/ /docs/concepts/workloads/controllers/job/ 301 /id/docs/concepts/jobs/run-to-completion-finite-workloads/ /id/docs/concepts/workloads/controllers/job/ 301 /docs/concepts/nodes/node/ /docs/concepts/architecture/nodes/ 301 +/docs/concepts/services-networking/connect-applications-service/ /docs/tutorials/services/connect-applications-service/ 301 /docs/concepts/object-metadata/annotations/ /docs/concepts/overview/working-with-objects/annotations/ 301 /docs/concepts/overview/ /docs/concepts/overview/what-is-kubernetes/ 301 /docs/concepts/overview/extending/ /docs/concepts/extend-kubernetes/ 301 @@ -393,7 +394,7 @@ /docs/user-guide/configmap/ /docs/tasks/configure-pod-container/configure-pod-configmap/ 301 /docs/user-guide/configmap/README/ /docs/tasks/configure-pod-container/configure-pod-configmap/ 301 /docs/user-guide/configuring-containers/ /docs/tasks/configure-pod-container/configure-pod-configmap/ 301 -/docs/user-guide/connecting-applications/ /docs/concepts/services-networking/connect-applications-service/ 301 +/docs/user-guide/connecting-applications/ /docs/tutorials/services/connect-applications-service/ 301 /docs/user-guide/connecting-to-applications-port-forward/ /docs/tasks/access-application-cluster/port-forward-access-application-cluster/ 301 /docs/user-guide/connecting-to-applications-proxy/ /docs/tasks/access-kubernetes-api/http-proxy-access-api/ 301 /docs/user-guide/container-environment/ /docs/concepts/containers/container-lifecycle-hooks/ 301 From ceb46ca01fc8e8335c4be6b714dd78d3464f7cd5 Mon Sep 17 00:00:00 2001 From: Tim Bannister Date: Fri, 4 Nov 2022 12:30:03 +0000 Subject: [PATCH 2/2] Link from Services concept index to Service tutorial --- content/en/docs/concepts/services-networking/_index.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/content/en/docs/concepts/services-networking/_index.md b/content/en/docs/concepts/services-networking/_index.md index 02c0a993db..25a59d536a 100644 --- a/content/en/docs/concepts/services-networking/_index.md +++ b/content/en/docs/concepts/services-networking/_index.md @@ -57,5 +57,7 @@ Kubernetes networking addresses four concerns: - You can also use Services to [publish services only for consumption inside your cluster](/docs/concepts/services-networking/service-traffic-policy/). +The [Connecting Applications with Services](/docs/tutorials/services/connect-applications-service/) tutorial lets you learn about Services and Kubernetes networking with a hands-on example. + [Cluster Networking](/docs/concepts/cluster-administration/networking/) explains how to set up networking for your cluster, and also provides an overview of the technologies involved.