Update README.md

Fri, 16 Aug 2019 19:07:18 -0400

author
Meredith Howard <mhoward@roomag.org>
date
Fri, 16 Aug 2019 19:07:18 -0400
changeset 94
3879346354aa
parent 93
14e0c774b916
child 95
c4cd818d97b8

Update README.md

README.md file | annotate | diff | comparison | revisions
inventory file | annotate | diff | comparison | revisions
local.yml file | annotate | diff | comparison | revisions
playbook.yml file | annotate | diff | comparison | revisions
--- a/README.md
+++ b/README.md
@@ -8,27 +8,34 @@ It's best-tested on Debian, but has some
 
 ## `gui_enabled`
 
-Boolean. Install and configure GUI tools, or with vim, choose between `gtk` and
+Install and configure GUI tools, or with vim, choose between `gtk` and
 `nox`.
 
 ## `disable_stock_users`
 
-Boolean.  Disable stock users like `pi` or `pine64`.
+Default `true`.  Disable stock users like `pi` or `pine64`.
+
+## `bootstrap_ansible_controller`
+
+Create an `ansible` user for the controller to connect as, with a public 
+key set up and sudo permission.
 
 # Running
 
 ## Push
 
-1. Create inventory file with target host, maybe extra vars
-2. If we can ssh as root with key, use `-u root`.  If we can sudo, use `-bK`.
-3. `ansible-playbook -i $inventory $args local.yml`
+1. Create inventory file with target hosts, maybe extra vars
+    - For a single host, `-i ${hostname},` works directly.
+2. We'll need to be root:
+    1. If we can ssh as root with key, use `-u root`.
+    2. If we can sudo, use `-bK`.
+3. `ansible-playbook -i $inventory $args playbook.yml`
 4. After the first run, `ansible` management user is created.
 
 ## Pull
 
 1. Install `ansible`, `git`
-2. `echo -e '[localhost]\nlocalhost ansible_connection=local' >> /etc/ansible/hosts`
-3. `ansible-pull -U https://github.com/merrilymeredith/devbox-ansible.git`
+2. `ansible-pull -i localhost, -c local -U https://github.com/merrilymeredith/devbox-ansible.git`
 
 ### cloud-init
 
@@ -38,10 +45,9 @@ packages:
   - ansible
   - git
 runcmd:
-  - echo '[localhost]\nlocalhost ansible_connection=local' >> /etc/ansible/hosts
-  - ansible-pull -U https://github.com/merrilymeredith/devbox-ansible.git
+  - ansible-pull -i localhost, -c local -U https://github.com/merrilymeredith/devbox-ansible.git
 ```
 
 # TODO
 
-- Make pull config install cron entry?
+- Make pull config or bootstrap install cron entry?
deleted file mode 100644
--- a/inventory
+++ /dev/null
@@ -1,2 +0,0 @@
-[localhost]
-localhost	ansible_connection=local
rename from local.yml
rename to playbook.yml

mercurial