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 bb1aca5
Showing 1 changed file with 29 additions and 0 deletions.
29 changes: 29 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,32 @@ 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 `--vpc-endpoint-access-public` and/or`--vpc-endpoint-access-private` 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 bb1aca5

Please sign in to comment.