Salt扩展用于Nix

Salt与Nix交互的扩展

安全

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

用户文档

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

贡献

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

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

快速入门

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

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

# Change to the repo dir
cd saltext-nix

自动

如果您已安装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。

贡献方式

贡献可以有多种形式，它们都是宝贵的！以下是一些您可以在不编写代码的情况下提供帮助的方法

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

您还可以通过以下方式做出贡献

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

这些事情中的任何一件对我们社区来说都非常宝贵，我们真诚地感谢每一次贡献！