{"id":16174545,"url":"https://github.com/felixfontein/ansible-acme","last_synced_at":"2025-03-19T00:31:00.147Z","repository":{"id":42193183,"uuid":"310932469","full_name":"felixfontein/ansible-acme","owner":"felixfontein","description":"An Ansible collection for managing TLS certificates with ACME CAs like Let's Encrypt.","archived":false,"fork":false,"pushed_at":"2025-03-12T19:46:05.000Z","size":5938,"stargazers_count":15,"open_issues_count":3,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-12T20:31:24.597Z","etag":null,"topics":["acme","ansible","ansible-collection","letsencrypt"],"latest_commit_sha":null,"homepage":"https://galaxy.ansible.com/ui/repo/published/felixfontein/acme/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/felixfontein.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-11-07T21:10:13.000Z","updated_at":"2025-03-12T19:46:01.000Z","dependencies_parsed_at":"2023-02-01T04:00:52.233Z","dependency_job_id":"a7bc45da-ed59-4c04-a942-5d05aa4abfe8","html_url":"https://github.com/felixfontein/ansible-acme","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felixfontein%2Fansible-acme","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felixfontein%2Fansible-acme/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felixfontein%2Fansible-acme/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felixfontein%2Fansible-acme/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/felixfontein","download_url":"https://codeload.github.com/felixfontein/ansible-acme/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243955701,"owners_count":20374373,"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":["acme","ansible","ansible-collection","letsencrypt"],"created_at":"2024-10-10T04:25:15.454Z","updated_at":"2025-03-19T00:31:00.141Z","avatar_url":"https://github.com/felixfontein.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!--\nGNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt or https://www.gnu.org/licenses/gpl-3.0.txt)\nSPDX-License-Identifier: GPL-3.0-or-later\nSPDX-FileCopyrightText: 2020, Felix Fontein\n--\u003e\n\n# Tools for ACME\n[![Documentation](https://img.shields.io/badge/docs-brightgreen.svg)](https://ansible.fontein.de/collections/felixfontein/acme/)\n[![CI](https://github.com/felixfontein/ansible-acme/actions/workflows/ansible-test.yml/badge.svg?branch=main)](https://github.com/felixfontein/ansible-acme/actions)\n\nThis collection provides some useful roles for retrieving ACME certificates.\n\n## Tested with Ansible\n\nTested with the current ansible-core 2.11, ansible-core 2.12, ansible-core 2.13, ansible-core 2.14, ansible-core 2.15, ansible-core 2.16, ansible-core 2.17, and ansible-core 2.18 releases and the current development version of ansible-core. Ansible-core versions before 2.11.0 are not supported.\n\n## External requirements\n\nRequires the Python [cryptography](https://pypi.org/project/cryptography/) library installed on the controller, available to the Python version used to execute the playbook. If `cryptography` is not installed, a recent enough version of [PyOpenSSL](https://pypi.org/project/pyOpenSSL/) is currently supported as a fallback by the `community.crypto.openssl_privatekey` and `community.crypto.openssl_csr` modules.\n\nThe `openssl` binary must also be available in the executable path on the controller. It is needed by the `community.crypto.acme_*` modules in case `cryptography` is not installed, and it is used for certificate chain validation by the `felixfontein.acme.acme_certificate` role.\n\nIf DNS challenges are used, there can be other requirements depending on the DNS provider. For example, for Amazon's Route 53, the Ansible `amazon.aws.route53` module requires the Python [`boto3`](https://pypi.org/project/boto3/) package. If DNS challenges with NS1 are used, the NS1 modules must be installed. See below for more information.\n\n## Included content\n\n- Role [felixfontein.acme.acme_certificate](https://ansible.fontein.de/collections/felixfontein/acme/docsite/acme_certificate_role.html).\n- Role [felixfontein.acme.revoke_old_certificates](https://ansible.fontein.de/collections/felixfontein/acme/docsite/revoke_old_certificates_role.html).\n- Role [felixfontein.acme.account_key_rollover](https://ansible.fontein.de/collections/felixfontein/acme/docsite/account_key_rollover_role.html).\n\n(You can see the documentation corresponding to the latest commits on [GitHub Pages](https://felixfontein.github.io/ansible-acme/branch/main/).)\n\n## Using this collection\n\nBefore using the `felixfontein.acme` collection, you need to install the collection with the `ansible-galaxy` CLI:\n```\nansible-galaxy collection install felixfontein.acme\n```\n\nYou can also include it in a `requirements.yml` file and install it via `ansible-galaxy collection install -r requirements.yml` using the format:\n\n```yaml\ncollections:\n- name: felixfontein.acme\n```\n\nSee [Ansible Using collections](https://docs.ansible.com/ansible/latest/user_guide/collections_using.html) for more details.\n\nFor using this collection, you always also need an ACME account. See [the documentation on ACME accounts](https://ansible.fontein.de/collections/felixfontein/acme/docsite/acme_account.html) on how to create one.\n\n## Release notes\n\nSee [the changelog](https://github.com/felixfontein/ansible-acme/tree/main/CHANGELOG.md).\n\n## Releasing, Deprecation and Versioning\n\nWe release new versions once there are new features or bugfixes. Deprecations can happen, and we try to announce them a long time in advance. We currently do not plan breaking changes, so there will be no new major release anytime soon.\n\n## Contributing\n\nPlease create issues to report problems or request new features, and create PRs to fix bugs or add new features. If you want to do a refactoring PR, please create an issue first to discuss the refactoring.\n\nPlease follow the general Ansible contributor guidelines; see the [Ansible Community Guide](https://docs.ansible.com/ansible/latest/community/index.html).\n\n## More information\n\n- [Ansible Collection overview](https://github.com/ansible-collections/overview)\n- [Ansible User guide](https://docs.ansible.com/ansible/latest/user_guide/index.html)\n- [Ansible Developer guide](https://docs.ansible.com/ansible/latest/dev_guide/index.html)\n- [Ansible Community code of conduct](https://docs.ansible.com/ansible/latest/community/code_of_conduct.html)\n\n## Licensing\n\nGNU General Public License v3.0 or later.\n\nSee [COPYING](https://www.gnu.org/licenses/gpl-3.0.txt) to see the full text.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffelixfontein%2Fansible-acme","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffelixfontein%2Fansible-acme","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffelixfontein%2Fansible-acme/lists"}