{"id":17023634,"url":"https://github.com/krisrang/cookbook-le-certbot","last_synced_at":"2025-03-22T18:19:23.923Z","repository":{"id":140124350,"uuid":"112339946","full_name":"krisrang/cookbook-le-certbot","owner":"krisrang","description":"Configures certbot with cron renew script support","archived":false,"fork":false,"pushed_at":"2018-02-22T13:23:04.000Z","size":52,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-27T22:37:33.493Z","etag":null,"topics":["certbot","chef","chef-cookbook"],"latest_commit_sha":null,"homepage":"https://supermarket.chef.io/cookbooks/le-certbot","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/krisrang.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"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":"2017-11-28T13:37:50.000Z","updated_at":"2018-07-28T11:43:33.000Z","dependencies_parsed_at":null,"dependency_job_id":"4d33dc4d-1769-4bbf-9b77-3224cf38e696","html_url":"https://github.com/krisrang/cookbook-le-certbot","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/krisrang%2Fcookbook-le-certbot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/krisrang%2Fcookbook-le-certbot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/krisrang%2Fcookbook-le-certbot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/krisrang%2Fcookbook-le-certbot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/krisrang","download_url":"https://codeload.github.com/krisrang/cookbook-le-certbot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244999698,"owners_count":20544922,"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":["certbot","chef","chef-cookbook"],"created_at":"2024-10-14T07:13:48.822Z","updated_at":"2025-03-22T18:19:23.880Z","avatar_url":"https://github.com/krisrang.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# le-certbot Cookbook\n\n[![Build Status](https://travis-ci.org/krisrang/cookbook-le-certbot.svg?branch=master)](https://travis-ci.org/krisrang/cookbook-le-certbot) [![Cookbook Version](https://img.shields.io/cookbook/v/le-certbot.svg)](https://supermarket.chef.io/cookbooks/le-certbot)\n\nThis cookbook is used to configure a system as a Chef Client.\n\n## Requirements\n\n### Platforms\n\n- Ubuntu\n\n### Chef\n\n- Chef 12.9+\n\n### Dependent Cookbooks\n\n- none\n\n## Attributes\n\nThe following attributes affect the behavior of the chef-client program when running as a service through one of the service recipes, or in cron with the cron recipe, or are used in the recipes for various settings that require flexibility.\n\n- `node['le-certbot']['rsa_key_size']` - Sets RSA key size for certificates requested with `certbot_certificate`. Default 4096.\n- `node['le-certbot']['webroot']` - Sets the webroot when requesting certificate with `certbot_certificate`. Default \"/var/www/acme\".\n\nThe following attributes are set on a per-platform basis, see the `attributes/default.rb` file for default values.\n\n- `node['le-certbot']['renew_scripts_root']` - Sets the directory where certbot expects renew scripts to be installed to.\n- `node['le-certbot']['executable_path']` - Sets the default location of the `certbot` executable on the node.\n- `node['le-certbot']['live_path']` - Sets the default location certbot links live certificates to on the node.\n\n## Recipes\n\nThis section describes the recipes in the cookbook and how to use them in your environment.\n\n### default\n\nSets up certbot on the node.\n\n## Usage\n\nUse the recipes as described above to configure your systems to run Chef as a service via cron / scheduled task or one of the service management systems supported by the recipes.\n\n## Resources\n\n### certbot\n\nThe certbot resource installs certbot.\n\n### Actions\n\n- `:install`\n- `:remove`\n\n### Properties\n\n- none\n\n### certbot_certificate\n\nThe certbot_certificate manages Let's Encrypt certificates via certbot. Certbot installs the certificates into the `node['le-certbot']['live_path']/\u003cdomain\u003e/` directory.\n\nThe file names are:\n\n- fullchain.pem - full certificate chain\n- privkey.pem - certificate key\n- chain.pem - certificate chain\n- cert.pem - certificate\n\n### Actions\n\n- `:create`\n- `:delete` - deletes the certificate from the node\n- `:revoke` - revokes the certificate but does not delete it\n\n### Properties\n\n- `domain` - Domain for the certificate.\n- `domains` - Array of additional domains to include in the certificate. The webroot must be accessible via all specified domains. The certificate will still be referenced by the primary `domain` property.\n- `email` - Let's Encrypt account email.\n- `renew_policy` - Specifies whether when requesting certificate via certbot and a valid active certificate to keep it or force request a new one ('keep', 'force'). Default is 'keep'\n- `test` - Connect to Let's Encrypt staging servers instead of live. Default is 'false'\n\n### certbot_renew_script\n\nThe certbot\\_renew_script manages certificate renew hook scripts that run when any certificates have been updated.\n\n### Actions\n\n- `:install`\n- `:delete`\n\n### Properties\n\n- `contents` - Contents of the script. The script is run via bash so most any commands are accepted.\n- `cookbook` - Cookbook to look for the `script.sh.erb` template that wraps the script if for example you want to use a different shebang. Default is 'le-certbot'\n\n## License\n\n**Copyright:** (c) 2017 Kristjan Rang\n\n```\nMIT License\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkrisrang%2Fcookbook-le-certbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkrisrang%2Fcookbook-le-certbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkrisrang%2Fcookbook-le-certbot/lists"}