add en pages

This commit is contained in:
Karen Bradshaw
2020-05-30 15:10:23 -04:00
parent 1502e0281d
commit ecc27bbbe7
347 changed files with 2900 additions and 2537 deletions
@@ -1,17 +1,17 @@
---
title: Accessing Clusters
weight: 20
content_template: templates/concept
content_type: concept
---
{{% capture overview %}}
<!-- overview -->
This topic discusses multiple ways to interact with clusters.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Accessing for the first time with kubectl
@@ -376,4 +376,3 @@ There are several different proxies you may encounter when using Kubernetes:
Kubernetes users will typically not need to worry about anything other than the first two types. The cluster admin
will typically ensure that the latter types are setup correctly.
{{% /capture %}}
@@ -1,25 +1,26 @@
---
title: Communicate Between Containers in the Same Pod Using a Shared Volume
content_template: templates/task
content_type: task
weight: 110
---
{{% capture overview %}}
<!-- overview -->
This page shows how to use a Volume to communicate between two Containers running
in the same Pod. See also how to allow processes to communicate by [sharing process namespace](/docs/tasks/configure-pod-container/share-process-namespace/) between containers.
{{% /capture %}}
{{% capture prerequisites %}}
## {{% heading "prerequisites" %}}
{{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}
{{% /capture %}}
{{% capture steps %}}
<!-- steps -->
## Creating a Pod that runs two Containers
@@ -108,10 +109,10 @@ The output shows that nginx serves a web page written by the debian container:
Hello from the debian container
{{% /capture %}}
{{% capture discussion %}}
<!-- discussion -->
## Discussion
@@ -127,10 +128,11 @@ The Volume in this exercise provides a way for Containers to communicate during
the life of the Pod. If the Pod is deleted and recreated, any data stored in
the shared Volume is lost.
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* Learn more about
[patterns for composite containers](https://kubernetes.io/blog/2015/06/the-distributed-system-toolkit-patterns).
@@ -147,7 +149,7 @@ the shared Volume is lost.
* See [Pod](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#pod-v1-core).
{{% /capture %}}
@@ -1,6 +1,6 @@
---
title: Configure Access to Multiple Clusters
content_template: templates/task
content_type: task
weight: 30
card:
name: tasks
@@ -8,7 +8,7 @@ card:
---
{{% capture overview %}}
<!-- overview -->
This page shows how to configure access to multiple clusters by using
configuration files. After your clusters, users, and contexts are defined in
@@ -21,15 +21,16 @@ a *kubeconfig file*. This is a generic way of referring to configuration files.
It does not mean that there is a file named `kubeconfig`.
{{< /note >}}
{{% /capture %}}
{{% capture prerequisites %}}
## {{% heading "prerequisites" %}}
{{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}
{{% /capture %}}
{{% capture steps %}}
<!-- steps -->
## Define clusters, users, and contexts
@@ -369,14 +370,15 @@ export KUBECONFIG=$KUBECONFIG_SAVED
$Env:KUBECONFIG=$ENV:KUBECONFIG_SAVED
```
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* [Organizing Cluster Access Using kubeconfig Files](/docs/concepts/configuration/organize-cluster-access-kubeconfig/)
* [kubectl config](/docs/reference/generated/kubectl/kubectl-commands#config)
{{% /capture %}}
@@ -3,27 +3,28 @@ reviewers:
- bprashanth
- davidopp
title: Configure Your Cloud Provider's Firewalls
content_template: templates/task
content_type: task
weight: 90
---
{{% capture overview %}}
<!-- overview -->
Many cloud providers (e.g. Google Compute Engine) define firewalls that help prevent inadvertent
exposure to the internet. When exposing a service to the external world, you may need to open up
one or more ports in these firewalls to serve traffic. This document describes this process, as
well as any provider specific details that may be necessary.
{{% /capture %}}
{{% capture prerequisites %}}
## {{% heading "prerequisites" %}}
{{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}
{{% /capture %}}
{{% capture steps %}}
<!-- steps -->
## Restrict Access For LoadBalancer Service
@@ -106,4 +107,4 @@ the wilds of the internet.
{{< /note >}}
{{% /capture %}}
@@ -1,13 +1,13 @@
---
title: Configure DNS for a Cluster
weight: 120
content_template: templates/concept
content_type: concept
---
{{% capture overview %}}
<!-- overview -->
Kubernetes offers a DNS cluster addon, which most of the supported environments enable by default. In Kubernetes version 1.11 and later, CoreDNS is recommended and is installed by default with kubeadm.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
For more information on how to configure CoreDNS for a Kubernetes cluster, see the [Customizing DNS Service](/docs/tasks/administer-cluster/dns-custom-nameservers/). An example demonstrating how to use Kubernetes DNS with kube-dns, see the [Kubernetes DNS sample plugin](https://github.com/kubernetes/examples/tree/master/staging/cluster-dns).
{{% /capture %}}
@@ -1,30 +1,32 @@
---
title: Connect a Front End to a Back End Using a Service
content_template: templates/tutorial
content_type: tutorial
weight: 70
---
{{% capture overview %}}
<!-- overview -->
This task shows how to create a frontend and a backend
microservice. The backend microservice is a hello greeter. The
frontend and backend are connected using a Kubernetes
{{< glossary_tooltip term_id="service" >}} object.
{{% /capture %}}
{{% capture objectives %}}
## {{% heading "objectives" %}}
* Create and run a microservice using a {{< glossary_tooltip term_id="deployment" >}} object.
* Route traffic to the backend using a frontend.
* Use a Service object to connect the frontend application to the
backend application.
{{% /capture %}}
{{% capture prerequisites %}}
## {{% heading "prerequisites" %}}
* {{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}
@@ -34,10 +36,10 @@ frontend and backend are connected using a Kubernetes
support this, you can use a Service of type
[NodePort](/docs/concepts/services-networking/service/#nodeport) instead.
{{% /capture %}}
{{% capture lessoncontent %}}
<!-- lessoncontent -->
## Creating the backend using a Deployment
@@ -201,9 +203,10 @@ The output shows the message generated by the backend:
{"message":"Hello"}
```
{{% /capture %}}
{{% capture cleanup %}}
## {{% heading "cleanup" %}}
To delete the Services, enter this command:
@@ -213,13 +216,14 @@ To delete the Deployments, the ReplicaSets and the Pods that are running the bac
kubectl delete deployment frontend hello
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* Learn more about [Services](/docs/concepts/services-networking/service/)
* Learn more about [ConfigMaps](/docs/tasks/configure-pod-container/configure-pod-configmap/)
{{% /capture %}}
@@ -1,11 +1,11 @@
---
title: Create an External Load Balancer
content_template: templates/task
content_type: task
weight: 80
---
{{% capture overview %}}
<!-- overview -->
This page shows how to create an External Load Balancer.
@@ -24,15 +24,16 @@ services externally-reachable URLs, load balance the traffic, terminate SSL etc.
please check the [Ingress](/docs/concepts/services-networking/ingress/)
documentation.
{{% /capture %}}
{{% capture prerequisites %}}
## {{% heading "prerequisites" %}}
* {{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}
{{% /capture %}}
{{% capture steps %}}
<!-- steps -->
## Configuration file
@@ -199,4 +200,4 @@ Once the external load balancers provide weights, this functionality can be adde
Internal pod to pod traffic should behave similar to ClusterIP services, with equal probability across all pods.
{{% /capture %}}
@@ -1,25 +1,26 @@
---
title: Set up Ingress on Minikube with the NGINX Ingress Controller
content_template: templates/task
content_type: task
weight: 100
---
{{% capture overview %}}
<!-- overview -->
An [Ingress](/docs/concepts/services-networking/ingress/) is an API object that defines rules which allow external access
to services in a cluster. An [Ingress controller](/docs/concepts/services-networking/ingress-controllers/) fulfills the rules set in the Ingress.
This page shows you how to set up a simple Ingress which routes requests to Service web or web2 depending on the HTTP URI.
{{% /capture %}}
{{% capture prerequisites %}}
## {{% heading "prerequisites" %}}
{{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}
{{% /capture %}}
{{% capture steps %}}
<!-- steps -->
## Create a Minikube cluster
@@ -275,13 +276,14 @@ The following file is an Ingress resource that sends traffic to your Service via
{{< note >}}If you are running Minikube locally, you can visit hello-world.info and hello-world.info/v2 from your browser.{{< /note >}}
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* Read more about [Ingress](/docs/concepts/services-networking/ingress/)
* Read more about [Ingress Controllers](/docs/concepts/services-networking/ingress-controllers/)
* Read more about [Services](/docs/concepts/services-networking/service/)
{{% /capture %}}
@@ -1,23 +1,24 @@
---
title: List All Container Images Running in a Cluster
content_template: templates/task
content_type: task
weight: 100
---
{{% capture overview %}}
<!-- overview -->
This page shows how to use kubectl to list all of the Container images
for Pods running in a cluster.
{{% /capture %}}
{{% capture prerequisites %}}
## {{% heading "prerequisites" %}}
{{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}
{{% /capture %}}
{{% capture steps %}}
<!-- steps -->
In this exercise you will use kubectl to fetch all of the Pods
running in a cluster, and format the output to pull out the list
@@ -108,19 +109,20 @@ kubectl get pods --all-namespaces -o go-template --template="{{range .items}}{{r
{{% /capture %}}
{{% capture discussion %}}
{{% /capture %}}
<!-- discussion -->
## {{% heading "whatsnext" %}}
{{% capture whatsnext %}}
### Reference
* [Jsonpath](/docs/user-guide/jsonpath/) reference guide
* [Go template](https://golang.org/pkg/text/template/) reference guide
{{% /capture %}}
@@ -1,29 +1,30 @@
---
title: Use Port Forwarding to Access Applications in a Cluster
content_template: templates/task
content_type: task
weight: 40
min-kubernetes-server-version: v1.10
---
{{% capture overview %}}
<!-- overview -->
This page shows how to use `kubectl port-forward` to connect to a Redis
server running in a Kubernetes cluster. This type of connection can be useful
for database debugging.
{{% /capture %}}
{{% capture prerequisites %}}
## {{% heading "prerequisites" %}}
* {{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}
* Install [redis-cli](http://redis.io/topics/rediscli).
{{% /capture %}}
{{% capture steps %}}
<!-- steps -->
## Creating Redis deployment and service
@@ -179,10 +180,10 @@ for database debugging.
PONG
```
{{% /capture %}}
{{% capture discussion %}}
<!-- discussion -->
## Discussion
@@ -196,9 +197,10 @@ The support for UDP protocol is tracked in
[issue 47862](https://github.com/kubernetes/kubernetes/issues/47862).
{{< /note >}}
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
Learn more about [kubectl port-forward](/docs/reference/generated/kubectl/kubectl-commands/#port-forward).
{{% /capture %}}
@@ -1,35 +1,37 @@
---
title: Use a Service to Access an Application in a Cluster
content_template: templates/tutorial
content_type: tutorial
weight: 60
---
{{% capture overview %}}
<!-- overview -->
This page shows how to create a Kubernetes Service object that external
clients can use to access an application running in a cluster. The Service
provides load balancing for an application that has two running instances.
{{% /capture %}}
{{% capture prerequisites %}}
## {{% heading "prerequisites" %}}
{{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}
{{% /capture %}}
{{% capture objectives %}}
## {{% heading "objectives" %}}
* Run two instances of a Hello World application.
* Create a Service object that exposes a node port.
* Use the Service object to access the running application.
{{% /capture %}}
{{% capture lessoncontent %}}
<!-- lessoncontent -->
## Creating a service for an application running in two pods
@@ -130,10 +132,11 @@ As an alternative to using `kubectl expose`, you can use a
[service configuration file](/docs/concepts/services-networking/service/)
to create a Service.
{{% /capture %}}
{{% capture cleanup %}}
## {{% heading "cleanup" %}}
To delete the Service, enter this command:
@@ -144,11 +147,12 @@ the Hello World application, enter this command:
kubectl delete deployment hello-world
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
Learn more about
[connecting applications with services](/docs/concepts/services-networking/connect-applications-service/).
{{% /capture %}}
@@ -4,7 +4,7 @@ reviewers:
- mikedanese
- rf232
title: Web UI (Dashboard)
content_template: templates/concept
content_type: concept
weight: 10
card:
name: tasks
@@ -12,7 +12,7 @@ card:
title: Use the Web UI Dashboard
---
{{% capture overview %}}
<!-- overview -->
Dashboard is a web-based Kubernetes user interface. You can use Dashboard to deploy containerized applications to a Kubernetes cluster, troubleshoot your containerized application, and manage the cluster resources. You can use Dashboard to get an overview of applications running on your cluster, as well as for creating or modifying individual Kubernetes resources (such as Deployments, Jobs, DaemonSets, etc). For example, you can scale a Deployment, initiate a rolling update, restart a pod or deploy new applications using a deploy wizard.
@@ -20,10 +20,10 @@ Dashboard also provides information on the state of Kubernetes resources in your
![Kubernetes Dashboard UI](/images/docs/ui-dashboard.png)
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Deploying the Dashboard UI
@@ -162,11 +162,12 @@ Pod lists and detail pages link to a logs viewer that is built into Dashboard. T
![Logs viewer](/images/docs/ui-dashboard-logs-view.png)
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
For more information, see the
[Kubernetes Dashboard project page](https://github.com/kubernetes/dashboard).
{{% /capture %}}