Add a bit more discussion about DNS on compute node images closes #16085

Arvados-DCO-1.1-Signed-off-by: Peter Amstutz <peter.amstutz@curii.com>

diff --git a/doc/install/install-dispatch-cloud.html.textile.liquid b/doc/install/install-dispatch-cloud.html.textile.liquid
index c4df633a3da9940c38c440cdafb39a995d075561..7bff6a4a246511a15e332284095f435219aca378 100644 (file)
--- a/doc/install/install-dispatch-cloud.html.textile.liquid
+++ b/doc/install/install-dispatch-cloud.html.textile.liquid
@@ -27,15 +27,19 @@ The cloud dispatch service is for running containers on cloud VMs. It works with
 
 The cloud dispatch service can run on any node that can connect to the Arvados API service, the cloud provider's API, and the SSH service on cloud VMs.  It is not resource-intensive, so you can run it on the API server node.
 
-h2(#create-image). Create compute node VM image
+h2(#create-image). Create compute node VM image and configure resolver
 
-Create a VM image following the steps "to set up a compute node":crunch2-slurm/install-compute-node.html
+Set up a VM following the steps "to set up a compute node":crunch2-slurm/install-compute-node.html
 
-On the compute VM image, add the API server's internal IP address to @/etc/hosts@, this will ensure that it contacts the API server on the private network and not through the public interface.  For example:
+Compute nodes must be able to resolve the hostnames of the API server and any keepstore servers to your internal IP addresses.  You can do this by running an internal DNS resolver and configuring the compute VMs to use that resolver, or by hardcoding the services in the @/etc/hosts@ file.  For example:
 
 <notextile><pre><code>10.20.30.40     <span class="userinput">ClusterID.example.com</span>
+10.20.30.41     <span class="userinput">keep1.ClusterID.example.com</span>
+10.20.30.42     <span class="userinput">keep2.ClusterID.example.com</span>
 </code></pre></notextile>
 
+Once the VM is fully configured, create a reusable VM image from it and make note of the image id.
+
 h2(#update-config). Update config.yml
 
 h3. Create a private key