<?xml version="1.0" encoding="UTF-8"?><rss version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>ngetchell.com - Posts tagged with &quot;Ansible&quot;</title><description>All blog posts tagged with &quot;Ansible&quot;</description><link>https://ngetchell.com/</link><item><title>Testing Ansible Roles with Molecule on Digital Ocean Droplets</title><link>https://ngetchell.com/blog/testing-ansible-roles-with-molecule-on-digital-ocean-droplets/</link><guid isPermaLink="true">https://ngetchell.com/blog/testing-ansible-roles-with-molecule-on-digital-ocean-droplets/</guid><description>For years, I’ve been using Ansible to configure my homelab, blog, and workstations. After testing out Chef and Salt, I’m glad I happened upon Ansible. The tool has grown more and I’ve gotten tons of value out of putting in the effort to learn it. Early on, I would manually test my code to make […]</description><pubDate>Wed, 21 Oct 2026 00:58:34 GMT</pubDate><content:encoded>
&lt;p&gt;For years, I’ve been using Ansible to configure my homelab, blog, and workstations. After testing out Chef and Salt, I’m glad I happened upon Ansible. The tool has grown more and I’ve gotten tons of value out of putting in the effort to learn it. &lt;/p&gt;



&lt;p&gt;Early on, I would manually test my code to make sure whatever I added worked. It was tougher since my work used RHEL-based distributions so I would always check my work against centos as well as debian distros. This grew tiresome and I looked for ways to automate the testing. &lt;/p&gt;



&lt;p&gt;Soon, I found Vagrant, which let me spin up local virtual machines quickly then test my Ansible roles against them to see if they had the desired impact. &lt;/p&gt;



&lt;p&gt;Then, I was able to stand on top of Vagrant with Molecule for testing roles. It allowed you to choose a &lt;em&gt;driver&lt;/em&gt; to set up the machine, apply your role, apply it again to see if it was idempotent, then would tear down the VM and report the results. I even got it all running in my own GitLab instance as part of a merge request. Adding the latest Ubuntu release was a two line change and BOOM, it was now part of your tests. &lt;/p&gt;



&lt;p&gt;It was glorious…..for a short while. Then, a big breaking change came from the molecule developers after I set up testing on all of my roles. My productivity with the tool was never the same.&lt;/p&gt;



&lt;p&gt;I would hard-code the molecule version I needed but the writing was on the wall. The vagrant driver I’d been using was no longer supported and everything would be moving to docker. My issue with that was that lots of my roles configured systemd services and emulating that in a docker container made for a testing nightmare. I could never confirm I was fixing test infrastructure bugs or bugs from my roles. &lt;/p&gt;



&lt;p&gt;Frankly, I was spending more time keeping my test framework up to date than I was developing roles to solve real problems. I left my Molecule tests abandoned in my repository for years. &lt;/p&gt;



&lt;p&gt;Then enters Claude Code. I’ve had lots of experience building useful web apps for myself. Even in languages and frameworks I wasn’t familiar with. &lt;/p&gt;



&lt;p&gt;It got me thinking, is it time to revamp my role testing strategy with Molecule? With the power of the Digital Ocean API, the answer is yes. &lt;/p&gt;



&lt;p&gt;For prerequisites, you’ll need Ansible and Molecule installed via your python package manage of choice. You’ll also need &lt;a href=&quot;https://docs.digitalocean.com/reference/doctl/&quot;&gt;doctl&lt;/a&gt; to control the creation of the DO droplets. &lt;/p&gt;



&lt;p&gt;Below is the Molecule configuration I use to test my ssh_hardening role. &lt;/p&gt;



&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;# file: create.yml&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;# harness: Claude Code&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;# model: Opus 5.5&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;---&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- name: Create DigitalOcean droplets&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  hosts: localhost&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  gather_facts: false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  vars:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    do_region: &quot;{{ lookup(&apos;ansible.builtin.env&apos;, &apos;DO_REGION&apos;) | default(&apos;nyc3&apos;, true) }}&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    do_size: &quot;{{ lookup(&apos;ansible.builtin.env&apos;, &apos;DO_SIZE&apos;) | default(&apos;s-1vcpu-1gb&apos;, true) }}&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    do_project: &quot;{{ lookup(&apos;ansible.builtin.env&apos;, &apos;DO_PROJECT&apos;) | default(&apos;Molecule&apos;, true) }}&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    do_state_file: &quot;{{ molecule_ephemeral_directory }}/do_state.yml&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    do_key_file: &quot;{{ molecule_ephemeral_directory }}/id_ed25519&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    do_user: molecule&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  tasks:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # Accepts DIGITALOCEAN_ACCESS_TOKEN or a token saved with `doctl auth init`.&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - name: Check DigitalOcean authentication&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      ansible.builtin.command:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        argv: &amp;amp;#91;doctl, account, get]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      register: do_account&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      changed_when: false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      failed_when: false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - name: Assert DigitalOcean authentication works&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      ansible.builtin.assert:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        that: do_account.rc == 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        fail_msg: &amp;gt;-&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          doctl cannot authenticate. Run `doctl auth init` or set DIGITALOCEAN_ACCESS_TOKEN.&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          {{ do_account.stderr | default(do_account.msg | default(&apos;&apos;)) }}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - name: List DigitalOcean projects&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      ansible.builtin.command:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        argv: &amp;amp;#91;doctl, projects, list, --output=json]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      register: do_projects&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      changed_when: false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - name: Set project ID&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      ansible.builtin.set_fact:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        do_project_id: &quot;{{ do_projects.stdout | from_json | selectattr(&apos;name&apos;, &apos;eq&apos;, do_project) | map(attribute=&apos;id&apos;) | first | default(&apos;&apos;) }}&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - name: Assert project exists&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      ansible.builtin.assert:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        that: do_project_id | length &amp;gt; 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        fail_msg: DigitalOcean project &apos;{{ do_project }}&apos; not found. Create it or set DO_PROJECT.&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # Unique per run so parallel runs (macOS, Linux, CI) do not collide.&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - name: Generate run ID&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      ansible.builtin.set_fact:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        do_run_id: &quot;{{ lookup(&apos;ansible.builtin.password&apos;, &apos;/dev/null&apos;, chars=&amp;amp;#91;&apos;ascii_lowercase&apos;, &apos;digits&apos;], length=8) }}&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - name: Generate ephemeral SSH key&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      ansible.builtin.command:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        argv: &amp;amp;#91;ssh-keygen, -q, -t, ed25519, -N, &quot;&quot;, -C, &quot;molecule-{{ do_run_id }}&quot;, -f, &quot;{{ do_key_file }}&quot;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        creates: &quot;{{ do_key_file }}&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # Registering a key stops DigitalOcean from setting and emailing a root password.&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - name: Register SSH key with DigitalOcean&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      ansible.builtin.command:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        argv:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          - doctl&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          - compute&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          - ssh-key&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          - import&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          - molecule-{{ do_run_id }}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          - --public-key-file={{ do_key_file }}.pub&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          - --output=json&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      register: do_ssh_key&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      changed_when: true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # Write state before droplets exist, so destroy can always clean up.&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - name: Write DigitalOcean state&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      ansible.builtin.copy:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        dest: &quot;{{ do_state_file }}&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        mode: &quot;0600&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        content: |&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          run_id: {{ do_run_id }}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          ssh_key_id: {{ (do_ssh_key.stdout | from_json | first).id }}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # ssh_pwauth makes cloud-init write 50-cloud-init.conf with&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # PasswordAuthentication yes, which the role must override.&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - name: Write cloud-init user data&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      ansible.builtin.copy:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        dest: &quot;{{ molecule_ephemeral_directory }}/user-data.yml&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        mode: &quot;0600&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        content: |&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          #cloud-config&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          ssh_pwauth: true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          users:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            - name: {{ do_user }}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;              shell: /bin/bash&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;              sudo: ALL=(ALL) NOPASSWD:ALL&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;              ssh_authorized_keys:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;                - {{ lookup(&apos;ansible.builtin.file&apos;, do_key_file ~ &apos;.pub&apos;) }}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - name: Create droplets&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      ansible.builtin.command:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        argv:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          - doctl&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          - compute&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          - droplet&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          - create&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          - &quot;molecule-{{ item.name }}-{{ do_run_id }}&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          - --image={{ item.image }}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          - --size={{ do_size }}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          - --region={{ do_region }}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          - --project-id={{ do_project_id }}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          - --ssh-keys={{ (do_ssh_key.stdout | from_json | first).id }}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          - --tag-names=molecule,molecule-{{ do_run_id }}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          - --user-data-file={{ molecule_ephemeral_directory }}/user-data.yml&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          - --wait&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          - --output=json&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      loop: &quot;{{ molecule_yml.platforms }}&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      loop_control:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        label: &quot;{{ item.name }}&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      register: do_droplets&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      changed_when: true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - name: Write Molecule instance config&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      ansible.builtin.copy:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        dest: &quot;{{ molecule_instance_config }}&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        mode: &quot;0600&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        content: &quot;{{ do_instances | to_nice_yaml }}&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      vars:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        do_instances: &amp;gt;-&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          {%- set out = &amp;amp;#91;] -%}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          {%- for r in do_droplets.results -%}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          {%- set d = r.stdout | from_json | first -%}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          {%- set _ = out.append({&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;                &apos;instance&apos;: r.item.name,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;                &apos;address&apos;: d.networks.v4 | selectattr(&apos;type&apos;, &apos;eq&apos;, &apos;public&apos;) | map(attribute=&apos;ip_address&apos;) | first,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;                &apos;user&apos;: do_user,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;                &apos;port&apos;: 22,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;                &apos;identity_file&apos;: do_key_file,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;              }) -%}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          {%- endfor -%}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          {{ out }}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - name: Wait for SSH&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      ansible.builtin.wait_for:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        host: &quot;{{ item.address }}&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        port: 22&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        search_regex: OpenSSH&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        timeout: 300&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      loop: &quot;{{ lookup(&apos;ansible.builtin.file&apos;, molecule_instance_config) | from_yaml }}&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      loop_control:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        label: &quot;{{ item.instance }}&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;...&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;



&lt;p&gt;&lt;/p&gt;



&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;# file: converge.yml&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;---&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- name: Converge&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  hosts: all&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  become: true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  roles:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - ssh_hardening&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;...&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;



&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;# file: destroy.yml&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;# harness: Claude Code&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;# model: Opus 5.5&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;---&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- name: Destroy DigitalOcean droplets&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  hosts: localhost&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  gather_facts: false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  vars:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    do_state_file: &quot;{{ molecule_ephemeral_directory }}/do_state.yml&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  tasks:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - name: Read DigitalOcean state&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      ansible.builtin.stat:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        path: &quot;{{ do_state_file }}&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      register: do_state_stat&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - name: Destroy run resources&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      when: do_state_stat.stat.exists&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      vars:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        do_state: &quot;{{ lookup(&apos;ansible.builtin.file&apos;, do_state_file) | from_yaml }}&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      block:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        - name: Delete droplets&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          ansible.builtin.command:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            argv:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;              - doctl&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;              - compute&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;              - droplet&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;              - delete&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;              - --tag-name=molecule-{{ do_state.run_id }}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;              - --force&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          register: do_delete&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          changed_when: do_delete.rc == 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          failed_when: do_delete.rc != 0 and &apos;not found&apos; not in do_delete.stderr&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        - name: Delete SSH key&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          ansible.builtin.command:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            argv: &amp;amp;#91;doctl, compute, ssh-key, delete, &quot;{{ do_state.ssh_key_id }}&quot;, --force]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          register: do_key_delete&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          changed_when: do_key_delete.rc == 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          failed_when: do_key_delete.rc != 0 and &apos;not found&apos; not in do_key_delete.stderr&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        - name: Remove DigitalOcean state&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          ansible.builtin.file:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            path: &quot;{{ item }}&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            state: absent&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          loop:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            - &quot;{{ do_state_file }}&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            - &quot;{{ molecule_ephemeral_directory }}/id_ed25519&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            - &quot;{{ molecule_ephemeral_directory }}/id_ed25519.pub&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            - &quot;{{ molecule_ephemeral_directory }}/user-data.yml&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - name: Write empty instance config&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      ansible.builtin.copy:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        dest: &quot;{{ molecule_instance_config }}&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        content: &quot;&amp;amp;#91;]\n&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        mode: &quot;0600&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;...&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;



&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;# file: molecule.yml&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;# harness: Claude Code&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;# model: Opus 5.5&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;---&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;# Droplets are created and destroyed with doctl.&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;# Requires doctl, authenticated with `doctl auth init` or DIGITALOCEAN_ACCESS_TOKEN.&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;# Optional: DO_REGION (default nyc3), DO_SIZE (default s-1vcpu-1gb),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;# DO_PROJECT (default Molecule; the project must already exist).&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;driver:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  name: default&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  options:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    managed: true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;# Slugs: doctl compute image list-distribution --public&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;platforms:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  - name: ubuntu2604&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    image: ubuntu-26-04-x64&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  - name: ubuntu2404&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    image: ubuntu-24-04-x64&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  - name: ubuntu2204&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    image: ubuntu-22-04-x64&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  - name: debian13&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    image: debian-13-x64&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;provisioner:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  name: ansible&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  env:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ANSIBLE_ROLES_PATH: ${MOLECULE_PROJECT_DIRECTORY}/roles&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;scenario:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  test_sequence:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - destroy&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - syntax&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - create&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - prepare&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - converge&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - idempotence&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - verify&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - destroy&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;...&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;



&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;# file: prepare.yml&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;# harness: Claude Code&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;# model: Opus 5.5&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;---&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- name: Wait for droplets to finish booting&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  hosts: all&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  gather_facts: false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  tasks:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - name: Wait for SSH login&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      ansible.builtin.wait_for_connection:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        timeout: 300&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # Exit code 2 means done with recoverable errors, which DO images often report.&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - name: Wait for cloud-init&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      ansible.builtin.command: cloud-init status --wait&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      register: cloud_init_status&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      changed_when: false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      failed_when: cloud_init_status.rc not in &amp;amp;#91;0, 2]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # Proves the test starts from an insecure baseline.&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - name: Assert cloud-init enabled password logins&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      ansible.builtin.command: grep -Eiqr &apos;^PasswordAuthentication yes&apos; /etc/ssh/sshd_config /etc/ssh/sshd_config.d&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      become: true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      changed_when: false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;...&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;



&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;# file: verify.yml&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;# harness: Claude Code&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;# model: Opus 5.5&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;---&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- name: Verify effective sshd configuration&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  hosts: all&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  become: true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  gather_facts: false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  vars:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    expected:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      permitrootlogin: &quot;no&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      passwordauthentication: &quot;no&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      kbdinteractiveauthentication: &quot;no&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      authenticationmethods: publickey&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      permitemptypasswords: &quot;no&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      maxauthtries: &quot;3&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      x11forwarding: &quot;no&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      allowtcpforwarding: &quot;no&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      allowagentforwarding: &quot;no&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      permittunnel: &quot;no&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      loglevel: VERBOSE&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  tasks:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # sshd -T prints the config after includes and defaults are applied.&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - name: Read effective sshd configuration&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      ansible.builtin.command: sshd -T&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      register: sshd_t&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      changed_when: false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - name: Assert hardened settings are in effect&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      ansible.builtin.assert:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        that: (item.key ~ &apos; &apos; ~ item.value) in sshd_t.stdout_lines&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        fail_msg: &quot;Expected &apos;{{ item.key }} {{ item.value }}&apos; in sshd -T output.&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        quiet: true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      loop: &quot;{{ expected | dict2items }}&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      loop_control:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        label: &quot;{{ item.key }}&quot;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;



&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;# file: cleanup.yml&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;# harness: Claude Code&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;# model: Opus 5.5&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;---&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;# Molecule runs this on failure, before destroy. Show sshd state for debugging.&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- name: Collect sshd diagnostics&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  hosts: all&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  become: true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  gather_facts: false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  ignore_unreachable: true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  tasks:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - name: Read recent sshd logs&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      ansible.builtin.command: journalctl --unit=ssh --lines=50 --no-pager&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      register: sshd_journal&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      changed_when: false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      failed_when: false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - name: Show recent sshd logs&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      ansible.builtin.debug:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        var: sshd_journal.stdout_lines&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      when: sshd_journal.stdout_lines is defined&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;...&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;



&lt;p&gt;The destroy file cleans up before and after your tests so you aren’t billed. Create and prepare set up the droplets. Converge actually calls your ansible role then verifier tests your role via assertions. &lt;/p&gt;



&lt;p&gt;AI is exceptionally good at this stuff. I plan on slowing backfilling my roles with proper tests across Ubuntu and Debian droplets to confirm I’m not adding regressions. I’ll also set this up to run in a Forgejo Action when I open up pull requests. &lt;/p&gt;
</content:encoded><category>Ansible</category><category>Claude Code</category><category>Digital Ocean</category><category>Molecule</category></item><item><title>Using Ansible via GitHub Actions and Tailscale</title><link>https://ngetchell.com/blog/using-ansible-via-github-actions-and-tailscale/</link><guid isPermaLink="true">https://ngetchell.com/blog/using-ansible-via-github-actions-and-tailscale/</guid><description>Use Tailscale and GitHub Actions run your ansible playbooks against nodes on your tailnet.</description><pubDate>Mon, 13 Nov 2023 16:10:28 GMT</pubDate><content:encoded>
&lt;p&gt;I build this blog using Hugo and updated it nightly (or on push to main) via GitHub Actions.
I run an nginx web server, sitting on a DigitalOcean VPS to serve the traffic.
It is a very simple setup for someone who is used to running a CMS (have been doing it since 2005).
Almost too simple.&lt;/p&gt;



&lt;p&gt;With this in mind, I set up to automate the creation and deletion of my VPS using Ansible.
The playbook is specific to my situation.
I set up nginx, tailscale, redirections, a staging env only accessable from the tailscale network, certbot, etc.
Every blog would be different so I won&apos;t be sharing my playbook but I will go over how I set up Ansible to connect to my VPS over the Tailscale network.&lt;/p&gt;



&lt;p&gt;For those that don&apos;t know, Tailscale is a mesh VPN that allows direct wireguard connections between peers.
Tailscale runs a coordination server for you to establish the connection, then it is peer-to-peer.
At work, we put it through it&apos;s paces and found it easy to deploy, the user deactivation process was near instantanious, and the price was right.&lt;/p&gt;



&lt;p&gt;On my own, I use it to access my home resources while on the road.
My mobile devices and laptops automatically connect so I am able to access my home media, rss reader, and more.&lt;/p&gt;



&lt;h2&gt;Why?&lt;/h2&gt;



&lt;p&gt;You may say to yourself, why make it so complicated?
Security and fun is the answer.
Being able to put the VPS behind a firewall that only allows port 80 and 443 incoming is nice.
Since tailscale initiates the connection from the client, it isn&apos;t impeeded by the firewall.
It is fun because I love building rube goldberg machines so lay off!&lt;/p&gt;



&lt;h2&gt;Setting up Ansible&lt;/h2&gt;



&lt;p&gt;First order of business is to make sure you have an inventory file that contains your assets and their corresponding tailnet addresses.
You&apos;ll need it inside of the GitHub action.&lt;/p&gt;



&lt;p&gt;Use the ansible_host inventory variable to handle it if you aren&apos;t using host_vars.&lt;/p&gt;



&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;hugo ansible_host&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;102.1&lt;/span&gt;&lt;span&gt;.264.22&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;



&lt;p&gt;Run your playbook with the new inventory file to make sure you are ready.
Any troubleshooting that can happen &lt;strong&gt;before&lt;/strong&gt; you roll out CI/CD will save you time later.
The iteration times are slow, no matter the CI/CD environment.
Plus, to iterate your CI, you need to commit code to generate the jobs so there is proof of your incompetence!
We must keep our incompetence to ourselves.
I love hiding my sins by squashing my PRs.&lt;/p&gt;



&lt;h2&gt;Configuring the Action&lt;/h2&gt;



&lt;p&gt;I love the layout of a GitHub Action yml file.
Simple, well-documented, and comes with batteries included.
The latest Ubuntu image works best for me and &lt;a href=&quot;https://github.com/actions/runner-images/blob/main/images/linux/Ubuntu2204-Readme.md&quot;&gt;look at everything it comes with&lt;/a&gt;.
That, coupled with a great VS Code extension and I was off to the races.
Looks at this tool tip.
It is doing the cron time math for me (in UTC).&lt;/p&gt;



&lt;figure&gt;&lt;img src=&quot;https://ngetchell.com/wp-media/2026/07/ansible-tooltip.png&quot; alt=&quot;GitHub Actions vs code extension displaying a helpful tooltip&quot; /&gt;&lt;/figure&gt;



&lt;p&gt;Make sure to configure your secrets in the repository so you can reference them in the action.&lt;/p&gt;



&lt;figure&gt;&lt;img src=&quot;https://ngetchell.com/wp-media/2026/07/ansible-secrets.png&quot; alt=&quot;GitHub action secrets configuration page&quot; /&gt;&lt;/figure&gt;



&lt;p&gt;GitHub has a great action dispatch system where you can generate actions for just about any event logged to your repository.
Here, set up the action to run when there is a commit to the main branch (when I merge a PR), when I kick it off manually via the workflow dispatch feature, and every day at 13:01 UTC.&lt;/p&gt;



&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;on&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  push&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    branches&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      - &lt;/span&gt;&lt;span&gt;main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  workflow_dispatch&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  schedule&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - &lt;/span&gt;&lt;span&gt;cron&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;01 13 * * *&apos;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;



&lt;p&gt;We have secrets to reference, so we set them as env vars near the top of the yml file.
To generate your ssh key, run &lt;code&gt;ssh-keygen -t ed25519&lt;/code&gt; to get a private key to add to GitHub.
You can add the public key to the knownhost file on the server using &lt;code&gt;ssh-copy-id&lt;/code&gt;.&lt;/p&gt;



&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;env&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  SSH_KEY_GITHUB_ACTIONS&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; ${{ secrets.SSH_KEY_GITHUB_ACTIONS }}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  VPS_DEPLOY_USER&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; ${{ secrets.VPS_DEPLOY_USER }}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  VPS_DEPLOY_HOST&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; ${{ secrets.VPS_DEPLOY_HOST }}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;



&lt;p&gt;Define your job next.
You give it a name, tell it what to run on, and give it a bunch of steps to complete.
First, we checkout the code.
Since I&apos;m using a git submodule, I need to pass that config as parameter.&lt;/p&gt;



&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;jobs&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  playbook&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    runs-on&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; ubuntu-latest&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    steps&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      - &lt;/span&gt;&lt;span&gt;name&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; Checkout&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        uses&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; actions/checkout@v3&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        with&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          submodules&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; recursive&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          fetch-depth&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 0&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;



&lt;p&gt;Then use the Tailscale provided reusable action to authenticate to your tailnet.
I tag my job so when I can apply ACLs on the ephemeral instance.
This instance will disappear shortly after the runner dies.&lt;/p&gt;



&lt;figure&gt;&lt;img src=&quot;https://ngetchell.com/wp-media/2026/07/ansible-tailscale-ephemeral-device.png&quot; alt=&quot;A screencap of the tailscale admin device screen showing the ephemeral device.&quot; /&gt;&lt;/figure&gt;



&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;      - &lt;/span&gt;&lt;span&gt;name&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; Connect to Tailnet&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        uses&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; tailscale/github-action@v2&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        with&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          oauth-client-id&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; ${{ secrets.TS_OAUTH_CLIENT_ID }}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          oauth-secret&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; ${{ secrets.TS_OAUTH_SECRET }}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          tags&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; tag:github&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;



&lt;p&gt;Now comes the fun part.
We drop into a bash terminal and set a few configs, then invoke ansible-playbook.
The first few lines are to set up your ssh private key since I disable password based authentication.
I&apos;m then able to call ansible-playbook with the env vars I set earlier in the file.&lt;/p&gt;



&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;      - &lt;/span&gt;&lt;span&gt;name&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; Invoke Ansible&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        run&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; |&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          mkdir -p ~/.ssh/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          chmod 0700 ~/.ssh&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          eval $(ssh-agent -s)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          ssh-add &amp;lt;(echo &quot;$SSH_KEY_GITHUB_ACTIONS&quot;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          pip install -r requirements.txt&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          ansible-playbook ansible/playbook.yml \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            -i ansible/tailscale_inventory \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            --ssh-common-args=&apos;-o StrictHostKeyChecking=no&apos; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            --extra-vars ansible_user=$VPS_DEPLOY_USER \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            --extra-vars ansible_host=$VPS_DEPLOY_HOST&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;



&lt;p&gt;If I was truly paranoid, I&apos;d add the ssh host key as an environment variable so I wouldn&apos;t need to disable strict host checking.&lt;/p&gt;



&lt;h2&gt;Entire Action&lt;/h2&gt;



&lt;pre&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;name&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; Configure Server&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;on&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  push&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    branches&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      - &lt;/span&gt;&lt;span&gt;main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  workflow_dispatch&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  schedule&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    - &lt;/span&gt;&lt;span&gt;cron&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; &apos;01 13 * * *&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;env&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  SSH_KEY_GITHUB_ACTIONS&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; ${{ secrets.SSH_KEY_GITHUB_ACTIONS }}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  VPS_DEPLOY_USER&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; ${{ secrets.VPS_DEPLOY_USER }}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  VPS_DEPLOY_HOST&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; ${{ secrets.VPS_DEPLOY_HOST }}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;jobs&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  playbook&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    runs-on&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; ubuntu-latest&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    steps&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      - &lt;/span&gt;&lt;span&gt;name&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; Checkout&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        uses&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; actions/checkout@v3&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        with&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          submodules&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; recursive&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          fetch-depth&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      - &lt;/span&gt;&lt;span&gt;name&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; Connect to Tailnet&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        uses&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; tailscale/github-action@v2&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        with&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          oauth-client-id&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; ${{ secrets.TS_OAUTH_CLIENT_ID }}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          oauth-secret&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; ${{ secrets.TS_OAUTH_SECRET }}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          tags&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; tag:github&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      - &lt;/span&gt;&lt;span&gt;name&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; Invoke Ansible&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        run&lt;/span&gt;&lt;span&gt;:&lt;/span&gt;&lt;span&gt; |&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          mkdir -p ~/.ssh/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          chmod 0700 ~/.ssh&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          eval $(ssh-agent -s)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          ssh-add &amp;lt;(echo &quot;$SSH_KEY_GITHUB_ACTIONS&quot;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          pip install -r requirements.txt&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          ANSIBLE_HOST_KEY_CHECKING=False&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          ansible-playbook ansible/playbook.yml \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            -i ansible/tailscale_inventory \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            --ssh-common-args=&apos;-o StrictHostKeyChecking=no&apos; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            --extra-vars ansible_user=$VPS_DEPLOY_USER \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            --extra-vars ansible_host=$VPS_DEPLOY_HOST&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
</content:encoded><category>Ansible</category><category>GitHub</category><category>GitHub Actions</category></item></channel></rss>