loelkes.octoprint
ansible-octoprint
Ansible 角色,用于在 Debian(或类似系统,如 Raspbian、Ubuntu)上将 OctoPrint 部署为 systemd 服务。
目前此角色不管理配置文件。如果状态设置为 absent
,配置文件将被删除。重启命令通过 OctoPrint 配置命令行工具进行配置。
注意: 此角色和代码库不应包含任何关于 OctoPrint/Ansible/Linux/Raspberry Pi 配置的帮助或建议。请查看各自项目的手册以获取帮助。
要求
需要一个启用 SSH 的 Debian 或类似系统。用于 Ansible 的用户必须能够无密码执行 sudo 命令。
角色变量
octoprint:
port: 5000 # OctoPrint 使用的端口
user: pi # 运行 OctoPrint 的系统用户。必须已存在,此角色不管理。
group: pi # 运行 OctoPrint 的系统组。必须已存在,此角色不管理。
version: latest # OctoPrint 版本。
state: present # 设置为 absent 以删除所有文件、配置和服务。
dir: /srv/octoprint # OctoPrint 安装目录。
示例
要安装最新版本的 OctoPrint:
- name: 安装 OctoPrint
hosts: rpi-octoprint
remote_user: pi
become: true
roles:
- loelkes.octoprint
要安装指定版本的 OctoPrint:
- name: 安装 OctoPrint
hosts: rpi-octoprint
remote_user: pi
become: true
vars:
octoprint:
version: "1.8.7"
roles:
- loelkes.octoprint
要更新 OctoPrint,保留现有配置和访问凭证:
- name: 使用现有配置更新 OctoPrint
hosts: rpi-octoprint
remote_user: pi
become: true
roles:
- loelkes.octoprint
要卸载 OctoPrint 及其所有软件包依赖:
- name: 卸载 Raspberry Pi OS 上的 OctoPrint
hosts: rpi-octoprint
remote_user: pi
become: true
vars:
octoprint:
state: absent
roles:
- loelkes.octoprint
贡献
请参见 贡献指南
许可证
更新日志
请参见 CHANGELOG.md