Skip to content

Commit

Permalink
Added API Server Endpoint Access documentation
Browse files Browse the repository at this point in the history
Added a section in `site/content/usage/06-vpc-networking.md`on how to
enable/disable public and private API server endpoint access via the
CLI and via the ClusterConfig file
  • Loading branch information
D3nn committed Aug 21, 2019
1 parent d4366f4 commit b4d0eea
Showing 1 changed file with 26 additions and 0 deletions.
26 changes: 26 additions & 0 deletions site/content/usage/06-vpc-networking.md
Original file line number Diff line number Diff line change
Expand Up @@ -160,3 +160,29 @@ See the complete example [here](https://github.com/weaveworks/eksctl/blob/master

**Note**: Specifying the NAT Gateway is only supported during cluster creation and it is not touched during a cluster
upgrade. There are plans to support changing between different modes on cluster update in the future.

### Managing Access to the Kubernetes API Server Endpoints

The default creation of an EKS cluster exposes the Kubernetes API server publicly but not directly from within the
VPC subnets (Public=true, Private=false). Traffic destined for the API server from within the VPC
must first exit
the VPC networks (but not Amazon's network) and then re-enter to reach the API server. Allowing
direct access from
within the VPC subnets is possible but not without some caveats.
See [Amazon EKS Cluster
Endpoint Access Control](https://docs.aws.amazon.com/eks/latest/userguide/cluster-endpoint.html) for
further information on additional steps needed when public=false, private=true.

The Kubernetes API server endpoint access for a cluster can be cofigured for public and private
access by specifiying
the `--public-endpoint-access` and/or `--private-endpoint-access` CLI flags to be `true` (access
enabled) or
`false` (access disabled). Alternatively, one can configure access in the cluster config file like
the example below:

```yaml
vpc:
endpointAccess:
public: <true|false>
private: <true|false>
```

0 comments on commit b4d0eea

Please sign in to comment.