mirror of
https://github.com/certbot/certbot.git
synced 2026-01-27 19:42:53 +03:00
43f58ca803
This is probably unlikely to come up again, but this documents that people should run our tests using setuptools rather than calling something like pytest directly. See https://opensource.eff.org/eff-open-source/pl/wdrky4uyzjguppgch3r7t7qjmc for more info.
5.1 KiB
5.1 KiB
Packaging Guide
Releases
We release packages and upload them to PyPI (wheels and source tarballs).
- https://pypi.python.org/pypi/acme
- https://pypi.python.org/pypi/certbot
- https://pypi.python.org/pypi/certbot-apache
- https://pypi.python.org/pypi/certbot-nginx
- https://pypi.python.org/pypi/certbot-dns-cloudflare
- https://pypi.python.org/pypi/certbot-dns-cloudxns
- https://pypi.python.org/pypi/certbot-dns-digitalocean
- https://pypi.python.org/pypi/certbot-dns-dnsimple
- https://pypi.python.org/pypi/certbot-dns-dnsmadeeasy
- https://pypi.python.org/pypi/certbot-dns-google
- https://pypi.python.org/pypi/certbot-dns-linode
- https://pypi.python.org/pypi/certbot-dns-luadns
- https://pypi.python.org/pypi/certbot-dns-nsone
- https://pypi.python.org/pypi/certbot-dns-ovh
- https://pypi.python.org/pypi/certbot-dns-rfc2136
- https://pypi.python.org/pypi/certbot-dns-route53
The following scripts are used in the process:
We use git tags to identify releases, using Semantic Versioning. For example: v0.11.1.
Notes for package maintainers
- Please use our tagged releases, not
master! - Do not package
certbot-compatibility-testorletshelp-certbot- it's only used internally. - To run tests on our packages, you should use
python setup.py test. Doing things like runningpytestdirectly on our package files may not work because Certbot relies on setuptools to register and find its plugins. - If you'd like to include automated renewal in your package
certbot renew -qshould be added to crontab or systemd timer. Additionally you should include a random per-machine time offset to avoid having a large number of your clients hit Let's Encrypt's servers simultaneously. jwsis an internal script foracmemodule and it doesn't have to be packaged - it's mostly for debugging: you can use it asecho foo | jws sign | jws verify.- Do get in touch with us. We are happy to make any changes that will make packaging easier. If you need to apply some patches don't do it downstream - make a PR here.
Already ongoing efforts
Arch
From our official releases:
- https://www.archlinux.org/packages/community/any/python-acme
- https://www.archlinux.org/packages/community/any/certbot
- https://www.archlinux.org/packages/community/any/certbot-apache
- https://www.archlinux.org/packages/community/any/certbot-nginx
- https://www.archlinux.org/packages/community/any/certbot-dns-cloudflare
- https://www.archlinux.org/packages/community/any/certbot-dns-cloudxns
- https://www.archlinux.org/packages/community/any/certbot-dns-digitalocean
- https://www.archlinux.org/packages/community/any/certbot-dns-dnsimple
- https://www.archlinux.org/packages/community/any/certbot-dns-dnsmadeeasy
- https://www.archlinux.org/packages/community/any/certbot-dns-google
- https://www.archlinux.org/packages/community/any/certbot-dns-luadns
- https://www.archlinux.org/packages/community/any/certbot-dns-nsone
- https://www.archlinux.org/packages/community/any/certbot-dns-rfc2136
- https://www.archlinux.org/packages/community/any/certbot-dns-route53
From master: https://aur.archlinux.org/packages/certbot-git
Debian (and its derivatives, including Ubuntu)
- https://packages.debian.org/sid/certbot
- https://packages.debian.org/sid/python-certbot
- https://packages.debian.org/sid/python-certbot-apache
Fedora
In Fedora 23+.
- https://apps.fedoraproject.org/packages/python-acme
- https://apps.fedoraproject.org/packages/certbot
- https://apps.fedoraproject.org/packages/python-certbot-apache
- https://apps.fedoraproject.org/packages/python-certbot-dns-cloudflare
- https://apps.fedoraproject.org/packages/python-certbot-dns-cloudxns
- https://apps.fedoraproject.org/packages/python-certbot-dns-digitalocean
- https://apps.fedoraproject.org/packages/python-certbot-dns-dnsimple
- https://apps.fedoraproject.org/packages/python-certbot-dns-dnsmadeeasy
- https://apps.fedoraproject.org/packages/python-certbot-dns-google
- https://apps.fedoraproject.org/packages/python-certbot-dns-luadns
- https://apps.fedoraproject.org/packages/python-certbot-dns-nsone
- https://apps.fedoraproject.org/packages/python-certbot-dns-rfc2136
- https://apps.fedoraproject.org/packages/python-certbot-dns-route53
- https://apps.fedoraproject.org/packages/python-certbot-nginx
FreeBSD
Gentoo
Currently, all certbot related packages are in the
testing branch:
- https://packages.gentoo.org/packages/app-crypt/certbot
- https://packages.gentoo.org/packages/app-crypt/certbot-apache
- https://packages.gentoo.org/packages/app-crypt/certbot-nginx
- https://packages.gentoo.org/packages/app-crypt/acme