Add devcontainers for Ansible

Author: John Fitzgerald

.devcontainer/devcontainer.json

@@ -0,0 +1,17 @@
+{
+  "name": "Ansible",
+  // Community Ansible dev tools image - has ansible, ansible-lint, ansible-dev-tools pre-installed
+  "image": "ghcr.io/ansible/community-ansible-dev-tools:latest",
+  // Host networking lets the container reach Vagrant VMs on 192.168.56.x
+  // This only works on Linux (which you're on)
+  "runArgs": ["--network=host"],
+  // Mount your SSH keys so Ansible can connect to hosts
+  "mounts": [
+    "source=${localEnv:HOME}/.vagrant.d,target=/root/.vagrant.d,type=bind,consistency=cached,readonly"
+  ],
+  "customizations": {
+    "vscode": {
+      "extensions": ["redhat.ansible", "redhat.vscode-yaml"]
+    }
+  }
+}

.gitignore

@@ -2,4 +2,4 @@
 .vagrant
 venv
 roles/geerlingguy.security
-working_notes.md
+working_notes.md

README.md

@@ -5,16 +5,6 @@ The goal of this project is to demonstrate how to build a Kubernetes cluster on
 - Vagrant/Virtual Box
 - Home lab (coming soon)
 - The plan in the future is to deploy it on some cheap cloud VM's
-## Dependencies
-### Ansible
-Ansible version is core 2.19.0. To install do:
-```shell
-sudo apt install python3-venv -y
-python3 -m venv ~/venvs/ansible
-source ~/venvs/ansible/bin/activate
-pip install ansible-core==2.19.0
-```
-Then `source path/to/venv/bin/activate`
 ### Vagrant
 - Install Vagrant and Virtual Box-
 ## Inventories
@@ -25,16 +15,52 @@ Then `source path/to/venv/bin/activate`
 192.168.56.112 srv2
 192.168.56.113 srv3
 ```
-#### Deploy to Vagrant
-Then from the root of the project:
+#### Local Development (Devcontainer)
+Ansible is run from a devcontainer to ensure a consistent, up-to-date version. You will need:
+- [Docker](https://docs.docker.com/engine/install/)
+- VS Code with the [Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) extension
+
+**1. Open the project in the devcontainer**
+
+Open the project in VS Code, then either accept the "Reopen in Container" popup or run via the command palette (`Ctrl+Shift+P`):
+```
+Dev Containers: Reopen in Container
+```
+The first run will pull the image and may take a minute. Subsequent opens are instant.
+
+**2. Start the Vagrant VMs**
+
+From a terminal on your **host machine** (not inside VS Code):
 ```shell
 vagrant up
 ```
-You should then be able to ssh to each node with `vagrant ssh ${node_name}`
-#### Re-running plays
-Run:
+This boots the three VMs without running Ansible. You can verify they are up with:
+```shell
+vagrant status
+```
+
+**3. Install Ansible roles**
+
+From the VS Code terminal (inside the devcontainer):
+```shell
+ansible-galaxy install -r roles/requirements.yml
+```
+
+**4. Run the playbook**
+
+```shell
+ansible-playbook -i inventory/local_vagrant site.yml --become
+```
+
+**Re-running the playbook**
+
+Just re-run step 4. No need to restart the VMs.
+
+**Tearing down**
+
+From the host terminal:
 ```shell
-vagrant provision
+vagrant destroy -f
 ```
 ### Home Servers
 - This is a for sure a work in progress.... Currently, I only have three Lenovo m910q machines plugged straight into my ISP modem (It's not serving anything to the internet). 

Vagrantfile

@@ -36,19 +36,6 @@ Vagrant.configure("2") do |config|
       box_config.vm.box = box[:box]
       box_config.vm.hostname = box[:hostname]
       box_config.vm.network "private_network", ip: box[:ip]
-
-      # do ansible provision after last box starts
-      if index == boxes.size - 1
-        box_config.vm.provision "ansible" do |ansible|
-          ansible.compatibility_mode = "2.0"
-          ansible.playbook = "site.yml"
-          ansible.limit = "all"
-          ansible.inventory_path = "inventory/local_vagrant"
-          ansible.become = true
-          ansible.galaxy_role_file = "roles/requirements.yml"
-          ansible.galaxy_command = "ansible-galaxy install -f -r %{role_file}"
-        end
-      end
     end
   end
 end

ansible.cfg

@@ -2,3 +2,6 @@
 [defaults]
 roles_path = ./roles
 collections_paths = ./collections
+host_key_checking = False
+remote_user = vagrant
+deprecation_warnings=False

inventory/local_vagrant/group_vars/all/base.yml

@@ -1,4 +1,9 @@
 ---
+# Vagrant SSH connection settings
+ansible_user: vagrant
+ansible_ssh_private_key_file: ~/.vagrant.d/insecure_private_key
+ansible_ssh_extra_args: "-o IdentitiesOnly=yes"
+
 # Create users
 user_config:
   - username: john

inventory/local_vagrant/host_vars/srv1.yml

@@ -1,3 +1,3 @@
 ansible_host: 192.168.56.111
-ansible_user: ansible
+ansible_user: vagrant
 hostname_short: srv1

inventory/local_vagrant/host_vars/srv2.yml

@@ -1,3 +1,3 @@
 ansible_host: 192.168.56.112
-ansible_user: ansible
+ansible_user: vagrant
 hostname_short: srv2

inventory/local_vagrant/host_vars/srv3.yml

@@ -1,3 +1,3 @@
 ansible_host: 192.168.56.113
-ansible_user: ansible
+ansible_user: vagrant
 hostname_short: srv3