diff --git a/docs/swarm_at_scale/about.md b/docs/swarm_at_scale/about.md index a1ecebc7e0..d1f4791771 100644 --- a/docs/swarm_at_scale/about.md +++ b/docs/swarm_at_scale/about.md @@ -39,7 +39,7 @@ shows the appliation's high level architecture: All the servers are running Docker Engine. The entire application is fully "dockerized" in that all services are running inside of containers. -The frontend consists of an load balancer with *N* frontend instances. Each +The frontend consists of a load balancer with *N* frontend instances. Each frontend consists of a web server and a Redis queue. The load balancer can handle an arbitrary number of web containers behind it (`frontend01`- `frontendN`). The web containers run a simple Python application that takes a @@ -56,7 +56,7 @@ Behind the frontend is a worker tier which runs on separate nodes. This tier: Just like the frontend, the worker tier can also scale arbitrarily. The worker count and frontend count are independent from each other. -The applications dockerized microservices are deployed to a container network. +The application's dockerized microservices are deployed to a container network. Container networks are a feature of Docker Engine that allows communication between multiple containers across multiple Docker hosts. diff --git a/docs/swarm_at_scale/deploy-app.md b/docs/swarm_at_scale/deploy-app.md index 734255c92c..9078682e7f 100644 --- a/docs/swarm_at_scale/deploy-app.md +++ b/docs/swarm_at_scale/deploy-app.md @@ -33,7 +33,7 @@ This application relies on both an overlay container network and a container volume. The Docker Engine provides these two features. You'll create them both on the Swarm `manager` instance. -1. Direct your local environmen to the Swarm manager host. +1. Direct your local environment to the Swarm manager host. ```bash $ eval $(docker-machine env manager) @@ -139,7 +139,7 @@ command below, look for the value constraint. --name results-app docker/example-voting-app-result-app ``` -7. Start voting application twice, on each frontend node. +7. Start the voting application twice. Once on each frontend node. ```bash $ docker -H $(docker-machine ip manager):3376 run -t -d \ diff --git a/docs/swarm_at_scale/deploy-infra.md b/docs/swarm_at_scale/deploy-infra.md index 6739fff859..d73cbe27f2 100644 --- a/docs/swarm_at_scale/deploy-infra.md +++ b/docs/swarm_at_scale/deploy-infra.md @@ -171,13 +171,13 @@ support the container network you'll create later. ## Task 3. Add the load balancer -The application uses an Interlock and an Nginx as a +The application uses Interlock and Nginx as a loadblancer. Before you build the load balancer host, you'll create the -cnofiguration you'll use for Nginx. +configuration you'll use for Nginx. -1. On your local host, create a `config` diretory. -2. Change to `config` directory. +1. On your local host, create a `config` directory. +2. Change directories to the `config` directory. ```bash $ cd config @@ -191,7 +191,7 @@ cnofiguration you'll use for Nginx. 192.168.99.101 ``` -5. Use your favorte editor to create a `config.toml` file and add this content +5. Use your favorite editor to create a `config.toml` file and add this content to the file: ```json @@ -294,12 +294,13 @@ node. Here, the task is to create each virtual host for each node. There are three commands required: * create the host with Docker Machine -* point the local environmnet to the new host +* point the local environment to the new host * join the host to the Swarm cluster If you were building this in a non-Mac/Windows environment, you'd only need to -run the `join` command to add node to Swarm and registers it with the Consul -discovery service. When you create a node, you'll label it also, for example: +run the `join` command to add a node to the Swarm cluster and register it with +the Consul discovery service. When you create a node, you also give it a label, +for example: ``` --engine-opt="label=com.function=frontend01" diff --git a/docs/swarm_at_scale/index.md b/docs/swarm_at_scale/index.md index fed7395831..16cdf49b52 100644 --- a/docs/swarm_at_scale/index.md +++ b/docs/swarm_at_scale/index.md @@ -22,10 +22,10 @@ Docker Compose file. You (or others) can use the file to deploy and scale the application further. The article also provides a troubleshooting section you can use while developing or deploying the voting application. -The sample is written for a novice network administrator. You should have a -basic skills on Linux systems and `ssh` experience. Some knowledge of Git is -also useful but not strictly required. This example takes approximately an hour -to complete and has the following steps: +The sample is written for a novice network administrator. You should have basic +skills on Linux systems and `ssh` experience. Some knowledge of Git is also +useful but not strictly required. This example takes approximately an hour to +complete and has the following steps: - [Learn the application architecture](about.md) - [Deploy your infrastructure](deploy-infra.md)