up-to-date on content/ko (#42)

related #40

content/ko/docs/home/_index.md

@@ -8,5 +8,11 @@ js: /js/user-journeys/home.js, https://use.fontawesome.com/4bcc658a89.js
 display_browse_numbers: true
 linkTitle: "문서"
 main_menu: true
-weight: 5
+weight: 10
+menu:
+  main:
+    title: "문서"
+    weight: 20
+    post: >
+      <p>Learn how to use Kubernetes with the use of walkthroughs, samples, and reference documentation. You can even <a href="/editdocs/" data-auto-burger-exclude>help contribute to the docs</a>!</p>
 ---

content/ko/docs/setup/building-from-source.md

@@ -2,7 +2,7 @@
 title: 소스로부터 빌드
 ---
 
-You can either build a release from source or download a pre-built release.  If you do not plan on developing Kubernetes itself, we suggest using a pre-built version of the current release, which can be found in the [Release Notes](/docs/imported/release/notes/).
+You can either build a release from source or download a pre-built release.  If you do not plan on developing Kubernetes itself, we suggest using a pre-built version of the current release, which can be found in the [Release Notes](/docs/setup/release/notes/).
 
 The Kubernetes source code can be downloaded from the [kubernetes/kubernetes](https://github.com/kubernetes/kubernetes) repo.
 

content/ko/docs/setup/cluster-large.md

@@ -1,5 +1,6 @@
 ---
 title: 대형 클러스터 구축
+weight: 80
 ---
 
 ## 지원

content/ko/docs/setup/custom-cloud/_index.md

@@ -1,3 +1,4 @@
 ---
 title: 사용자 지정 클라우드 솔루션
+weight: 50
 ---

content/ko/docs/setup/custom-cloud/coreos.md

@@ -1,84 +1,79 @@
 ---
 title: CoreOS on AWS or GCE
+content_template: templates/concept
 ---
 
-{{< toc >}}
+{{% capture overview %}}
 
-There are multiple guides on running Kubernetes with [CoreOS](https://coreos.com/kubernetes/docs/latest/):
+There are multiple guides on running Kubernetes with [CoreOS](https://coreos.com/kubernetes/docs/latest/).
 
-### Official CoreOS Guides
+{{% /capture %}}
 
-These guides are maintained by CoreOS and deploy Kubernetes the "CoreOS Way" with full TLS, the DNS add-on, and more. These guides pass Kubernetes conformance testing and we encourage you to [test this yourself](https://coreos.com/kubernetes/docs/latest/conformance-tests.html).
-
-[**AWS Multi-Node**](https://coreos.com/kubernetes/docs/latest/kubernetes-on-aws.html)
+{{% capture body %}}
 
-Guide and CLI tool for setting up a multi-node cluster on AWS. CloudFormation is used to set up a master and multiple workers in auto-scaling groups.
+## Official CoreOS Guides
 
-<hr/>
+These guides are maintained by CoreOS and deploy Kubernetes the "CoreOS Way" with full TLS, the DNS add-on, and more. These guides pass Kubernetes conformance testing and we encourage you to [test this yourself](https://coreos.com/kubernetes/docs/latest/conformance-tests.html).
 
-[**Bare Metal Multi-Node**](https://coreos.com/kubernetes/docs/latest/kubernetes-on-baremetal.html#automated-provisioning)
+* [**AWS Multi-Node**](https://coreos.com/kubernetes/docs/latest/kubernetes-on-aws.html)
 
-Guide and HTTP/API service for PXE booting and provisioning a multi-node cluster on bare metal. [Ignition](https://coreos.com/ignition/docs/latest/) is used to provision a master and multiple workers on the first boot from disk.
+    Guide and CLI tool for setting up a multi-node cluster on AWS.
+    CloudFormation is used to set up a master and multiple workers in auto-scaling groups.
 
-[**Vagrant Multi-Node**](https://coreos.com/kubernetes/docs/latest/kubernetes-on-vagrant.html)
+* [**Bare Metal Multi-Node**](https://coreos.com/kubernetes/docs/latest/kubernetes-on-baremetal.html#automated-provisioning)
 
-Guide to setting up a multi-node cluster on Vagrant. The deployer can independently configure the number of etcd nodes, master nodes, and worker nodes to bring up a fully HA control plane.
+    Guide and HTTP/API service for PXE booting and provisioning a multi-node cluster on bare metal.
+    [Ignition](https://coreos.com/ignition/docs/latest/) is used to provision a master and multiple workers on the first boot from disk.
 
-<hr/>
+* [**Vagrant Multi-Node**](https://coreos.com/kubernetes/docs/latest/kubernetes-on-vagrant.html)
 
-[**Vagrant Single-Node**](https://coreos.com/kubernetes/docs/latest/kubernetes-on-vagrant-single.html)
+    Guide to setting up a multi-node cluster on Vagrant.
+    The deployer can independently configure the number of etcd nodes, master nodes, and worker nodes to bring up a fully HA control plane.
 
-The quickest way to set up a Kubernetes development environment locally. As easy as `git clone`, `vagrant up` and configuring `kubectl`.
+* [**Vagrant Single-Node**](https://coreos.com/kubernetes/docs/latest/kubernetes-on-vagrant-single.html)
 
-<hr/>
+    The quickest way to set up a Kubernetes development environment locally.
+    As easy as `git clone`, `vagrant up` and configuring `kubectl`.
 
-[**Full Step by Step Guide**](https://coreos.com/kubernetes/docs/latest/getting-started.html)
+* [**Full Step by Step Guide**](https://coreos.com/kubernetes/docs/latest/getting-started.html)
 
-A generic guide to setting up an HA cluster on any cloud or bare metal, with full TLS. Repeat the master or worker steps to configure more machines of that role.
+    A generic guide to setting up an HA cluster on any cloud or bare metal, with full TLS.
+    Repeat the master or worker steps to configure more machines of that role.
 
-### Community Guides
+## Community Guides
 
 These guides are maintained by community members, cover specific platforms and use cases, and experiment with different ways of configuring Kubernetes on CoreOS.
 
-[**Easy Multi-node Cluster on Google Compute Engine**](https://github.com/rimusz/coreos-multi-node-k8s-gce/blob/master/README.md)
-
-Scripted installation of a single master, multi-worker cluster on GCE. Kubernetes components are managed by [fleet](https://github.com/coreos/fleet).
-
-<hr/>
+* [**Easy Multi-node Cluster on Google Compute Engine**](https://github.com/rimusz/coreos-multi-node-k8s-gce/blob/master/README.md)
 
-[**Multi-node cluster using cloud-config and Weave on Vagrant**](https://github.com/errordeveloper/weave-demos/blob/master/poseidon/README.md)
+    Scripted installation of a single master, multi-worker cluster on GCE.
+    Kubernetes components are managed by [fleet](https://github.com/coreos/fleet).
 
-Configure a Vagrant-based cluster of 3 machines with networking provided by Weave.
+* [**Multi-node cluster using cloud-config and Weave on Vagrant**](https://github.com/errordeveloper/weave-demos/blob/master/poseidon/README.md)
 
-<hr/>
+    Configure a Vagrant-based cluster of 3 machines with networking provided by Weave.
 
-[**Multi-node cluster using cloud-config and Vagrant**](https://github.com/pires/kubernetes-vagrant-coreos-cluster/blob/master/README.md)
+* [**Multi-node cluster using cloud-config and Vagrant**](https://github.com/pires/kubernetes-vagrant-coreos-cluster/blob/master/README.md)
 
-Configure a single master, multi-worker cluster locally, running on your choice of hypervisor: VirtualBox, Parallels, or VMware
+    Configure a single master, multi-worker cluster locally, running on your choice of hypervisor: VirtualBox, Parallels, or VMware
 
-<hr/>
+* [**Single-node cluster using a small macOS App**](https://github.com/rimusz/kube-solo-osx/blob/master/README.md)
 
-[**Single-node cluster using a small macOS App**](https://github.com/rimusz/kube-solo-osx/blob/master/README.md)
+    Guide to running a solo cluster (master + worker) controlled by an macOS menubar application.
+    Uses xhyve + CoreOS under the hood.
 
-Guide to running a solo cluster (master + worker) controlled by an macOS menubar application. Uses xhyve + CoreOS under the hood.
+* [**Multi-node cluster with Vagrant and fleet units using a small macOS App**](https://github.com/rimusz/coreos-osx-gui-kubernetes-cluster/blob/master/README.md)
 
-<hr/>
+    Guide to running a single master, multi-worker cluster controlled by an macOS menubar application.
+    Uses Vagrant under the hood.
 
-[**Multi-node cluster with Vagrant and fleet units using a small macOS App**](https://github.com/rimusz/coreos-osx-gui-kubernetes-cluster/blob/master/README.md)
+* [**Multi-node cluster using cloud-config, CoreOS and VMware ESXi**](https://github.com/xavierbaude/VMware-coreos-multi-nodes-Kubernetes)
 
-Guide to running a single master, multi-worker cluster controlled by an macOS menubar application. Uses Vagrant under the hood.
+    Configure a single master, single worker cluster on VMware ESXi.
 
-<hr/>
+* [**Single/Multi-node cluster using cloud-config, CoreOS and Foreman**](https://github.com/johscheuer/theforeman-coreos-kubernetes)
 
-[**Multi-node cluster using cloud-config, CoreOS and VMware ESXi**](https://github.com/xavierbaude/VMware-coreos-multi-nodes-Kubernetes)
-
-Configure a single master, single worker cluster on VMware ESXi.
-
-<hr/>
-
-[**Single/Multi-node cluster using cloud-config, CoreOS and Foreman**](https://github.com/johscheuer/theforeman-coreos-kubernetes)
-
-Configure a standalone Kubernetes or a Kubernetes cluster with [Foreman](https://theforeman.org).
+    Configure a standalone Kubernetes or a Kubernetes cluster with [Foreman](https://theforeman.org).
 
 ## Support Level
 
@@ -89,3 +84,5 @@ GCE                  | CoreOS       | CoreOS | flannel     | [docs](/docs/gettin
 Vagrant              | CoreOS       | CoreOS | flannel     | [docs](/docs/getting-started-guides/coreos)                                 |          | Community ([@pires](https://github.com/pires), [@AntonioMeireles](https://github.com/AntonioMeireles))
 
 For support level information on all solutions, see the [Table of solutions](/docs/getting-started-guides/#table-of-solutions) chart.
+
+{{% /capture %}}

content/ko/docs/setup/custom-cloud/kops.md

@@ -1,8 +1,9 @@
 ---
 title: Installing Kubernetes on AWS with kops
+content_template: templates/concept
 ---
 
-## Overview
+{{% capture overview %}}
 
 This quickstart shows you how to easily install a Kubernetes cluster on AWS.
 It uses a tool called [`kops`](https://github.com/kubernetes/kops).
@@ -12,13 +13,17 @@ kops is an opinionated provisioning system:
 * Fully automated installation
 * Uses DNS to identify clusters
 * Self-healing: everything runs in Auto-Scaling Groups
-* Limited OS support (Debian preferred, Ubuntu 16.04 supported, early support for CentOS & RHEL)
-* High-Availability support
-* Can directly provision, or generate terraform manifests
+* Multiple OS support (Debian, Ubuntu 16.04 supported, CentOS & RHEL, Amazon Linux and CoreOS) - see the [images.md](https://github.com/kubernetes/kops/blob/master/docs/images.md)
+* High-Availability support - see the [high_availability.md](https://github.com/kubernetes/kops/blob/master/docs/high_availability.md)
+* Can directly provision, or generate terraform manifests - see the [terraform.md](https://github.com/kubernetes/kops/blob/master/docs/terraform.md)
 
 If your opinions differ from these you may prefer to build your own cluster using [kubeadm](/docs/admin/kubeadm/) as
 a building block.  kops builds on the kubeadm work.
 
+{{% /capture %}}
+
+{{% capture body %}}
+
 ## Creating a cluster
 
 ### (1/5) Install kops
@@ -33,8 +38,8 @@ Download kops from the [releases page](https://github.com/kubernetes/kops/releas
 
 On macOS:
 
-```
-curl -OL https://github.com/kubernetes/kops/releases/download/1.8.0/kops-darwin-amd64
+```shell
+curl -OL https://github.com/kubernetes/kops/releases/download/1.10.0/kops-darwin-amd64
 chmod +x kops-darwin-amd64
 mv kops-darwin-amd64 /usr/local/bin/kops
 # you can also install using Homebrew
@@ -43,8 +48,8 @@ brew update && brew install kops
 
 On Linux:
 
-```
-wget https://github.com/kubernetes/kops/releases/download/1.8.0/kops-linux-amd64
+```shell
+wget https://github.com/kubernetes/kops/releases/download/1.10.0/kops-linux-amd64
 chmod +x kops-linux-amd64
 mv kops-linux-amd64 /usr/local/bin/kops
 ```
@@ -149,17 +154,21 @@ for production clusters!
 
 See the [list of add-ons](/docs/concepts/cluster-administration/addons/) to explore other add-ons, including tools for logging, monitoring, network policy, visualization & control of your Kubernetes cluster.
 
-## What's next
-
-* Learn more about Kubernetes [concepts](/docs/concepts/) and [`kubectl`](/docs/user-guide/kubectl-overview/).
-* Learn about `kops` [advanced usage](https://github.com/kubernetes/kops)
-
 ## Cleanup
 
 * To delete your cluster: `kops delete cluster useast1.dev.example.com --yes`
 
 ## Feedback
 
-* Slack Channel: [#sig-aws](https://kubernetes.slack.com/messages/sig-aws/) has a lot of kops users
+* Slack Channel: [#kops-users](https://kubernetes.slack.com/messages/kops-users/)
 * [GitHub Issues](https://github.com/kubernetes/kops/issues)
 
+{{% /capture %}}
+
+{{% capture whatsnext %}}
+
+* Learn more about Kubernetes [concepts](/docs/concepts/) and [`kubectl`](/docs/user-guide/kubectl-overview/).
+* Learn about `kops` [advanced usage](https://github.com/kubernetes/kops)
+* See the `kops` [docs](https://github.com/kubernetes/kops) section for tutorials, best practices and advanced configuration options.
+
+{{% /capture %}}

content/ko/docs/setup/custom-cloud/kubespray.md

@@ -1,8 +1,9 @@
 ---
 title: Installing Kubernetes On-premises/Cloud Providers with Kubespray
+content_template: templates/concept
 ---
 
-## Overview
+{{% capture overview %}}
 
 This quickstart helps to install a Kubernetes cluster hosted on GCE, Azure, OpenStack, AWS, or Baremetal with [Kubespray](https://github.com/kubernetes-incubator/kubespray).
 
@@ -15,22 +16,23 @@ Kubespray is a composition of [Ansible](http://docs.ansible.com/) playbooks, [in
 
 To choose a tool which best fits your use case, read [this comparison](https://github.com/kubernetes-incubator/kubespray/blob/master/docs/comparisons.md) to [kubeadm](/docs/admin/kubeadm/) and [kops](../kops).
 
+{{% /capture %}}
+
+{{% capture body %}}
+
 ## Creating a cluster
 
-### (1/5) Meet the underlay [requirements](https://github.com/kubernetes-incubator/kubespray#requirements)
+### (1/5) Meet the underlay requirements
 
-Provision servers with the following requirements:
+Provision servers with the following [requirements](https://github.com/kubernetes-incubator/kubespray#requirements):
 
-* `Ansible v2.4` (or newer)
-* `Jinja 2.9` (or newer)
-* `python-netaddr` installed on the machine that running Ansible commands
-* Target servers must have access to the Internet in order to pull docker images
-* Target servers are configured to allow IPv4 forwarding
-* Target servers have SSH connectivity ( tcp/22 ) directly to your nodes or through a bastion host/ssh jump box
-* Target servers have a privileged user
-* Your SSH key must be copied to all the servers that are part of your inventory
-* Firewall rules configured properly to allow Ansible and Kubernetes components to communicate
-* If using a cloud provider, you must have the appropriate credentials available and exported as environment variables
+* **Ansible v2.4 (or newer) and python-netaddr is installed on the machine that will run Ansible commands**
+* **Jinja 2.9 (or newer) is required to run the Ansible Playbooks**
+* The target servers must have **access to the Internet** in order to pull docker images
+* The target servers are configured to allow **IPv4 forwarding**
+* **Your ssh key must be copied** to all the servers part of your inventory
+* The **firewalls are not managed**, you'll need to implement your own rules the way you used to. in order to avoid any issue during deployment you should disable your firewall
+* If kubespray is ran from non-root user account, correct privilege escalation method should be configured in the target servers. Then the `ansible_become` flag or command parameters `--become` or `-b` should be specified
 
 Kubespray provides the following utilities to help provision your environment:
 
@@ -61,12 +63,12 @@ Kubespray customizations can be made to a [variable file](http://docs.ansible.co
 Next, deploy your cluster:
 
 Cluster deployment using [ansible-playbook](https://github.com/kubernetes-incubator/kubespray/blob/master/docs/getting-started.md#starting-custom-deployment).
-```console
+
+```shell
 ansible-playbook -i your/inventory/hosts.ini cluster.yml -b -v \
   --private-key=~/.ssh/private_key
 ```
 
-
 Large deployments (100+ nodes) may require [specific adjustments](https://github.com/kubernetes-incubator/kubespray/blob/master/docs/large-deployments.md) for best results.
 
 ### (5/5) Verify the deployment
@@ -86,10 +88,6 @@ You can remove worker nodes from your cluster by running the remove-node playboo
 
 You can upgrade your cluster by running the upgrade-cluster playbook. For more information, see "[Upgrades](https://github.com/kubernetes-incubator/kubespray/blob/master/docs/upgrades.md)".
 
-## What's next
-
-Check out planned work on Kubespray's [roadmap](https://github.com/kubernetes-incubator/kubespray/blob/master/docs/roadmap.md).
-
 ## Cleanup
 
 You can reset your nodes and wipe out all components installed with Kubespray via the [reset playbook](https://github.com/kubernetes-incubator/kubespray/blob/master/reset.yml).
@@ -102,3 +100,11 @@ You can reset your nodes and wipe out all components installed with Kubespray vi
 
 * Slack Channel: [#kubespray](https://kubernetes.slack.com/messages/kubespray/)
 * [GitHub Issues](https://github.com/kubernetes-incubator/kubespray/issues)
+
+{{% /capture %}}
+
+{{% capture whatsnext %}}
+
+Check out planned work on Kubespray's [roadmap](https://github.com/kubernetes-incubator/kubespray/blob/master/docs/roadmap.md).
+
+{{% /capture %}}