Getting started

Example inventory

To setup the dropbear ssh server in initramfs of a given host or a set of hosts, they need to be added in the specific Ansible inventory group debops_service_dropbear_initramfs:

[debops_service_dropbear_initramfs]
hostname

Example playbook

If you are using this role without DebOps, here's an example Ansible playbook that uses the debops.dropbear_initramfs role:

---

- name: Setup the dropbear ssh server in initramfs
  collections: [ 'debops.debops', 'debops.roles01',
                 'debops.roles02', 'debops.roles03' ]
  hosts: [ 'debops_service_dropbear_initramfs' ]
  become: True

  environment: '{{ inventory__environment | d({})
                   | combine(inventory__group_environment | d({}))
                   | combine(inventory__host_environment  | d({})) }}'

  roles:

    - role: dropbear_initramfs
      tags: [ 'role::dropbear_initramfs', 'skip::dropbear_initramfs' ]

Ansible tags

You can use Ansible --tags or --skip-tags parameters to limit what tasks are performed during Ansible run. This can be used after a host was first configured to speed up playbook execution, when you are sure that most of the configuration is already in the desired state.

Available role tags:

role::dropbear_initramfs

Main role tag, should be used in the playbook to execute all of the role tasks as well as role dependencies.

skip::dropbear_initramfs

Tag used to skip the playbook in a run.

role::dropbear_initramfs:pkgs

Tasks related to system package management like installing or removing packages.