https://github.com/darkwizard242/ansible-role-mkcert

Ansible role for 'mkcert'. Available on Ansible Galaxy.
https://github.com/darkwizard242/ansible-role-mkcert

ansible ansible-galaxy ansible-role certificate-creation certificates linux mkcert

Last synced: about 2 months ago
JSON representation

Ansible role for 'mkcert'. Available on Ansible Galaxy.

• Host: GitHub
• URL: https://github.com/darkwizard242/ansible-role-mkcert
• Owner: darkwizard242
• License: mit
• Created: 2023-04-10T15:54:33.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2024-06-27T23:07:14.000Z (over 1 year ago)
• Last Synced: 2025-05-18T21:35:32.524Z (5 months ago)
• Topics: ansible, ansible-galaxy, ansible-role, certificate-creation, certificates, linux, mkcert
• Language: Python
• Homepage: https://galaxy.ansible.com/darkwizard242/mkcert
• Size: 25.4 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
[![build-test](https://github.com/darkwizard242/ansible-role-mkcert/workflows/build-and-test/badge.svg?branch=master)](https://github.com/darkwizard242/ansible-role-mkcert/actions?query=workflow%3Abuild-and-test) [![release](https://github.com/darkwizard242/ansible-role-mkcert/workflows/release/badge.svg)](https://github.com/darkwizard242/ansible-role-mkcert/actions?query=workflow%3Arelease) ![Ansible Role](https://img.shields.io/ansible/role/d/darkwizard242/mkcert) [![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=ansible-role-mkcert&metric=sqale_rating)](https://sonarcloud.io/dashboard?id=ansible-role-mkcert) [![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=ansible-role-mkcert&metric=reliability_rating)](https://sonarcloud.io/dashboard?id=ansible-role-mkcert) [![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=ansible-role-mkcert&metric=security_rating)](https://sonarcloud.io/dashboard?id=ansible-role-mkcert) ![GitHub tag (latest SemVer)](https://img.shields.io/github/tag/darkwizard242/ansible-role-mkcert?label=release) ![GitHub repo size](https://img.shields.io/github/repo-size/darkwizard242/ansible-role-mkcert?color=orange&style=flat-square)

# Ansible Role: mkcert

Role to install (_by default_) [mkcert](https://github.com/FiloSottile/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:

```yaml

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.

```yaml

- hosts: servers

  roles:

    - darkwizard242.mkcert

```

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

```yaml

- 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.

```yaml

- hosts: servers

  roles:

    - darkwizard242.mkcert

  vars:

    mkcert_bin_path: /bin/

```

## License

[MIT](https://github.com/darkwizard242/ansible-role-mkcert/blob/master/LICENSE)

## Author Information

This role was created by [Ali Muhammad](https://www.linkedin.com/in/ali-muhammad-759791130/).