Skip to content

Commit

Permalink
Updated documentation to include DNS requirements
Browse files Browse the repository at this point in the history
  • Loading branch information
Patrick Dwyer committed Apr 30, 2018
1 parent b2ba4b8 commit 791495b
Show file tree
Hide file tree
Showing 2 changed files with 14 additions and 1 deletion.
8 changes: 8 additions & 0 deletions deployment.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,3 +26,11 @@ The following ports need to be open and accessible between hosts in the Sensing
- **9555/tcp**: Swarm external port for Kafka communication
- **17141/tcp**: Sensing API Insecure port
- **17504/tcp**: Sensing API Secure port

# DNS

Internal DNS (as handled by Route 53) **must include** the following routes, for now all pointing at the Swarm Master node:

- sensing-api.savior.internal
- sensing-ca.savior.internal
- sensing-kafka.savior.internal
7 changes: 6 additions & 1 deletion swarm.md
Original file line number Diff line number Diff line change
Expand Up @@ -66,6 +66,11 @@ The utility of each of these ports:
- **17141**: Sensing API Insecure port (HTTP)
- **17504**: Sensing API Secure port (HTTP/TLS)

As well, internal DNS (as handled by Route 53) **must include** the following routes, for now all pointing at the Swarm Master node:

- sensing-api.savior.internal
- sensing-ca.savior.internal
- sensing-kafka.savior.internal

### Manager Node

Expand Down Expand Up @@ -111,7 +116,7 @@ Start the external docker overlay network
> sudo docker network create --driver overlay --attachable --subnet 192.168.1.0/24 apinet
```

Notice that we're directly setting a subnet for use in the Swarm network - if we don't do this, the default network used in swarm has conflicts with the default subnet in the AWS VPC, that is overlapping `10.0.1.0/24` segments, which wreaks havoc with DNS and container routing. The name of this network, `apinet`, **must** match the defined external network name in the `docker-compose-swarm.yml` and `docker-compose-registry.yml` compose files.
Notice that we're directly setting a subnet for use in the Swarm network - if we don't do this, the default network used in swarm has conflicts with the default subnet in the AWS VPC, that is overlapping `10.0.1.0/24` segments, which wreaks havoc with DNS and container routing. The name of this network, `apinet`, **must** match the defined external network name in the `docker-compose-swarm.yml` compose file.

## Pull the API code

Expand Down

0 comments on commit 791495b

Please sign in to comment.