Salt扩展用于Certbot

与Certbot交互的Salt扩展

安全

如果您发现安全漏洞，请参阅Salt的安全指南。

用户文档

有关设置和使用说明，请参阅用户文档。

贡献

saltext-acme项目欢迎任何人的贡献！

Salt扩展指南提供了关于Salt扩展开发的全面说明，包括编写测试、运行测试、编写文档和渲染文档。

快速入门

要开始贡献，首先克隆此存储库（或您的分支）

# Clone the repo
git clone --origin upstream git@github.com:salt-extensions/saltext-acme.git

# Change to the repo dir
cd saltext-acme

自动

如果您已安装direnv，允许项目的.envrc确保存在适当的发展环境，并且虚拟环境是活动的。

没有direnv，您仍然可以显式运行自动化

python3 tools/initialize.py
source .venv/bin/activate

手动

请按照第一步操作，跳过仓库初始化和第一次提交。

拉取请求

始终在功能分支中进行更改

git switch -c my-feature-branch

要提交拉取请求，你需要在自己的GitHub账户中拥有此仓库的分支。如果你按照上述说明进行了操作，现在请将你的分支设置为origin远程分支。

git remote add origin git@github.com:<your_fork>.git

确保你已经按照第一步操作并提交了更改，修复了任何失败的pre-commit钩子。然后推送功能分支到你的分支并提交PR。

贡献方式

贡献可以有多种形式，而且它们都很有价值！以下是一些你可以不编写代码就能帮助的方式

• 文档：特别是展示如何使用此项目解决特定问题的示例。
• 问题分类：帮助管理问题并参与讨论。
• 审查拉取请求：我们特别欣赏使用Conventional Comments的审查。

你也可以通过以下方式来贡献

• 撰写博客文章
• 在社交媒体上分享使用Salt + Certbot的经验
• 在会议上发表演讲
• 发布视频
• 参与IRC、Discord或电子邮件组

以上任何一项对我们社区都非常有价值，我们衷心感谢每一项贡献！