🕊️ peace – 零压力自动化

peace 是一个构建有同情心和宽容的软件自动化的框架。

查看

• peace.mk 了解项目愿景。
• 背景 了解创建此框架的动机。
• 操作用户体验 了解在 peace 的设计和开发过程中考虑的维度。

指导原则

• 使用愉快。
• 人体工程学API和指导，做正确的事情。
• 可理解的输出。

特性

• 🟢 幂等: 多次调用会产生预期结果。
• 🟢 清洁: 每个项目的创建都配对有如何清理它的方法。
• 🟢 可理解: 进展以可理解的程度显示。
• 🔵 可理解: 错误报告与 miette 兼容。
• 🟡 可中断: 执行可以被中断。
• 🟢 可恢复: 自动化在停止的地方恢复。
• 🟢 可比较: 状态和差异以 YAML 格式序列化。
• 🟢 高效: 任务通过 fn_graph 并发执行。
• 🟢 命名空间: 配置文件目录将环境相互隔离。
• 🟢 类型安全: 项目和参数在代码中定义，而不是在配置中。

路线图

• 🟢 定义要管理的项目。
• 🟢 定义项目之间的依赖关系。
• 🟢 定义“应用”逻辑。
• 🟢 定义“清理”逻辑。
• 🟢 发现当前状态和目标状态。
• 🟢 定义状态之间的差异计算。
• 🟢 在多个命令间存储和回溯参数。
• 🟢 多个配置文件之间的差异状态。
• 🟢 类型安全的引用参数 -- 指定自动化过程中生成值的后续项目使用。
• 🟡 特性门控的增量功能。
• 🟡 常用项目的现成支持。
• 🟡 干运行。
• 🟣 支持WASM。
• ⚫ 通过 tokio-graceful-shutdown 进行取消安全的中断。
• ⚫ 设计安全支持：加密值存储，按执行/基于时间代理解密。
• ⚫ 编写软件生命周期管理工具的教程。
• ⚫ 内置应用程序执行方法 -- CLI，网络服务。
• ⚫ 基于miette（可选特性）的peace二进制文件用于基于配置的工作流程。
• ⚫ 基于网络的交互式图形界面。
• ⚫ 代理模式在服务器上运行peace（Web API调用）。

更多想法

• 备份当前状态。
• 恢复先前的状态。
• 遥测/指标日志用于分析。

示例

示例使用--package而不是--example运行，因为每个示例都组织为其自己的crate。

cargo run --package $example_name --all-features

# e.g.
cargo build --package download --all-features
cargo run -q --package download --all-features -- init https://ifconfig.me ip.json

for cmd in status goal diff ensure ensure diff clean clean diff
do
    printf "=== ${cmd} ===\n"
    cargo run -q --package download --all-features -- --format text $cmd
    printf '\n'
done

# Look at metadata that Peace has saved
find .peace -type f -exec bash -c 'echo \# {}; cat {}; echo' \;

# Clean up the metadata directory
rm -rf .peace

WASM

使用wasm-pack可以将download示例构建为Web Assembly应用程序。

cd examples/download
wasm-pack build --target web

在examples/download目录中启动HTTP服务器，并打开https://127.0.0.1:8000/

python3 -m http.server 8000 # or
simple-http-server --nocache --port 8000 -i

许可证

根据您的选择，许可权受以下之一约束：

• Apache License, Version 2.0, (LICENSE-APACHE 或 https://apache.ac.cn/licenses/LICENSE-2.0)
• MIT许可证 (LICENSE-MIT 或 https://opensource.org/licenses/MIT)

。

贡献

除非您明确声明，否则根据Apache-2.0许可证定义的任何有意提交的供工作使用的贡献，都应按上述方式双重许可，不附加任何额外条款或条件。