Add example of ansible provisioning with playbook

Currently the playbook is relative to the current workdir,
it should probably be relative to the lima.yaml instead.

The YAML syntax and the directory layout has been modified
slightly from the original, to work with Lima's setup.

Signed-off-by: Anders F Björklund <[email protected]>

Author: afbjorklund

.github/workflows/test.yml

@@ -122,7 +122,7 @@ jobs:
       run: sudo make install
     - name: Verify templates match `limactl edit` format
       run: |
-        find templates -name '*.yaml' -exec limactl edit --set 'del(.nothing)' {} \;
+        find templates -name '*.yaml' -not \( -path "templates/ansible/*" -prune \) -exec limactl edit --set 'del(.nothing)' {} \;
         git diff-index --exit-code HEAD
     - name: Uninstall
       run: sudo make uninstall
@@ -196,7 +196,7 @@ jobs:
     - name: Validate jsonschema
       run: make schema-limayaml.json
     - name: Validate templates
-      run: find -L templates -name '*.yaml' | xargs limactl validate
+      run: find -L templates -name '*.yaml' -not \( -path "templates/ansible/*" -prune \) | xargs limactl validate
     - name: Install test dependencies
       # QEMU:      required by Lima itself
       # bash:      required by test-templates.sh (OS version of bash is too old)

templates/README.md

@@ -32,6 +32,9 @@ Distro:
 - [`experimental/opensuse-tumbleweed`](./experimental/opensuse-tumbleweed.yaml): [experimental] openSUSE Tumbleweed
 - [`experimental/debian-sid`](./experimental/debian-sid.yaml): [experimental] Debian Sid
 
+Provisioning:
+- [`ansible`](./ansible.yaml): Ansible, using [playbook.yaml](./ansible/playbook.yaml)
+
 Container engines:
 - [`apptainer`](./apptainer.yaml): Apptainer
 - [`apptainer-rootful`](./apptainer-rootful.yaml): Apptainer (rootful)

templates/ansible.yaml

@@ -0,0 +1,31 @@
+minimumLimaVersion: "1.0.0"
+images:
+# Try to use release-yyyyMMdd image if available. Note that release-yyyyMMdd will be removed after several months.
+- location: "https://cloud-images.ubuntu.com/releases/noble/release-20250313/ubuntu-24.04-server-cloudimg-amd64.img"
+  arch: "x86_64"
+  digest: "sha256:eacac65efe9e9bae0cbcb3f9d5c2b5e8c5313fa78a3bc401c3fb28b2d48cefc0"
+- location: "https://cloud-images.ubuntu.com/releases/noble/release-20250313/ubuntu-24.04-server-cloudimg-arm64.img"
+  arch: "aarch64"
+  digest: "sha256:103f31c5a5b7f031a60ce3555c8fbd56317fd8ffbaaa7e17002879e6157d546d"
+# Fallback to the latest release image.
+# Hint: run `limactl prune` to invalidate the cache
+- location: "https://cloud-images.ubuntu.com/releases/noble/release/ubuntu-24.04-server-cloudimg-amd64.img"
+  arch: "x86_64"
+- location: "https://cloud-images.ubuntu.com/releases/noble/release/ubuntu-24.04-server-cloudimg-arm64.img"
+  arch: "aarch64"
+mounts:
+- location: "~"
+- location: "/tmp/lima"
+  writable: true
+
+provision:
+- mode: ansible
+  playbook: ./templates/ansible/playbook.yaml
+message: |
+  To run `ansible` on the host (assumes ansible is installed), run the following commands:
+  ------
+  export ANSIBLE_INVENTORY="{{.Dir}}/ansible-inventory.yaml"
+  # To see the inventory: `ansible-inventory --list --yaml`
+
+  ansible all -m ping
+  ------

templates/ansible/README.md

@@ -0,0 +1,9 @@
+# Ansible
+
+Playbook example from:
+
+<https://docs.ansible.com/ansible/latest/getting_started/get_started_playbook.html>
+
+Template example from:
+
+<https://docs.ansible.com/ansible/latest/playbook_guide/playbooks_templating.html>

templates/ansible/playbook.yaml

@@ -0,0 +1,11 @@
+- name: My first play
+  hosts: all
+  tasks:
+  - name: Ping my hosts
+    ansible.builtin.ping:
+
+  - name: Print message
+    ansible.builtin.debug:
+      msg: Hello world
+  roles:
+  - hostname

templates/ansible/roles/hostname/tasks/main.yaml

@@ -0,0 +1,5 @@
+---
+- name: write hostname using jinja2
+  ansible.builtin.template:
+     src: templates/test.j2
+     dest: /tmp/hostname

templates/ansible/roles/hostname/templates/test.j2

@@ -0,0 +1 @@
+My name is {{ ansible_facts['hostname'] }}