Setting up Kubernetes Clusters on Amazon VPC based Private Subnets

Using Amazon Virtual Private Cloud (VPC) based private subnets to deploy Platform9 Managed Kubernetes clusters improves the security of your application deployment.

Putting both master and worker nodes on private subnets prevents direct reachability to the nodes from the Internet, and reduces the overall attack surface. All master and worker nodes can access the Internet through a NAT gateway. The nodes can be accessed via a bastion host, if required.

If you are using site-to-site VPNs from your corporate network to Amazon Web Services (AWS), you may want to utilize private subnets, so that you can deploy the Kubernetes hosts on the address space that matches what you use internally. In this case, the Kubernetes hosts would be reachable from the corporate network via a secure VPN or a dedicated AWS connection, instead of transiting the insecure public Internet.

The following diagram is a conceptual representation of an Amazon VPC with a public subnet and a private subnet.

You can deploy your Kubernetes cluster on a setup that is similar to the setup seen in the above diagram.

Before you can create a Kubernetes cluster on an Amazon VPC based private subnet, you must have added AWS as your cloud provider. Refer to this article to add AWS as your cloud provider.

You can then take one of the following two paths to create a Kubernetes cluster.

  • Create a Kubernetes cluster on an existing private subnet on your Amazon VPC.
  • Create a VPC with public and private subnets during the creation of a Kubernetes cluster, and then create the cluster on the newly created private subnet.

The sections that follow provide details to

  • Create a VPC
  • Create a Kubernetes Cluster with Clarity UI

Create VPC

The following criteria must be satisfied by the Amazon VPC based private subnet, on which you want to deploy your Kubernetes cluster.

  • A private subnet and a public subnet must be provided for each availability zone selected from the Amazon VPC.
  • The private subnet should have external connectivity through a NAT gateway.
  • The NAT gateway itself should be in the public subnet in order to get external connectivity.

Follow the steps given below to create a VPC and configure public and private subnets required for the Kubernetes cluster.

  1. Create a VPC with a /16 IPv4 CIDR block. Refer to Step 1-Create the VPC in http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/getting-started-ipv4.html for details.
  2. Edit the VPC to enable DNS hostname. Refer to http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/vpc-dns.html to enable DNS hostname.
  3. Create a subnet on the VPC that can be used by elastic load balancers(ELB). This is your public subnet. Refer to http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_Subnets.html#AddaSubnet to add a subnet.
  4. Enable auto-assignment of public IPv4 addresses for the public subnet created in the step above. Refer to http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/vpc-ip-addressing.html#subnet-public-ip to enable auto-assignment of IPv4 addresses.
  5. Create and attach an Internet gateway to your VPC. Refer to the Attaching an Internet Gateway section at http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_Internet_Gateway.html, to create and attach an internet gateway to the VPC.
  6. Create a route table in your VPC and add a route with a destination of 0.0.0.0/0 for IPv4 traffic. Refer to http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_Internet_Gateway.html for details.
  7. Forward all traffic to the Internet gateway for this route.
  8. Set the route table as the main route table. Refer to the Main Route Tables section in http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_Route_Tables.html for details.
  9. Create a  subnet on the VPC.  Ensure that the auto-assign IP address attribute is disabled so that this becomes a private subnet. Ensure that the availability zone for this subnet is the same as the one that is used in the public subnet.
  10. Create a NAT gateway on the public subnet. While creating the NAT gateway, create an Elastic IP and assign it to the NAT gateway. Refer to http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/vpc-nat-gateway.html#nat-gateway-creating for details.
  11. Create a route table for the private subnet. This is the NAT route table. Add a route for the NAT table and forward all traffic to the NAT gateway created on the VPC.
  12. Edit the route table subnet association to associate the NAT route table with the private subnet.
  13. Repeat the steps 3 to 12 for each availability zone to create public and private subnets for the availability zone.

The public subnet is accessible through the Internet gateway and the private network is accessible through the NAT gateway.

You can deploy your applications on the private subnet.

Create Kubernetes Cluster with Clarity UI

You must have a private subnet configured on your Amazon VPC before you can create and deploy a Kubernetes cluster on the private subnet.

You could use an existing private subnet that has already been configured on your Amazon VPC.

Alternatively, you can create a VPC with public and private subnets during the creation of the Kubernetes cluster. The procedure to create a VPC has been described in the Create VPC section above.

Follow the steps given below to create a Kubernetes Cluster on an Amazon VPC based private subnet, by using the Platform9 Clarity UI.

  1. Log in to Platform9 Clarity UI with your credentials.
  2. Click Infrastructure>Clusters>Add Cluster.
  3. Select Auto-deploy cluster as the Deployment Type.
    Select the cloud provider to auto-deploy the cluster on and also select the Region.
  4. Click Next.
  5. Enter the cluster configuration details. It is recommended that you select  region having at least three availability zones.
  6. Click Next.
  7. Enter the network related details corresponding to the availability zone selected in the cluster configuration details.
    You can either choose to create a new VPC which will automatically create everything for you or choose the private subnets that you have already created in a given VPC. Refer to the Create VPC section above to create a new VPC.
    Select the private network check box and select the private network configured on Amazon VPC.
  8. Click Next and review the cluster details.
  9. Click Create Cluster to create and deploy the newly created Kubernetes cluster on the Amazon VPC based private subnet.

The browser you are using is outdated. For the best experience please download or update your browser to one of the following: