From 92baa2bc97e4d9094cf8c0b41be008e055461e7c Mon Sep 17 00:00:00 2001 From: makocchi Date: Thu, 19 Jul 2018 08:37:46 +0900 Subject: [PATCH] Fix dead links and apply template (#9476) * fix dead links and apply template * fix conflicts * re-fix dead links * Revert "re-fix dead links" This reverts commit 3eb8292f45c6453c577f6fc4a49600da291d8622. --- content/en/docs/setup/pick-right-solution.md | 59 +++++++++++--------- 1 file changed, 34 insertions(+), 25 deletions(-) diff --git a/content/en/docs/setup/pick-right-solution.md b/content/en/docs/setup/pick-right-solution.md index e3d2129397..4a01647ed8 100644 --- a/content/en/docs/setup/pick-right-solution.md +++ b/content/en/docs/setup/pick-right-solution.md @@ -4,8 +4,11 @@ reviewers: - erictune - mikedanese title: Picking the Right Solution +content_template: templates/concept --- +{{% capture overview %}} + Kubernetes can run on various platforms: from your laptop, to VMs on a cloud provider, to a rack of bare metal servers. The effort required to set up a cluster varies from running a single command to crafting your own customized cluster. Use this guide to choose a solution that fits your needs. @@ -22,11 +25,13 @@ If you already have a way to configure hosting resources, use [kubeadm](/docs/se [Custom solutions](#custom-solutions) vary from step-by-step instructions to general advice for setting up a Kubernetes cluster from scratch. -{{< toc >}} +{{% /capture %}} -# Local-machine Solutions +{{% capture body %}} -* [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. +## Local-machine Solutions + +* [Minikube](/docs/setup/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. * [Kubeadm-dind](https://github.com/kubernetes-sigs/kubeadm-dind-cluster) is a multi-node (while minikube is single-node) Kubernetes cluster which only requires a docker daemon. It uses docker-in-docker technique to spawn the Kubernetes cluster. @@ -36,7 +41,7 @@ a Kubernetes cluster from scratch. * [IBM Cloud Private-CE (Community Edition) on Linux Containers](https://github.com/HSBawa/icp-ce-on-linux-containers) is a Terraform/Packer/BASH based Infrastructure as Code (IaC) scripts to create a seven node (1 Boot, 1 Master, 1 Management, 1 Proxy and 3 Workers) LXD cluster on Linux Host. -# Hosted Solutions +## Hosted Solutions * [Google Kubernetes Engine](https://cloud.google.com/kubernetes-engine/) offers managed Kubernetes clusters. @@ -88,7 +93,7 @@ few commands. These solutions are actively developed and have active community s * [Gardener](https://gardener.cloud/) * [Kublr](https://kublr.com/) -# On-Premises turnkey cloud solutions +## On-Premises turnkey cloud solutions These solutions allow you to create Kubernetes clusters on your internal, secure, cloud network with only a few commands. @@ -99,7 +104,7 @@ few commands. * [Rancher 2.0](https://rancher.com/docs/rancher/v2.x/en/) * [Kublr](https://kublr.com/) -# Custom Solutions +## Custom Solutions Kubernetes can run on a wide range of Cloud providers and bare-metal environments, and with many base operating systems. @@ -107,54 +112,54 @@ 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 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 -cluster, try the [Getting Started from Scratch](/docs/getting-started-guides/scratch/) guide. +cluster, try the [Getting Started from Scratch](/docs/setup/scratch/) guide. 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). -## Universal +### Universal If you already have a way to configure hosting resources, use [kubeadm](/docs/setup/independent/create-cluster-kubeadm/) to easily bring up a cluster with a single command per machine. -## Cloud +### Cloud 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/setup/custom-cloud/coreos/) * [Kubernetes on Ubuntu](/docs/getting-started-guides/ubuntu/) -* [Kubespray](/docs/getting-started-guides/kubespray/) +* [Kubespray](/docs/setup/custom-cloud/kubespray/) * [Rancher Kubernetes Engine (RKE)](https://github.com/rancher/rke) * [Gardener](https://gardener.cloud/) * [Kublr](https://kublr.com/) -## On-Premises VMs +### On-Premises VMs -* [Vagrant](/docs/getting-started-guides/coreos/) (uses CoreOS and flannel) -* [CloudStack](/docs/getting-started-guides/cloudstack/) (uses Ansible, CoreOS and flannel) +* [Vagrant](/docs/setup/custom-cloud/coreos/) (uses CoreOS and flannel) +* [CloudStack](/docs/setup/on-premises-vm/cloudstack/) (uses Ansible, CoreOS and flannel) * [VMware vSphere](https://vmware.github.io/vsphere-storage-for-kubernetes/documentation/) * [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) -* [oVirt](/docs/getting-started-guides/ovirt/) +* [VMware](/docs/setup/custom-cloud/coreos/) (uses CoreOS and flannel) +* [oVirt](/docs/setup/on-premises-vm/ovirt/) * [Fedora (Multi Node)](/docs/getting-started-guides/fedora/flannel_multi_node_cluster/) (uses Fedora and flannel) -## Bare Metal +### Bare Metal * [Fedora (Single Node)](/docs/getting-started-guides/fedora/fedora_manual_config/) * [Fedora (Multi Node)](/docs/getting-started-guides/fedora/flannel_multi_node_cluster/) * [Kubernetes on Ubuntu](/docs/getting-started-guides/ubuntu/) -* [CoreOS](/docs/getting-started-guides/coreos/) +* [CoreOS](/docs/setup/custom-cloud/coreos/) -## Integrations +### Integrations These solutions provide integration with third-party schedulers, resource managers, and/or lower level platforms. -* [DCOS](/docs/getting-started-guides/dcos/) +* [DCOS](/docs/setup/on-premises-vm/dcos/) * Community Edition DCOS uses AWS * Enterprise Edition DCOS supports cloud hosting, on-premises VMs, and bare metal -# Table of Solutions +## Table of Solutions Below is a table of all of the solutions listed above. @@ -194,15 +199,17 @@ Bare Metal | Juju | Ubuntu | flannel/calico/canal | [docs] AWS | Saltstack | Debian | AWS | [docs](/docs/setup/turnkey/aws/) | 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)) -oVirt | | | | [docs](/docs/getting-started-guides/ovirt/) | Community ([@simon3z](https://github.com/simon3z)) -any | any | any | any | [docs](/docs/getting-started-guides/scratch/) | Community ([@erictune](https://github.com/erictune)) +oVirt | | | | [docs](/docs/setup/on-premises-vm/ovirt/) | Community ([@simon3z](https://github.com/simon3z)) +any | any | any | any | [docs](/docs/setup/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 | RKE | multi-support | flannel or canal | [docs](https://rancher.com/docs/rancher/v2.x/en/quick-start-guide/) | [Commercial](https://rancher.com/what-is-rancher/overview/) and [Community](https://github.com/rancher/rancher) any | [Gardener Cluster-Operator](https://kubernetes.io/blog/2018/05/17/gardener/) | multi-support | multi-support | [docs](https://gardener.cloud) | [Project/Community](https://github.com/gardener) and [Commercial]( https://cloudplatform.sap.com/) -**Note**: The above table is ordered by version test/used in nodes, followed by support level. +{{< note >}} +**Note:** The above table is ordered by version test/used in nodes, followed by support level. +{{< /note >}} -## Definition of columns +### Definition of columns * **IaaS Provider** is the product or organization which provides the virtual or physical machines (nodes) that Kubernetes runs on. * **OS** is the base operating system of the nodes. @@ -228,3 +235,5 @@ any | [Gardener Cluster-Operator](https://kubernetes.io/blog/20 [2]: https://gist.github.com/derekwaynecarr/505e56036cdf010bf6b6 [3]: https://gist.github.com/erictune/2f39b22f72565365e59b + +{{% /capture %}}