From 0f6066e43f2c940795319b4248a3a817f63f983c Mon Sep 17 00:00:00 2001 From: Murali Reddy Date: Thu, 22 Jun 2017 14:38:54 +0530 Subject: [PATCH] update kops.md documentaition to reflect kops 1.6.2 with kube-router support --- Documentation/kops.md | 51 +++---------------------------------------- 1 file changed, 3 insertions(+), 48 deletions(-) diff --git a/Documentation/kops.md b/Documentation/kops.md index 385ec7dda5..3a71668d40 100644 --- a/Documentation/kops.md +++ b/Documentation/kops.md @@ -1,52 +1,7 @@ # Kops Integration -The following instructions and examples demonstrate how to create a new [Kops](https://github.com/kubernetes/kops/) provisioned Kubernetes cluster using kube-router. Kube-router will provide an IPVS based service proxy (replacing kube-proxy), a network policy enforcer and also provides pod-to-pod networking. - - -We are working to get the Kube-router support in Kops thorugh [#2606](https://github.com/kubernetes/kops/issues/2606). Till we get the support in upstream kops, you can use patched kops. Following instruction will walk through setting up cluster with patche kops - - -## Instructions - -- Please download the [Linux](https://s3.amazonaws.com/nodeupbkt/kops/1.6.0/linux/amd64/kops) or [Mac](https://s3.amazonaws.com/nodeupbkt/kops/1.6.0/darwin/amd64/kops) patched version of KOPS with support for Kube-router. - -- Please run `kops create cluster --help` to see the support for kube-router in `--networking` flag. You should see as below - -``` ---networking string Networking mode to use. kubenet (default), classic, external, kopeio-vxlan (or kopeio), weave, flannel, calico, canal, kube-router. (default "kubenet") -``` - -- Please export KOPS_BASE_URL as environment variable `export KOPS_BASE_URL=https://nodeupbkt.s3.amazonaws.com/kops/1.6.0/` this will make kops to use patched protokube and nodeup with support for Kube-router - -- Now you can deploy cluster with `--networking` flag set to `kube-router`. For e.g as shown below, all kops functionality remains same, so you configure rest of the param as you need. - -``` -kops create cluster \ - --node-count 2 \ - --zones us-west-2a \ - --master-zones us-west-2a \ - --dns-zone aws.cloudnativelabs.net \ - --node-size t2.medium \ - --master-size t2.medium \ - --networking kube-router \ - mycluster.aws.cloudnativelabs.net -``` - -- Now provision cluster - -``` -kops update cluster mycluster.aws.cloudnativelabs.net --yes -``` - -- It would take couple of minutes to provision cluster. Once cluster is provisioned please veriy kube-router running on each node `kubectl get pods --all-namespaces` - -- At this point your cluster control plane is setup. One last is step is needed for pod connectivity. Since kube-router uses host based routing, AWS instances will send and recieve traffic from IP in the pod CIDR range. AWS by default drops packets destined to instance and from instances with IP not in subnet range. So we will need to perform disable source and desintation check on each instance by running below command - -``` -aws ec2 modify-instance-attribute --instance-id --no-source-dest-check -``` - -At this point your cluster is ready to deploy pods, services, network policies etc. Please report if you face any issue. - +Kops version 1.6.2 and above now officially includes kube-router integration. +Please follow the instruction at https://github.com/kubernetes/kops/blob/master/docs/networking.md#kube-router-example-for-cni-ipvs-based-service-proxy-and-network-policy-enforcer to provision a Kubernetes cluster with Kube-router. +Uses the kops [latest version](https://github.com/kubernetes/kops/releases/tag/1.6.2) binaries which has the kube-router support.