Add trailing slashes to reduce redirects. (#5592)
This commit is contained in:
@@ -13,7 +13,7 @@ This section describes all the possible configurations which can
|
|||||||
be used when running Kubernetes on Amazon Web Services.
|
be used when running Kubernetes on Amazon Web Services.
|
||||||
|
|
||||||
## Load Balancers
|
## Load Balancers
|
||||||
You can setup [external load balancers](/docs/tasks/access-application-cluster/create-external-load-balancer)
|
You can setup [external load balancers](/docs/tasks/access-application-cluster/create-external-load-balancer/)
|
||||||
to use specific features in AWS by configuring the annotations as shown below.
|
to use specific features in AWS by configuring the annotations as shown below.
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
|
|||||||
@@ -18,23 +18,23 @@ See the guides in [Picking the Right Solution](/docs/setup/pick-right-solution/)
|
|||||||
Before choosing a guide, here are some considerations:
|
Before choosing a guide, here are some considerations:
|
||||||
|
|
||||||
- Do you just want to try out Kubernetes on your computer, or do you want to build a high-availability, multi-node cluster? Choose distros best suited for your needs.
|
- Do you just want to try out Kubernetes on your computer, or do you want to build a high-availability, multi-node cluster? Choose distros best suited for your needs.
|
||||||
- **If you are designing for high-availability**, learn about configuring [clusters in multiple zones](/docs/admin/multi-cluster).
|
- **If you are designing for high-availability**, learn about configuring [clusters in multiple zones](/docs/admin/multi-cluster/).
|
||||||
- Will you be using **a hosted Kubernetes cluster**, such as [Google Container Engine (GKE)](https://cloud.google.com/container-engine/), or **hosting your own cluster**?
|
- Will you be using **a hosted Kubernetes cluster**, such as [Google Container Engine (GKE)](https://cloud.google.com/container-engine/), or **hosting your own cluster**?
|
||||||
- Will your cluster be **on-premises**, or **in the cloud (IaaS)**? Kubernetes does not directly support hybrid clusters. Instead, you can set up multiple clusters.
|
- Will your cluster be **on-premises**, or **in the cloud (IaaS)**? Kubernetes does not directly support hybrid clusters. Instead, you can set up multiple clusters.
|
||||||
- **If you are configuring Kubernetes on-premises**, consider which [networking model](/docs/admin/networking) fits best. One option for custom networking is [*OpenVSwitch GRE/VxLAN networking*](/docs/admin/ovs-networking/), which uses OpenVSwitch to set up networking between pods across Kubernetes nodes.
|
- **If you are configuring Kubernetes on-premises**, consider which [networking model](/docs/admin/networking/) fits best. One option for custom networking is [*OpenVSwitch GRE/VxLAN networking*](/docs/admin/ovs-networking/), which uses OpenVSwitch to set up networking between pods across Kubernetes nodes.
|
||||||
- Will you be running Kubernetes on **"bare metal" hardware** or on **virtual machines (VMs)**?
|
- Will you be running Kubernetes on **"bare metal" hardware** or on **virtual machines (VMs)**?
|
||||||
- Do you **just want to run a cluster**, or do you expect to do **active development of Kubernetes project code**? If the
|
- Do you **just want to run a cluster**, or do you expect to do **active development of Kubernetes project code**? If the
|
||||||
latter, choose a actively-developed distro. Some distros only use binary releases, but
|
latter, choose a actively-developed distro. Some distros only use binary releases, but
|
||||||
offer a greater variety of choices.
|
offer a greater variety of choices.
|
||||||
- Familiarize yourself with the [components](/docs/admin/cluster-components) needed to run a cluster.
|
- Familiarize yourself with the [components](/docs/admin/cluster-components/) needed to run a cluster.
|
||||||
|
|
||||||
Note: Not all distros are actively maintained. Choose distros which have been tested with a recent version of Kubernetes.
|
Note: Not all distros are actively maintained. Choose distros which have been tested with a recent version of Kubernetes.
|
||||||
|
|
||||||
If you are using a guide involving Salt, see [Configuring Kubernetes with Salt](/docs/admin/salt).
|
If you are using a guide involving Salt, see [Configuring Kubernetes with Salt](/docs/admin/salt/).
|
||||||
|
|
||||||
## Managing a cluster
|
## Managing a cluster
|
||||||
|
|
||||||
* [Managing a cluster](/docs/concepts/cluster-administration/cluster-management/) describes several topics related to the lifecycle of a cluster: creating a new cluster, upgrading your cluster’s master and worker nodes, performing node maintenance (e.g. kernel upgrades), and upgrading the Kubernetes API version of a running cluster..
|
* [Managing a cluster](/docs/concepts/cluster-administration/cluster-management/) describes several topics related to the lifecycle of a cluster: creating a new cluster, upgrading your cluster’s master and worker nodes, performing node maintenance (e.g. kernel upgrades), and upgrading the Kubernetes API version of a running cluster.
|
||||||
|
|
||||||
* Learn how to [manage nodes](/docs/concepts/nodes/node/).
|
* Learn how to [manage nodes](/docs/concepts/nodes/node/).
|
||||||
|
|
||||||
@@ -44,13 +44,13 @@ If you are using a guide involving Salt, see [Configuring Kubernetes with Salt](
|
|||||||
|
|
||||||
* [Kubernetes Container Environment](/docs/concepts/containers/container-environment-variables/) describes the environment for Kubelet managed containers on a Kubernetes node.
|
* [Kubernetes Container Environment](/docs/concepts/containers/container-environment-variables/) describes the environment for Kubelet managed containers on a Kubernetes node.
|
||||||
|
|
||||||
* [Controlling Access to the Kubernetes API](/docs/admin/accessing-the-api) describes how to set up permissions for users and service accounts.
|
* [Controlling Access to the Kubernetes API](/docs/admin/accessing-the-api/) describes how to set up permissions for users and service accounts.
|
||||||
|
|
||||||
* [Authenticating](/docs/admin/authentication) explains authentication in Kubernetes, including the various authentication options.
|
* [Authenticating](/docs/admin/authentication/) explains authentication in Kubernetes, including the various authentication options.
|
||||||
|
|
||||||
* [Authorization](/docs/admin/authorization) is separate from authentication, and controls how HTTP calls are handled.
|
* [Authorization](/docs/admin/authorization/) is separate from authentication, and controls how HTTP calls are handled.
|
||||||
|
|
||||||
* [Using Admission Controllers](/docs/admin/admission-controllers) explains plug-ins which intercepts requests to the Kubernetes API server after authentication and authorization.
|
* [Using Admission Controllers](/docs/admin/admission-controllers/) explains plug-ins which intercepts requests to the Kubernetes API server after authentication and authorization.
|
||||||
|
|
||||||
* [Using Sysctls in a Kubernetes Cluster](/docs/concepts/cluster-administration/sysctl-cluster/) describes to an administrator how to use the `sysctl` command-line tool to set kernel parameters .
|
* [Using Sysctls in a Kubernetes Cluster](/docs/concepts/cluster-administration/sysctl-cluster/) describes to an administrator how to use the `sysctl` command-line tool to set kernel parameters .
|
||||||
|
|
||||||
|
|||||||
@@ -19,7 +19,7 @@ This page describes the resources available to Containers in the Container envir
|
|||||||
|
|
||||||
The Kubernetes Container environment provides several important resources to Containers:
|
The Kubernetes Container environment provides several important resources to Containers:
|
||||||
|
|
||||||
* A filesystem, which is a combination of an [image](/docs/concepts/containers/images) and one or more [volumes](/docs/concepts/storage/volumes).
|
* A filesystem, which is a combination of an [image](/docs/concepts/containers/images/) and one or more [volumes](/docs/concepts/storage/volumes/).
|
||||||
* Information about the Container itself.
|
* Information about the Container itself.
|
||||||
* Information about other objects in the cluster.
|
* Information about other objects in the cluster.
|
||||||
|
|
||||||
@@ -31,7 +31,7 @@ It is available through the `hostname` command or the
|
|||||||
function call in libc.
|
function call in libc.
|
||||||
|
|
||||||
The Pod name and namespace are available as environment variables through the
|
The Pod name and namespace are available as environment variables through the
|
||||||
[downward API](/docs/tasks/configure-pod-container/downward-api-volume-expose-pod-information).
|
[downward API](/docs/tasks/configure-pod-container/downward-api-volume-expose-pod-information/).
|
||||||
|
|
||||||
User defined environment variables from the Pod definition are also available to the Container,
|
User defined environment variables from the Pod definition are also available to the Container,
|
||||||
as are any environment variables specified statically in the Docker image.
|
as are any environment variables specified statically in the Docker image.
|
||||||
|
|||||||
@@ -18,20 +18,20 @@ cluster (for example, scheduling), and detecting and responding to cluster event
|
|||||||
Master components can be run on any node in the cluster. However,
|
Master components can be run on any node in the cluster. However,
|
||||||
for simplicity, set up scripts typically start all master components on
|
for simplicity, set up scripts typically start all master components on
|
||||||
the same VM, and do not run user containers on this VM. See
|
the same VM, and do not run user containers on this VM. See
|
||||||
[Building High-Availability Clusters](/docs/admin/high-availability) for an example multi-master-VM setup.
|
[Building High-Availability Clusters](/docs/admin/high-availability/) for an example multi-master-VM setup.
|
||||||
|
|
||||||
### kube-apiserver
|
### kube-apiserver
|
||||||
|
|
||||||
[kube-apiserver](/docs/admin/kube-apiserver) exposes the Kubernetes API. It is the front-end for the
|
[kube-apiserver](/docs/admin/kube-apiserver/) exposes the Kubernetes API. It is the front-end for the
|
||||||
Kubernetes control plane. It is designed to scale horizontally -- that is, it scales by deploying more instances. See [Building High-Availability Clusters](/docs/admin/high-availability).
|
Kubernetes control plane. It is designed to scale horizontally -- that is, it scales by deploying more instances. See [Building High-Availability Clusters](/docs/admin/high-availability/).
|
||||||
|
|
||||||
### etcd
|
### etcd
|
||||||
|
|
||||||
[etcd](/docs/tasks/administer-cluster/configure-upgrade-etcd) is used as Kubernetes' backing store. All cluster data is stored here. Always have a backup plan for etcd's data for your Kubernetes cluster.
|
[etcd](/docs/tasks/administer-cluster/configure-upgrade-etcd/) is used as Kubernetes' backing store. All cluster data is stored here. Always have a backup plan for etcd's data for your Kubernetes cluster.
|
||||||
|
|
||||||
### kube-controller-manager
|
### kube-controller-manager
|
||||||
|
|
||||||
[kube-controller-manager](/docs/admin/kube-controller-manager) runs controllers, which are the background threads that handle routine tasks in the cluster. Logically, each controller is a separate process, but to reduce complexity, they are all compiled into a single binary and run in a single process.
|
[kube-controller-manager](/docs/admin/kube-controller-manager/) runs controllers, which are the background threads that handle routine tasks in the cluster. Logically, each controller is a separate process, but to reduce complexity, they are all compiled into a single binary and run in a single process.
|
||||||
|
|
||||||
These controllers include:
|
These controllers include:
|
||||||
|
|
||||||
@@ -58,7 +58,7 @@ The following controllers have cloud provider dependencies:
|
|||||||
|
|
||||||
### kube-scheduler
|
### kube-scheduler
|
||||||
|
|
||||||
[kube-scheduler](/docs/admin/kube-scheduler) watches newly created pods that have no node assigned, and
|
[kube-scheduler](/docs/admin/kube-scheduler/) watches newly created pods that have no node assigned, and
|
||||||
selects a node for them to run on.
|
selects a node for them to run on.
|
||||||
|
|
||||||
### addons
|
### addons
|
||||||
@@ -84,12 +84,12 @@ Containers started by Kubernetes automatically include this DNS server in their
|
|||||||
|
|
||||||
#### Container Resource Monitoring
|
#### Container Resource Monitoring
|
||||||
|
|
||||||
[Container Resource Monitoring](/docs/tasks/debug-application-cluster/resource-usage-monitoring) records generic time-series metrics
|
[Container Resource Monitoring](/docs/tasks/debug-application-cluster/resource-usage-monitoring/) records generic time-series metrics
|
||||||
about containers in a central database, and provides a UI for browsing that data.
|
about containers in a central database, and provides a UI for browsing that data.
|
||||||
|
|
||||||
#### Cluster-level Logging
|
#### Cluster-level Logging
|
||||||
|
|
||||||
A [Cluster-level logging](/docs/concepts/cluster-administration/logging) mechanism is responsible for
|
A [Cluster-level logging](/docs/concepts/cluster-administration/logging/) mechanism is responsible for
|
||||||
saving container logs to a central log store with search/browsing interface.
|
saving container logs to a central log store with search/browsing interface.
|
||||||
|
|
||||||
## Node components
|
## Node components
|
||||||
@@ -98,7 +98,7 @@ Node components run on every node, maintaining running pods and providing the Ku
|
|||||||
|
|
||||||
### kubelet
|
### kubelet
|
||||||
|
|
||||||
[kubelet](/docs/admin/kubelet) is the primary node agent. It watches for pods that have been assigned to its node (either by apiserver or via local configuration file) and:
|
[kubelet](/docs/admin/kubelet/) is the primary node agent. It watches for pods that have been assigned to its node (either by apiserver or via local configuration file) and:
|
||||||
|
|
||||||
* Mounts the pod's required volumes.
|
* Mounts the pod's required volumes.
|
||||||
* Downloads the pod's secrets.
|
* Downloads the pod's secrets.
|
||||||
@@ -109,7 +109,7 @@ Node components run on every node, maintaining running pods and providing the Ku
|
|||||||
|
|
||||||
### kube-proxy
|
### kube-proxy
|
||||||
|
|
||||||
[kube-proxy](/docs/admin/kube-proxy) enables the Kubernetes service abstraction by maintaining
|
[kube-proxy](/docs/admin/kube-proxy/) enables the Kubernetes service abstraction by maintaining
|
||||||
network rules on the host and performing connection forwarding.
|
network rules on the host and performing connection forwarding.
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@@ -160,7 +160,7 @@ The StatefulSet should not specify a `pod.Spec.TerminationGracePeriodSeconds` of
|
|||||||
|
|
||||||
When the nginx example above is created, three Pods will be deployed in the order
|
When the nginx example above is created, three Pods will be deployed in the order
|
||||||
web-0, web-1, web-2. web-1 will not be deployed before web-0 is
|
web-0, web-1, web-2. web-1 will not be deployed before web-0 is
|
||||||
[Running and Ready](/docs/user-guide/pod-states), and web-2 will not be deployed until
|
[Running and Ready](/docs/user-guide/pod-states/), and web-2 will not be deployed until
|
||||||
web-1 is Running and Ready. If web-0 should fail, after web-1 is Running and Ready, but before
|
web-1 is Running and Ready. If web-0 should fail, after web-1 is Running and Ready, but before
|
||||||
web-2 is launched, web-2 will not be launched until web-0 is successfully relaunched and
|
web-2 is launched, web-2 will not be launched until web-0 is successfully relaunched and
|
||||||
becomes Running and Ready.
|
becomes Running and Ready.
|
||||||
@@ -225,7 +225,7 @@ update, roll out a canary, or perform a phased roll out.
|
|||||||
{% endcapture %}
|
{% endcapture %}
|
||||||
{% capture whatsnext %}
|
{% capture whatsnext %}
|
||||||
|
|
||||||
* Follow an example of [deploying a stateful application](/docs/tutorials/stateful-application/basic-stateful-set).
|
* Follow an example of [deploying a stateful application](/docs/tutorials/stateful-application/basic-stateful-set/).
|
||||||
* Follow an example of [deploying Cassandra with Stateful Sets](/docs/tutorials/stateful-application/cassandra/).
|
* Follow an example of [deploying Cassandra with Stateful Sets](/docs/tutorials/stateful-application/cassandra/).
|
||||||
|
|
||||||
{% endcapture %}
|
{% endcapture %}
|
||||||
|
|||||||
@@ -631,7 +631,7 @@ Reboot these servers to get the images PXEd and ready for running containers!
|
|||||||
|
|
||||||
Now that the CoreOS with Kubernetes installed is up and running lets spin up some Kubernetes pods to demonstrate the system.
|
Now that the CoreOS with Kubernetes installed is up and running lets spin up some Kubernetes pods to demonstrate the system.
|
||||||
|
|
||||||
See [a simple nginx example](/docs/user-guide/simple-nginx) to try out your new cluster.
|
See [a simple nginx example](/docs/user-guide/simple-nginx/) to try out your new cluster.
|
||||||
|
|
||||||
For more complete applications, please look in the [examples directory](https://github.com/kubernetes/examples/tree/{{page.githubbranch}}/).
|
For more complete applications, please look in the [examples directory](https://github.com/kubernetes/examples/tree/{{page.githubbranch}}/).
|
||||||
|
|
||||||
@@ -683,6 +683,6 @@ for i in `kubectl get pods | awk '{print $1}'`; do kubectl delete pod $i; done
|
|||||||
|
|
||||||
IaaS Provider | Config. Mgmt | OS | Networking | Docs | Conforms | Support Level
|
IaaS Provider | Config. Mgmt | OS | Networking | Docs | Conforms | Support Level
|
||||||
-------------------- | ------------ | ------ | ---------- | --------------------------------------------- | ---------| ----------------------------
|
-------------------- | ------------ | ------ | ---------- | --------------------------------------------- | ---------| ----------------------------
|
||||||
Bare-metal (Offline) | CoreOS | CoreOS | flannel | [docs](/docs/getting-started-guides/coreos/bare_metal_offline) | | Community ([@jeffbean](https://github.com/jeffbean))
|
Bare-metal (Offline) | CoreOS | CoreOS | flannel | [docs](/docs/getting-started-guides/coreos/bare_metal_offline/) | | Community ([@jeffbean](https://github.com/jeffbean))
|
||||||
|
|
||||||
For support level information on all solutions, see the [Table of solutions](/docs/getting-started-guides/#table-of-solutions) chart.
|
For support level information on all solutions, see the [Table of solutions](/docs/getting-started-guides/#table-of-solutions/) chart.
|
||||||
|
|||||||
@@ -138,6 +138,6 @@ $ dcos package uninstall kubernetes
|
|||||||
|
|
||||||
IaaS Provider | Config. Mgmt | OS | Networking | Docs | Conforms | Support Level
|
IaaS Provider | Config. Mgmt | OS | Networking | Docs | Conforms | Support Level
|
||||||
-------------------- | ------------ | ------ | ---------- | --------------------------------------------- | ---------| ----------------------------
|
-------------------- | ------------ | ------ | ---------- | --------------------------------------------- | ---------| ----------------------------
|
||||||
DCOS | Marathon | CoreOS/Alpine | custom | [docs](/docs/getting-started-guides/dcos) | | Community ([Kubernetes-Mesos Authors](https://github.com/mesosphere/kubernetes-mesos/blob/master/AUTHORS.md))
|
DCOS | Marathon | CoreOS/Alpine | custom | [docs](/docs/getting-started-guides/dcos/) | | Community ([Kubernetes-Mesos Authors](https://github.com/mesosphere/kubernetes-mesos/blob/master/AUTHORS.md))
|
||||||
|
|
||||||
For support level information on all solutions, see the [Table of solutions](/docs/getting-started-guides/#table-of-solutions) chart.
|
For support level information on all solutions, see the [Table of solutions](/docs/getting-started-guides/#table-of-solutions) chart.
|
||||||
|
|||||||
@@ -309,10 +309,10 @@ Address 1: 10.10.10.1
|
|||||||
|
|
||||||
IaaS Provider | Config. Mgmt | OS | Networking | Docs | Conforms | Support Level
|
IaaS Provider | Config. Mgmt | OS | Networking | Docs | Conforms | Support Level
|
||||||
-------------------- | ------------ | ------ | ---------- | --------------------------------------------- | ---------| ----------------------------
|
-------------------- | ------------ | ------ | ---------- | --------------------------------------------- | ---------| ----------------------------
|
||||||
Mesos/GCE | | | | [docs](/docs/getting-started-guides/mesos) | | Community ([Kubernetes-Mesos Authors](https://github.com/mesosphere/kubernetes-mesos/blob/master/AUTHORS.md))
|
Mesos/GCE | | | | [docs](/docs/getting-started-guides/mesos/) | | Community ([Kubernetes-Mesos Authors](https://github.com/mesosphere/kubernetes-mesos/blob/master/AUTHORS.md))
|
||||||
|
|
||||||
|
|
||||||
For support level information on all solutions, see the [Table of solutions](/docs/getting-started-guides/#table-of-solutions) chart.
|
For support level information on all solutions, see the [Table of solutions](/docs/getting-started-guides/#table-of-solutions/) chart.
|
||||||
|
|
||||||
## What next?
|
## What next?
|
||||||
|
|
||||||
|
|||||||
@@ -27,7 +27,7 @@ steps that existing cluster setup scripts are making.
|
|||||||
|
|
||||||
1. You should be familiar with using Kubernetes already. We suggest you set
|
1. You should be familiar with using Kubernetes already. We suggest you set
|
||||||
up a temporary cluster by following one of the other Getting Started Guides.
|
up a temporary cluster by following one of the other Getting Started Guides.
|
||||||
This will help you become familiar with the CLI ([kubectl](/docs/user-guide/kubectl/)) and concepts ([pods](/docs/user-guide/pods), [services](/docs/user-guide/services), etc.) first.
|
This will help you become familiar with the CLI ([kubectl](/docs/user-guide/kubectl/)) and concepts ([pods](/docs/user-guide/pods/), [services](/docs/user-guide/services/), etc.) first.
|
||||||
1. You should have `kubectl` installed on your desktop. This will happen as a side
|
1. You should have `kubectl` installed on your desktop. This will happen as a side
|
||||||
effect of completing one of the other Getting Started Guides. If not, follow the instructions
|
effect of completing one of the other Getting Started Guides. If not, follow the instructions
|
||||||
[here](/docs/tasks/kubectl/install/).
|
[here](/docs/tasks/kubectl/install/).
|
||||||
@@ -58,7 +58,7 @@ on how flags are set on various components.
|
|||||||
### Network
|
### Network
|
||||||
|
|
||||||
#### Network Connectivity
|
#### Network Connectivity
|
||||||
Kubernetes has a distinctive [networking model](/docs/admin/networking).
|
Kubernetes has a distinctive [networking model](/docs/admin/networking/).
|
||||||
|
|
||||||
Kubernetes allocates an IP address to each pod. When creating a cluster, you
|
Kubernetes allocates an IP address to each pod. When creating a cluster, you
|
||||||
need to allocate a block of IPs for Kubernetes to use as Pod IPs. The simplest
|
need to allocate a block of IPs for Kubernetes to use as Pod IPs. The simplest
|
||||||
@@ -87,11 +87,11 @@ to implement one of the above options:
|
|||||||
- [Open vSwitch (OVS)](http://openvswitch.org/)
|
- [Open vSwitch (OVS)](http://openvswitch.org/)
|
||||||
- [Romana](http://romana.io/)
|
- [Romana](http://romana.io/)
|
||||||
- [Weave](http://weave.works/)
|
- [Weave](http://weave.works/)
|
||||||
- [More found here](/docs/admin/networking#how-to-achieve-this)
|
- [More found here](/docs/admin/networking#how-to-achieve-this/)
|
||||||
- You can also write your own.
|
- You can also write your own.
|
||||||
- **Compile support directly into Kubernetes**
|
- **Compile support directly into Kubernetes**
|
||||||
- This can be done by implementing the "Routes" interface of a Cloud Provider module.
|
- This can be done by implementing the "Routes" interface of a Cloud Provider module.
|
||||||
- The Google Compute Engine ([GCE](/docs/getting-started-guides/gce)) and [AWS](/docs/getting-started-guides/aws) guides use this approach.
|
- The Google Compute Engine ([GCE](/docs/getting-started-guides/gce)/) and [AWS](/docs/getting-started-guides/aws/) guides use this approach.
|
||||||
- **Configure the network external to Kubernetes**
|
- **Configure the network external to Kubernetes**
|
||||||
- This can be done by manually running commands, or through a set of externally maintained scripts.
|
- This can be done by manually running commands, or through a set of externally maintained scripts.
|
||||||
- You have to implement this yourself, but it can give you an extra degree of flexibility.
|
- You have to implement this yourself, but it can give you an extra degree of flexibility.
|
||||||
@@ -113,7 +113,7 @@ You will need to select an address range for the Pod IPs. Note that IPv6 is not
|
|||||||
using `10.10.0.0/24` through `10.10.255.0/24`, respectively.
|
using `10.10.0.0/24` through `10.10.255.0/24`, respectively.
|
||||||
- Need to make these routable or connect with overlay.
|
- Need to make these routable or connect with overlay.
|
||||||
|
|
||||||
Kubernetes also allocates an IP to each [service](/docs/user-guide/services). However,
|
Kubernetes also allocates an IP to each [service](/docs/user-guide/services/). However,
|
||||||
service IPs do not necessarily need to be routable. The kube-proxy takes care
|
service IPs do not necessarily need to be routable. The kube-proxy takes care
|
||||||
of translating Service IPs to Pod IPs before traffic leaves the node. You do
|
of translating Service IPs to Pod IPs before traffic leaves the node. You do
|
||||||
need to Allocate a block of IPs for services. Call this
|
need to Allocate a block of IPs for services. Call this
|
||||||
@@ -237,7 +237,7 @@ You need to prepare several certs:
|
|||||||
Unless you plan to have a real CA generate your certs, you will need
|
Unless you plan to have a real CA generate your certs, you will need
|
||||||
to generate a root cert and use that to sign the master, kubelet, and
|
to generate a root cert and use that to sign the master, kubelet, and
|
||||||
kubectl certs. How to do this is described in the [authentication
|
kubectl certs. How to do this is described in the [authentication
|
||||||
documentation](/docs/admin/authentication/#creating-certificates).
|
documentation](/docs/admin/authentication/#creating-certificates/).
|
||||||
|
|
||||||
You will end up with the following files (we will use these variables later on)
|
You will end up with the following files (we will use these variables later on)
|
||||||
|
|
||||||
@@ -263,7 +263,7 @@ The admin user (and any users) need:
|
|||||||
|
|
||||||
Your tokens and passwords need to be stored in a file for the apiserver
|
Your tokens and passwords need to be stored in a file for the apiserver
|
||||||
to read. This guide uses `/var/lib/kube-apiserver/known_tokens.csv`.
|
to read. This guide uses `/var/lib/kube-apiserver/known_tokens.csv`.
|
||||||
The format for this file is described in the [authentication documentation](/docs/admin/authentication).
|
The format for this file is described in the [authentication documentation](/docs/admin/authentication/).
|
||||||
|
|
||||||
For distributing credentials to clients, the convention in Kubernetes is to put the credentials
|
For distributing credentials to clients, the convention in Kubernetes is to put the credentials
|
||||||
into a [kubeconfig file](/docs/concepts/cluster-administration/authenticate-across-clusters-kubeconfig/).
|
into a [kubeconfig file](/docs/concepts/cluster-administration/authenticate-across-clusters-kubeconfig/).
|
||||||
@@ -408,7 +408,7 @@ Arguments to consider:
|
|||||||
- `--docker-root=`
|
- `--docker-root=`
|
||||||
- `--root-dir=`
|
- `--root-dir=`
|
||||||
- `--configure-cbr0=` (described below)
|
- `--configure-cbr0=` (described below)
|
||||||
- `--register-node` (described in [Node](/docs/admin/node) documentation.)
|
- `--register-node` (described in [Node](/docs/admin/node/) documentation.)
|
||||||
|
|
||||||
### kube-proxy
|
### kube-proxy
|
||||||
|
|
||||||
@@ -430,7 +430,7 @@ Each node needs to be allocated its own CIDR range for pod networking.
|
|||||||
Call this `NODE_X_POD_CIDR`.
|
Call this `NODE_X_POD_CIDR`.
|
||||||
|
|
||||||
A bridge called `cbr0` needs to be created on each node. The bridge is explained
|
A bridge called `cbr0` needs to be created on each node. The bridge is explained
|
||||||
further in the [networking documentation](/docs/admin/networking). The bridge itself
|
further in the [networking documentation](/docs/admin/networking/). The bridge itself
|
||||||
needs an address from `$NODE_X_POD_CIDR` - by convention the first IP. Call
|
needs an address from `$NODE_X_POD_CIDR` - by convention the first IP. Call
|
||||||
this `NODE_X_BRIDGE_ADDR`. For example, if `NODE_X_POD_CIDR` is `10.0.0.0/16`,
|
this `NODE_X_BRIDGE_ADDR`. For example, if `NODE_X_POD_CIDR` is `10.0.0.0/16`,
|
||||||
then `NODE_X_BRIDGE_ADDR` is `10.0.0.1/16`. NOTE: this retains the `/16` suffix
|
then `NODE_X_BRIDGE_ADDR` is `10.0.0.1/16`. NOTE: this retains the `/16` suffix
|
||||||
@@ -499,7 +499,7 @@ traffic to the internet, but have no problem with them inside your GCE Project.
|
|||||||
|
|
||||||
The previous steps all involved "conventional" system administration techniques for setting up
|
The previous steps all involved "conventional" system administration techniques for setting up
|
||||||
machines. You may want to use a Configuration Management system to automate the node configuration
|
machines. You may want to use a Configuration Management system to automate the node configuration
|
||||||
process. There are examples of [Saltstack](/docs/admin/salt), Ansible, Juju, and CoreOS Cloud Config in the
|
process. There are examples of [Saltstack](/docs/admin/salt/), Ansible, Juju, and CoreOS Cloud Config in the
|
||||||
various Getting Started Guides.
|
various Getting Started Guides.
|
||||||
|
|
||||||
## Bootstrapping the Cluster
|
## Bootstrapping the Cluster
|
||||||
@@ -524,7 +524,7 @@ You will need to run one or more instances of etcd.
|
|||||||
- Highly available - Run 3 or 5 etcd instances with non durable storage.
|
- Highly available - Run 3 or 5 etcd instances with non durable storage.
|
||||||
**Note:** Log can be written to non-durable storage because storage is replicated.
|
**Note:** Log can be written to non-durable storage because storage is replicated.
|
||||||
|
|
||||||
See [cluster-troubleshooting](/docs/admin/cluster-troubleshooting) for more discussion on factors affecting cluster
|
See [cluster-troubleshooting](/docs/admin/cluster-troubleshooting/) for more discussion on factors affecting cluster
|
||||||
availability.
|
availability.
|
||||||
|
|
||||||
To run an etcd instance:
|
To run an etcd instance:
|
||||||
@@ -633,7 +633,7 @@ Here are some apiserver flags you may need to set:
|
|||||||
- `--tls-cert-file=/srv/kubernetes/server.cert`
|
- `--tls-cert-file=/srv/kubernetes/server.cert`
|
||||||
- `--tls-private-key-file=/srv/kubernetes/server.key`
|
- `--tls-private-key-file=/srv/kubernetes/server.key`
|
||||||
- `--admission-control=$RECOMMENDED_LIST`
|
- `--admission-control=$RECOMMENDED_LIST`
|
||||||
- See [admission controllers](/docs/admin/admission-controllers) for recommended arguments.
|
- See [admission controllers](/docs/admin/admission-controllers/) for recommended arguments.
|
||||||
- `--allow-privileged=true`, only if you trust your cluster user to run pods as root.
|
- `--allow-privileged=true`, only if you trust your cluster user to run pods as root.
|
||||||
|
|
||||||
If you are following the firewall-only security approach, then use these arguments:
|
If you are following the firewall-only security approach, then use these arguments:
|
||||||
@@ -841,9 +841,9 @@ Notes for setting up each cluster service are given below:
|
|||||||
* [Setup instructions](http://releases.k8s.io/{{page.githubbranch}}/cluster/addons/dns/)
|
* [Setup instructions](http://releases.k8s.io/{{page.githubbranch}}/cluster/addons/dns/)
|
||||||
* [Admin Guide](/docs/concepts/services-networking/dns-pod-service/)
|
* [Admin Guide](/docs/concepts/services-networking/dns-pod-service/)
|
||||||
* Cluster-level Logging
|
* Cluster-level Logging
|
||||||
* [Cluster-level Logging Overview](/docs/user-guide/logging/overview)
|
* [Cluster-level Logging Overview](/docs/user-guide/logging/overview/)
|
||||||
* [Cluster-level Logging with Elasticsearch](/docs/user-guide/logging/elasticsearch)
|
* [Cluster-level Logging with Elasticsearch](/docs/user-guide/logging/elasticsearch/)
|
||||||
* [Cluster-level Logging with Stackdriver Logging](/docs/user-guide/logging/stackdriver)
|
* [Cluster-level Logging with Stackdriver Logging](/docs/user-guide/logging/stackdriver/)
|
||||||
* Container Resource Monitoring
|
* Container Resource Monitoring
|
||||||
* [Setup instructions](http://releases.k8s.io/{{page.githubbranch}}/cluster/addons/cluster-monitoring/)
|
* [Setup instructions](http://releases.k8s.io/{{page.githubbranch}}/cluster/addons/cluster-monitoring/)
|
||||||
* GUI
|
* GUI
|
||||||
@@ -904,7 +904,7 @@ If you run into trouble, please see the section on [troubleshooting](/docs/getti
|
|||||||
|
|
||||||
IaaS Provider | Config. Mgmt | OS | Networking | Docs | Conforms | Support Level
|
IaaS Provider | Config. Mgmt | OS | Networking | Docs | Conforms | Support Level
|
||||||
-------------------- | ------------ | ------ | ---------- | --------------------------------------------- | ---------| ----------------------------
|
-------------------- | ------------ | ------ | ---------- | --------------------------------------------- | ---------| ----------------------------
|
||||||
any | any | any | any | [docs](/docs/getting-started-guides/scratch) | | Community ([@erictune](https://github.com/erictune))
|
any | any | any | any | [docs](/docs/getting-started-guides/scratch/) | | Community ([@erictune](https://github.com/erictune))
|
||||||
|
|
||||||
|
|
||||||
For support level information on all solutions, see the [Table of solutions](/docs/getting-started-guides/#table-of-solutions) chart.
|
For support level information on all solutions, see the [Table of solutions](/docs/getting-started-guides/#table-of-solutions/) chart.
|
||||||
|
|||||||
@@ -36,24 +36,24 @@ conjure-up kubernetes
|
|||||||
|
|
||||||
These are more in-depth guides for users choosing to run Kubernetes in production:
|
These are more in-depth guides for users choosing to run Kubernetes in production:
|
||||||
|
|
||||||
- [Installation](/docs/getting-started-guides/ubuntu/installation)
|
- [Installation](/docs/getting-started-guides/ubuntu/installation/)
|
||||||
- [Validation](/docs/getting-started-guides/ubuntu/validation)
|
- [Validation](/docs/getting-started-guides/ubuntu/validation/)
|
||||||
- [Backups](/docs/getting-started-guides/ubuntu/backups)
|
- [Backups](/docs/getting-started-guides/ubuntu/backups/)
|
||||||
- [Upgrades](/docs/getting-started-guides/ubuntu/upgrades)
|
- [Upgrades](/docs/getting-started-guides/ubuntu/upgrades/)
|
||||||
- [Scaling](/docs/getting-started-guides/ubuntu/scaling)
|
- [Scaling](/docs/getting-started-guides/ubuntu/scaling/)
|
||||||
- [Logging](/docs/getting-started-guides/ubuntu/logging)
|
- [Logging](/docs/getting-started-guides/ubuntu/logging/)
|
||||||
- [Monitoring](/docs/getting-started-guides/ubuntu/monitoring)
|
- [Monitoring](/docs/getting-started-guides/ubuntu/monitoring/)
|
||||||
- [Networking](/docs/getting-started-guides/ubuntu/networking)
|
- [Networking](/docs/getting-started-guides/ubuntu/networking/)
|
||||||
- [Security](/docs/getting-started-guides/ubuntu/security)
|
- [Security](/docs/getting-started-guides/ubuntu/security/)
|
||||||
- [Storage](/docs/getting-started-guides/ubuntu/storage)
|
- [Storage](/docs/getting-started-guides/ubuntu/storage/)
|
||||||
- [Troubleshooting](/docs/getting-started-guides/ubuntu/troubleshooting)
|
- [Troubleshooting](/docs/getting-started-guides/ubuntu/troubleshooting/)
|
||||||
- [Decommissioning](/docs/getting-started-guides/ubuntu/decommissioning)
|
- [Decommissioning](/docs/getting-started-guides/ubuntu/decommissioning/)
|
||||||
- [Operational Considerations](/docs/getting-started-guides/ubuntu/operational-considerations)
|
- [Operational Considerations](/docs/getting-started-guides/ubuntu/operational-considerations/)
|
||||||
- [Glossary](/docs/getting-started-guides/ubuntu/glossary)
|
- [Glossary](/docs/getting-started-guides/ubuntu/glossary/)
|
||||||
|
|
||||||
## Developer Guides
|
## Developer Guides
|
||||||
|
|
||||||
- [Localhost using LXD](/docs/getting-started-guides/ubuntu/local)
|
- [Localhost using LXD](/docs/getting-started-guides/ubuntu/local/)
|
||||||
|
|
||||||
## Where to find us
|
## Where to find us
|
||||||
|
|
||||||
|
|||||||
@@ -251,14 +251,14 @@ Feature requests, bug reports, pull requests or any feedback would be much appre
|
|||||||
|
|
||||||
IaaS Provider | Config. Mgmt | OS | Networking | Docs | Conforms | Support Level
|
IaaS Provider | Config. Mgmt | OS | Networking | Docs | Conforms | Support Level
|
||||||
-------------------- | ------------ | ------ | ---------- | --------------------------------------------- | ---------| ----------------------------
|
-------------------- | ------------ | ------ | ---------- | --------------------------------------------- | ---------| ----------------------------
|
||||||
Amazon Web Services (AWS) | Juju | Ubuntu | flannel, calico* | [docs](/docs/getting-started-guides/ubuntu) | | [Commercial](https://ubuntu.com/cloud/kubernetes), [Community](https://github.com/juju-solutions/bundle-kubernetes-core) ( [@mbruzek](https://github.com/mbruzek), [@chuckbutler](https://github.com/chuckbutler) )
|
Amazon Web Services (AWS) | Juju | Ubuntu | flannel, calico* | [docs](/docs/getting-started-guides/ubuntu/) | | [Commercial](https://ubuntu.com/cloud/kubernetes), [Community](https://github.com/juju-solutions/bundle-kubernetes-core) ( [@mbruzek](https://github.com/mbruzek), [@chuckbutler](https://github.com/chuckbutler) )
|
||||||
OpenStack | Juju | Ubuntu | flannel, calico | [docs](/docs/getting-started-guides/ubuntu) | | [Commercial](https://ubuntu.com/cloud/kubernetes), [Community](https://github.com/juju-solutions/bundle-kubernetes-core) ( [@mbruzek](https://github.com/mbruzek), [@chuckbutler](https://github.com/chuckbutler) )
|
OpenStack | Juju | Ubuntu | flannel, calico | [docs](/docs/getting-started-guides/ubuntu/) | | [Commercial](https://ubuntu.com/cloud/kubernetes), [Community](https://github.com/juju-solutions/bundle-kubernetes-core) ( [@mbruzek](https://github.com/mbruzek), [@chuckbutler](https://github.com/chuckbutler) )
|
||||||
Microsoft Azure | Juju | Ubuntu | flannel | [docs](/docs/getting-started-guides/ubuntu) | | [Commercial](https://ubuntu.com/cloud/kubernetes), [Community](https://github.com/juju-solutions/bundle-kubernetes-core) ( [@mbruzek](https://github.com/mbruzek), [@chuckbutler](https://github.com/chuckbutler) )
|
Microsoft Azure | Juju | Ubuntu | flannel | [docs](/docs/getting-started-guides/ubuntu/) | | [Commercial](https://ubuntu.com/cloud/kubernetes), [Community](https://github.com/juju-solutions/bundle-kubernetes-core) ( [@mbruzek](https://github.com/mbruzek), [@chuckbutler](https://github.com/chuckbutler) )
|
||||||
Google Compute Engine (GCE) | Juju | Ubuntu | flannel, calico | [docs](/docs/getting-started-guides/ubuntu) | | [Commercial](https://ubuntu.com/cloud/kubernetes), [Community](https://github.com/juju-solutions/bundle-kubernetes-core) ( [@mbruzek](https://github.com/mbruzek), [@chuckbutler](https://github.com/chuckbutler) )
|
Google Compute Engine (GCE) | Juju | Ubuntu | flannel, calico | [docs](/docs/getting-started-guides/ubuntu/) | | [Commercial](https://ubuntu.com/cloud/kubernetes), [Community](https://github.com/juju-solutions/bundle-kubernetes-core) ( [@mbruzek](https://github.com/mbruzek), [@chuckbutler](https://github.com/chuckbutler) )
|
||||||
Joyent | Juju | Ubuntu | flannel | [docs](/docs/getting-started-guides/ubuntu) | | [Commercial](https://ubuntu.com/cloud/kubernetes), [Community](https://github.com/juju-solutions/bundle-kubernetes-core) ( [@mbruzek](https://github.com/mbruzek), [@chuckbutler](https://github.com/chuckbutler) )
|
Joyent | Juju | Ubuntu | flannel | [docs](/docs/getting-started-guides/ubuntu/) | | [Commercial](https://ubuntu.com/cloud/kubernetes), [Community](https://github.com/juju-solutions/bundle-kubernetes-core) ( [@mbruzek](https://github.com/mbruzek), [@chuckbutler](https://github.com/chuckbutler) )
|
||||||
Rackspace | Juju | Ubuntu | flannel | [docs](/docs/getting-started-guides/ubuntu) | | [Commercial](https://ubuntu.com/cloud/kubernetes), [Community](https://github.com/juju-solutions/bundle-kubernetes-core) ( [@mbruzek](https://github.com/mbruzek), [@chuckbutler](https://github.com/chuckbutler) )
|
Rackspace | Juju | Ubuntu | flannel | [docs](/docs/getting-started-guides/ubuntu/) | | [Commercial](https://ubuntu.com/cloud/kubernetes), [Community](https://github.com/juju-solutions/bundle-kubernetes-core) ( [@mbruzek](https://github.com/mbruzek), [@chuckbutler](https://github.com/chuckbutler) )
|
||||||
VMWare vSphere | Juju | Ubuntu | flannel, calico | [docs](/docs/getting-started-guides/ubuntu) | | [Commercial](https://ubuntu.com/cloud/kubernetes), [Community](https://github.com/juju-solutions/bundle-kubernetes-core) ( [@mbruzek](https://github.com/mbruzek), [@chuckbutler](https://github.com/chuckbutler) )
|
VMWare vSphere | Juju | Ubuntu | flannel, calico | [docs](/docs/getting-started-guides/ubuntu/) | | [Commercial](https://ubuntu.com/cloud/kubernetes), [Community](https://github.com/juju-solutions/bundle-kubernetes-core) ( [@mbruzek](https://github.com/mbruzek), [@chuckbutler](https://github.com/chuckbutler) )
|
||||||
Bare Metal (MAAS) | Juju | Ubuntu | flannel, calico | [docs](/docs/getting-started-guides/ubuntu) | | [Commercial](https://ubuntu.com/cloud/kubernetes), [Community](https://github.com/juju-solutions/bundle-kubernetes-core) ( [@mbruzek](https://github.com/mbruzek), [@chuckbutler](https://github.com/chuckbutler) )
|
Bare Metal (MAAS) | Juju | Ubuntu | flannel, calico | [docs](/docs/getting-started-guides/ubuntu/) | | [Commercial](https://ubuntu.com/cloud/kubernetes), [Community](https://github.com/juju-solutions/bundle-kubernetes-core) ( [@mbruzek](https://github.com/mbruzek), [@chuckbutler](https://github.com/chuckbutler) )
|
||||||
|
|
||||||
|
|
||||||
For support level information on all solutions, see the [Table of solutions](/docs/getting-started-guides/#table-of-solutions) chart.
|
For support level information on all solutions, see the [Table of solutions](/docs/getting-started-guides/#table-of-solutions) chart.
|
||||||
|
|||||||
@@ -201,7 +201,7 @@ For quick support please join VMware Code Slack ([kubernetes](https://vmwarecode
|
|||||||
|
|
||||||
IaaS Provider | Config. Mgmt | OS | Networking | Docs | Conforms | Support Level
|
IaaS Provider | Config. Mgmt | OS | Networking | Docs | Conforms | Support Level
|
||||||
-------------------- | ------------ | ------ | ---------- | --------------------------------------------- | --------- | ----------------------------
|
-------------------- | ------------ | ------ | ---------- | --------------------------------------------- | --------- | ----------------------------
|
||||||
Vmware vSphere | Kube-anywhere | Photon OS | Flannel | [docs](/docs/getting-started-guides/vsphere) | | Community ([@abrarshivani](https://github.com/abrarshivani)), ([@kerneltime](https://github.com/kerneltime)), ([@BaluDontu](https://github.com/BaluDontu)), ([@luomiao](https://github.com/luomiao)), ([@divyenpatel](https://github.com/divyenpatel))
|
Vmware vSphere | Kube-anywhere | Photon OS | Flannel | [docs](/docs/getting-started-guides/vsphere/) | | Community ([@abrarshivani](https://github.com/abrarshivani)), ([@kerneltime](https://github.com/kerneltime)), ([@BaluDontu](https://github.com/BaluDontu)), ([@luomiao](https://github.com/luomiao)), ([@divyenpatel](https://github.com/divyenpatel))
|
||||||
|
|
||||||
If you identify any issues/problems using the vSphere cloud provider, you can create an issue in our repo - [VMware Kubernetes](https://github.com/vmware/kubernetes).
|
If you identify any issues/problems using the vSphere cloud provider, you can create an issue in our repo - [VMware Kubernetes](https://github.com/vmware/kubernetes).
|
||||||
|
|
||||||
|
|||||||
@@ -39,7 +39,7 @@ This page shows how to use install kubeadm.
|
|||||||
|-------------|---------------------------------|
|
|-------------|---------------------------------|
|
||||||
| 10250 | Kubelet API |
|
| 10250 | Kubelet API |
|
||||||
| 10255 | Read-only Kubelet API (Heapster)|
|
| 10255 | Read-only Kubelet API (Heapster)|
|
||||||
| 30000-32767 | Default port range for [NodePort Services](/docs/concepts/services-networking/service). Typically, these ports would need to be exposed to external load-balancers, or other external consumers of the application itself. |
|
| 30000-32767 | Default port range for [NodePort Services](/docs/concepts/services-networking/service/). Typically, these ports would need to be exposed to external load-balancers, or other external consumers of the application itself. |
|
||||||
|
|
||||||
Any port numbers marked with * are overridable, so you will need to ensure any
|
Any port numbers marked with * are overridable, so you will need to ensure any
|
||||||
custom ports you provide are also open.
|
custom ports you provide are also open.
|
||||||
|
|||||||
@@ -29,7 +29,7 @@ a Kubernetes cluster from scratch.
|
|||||||
|
|
||||||
* [Minikube](/docs/getting-started-guides/minikube/) is the recommended method for creating a local, single-node Kubernetes cluster for development and testing. Setup is completely automated and doesn't require a cloud provider account.
|
* [Minikube](/docs/getting-started-guides/minikube/) is the recommended method for creating a local, single-node Kubernetes cluster for development and testing. Setup is completely automated and doesn't require a cloud provider account.
|
||||||
|
|
||||||
* [Ubuntu on LXD](/docs/getting-started-guides/ubuntu/local) supports a nine-instance deployment on localhost.
|
* [Ubuntu on LXD](/docs/getting-started-guides/ubuntu/local/) supports a nine-instance deployment on localhost.
|
||||||
|
|
||||||
* [IBM Cloud private-ce (Community Edition)](https://www.ibm.com/support/knowledgecenter/en/SSBS6K/product_welcome_cloud_private.html) can use VirtualBox on your machine to deploy Kubernetes to one or more VMs for dev and test scenarios. Scales to full multi-node cluster. Free version of the enterprise solution.
|
* [IBM Cloud private-ce (Community Edition)](https://www.ibm.com/support/knowledgecenter/en/SSBS6K/product_welcome_cloud_private.html) can use VirtualBox on your machine to deploy Kubernetes to one or more VMs for dev and test scenarios. Scales to full multi-node cluster. Free version of the enterprise solution.
|
||||||
|
|
||||||
@@ -62,11 +62,11 @@ a Kubernetes cluster from scratch.
|
|||||||
These solutions allow you to create Kubernetes clusters on a range of Cloud IaaS providers with only a
|
These solutions allow you to create Kubernetes clusters on a range of Cloud IaaS providers with only a
|
||||||
few commands. These solutions are actively developed and have active community support.
|
few commands. These solutions are actively developed and have active community support.
|
||||||
|
|
||||||
* [Google Compute Engine (GCE)](/docs/getting-started-guides/gce)
|
* [Google Compute Engine (GCE)](/docs/getting-started-guides/gce/)
|
||||||
* [AWS](/docs/getting-started-guides/aws)
|
* [AWS](/docs/getting-started-guides/aws/)
|
||||||
* [Azure](/docs/getting-started-guides/azure)
|
* [Azure](/docs/getting-started-guides/azure/)
|
||||||
* [Tectonic by CoreOS](https://coreos.com/tectonic)
|
* [Tectonic by CoreOS](https://coreos.com/tectonic)
|
||||||
* [CenturyLink Cloud](/docs/getting-started-guides/clc)
|
* [CenturyLink Cloud](/docs/getting-started-guides/clc/)
|
||||||
* [IBM Bluemix](https://github.com/patrocinio/kubernetes-softlayer)
|
* [IBM Bluemix](https://github.com/patrocinio/kubernetes-softlayer)
|
||||||
* [Stackpoint.io](/docs/getting-started-guides/stackpoint/)
|
* [Stackpoint.io](/docs/getting-started-guides/stackpoint/)
|
||||||
* [KUBE2GO.io](https://kube2go.io/)
|
* [KUBE2GO.io](https://kube2go.io/)
|
||||||
@@ -80,7 +80,7 @@ base operating systems.
|
|||||||
If you can find a guide below that matches your needs, use it. It may be a little out of date, but
|
If you can find a guide below that matches your needs, use it. It may be a little out of date, but
|
||||||
it will be easier than starting from scratch. If you do want to start from scratch, either because you
|
it will be easier than starting from scratch. If you do want to start from scratch, either because you
|
||||||
have special requirements, or just because you want to understand what is underneath a Kubernetes
|
have special requirements, or just because you want to understand what is underneath a Kubernetes
|
||||||
cluster, try the [Getting Started from Scratch](/docs/getting-started-guides/scratch) guide.
|
cluster, try the [Getting Started from Scratch](/docs/getting-started-guides/scratch/) guide.
|
||||||
|
|
||||||
If you are interested in supporting Kubernetes on a new platform, see
|
If you are interested in supporting Kubernetes on a new platform, see
|
||||||
[Writing a Getting Started Guide](https://git.k8s.io/community/contributors/devel/writing-a-getting-started-guide.md).
|
[Writing a Getting Started Guide](https://git.k8s.io/community/contributors/devel/writing-a-getting-started-guide.md).
|
||||||
@@ -95,40 +95,40 @@ with a single command per machine.
|
|||||||
|
|
||||||
These solutions are combinations of cloud providers and operating systems not covered by the above solutions.
|
These solutions are combinations of cloud providers and operating systems not covered by the above solutions.
|
||||||
|
|
||||||
* [CoreOS on AWS or GCE](/docs/getting-started-guides/coreos)
|
* [CoreOS on AWS or GCE](/docs/getting-started-guides/coreos/)
|
||||||
* [Kubernetes on Ubuntu](/docs/getting-started-guides/ubuntu/)
|
* [Kubernetes on Ubuntu](/docs/getting-started-guides/ubuntu/)
|
||||||
* [Kubespray](/docs/getting-started-guides/kubespray/)
|
* [Kubespray](/docs/getting-started-guides/kubespray/)
|
||||||
|
|
||||||
## On-Premises VMs
|
## On-Premises VMs
|
||||||
|
|
||||||
* [Vagrant](/docs/getting-started-guides/coreos) (uses CoreOS and flannel)
|
* [Vagrant](/docs/getting-started-guides/coreos/) (uses CoreOS and flannel)
|
||||||
* [CloudStack](/docs/getting-started-guides/cloudstack) (uses Ansible, CoreOS and flannel)
|
* [CloudStack](/docs/getting-started-guides/cloudstack/) (uses Ansible, CoreOS and flannel)
|
||||||
* [Vmware vSphere](/docs/getting-started-guides/vsphere) (uses Debian)
|
* [Vmware vSphere](/docs/getting-started-guides/vsphere/) (uses Debian)
|
||||||
* [Vmware Photon Controller](/docs/getting-started-guides/photon-controller) (uses Debian)
|
* [Vmware Photon Controller](/docs/getting-started-guides/photon-controller/) (uses Debian)
|
||||||
* [Vmware vSphere, OpenStack, or Bare Metal](/docs/getting-started-guides/ubuntu/) (uses Juju, Ubuntu and flannel)
|
* [Vmware vSphere, OpenStack, or Bare Metal](/docs/getting-started-guides/ubuntu/) (uses Juju, Ubuntu and flannel)
|
||||||
* [Vmware](/docs/getting-started-guides/coreos) (uses CoreOS and flannel)
|
* [Vmware](/docs/getting-started-guides/coreos/) (uses CoreOS and flannel)
|
||||||
* [CoreOS on libvirt](/docs/getting-started-guides/libvirt-coreos) (uses CoreOS)
|
* [CoreOS on libvirt](/docs/getting-started-guides/libvirt-coreos/) (uses CoreOS)
|
||||||
* [oVirt](/docs/getting-started-guides/ovirt)
|
* [oVirt](/docs/getting-started-guides/ovirt/)
|
||||||
* [OpenStack Heat](/docs/getting-started-guides/openstack-heat) (uses CentOS and flannel)
|
* [OpenStack Heat](/docs/getting-started-guides/openstack-heat/) (uses CentOS and flannel)
|
||||||
* [Fedora (Multi Node)](/docs/getting-started-guides/fedora/flannel_multi_node_cluster) (uses Fedora and flannel)
|
* [Fedora (Multi Node)](/docs/getting-started-guides/fedora/flannel_multi_node_cluster/) (uses Fedora and flannel)
|
||||||
|
|
||||||
## Bare Metal
|
## Bare Metal
|
||||||
|
|
||||||
* [Offline](/docs/getting-started-guides/coreos/bare_metal_offline) (no internet required. Uses CoreOS and Flannel)
|
* [Offline](/docs/getting-started-guides/coreos/bare_metal_offline/) (no internet required. Uses CoreOS and Flannel)
|
||||||
* [Fedora via Ansible](/docs/getting-started-guides/fedora/fedora_ansible_config)
|
* [Fedora via Ansible](/docs/getting-started-guides/fedora/fedora_ansible_config/)
|
||||||
* [Fedora (Single Node)](/docs/getting-started-guides/fedora/fedora_manual_config)
|
* [Fedora (Single Node)](/docs/getting-started-guides/fedora/fedora_manual_config/)
|
||||||
* [Fedora (Multi Node)](/docs/getting-started-guides/fedora/flannel_multi_node_cluster)
|
* [Fedora (Multi Node)](/docs/getting-started-guides/fedora/flannel_multi_node_cluster/)
|
||||||
* [CentOS](/docs/getting-started-guides/centos/centos_manual_config)
|
* [CentOS](/docs/getting-started-guides/centos/centos_manual_config/)
|
||||||
* [Kubernetes on Ubuntu](/docs/getting-started-guides/ubuntu/)
|
* [Kubernetes on Ubuntu](/docs/getting-started-guides/ubuntu/)
|
||||||
* [CoreOS on AWS or GCE](/docs/getting-started-guides/coreos)
|
* [CoreOS on AWS or GCE](/docs/getting-started-guides/coreos/)
|
||||||
|
|
||||||
## Integrations
|
## Integrations
|
||||||
|
|
||||||
These solutions provide integration with third-party schedulers, resource managers, and/or lower level platforms.
|
These solutions provide integration with third-party schedulers, resource managers, and/or lower level platforms.
|
||||||
|
|
||||||
* [Kubernetes on Mesos](/docs/getting-started-guides/mesos)
|
* [Kubernetes on Mesos](/docs/getting-started-guides/mesos/)
|
||||||
* Instructions specify GCE, but are generic enough to be adapted to most existing Mesos clusters
|
* Instructions specify GCE, but are generic enough to be adapted to most existing Mesos clusters
|
||||||
* [DCOS](/docs/getting-started-guides/dcos)
|
* [DCOS](/docs/getting-started-guides/dcos/)
|
||||||
* Community Edition DCOS uses AWS
|
* Community Edition DCOS uses AWS
|
||||||
* Enterprise Edition DCOS supports cloud hosting, on-premises VMs, and bare metal
|
* Enterprise Edition DCOS supports cloud hosting, on-premises VMs, and bare metal
|
||||||
|
|
||||||
@@ -146,37 +146,37 @@ KUBE2GO.io | | multi-support | multi-support | [docs](http
|
|||||||
Madcore.Ai | Jenkins DSL | Ubuntu | flannel | [docs](https://madcore.ai) | Community ([@madcore-ai](https://github.com/madcore-ai))
|
Madcore.Ai | Jenkins DSL | Ubuntu | flannel | [docs](https://madcore.ai) | Community ([@madcore-ai](https://github.com/madcore-ai))
|
||||||
Platform9 | | multi-support | multi-support | [docs](https://platform9.com/managed-kubernetes/) | Commercial
|
Platform9 | | multi-support | multi-support | [docs](https://platform9.com/managed-kubernetes/) | Commercial
|
||||||
Giant Swarm | | CoreOS | flannel and/or Calico | [docs](https://docs.giantswarm.io/) | Commercial
|
Giant Swarm | | CoreOS | flannel and/or Calico | [docs](https://docs.giantswarm.io/) | Commercial
|
||||||
GCE | Saltstack | Debian | GCE | [docs](/docs/getting-started-guides/gce) | Project
|
GCE | Saltstack | Debian | GCE | [docs](/docs/getting-started-guides/gce/) | Project
|
||||||
Azure Container Service | | Ubuntu | Azure | [docs](https://azure.microsoft.com/en-us/services/container-service/) | Commercial
|
Azure Container Service | | Ubuntu | Azure | [docs](https://azure.microsoft.com/en-us/services/container-service/) | Commercial
|
||||||
Azure (IaaS) | | Ubuntu | Azure | [docs](/docs/getting-started-guides/azure) | [Community (Microsoft)](https://github.com/Azure/acs-engine)
|
Azure (IaaS) | | Ubuntu | Azure | [docs](/docs/getting-started-guides/azure/) | [Community (Microsoft)](https://github.com/Azure/acs-engine)
|
||||||
Bare-metal | Ansible | Fedora | flannel | [docs](/docs/getting-started-guides/fedora/fedora_ansible_config) | Project
|
Bare-metal | Ansible | Fedora | flannel | [docs](/docs/getting-started-guides/fedora/fedora_ansible_config/) | Project
|
||||||
Bare-metal | custom | Fedora | _none_ | [docs](/docs/getting-started-guides/fedora/fedora_manual_config) | Project
|
Bare-metal | custom | Fedora | _none_ | [docs](/docs/getting-started-guides/fedora/fedora_manual_config/) | Project
|
||||||
Bare-metal | custom | Fedora | flannel | [docs](/docs/getting-started-guides/fedora/flannel_multi_node_cluster) | Community ([@aveshagarwal](https://github.com/aveshagarwal))
|
Bare-metal | custom | Fedora | flannel | [docs](/docs/getting-started-guides/fedora/flannel_multi_node_cluster/) | Community ([@aveshagarwal](https://github.com/aveshagarwal))
|
||||||
libvirt | custom | Fedora | flannel | [docs](/docs/getting-started-guides/fedora/flannel_multi_node_cluster) | Community ([@aveshagarwal](https://github.com/aveshagarwal))
|
libvirt | custom | Fedora | flannel | [docs](/docs/getting-started-guides/fedora/flannel_multi_node_cluster/) | Community ([@aveshagarwal](https://github.com/aveshagarwal))
|
||||||
KVM | custom | Fedora | flannel | [docs](/docs/getting-started-guides/fedora/flannel_multi_node_cluster) | Community ([@aveshagarwal](https://github.com/aveshagarwal))
|
KVM | custom | Fedora | flannel | [docs](/docs/getting-started-guides/fedora/flannel_multi_node_cluster/) | Community ([@aveshagarwal](https://github.com/aveshagarwal))
|
||||||
Mesos/Docker | custom | Ubuntu | Docker | [docs](/docs/getting-started-guides/mesos-docker) | Community ([Kubernetes-Mesos Authors](https://github.com/mesosphere/kubernetes-mesos/blob/master/AUTHORS.md))
|
Mesos/Docker | custom | Ubuntu | Docker | [docs](/docs/getting-started-guides/mesos-docker/) | Community ([Kubernetes-Mesos Authors](https://github.com/mesosphere/kubernetes-mesos/blob/master/AUTHORS.md))
|
||||||
Mesos/GCE | | | | [docs](/docs/getting-started-guides/mesos) | Community ([Kubernetes-Mesos Authors](https://github.com/mesosphere/kubernetes-mesos/blob/master/AUTHORS.md))
|
Mesos/GCE | | | | [docs](/docs/getting-started-guides/mesos/) | Community ([Kubernetes-Mesos Authors](https://github.com/mesosphere/kubernetes-mesos/blob/master/AUTHORS.md))
|
||||||
DCOS | Marathon | CoreOS/Alpine | custom | [docs](/docs/getting-started-guides/dcos) | Community ([Kubernetes-Mesos Authors](https://github.com/mesosphere/kubernetes-mesos/blob/master/AUTHORS.md))
|
DCOS | Marathon | CoreOS/Alpine | custom | [docs](/docs/getting-started-guides/dcos/) | Community ([Kubernetes-Mesos Authors](https://github.com/mesosphere/kubernetes-mesos/blob/master/AUTHORS.md))
|
||||||
AWS | CoreOS | CoreOS | flannel | [docs](/docs/getting-started-guides/aws) | Community
|
AWS | CoreOS | CoreOS | flannel | [docs](/docs/getting-started-guides/aws/) | Community
|
||||||
GCE | CoreOS | CoreOS | flannel | [docs](/docs/getting-started-guides/coreos) | Community ([@pires](https://github.com/pires))
|
GCE | CoreOS | CoreOS | flannel | [docs](/docs/getting-started-guides/coreos/) | Community ([@pires](https://github.com/pires))
|
||||||
Vagrant | CoreOS | CoreOS | flannel | [docs](/docs/getting-started-guides/coreos) | Community ([@pires](https://github.com/pires), [@AntonioMeireles](https://github.com/AntonioMeireles))
|
Vagrant | CoreOS | CoreOS | flannel | [docs](/docs/getting-started-guides/coreos/) | Community ([@pires](https://github.com/pires), [@AntonioMeireles](https://github.com/AntonioMeireles))
|
||||||
Bare-metal (Offline) | CoreOS | CoreOS | flannel | [docs](/docs/getting-started-guides/coreos/bare_metal_offline) | Community ([@jeffbean](https://github.com/jeffbean))
|
Bare-metal (Offline) | CoreOS | CoreOS | flannel | [docs](/docs/getting-started-guides/coreos/bare_metal_offline/) | Community ([@jeffbean](https://github.com/jeffbean))
|
||||||
CloudStack | Ansible | CoreOS | flannel | [docs](/docs/getting-started-guides/cloudstack) | Community ([@sebgoa](https://github.com/sebgoa))
|
CloudStack | Ansible | CoreOS | flannel | [docs](/docs/getting-started-guides/cloudstack/) | Community ([@sebgoa](https://github.com/sebgoa))
|
||||||
Vmware vSphere | Saltstack | Debian | OVS | [docs](/docs/getting-started-guides/vsphere) | Community ([@imkin](https://github.com/imkin))
|
Vmware vSphere | Saltstack | Debian | OVS | [docs](/docs/getting-started-guides/vsphere/) | Community ([@imkin](https://github.com/imkin))
|
||||||
Vmware Photon | Saltstack | Debian | OVS | [docs](/docs/getting-started-guides/photon-controller) | Community ([@alainroy](https://github.com/alainroy))
|
Vmware Photon | Saltstack | Debian | OVS | [docs](/docs/getting-started-guides/photon-controller/) | Community ([@alainroy](https://github.com/alainroy))
|
||||||
Bare-metal | custom | CentOS | flannel | [docs](/docs/getting-started-guides/centos/centos_manual_config) | Community ([@coolsvap](https://github.com/coolsvap))
|
Bare-metal | custom | CentOS | flannel | [docs](/docs/getting-started-guides/centos/centos_manual_config/) | Community ([@coolsvap](https://github.com/coolsvap))
|
||||||
AWS | Juju | Ubuntu | flannel | [docs](/docs/getting-started-guides/ubuntu/) | [Commercial](http://www.ubuntu.com/cloud/kubernetes) and [Community](https://github.com/juju-solutions/bundle-canonical-kubernetes) ( [@matt](https://github.com/mbruzek), [@chuck](https://github.com/chuckbutler) )
|
AWS | Juju | Ubuntu | flannel | [docs](/docs/getting-started-guides/ubuntu/) | [Commercial](http://www.ubuntu.com/cloud/kubernetes) and [Community](https://github.com/juju-solutions/bundle-canonical-kubernetes) ( [@matt](https://github.com/mbruzek), [@chuck](https://github.com/chuckbutler) )
|
||||||
GCE | Juju | Ubuntu | flannel | [docs](/docs/getting-started-guides/ubuntu/) | [Commercial](http://www.ubuntu.com/cloud/kubernetes) and [Community](https://github.com/juju-solutions/bundle-canonical-kubernetes) ( [@matt](https://github.com/mbruzek), [@chuck](https://github.com/chuckbutler) )
|
GCE | Juju | Ubuntu | flannel | [docs](/docs/getting-started-guides/ubuntu/) | [Commercial](http://www.ubuntu.com/cloud/kubernetes) and [Community](https://github.com/juju-solutions/bundle-canonical-kubernetes) ( [@matt](https://github.com/mbruzek), [@chuck](https://github.com/chuckbutler) )
|
||||||
Bare Metal | Juju | Ubuntu | flannel | [docs](/docs/getting-started-guides/ubuntu/) | [Commercial](http://www.ubuntu.com/cloud/kubernetes) and [Community](https://github.com/juju-solutions/bundle-canonical-kubernetes) ( [@matt](https://github.com/mbruzek), [@chuck](https://github.com/chuckbutler) )
|
Bare Metal | Juju | Ubuntu | flannel | [docs](/docs/getting-started-guides/ubuntu/) | [Commercial](http://www.ubuntu.com/cloud/kubernetes) and [Community](https://github.com/juju-solutions/bundle-canonical-kubernetes) ( [@matt](https://github.com/mbruzek), [@chuck](https://github.com/chuckbutler) )
|
||||||
Rackspace | Juju | Ubuntu | flannel | [docs](/docs/getting-started-guides/ubuntu/) | [Commercial](http://www.ubuntu.com/cloud/kubernetes) and [Community](https://github.com/juju-solutions/bundle-canonical-kubernetes) ( [@matt](https://github.com/mbruzek), [@chuck](https://github.com/chuckbutler) )
|
Rackspace | Juju | Ubuntu | flannel | [docs](/docs/getting-started-guides/ubuntu/) | [Commercial](http://www.ubuntu.com/cloud/kubernetes) and [Community](https://github.com/juju-solutions/bundle-canonical-kubernetes) ( [@matt](https://github.com/mbruzek), [@chuck](https://github.com/chuckbutler) )
|
||||||
Vmware vSphere | Juju | Ubuntu | flannel | [docs](/docs/getting-started-guides/ubuntu/) | [Commercial](http://www.ubuntu.com/cloud/kubernetes) and [Community](https://github.com/juju-solutions/bundle-canonical-kubernetes) ( [@matt](https://github.com/mbruzek), [@chuck](https://github.com/chuckbutler) )
|
Vmware vSphere | Juju | Ubuntu | flannel | [docs](/docs/getting-started-guides/ubuntu/) | [Commercial](http://www.ubuntu.com/cloud/kubernetes) and [Community](https://github.com/juju-solutions/bundle-canonical-kubernetes) ( [@matt](https://github.com/mbruzek), [@chuck](https://github.com/chuckbutler) )
|
||||||
AWS | Saltstack | Debian | AWS | [docs](/docs/getting-started-guides/aws) | Community ([@justinsb](https://github.com/justinsb))
|
AWS | Saltstack | Debian | AWS | [docs](/docs/getting-started-guides/aws/) | Community ([@justinsb](https://github.com/justinsb))
|
||||||
AWS | kops | Debian | AWS | [docs](https://github.com/kubernetes/kops) | Community ([@justinsb](https://github.com/justinsb))
|
AWS | kops | Debian | AWS | [docs](https://github.com/kubernetes/kops/) | Community ([@justinsb](https://github.com/justinsb))
|
||||||
Bare-metal | custom | Ubuntu | flannel | [docs](/docs/getting-started-guides/ubuntu) | Community ([@resouer](https://github.com/resouer), [@WIZARD-CXY](https://github.com/WIZARD-CXY))
|
Bare-metal | custom | Ubuntu | flannel | [docs](/docs/getting-started-guides/ubuntu/) | Community ([@resouer](https://github.com/resouer), [@WIZARD-CXY](https://github.com/WIZARD-CXY))
|
||||||
libvirt/KVM | CoreOS | CoreOS | libvirt/KVM | [docs](/docs/getting-started-guides/libvirt-coreos) | Community ([@lhuard1A](https://github.com/lhuard1A))
|
libvirt/KVM | CoreOS | CoreOS | libvirt/KVM | [docs](/docs/getting-started-guides/libvirt-coreos/) | Community ([@lhuard1A](https://github.com/lhuard1A))
|
||||||
oVirt | | | | [docs](/docs/getting-started-guides/ovirt) | Community ([@simon3z](https://github.com/simon3z))
|
oVirt | | | | [docs](/docs/getting-started-guides/ovirt/) | Community ([@simon3z](https://github.com/simon3z))
|
||||||
OpenStack Heat | Saltstack | CentOS | Neutron + flannel hostgw | [docs](/docs/getting-started-guides/openstack-heat) | Community ([@FujitsuEnablingSoftwareTechnologyGmbH](https://github.com/FujitsuEnablingSoftwareTechnologyGmbH))
|
OpenStack Heat | Saltstack | CentOS | Neutron + flannel hostgw | [docs](/docs/getting-started-guides/openstack-heat/) | Community ([@FujitsuEnablingSoftwareTechnologyGmbH](https://github.com/FujitsuEnablingSoftwareTechnologyGmbH))
|
||||||
any | any | any | any | [docs](/docs/getting-started-guides/scratch) | Community ([@erictune](https://github.com/erictune))
|
any | any | any | any | [docs](/docs/getting-started-guides/scratch/) | Community ([@erictune](https://github.com/erictune))
|
||||||
any | any | any | any | [docs](http://docs.projectcalico.org/v2.2/getting-started/kubernetes/installation/) | Commercial and Community
|
any | any | any | any | [docs](http://docs.projectcalico.org/v2.2/getting-started/kubernetes/installation/) | Commercial and Community
|
||||||
|
|
||||||
**Note**: The above table is ordered by version test/used in nodes, followed by support level.
|
**Note**: The above table is ordered by version test/used in nodes, followed by support level.
|
||||||
|
|||||||
@@ -185,7 +185,7 @@ very charm
|
|||||||
|
|
||||||
## Add ConfigMap data to a Volume
|
## Add ConfigMap data to a Volume
|
||||||
|
|
||||||
As explained in [Configure Containers Using a ConfigMap](/docs/tasks/configure-pod-container/configmap.html), when you create a ConfigMap using ``--from-file``, the filename becomes a key stored in the `data` section of the ConfigMap. The file contents become the key's value.
|
As explained in [Configure Containers Using a ConfigMap](/docs/tasks/configure-pod-container/configmap/), when you create a ConfigMap using ``--from-file``, the filename becomes a key stored in the `data` section of the ConfigMap. The file contents become the key's value.
|
||||||
|
|
||||||
The examples in this section refer to a ConfigMap named special-config, shown below.
|
The examples in this section refer to a ConfigMap named special-config, shown below.
|
||||||
|
|
||||||
|
|||||||
@@ -9,7 +9,7 @@ title: Configure Service Accounts for Pods
|
|||||||
A service account provides an identity for processes that run in a Pod.
|
A service account provides an identity for processes that run in a Pod.
|
||||||
|
|
||||||
*This is a user introduction to Service Accounts. See also the
|
*This is a user introduction to Service Accounts. See also the
|
||||||
[Cluster Admin Guide to Service Accounts](/docs/admin/service-accounts-admin).*
|
[Cluster Admin Guide to Service Accounts](/docs/admin/service-accounts-admin/).*
|
||||||
|
|
||||||
**Note:** This document describes how service accounts behave in a cluster set up
|
**Note:** This document describes how service accounts behave in a cluster set up
|
||||||
as recommended by the Kubernetes project. Your cluster administrator may have
|
as recommended by the Kubernetes project. Your cluster administrator may have
|
||||||
|
|||||||
@@ -468,7 +468,7 @@ as described in the
|
|||||||
|
|
||||||
## Removing a cluster from a federation
|
## Removing a cluster from a federation
|
||||||
|
|
||||||
To remove a cluster from a federation, run the [`kubefed unjoin`](/docs/admin/kubefed_unjoin)
|
To remove a cluster from a federation, run the [`kubefed unjoin`](/docs/admin/kubefed_unjoin/)
|
||||||
command with the cluster name and the federation's
|
command with the cluster name and the federation's
|
||||||
`--host-cluster-context`:
|
`--host-cluster-context`:
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user