tiny bit on ansible installation

Author: hjwp

chapter_11_ansible.asciidoc

@@ -70,7 +70,9 @@ I promise seeing your site on a "real" website will be a thrill.
 
 === Manually Provisioning a Server to Host Our Site
 
-// TODO: revise this section
+// TODO: revise this section?  I used to assume provisioning included installing dependencies,
+// but now we have docker, so at least some of that job is part of deployment after all.
+
 
 ((("staging sites", "manual server provisioning", id="SSserver09")))
 ((("server provisioning", id="seerver09")))
@@ -209,18 +211,8 @@ https://www.whatsmydns.net/#A/staging.ottg.co.uk.
 
 I'm planning to host my staging server at _staging.ottg.co.uk_
 
-=== Installing ansible
-
-TODO:
-
-https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html
-
-suggests pipx.  could also install it in the local virtualenv?
-may need to add docker-sdk
 
-
-
-=== A first Cut of an Ansible Script
+=== Ansible
 
 Infrastructure-as-code tools, also called "configuration management" tools,
 come in lots of shapes and sizes.
@@ -240,7 +232,27 @@ by expressing the desired state of the server in a particular config syntax,
 rather than specifying a procedural series of steps to be followed one by one.
 
 
-Let's dip our toes into ansible,
+==== Installing Ansible
+
+Take a look at the instructions here:
+https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html
+
+----
+pipx install --include-deps ansible
+pipx inject ansible docker
+
+# or
+
+pip install ansible docker
+----
+
+// TODO: consider introducing an explicit requirements.dev.txt here,
+// with -r requirements.txt and put ansible, docker, and selenium in there.
+
+
+==== A First Cut of an Ansible Playbook
+
+Let's dip our toes into Ansible,
 and see if we can get it to run a simple "hello world" container on our server.
 
 Here's what's called a "playbook" in ansible terminology.