{"id":18472075,"url":"https://github.com/nginxinc/ansible-role-nginx-unit","last_synced_at":"2025-04-08T11:32:32.055Z","repository":{"id":37802670,"uuid":"286494964","full_name":"nginxinc/ansible-role-nginx-unit","owner":"nginxinc","description":"Ansible role for NGINX Unit","archived":true,"fork":false,"pushed_at":"2023-09-20T13:43:02.000Z","size":63,"stargazers_count":7,"open_issues_count":7,"forks_count":3,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-03-28T00:29:10.606Z","etag":null,"topics":["ansible","ansible-role","nginx","nginx-unit"],"latest_commit_sha":null,"homepage":"","language":"Jinja","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nginxinc.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null}},"created_at":"2020-08-10T14:18:06.000Z","updated_at":"2025-01-07T01:24:18.000Z","dependencies_parsed_at":"2023-02-11T22:02:07.804Z","dependency_job_id":null,"html_url":"https://github.com/nginxinc/ansible-role-nginx-unit","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nginxinc%2Fansible-role-nginx-unit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nginxinc%2Fansible-role-nginx-unit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nginxinc%2Fansible-role-nginx-unit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nginxinc%2Fansible-role-nginx-unit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nginxinc","download_url":"https://codeload.github.com/nginxinc/ansible-role-nginx-unit/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247834166,"owners_count":21003917,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ansible","ansible-role","nginx","nginx-unit"],"created_at":"2024-11-06T10:18:56.661Z","updated_at":"2025-04-08T11:32:31.665Z","avatar_url":"https://github.com/nginxinc.png","language":"Jinja","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Ansible Galaxy](https://img.shields.io/badge/galaxy-nginxinc.nginx__unit-5bbdbf.svg)](https://galaxy.ansible.com/nginxinc/nginx_unit)\n[![Molecule CI/CD](https://github.com/nginxinc/ansible-role-nginx-unit/workflows/Molecule%20CI/CD/badge.svg)](https://github.com/nginxinc/ansible-role-nginx-unit/actions)\n[![License](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n\n# 👾 *Help make the NGINX Unit Ansible role better by participating in our [survey](https://forms.office.com/Pages/ResponsePage.aspx?id=L_093Ttq0UCb4L-DJ9gcUKLQ7uTJaE1PitM_37KR881UM0NCWkY5UlE5MUYyWU1aTUcxV0NRUllJSC4u)!* 👾\n\n# Ansible NGINX Unit Role\n\nThis role installs NGINX Unit on your target host.\n\n**Note:** This role is still in active development. There may be unidentified issues and the role variables may change as development continues.\n\n## Requirements\n\n### Ansible\n\n*   This role is developed and tested with [maintained](https://docs.ansible.com/ansible/devel/reference_appendices/release_and_maintenance.html) versions of Ansible base. When using Ansible base, you will also need to install the following collections:\n    ```yaml\n    ---\n    collections:\n      - name: community.general\n        version: 2.0.0\n      - name: ansible.posix\n        version: 1.1.1\n    ```\n    **Note:** You can alternatively install the Ansible community distribution if you don't want to manage individual collections.\n*   Instructions on how to install Ansible can be found in the [Ansible website](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html#upgrading-ansible-from-version-2-9-and-older-to-version-2-10-or-later).\n\n### Molecule\n\n*   Molecule `3.x` is used to test the various functionalities of the role.\n*   Instructions on how to install Molecule can be found in the [Molecule website](https://molecule.readthedocs.io/en/latest/installation.html).\n\n## Installation\n\n### Ansible Galaxy\n\nUse `ansible-galaxy install nginxinc.nginx_unit` to install the latest stable release of the role on your system.\n\n### Git\n\nUse `git clone https://github.com/nginxinc/ansible-role-nginx-unit.git` to pull the latest edge commit of the role from GitHub.\n\n## Platforms\n\nThe NGINX Ansible role supports all platforms supported by [NGINX Unit](https://unit.nginx.org/installation/#official-packages):\n\n```yaml\nAmazon Linux:\n  versions:\n    - 2018.03\nAmazon Linux 2:\n  versions:\n    - any\nCentOS:\n  versions:\n    - 6\n    - 7\n    - 8\nDebian:\n  versions:\n    - stretch\n    - buster\nRedHat:\n  versions:\n    - 6\n    - 7\n    - 8\nUbuntu:\n  versions:\n    - xenial\n    - bionic\n    - focal\n```\n\n## Role Variables\n\nThis role has multiple variables. The descriptions and defaults for all these variables can be found in the **[`defaults/main/`](https://github.com/nginxinc/ansible-role-nginx-unit/blob/main/defaults/main/)** folder in the following files:\n\n|Name|Description|\n|----|-----------|\n|**[`defaults/main/main.yml`](https://github.com/nginxinc/ansible-role-nginx-unit/blob/main/defaults/main/main.yml)**|NGINX Unit installation variables|\n|**[`defaults/main/selinux.yml`](https://github.com/nginxinc/ansible-role-nginx-unit/blob/main/defaults/main/unit.yml)**|NGINX Unit SELinux variables|\n|**[`defaults/main/bsd.yml`](https://github.com/nginxinc/ansible-role-nginx-unit/blob/main/defaults/main/bsd.yml)**|BSD specific installation variables|\n\n## Example Playbooks\n\nA working functional playbook example can be found in the **[`molecule/common/playbooks`](https://github.com/nginxinc/ansible-role-nginx-unit/blob/main/molecule/common/)** folder in the following file:\n\n|Name|Description|\n|----|-----------|\n|**[`molecule/common/playbooks/default_converge.yml`](https://github.com/nginxinc/ansible-role-nginx-unit/blob/main/molecule/common/playbooks/default_converge.yml)**|Install NGINX Unit|\n\nDo note that if you install this repository via Ansible Galaxy, you will have to replace the role variable in the sample playbooks from `ansible-role-nginx-unit` to `nginxinc.nginx_unit`.\n\n## Other NGINX Ansible Collections and Roles\n\nYou can find the Ansible NGINX Core collection of roles to install and configure NGINX Open Source, NGINX Plus, and NGINX App Protect [here](https://github.com/nginxinc/ansible-collection-nginx).\n\nYou can find the Ansible NGINX role to install NGINX [here](https://github.com/nginxinc/ansible-role-nginx).\n\nYou can find the Ansible NGINX configuration role to configure NGINX [here](https://github.com/nginxinc/ansible-role-nginx-config).\n\nYou can find the Ansible NGINX App Protect role to install and configure NGINX App Protect [here](https://github.com/nginxinc/ansible-role-nginx-app-protect).\n\nYou can find the Ansible NGINX Controller collection of roles to install and configure NGINX Controller [here](https://github.com/nginxinc/ansible-collection-nginx_controller).\n\n## License\n\n[Apache License, Version 2.0](https://github.com/nginxinc/ansible-role-nginx-unit/blob/main/LICENSE)\n\n## Author Information\n\n[Alessandro Fael Garcia](https://github.com/alessfg)\n\n\u0026copy; [F5 Networks, Inc.](https://www.f5.com/) 2020\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnginxinc%2Fansible-role-nginx-unit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnginxinc%2Fansible-role-nginx-unit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnginxinc%2Fansible-role-nginx-unit/lists"}