Add instructions on how to enable the docker bridge network (#352)

Signed-off-by: Andrew Roth <roth.andy@gmail.com>
This commit is contained in:
Andrew Roth
2019-04-18 03:26:13 -04:00
committed by Max Williams
parent 1a26f353d8
commit b2da12dc6e
3 changed files with 25 additions and 0 deletions

View File

@@ -15,6 +15,7 @@ project adheres to [Semantic Versioning](http://semver.org/).
### Changed
- Add instructions on how to enable the docker bridge network (by @rothandrew)
- Write your awesome change here (by @you)
# History

View File

@@ -44,6 +44,7 @@ module "my-cluster" {
## Other documentation
- [Autoscaling](docs/autoscaling.md): How to enabled worker node autoscaling.
- [Enable Docker Bridge Network](docs/enable-docker-bridge-network.md): How to enable the docker bridge network when using the EKS-optimized AMI, which disables it by default.
## Release schedule

View File

@@ -0,0 +1,23 @@
# Enable Docker Bridge Network
The latest versions of the AWS EKS-optimized AMI disable the docker bridge network by default. To enable it, add the `bootstrap_extra_args` parameter to your worker group template.
```hcl
locals {
worker_groups = [
{
# Other parameters omitted for brevity
bootstrap_extra_args = "--enable-docker-bridge true"
}
]
}
```
Examples of when this would be necessary are:
- You are running Continuous Integration in K8s, and building docker images by either mounting the docker sock as a volume or using docker in docker. Without the bridge enabled, internal routing from the inner container can't reach the outside world.
## See More
- [Docker in Docker no longer works without docker0 bridge](https://github.com/awslabs/amazon-eks-ami/issues/183)
- [Add enable-docker-bridge bootstrap argument](https://github.com/awslabs/amazon-eks-ami/pull/187)