Skip to content

darkwizard242/ansible-role-mkcert

Repository files navigation

build-test release Ansible Role Maintainability Rating Reliability Rating Security Rating GitHub tag (latest SemVer) GitHub repo size

Ansible Role: mkcert

Role to install (by default) mkcert on Debian/Ubuntu and EL systems. mkcert is a simple tool for making locally-trusted development certificates.

Requirements

None.

Role Variables

Available variables are listed below (located in defaults/main.yml):

Variables list:

mkcert_app: mkcert
mkcert_version: 1.4.4
mkcert_os: "{{ ansible_system | lower }}"
mkcert_architecture_map:
  amd64: amd64
  arm: arm64
  x86_64: amd64
  armv6l: armv6
  armv7l: armv7
  aarch64: arm64
  32-bit: "386"
  64-bit: amd64
mkcert_dl_url: https://github.com/FiloSottile/{{ mkcert_app }}/releases/download/v{{ mkcert_version }}/{{ mkcert_app }}-v{{ mkcert_version }}-{{ mkcert_os }}-{{ mkcert_architecture_map[ansible_architecture] }}
mkcert_bin_path: /usr/local/bin
mkcert_file_owner: root
mkcert_file_group: root
mkcert_file_mode: '0755'

Variables table:

Variable Description
mkcert_app Defines the app to install i.e. mkcert
mkcert_version Defined to dynamically fetch the desired version to install. Defaults to: 1.4.4
mkcert_os Defines os type. Used for obtaining the correct type of binaries based on OS type.
mkcert_architecture_map Defines os architecture. Used to set the correct type of binaries based on OS System Architecture.
mkcert_dl_url Defines URL to download the mkcert binary from.
mkcert_bin_path Defined to dynamically set the appropriate path to store mkcert binary into. Defaults to (as generally available on any user's PATH): /usr/local/bin
mkcert_file_owner Owner for the binary file of mkcert.
mkcert_file_group Group for the binary file of mkcert.
mkcert_file_mode Mode for the binary file of mkcert.

Dependencies

None

Example Playbook

For default behaviour of role (i.e. installation of mkcert) in ansible playbooks.

- hosts: servers
  roles:
    - darkwizard242.mkcert

For customizing behavior of role (i.e. specifying the desired mkcert version) in ansible playbooks.

- hosts: servers
  roles:
    - darkwizard242.mkcert
  vars:
    mkcert_version: 1.4.3

For customizing behavior of role (i.e. placing binary of mkcert package in different location) in ansible playbooks.

- hosts: servers
  roles:
    - darkwizard242.mkcert
  vars:
    mkcert_bin_path: /bin/

License

MIT

Author Information

This role was created by Ali Muhammad.