变更前验证配置
对 Git 中的配置执行模式或策略检查。验证失败时以失败退出码结束任务，防止后续工作流步骤改变基础设施。
为工作流添加验证步骤脚本在您的笔记本上能运行，团队也能运行吗？
本地软件包、环境值和记忆中的命令，让好用的 Python 脚本难以交接，也难以每天可靠运行。
为脚本提供可重复使用的执行配置
- 保存仓库与 .py 入口
- 在执行环境中准备 Python 软件包
- 按需或按计划执行，并共享输出
保存 Python 作业、启动并查看输出
模板指向仓库中的脚本，因此代码保留在 Git 中供审查，而不是只在一台笔记本电脑上。
启动时添加简短的运行说明，无需修改脚本，即可在任务历史中识别本次执行。
任务在运行后保留脚本完整输出和退出状态，随时可以再次安排执行。
基础设施变更前验证配置
先运行 Python 验证器。验证成功后才继续执行 Terraform，再使用 Ansible 配置环境。每个步骤保留各自的输出。
验证配置
成功时→输出 → 输入
配置基础设施
成功时→输出 → 输入
配置环境
失败时
收集诊断信息
收集诊断信息Python 代码、依赖与输入
准备解释器与软件包
Python 任务在执行环境中使用 python3。请在那里安装脚本依赖。Docker 安装支持位于 /etc/semaphore/requirements.txt 的 requirements.txt 文件，在容器启动时安装。
提供可重用的配置与密钥
变量组注入环境变量，脚本通过 os.environ 读取。敏感值应保存在密钥条目中，不要嵌入源码。
保留输出，有计划地存储报告
Semaphore 保存任务状态与输出。脚本失败时应返回非零退出码。生成的文件应保存在流程自己管理的存储中，不要将任务日志视为文件存储。
选择代码所需的环境
在预先准备的服务器上执行，或使用 Pro 的项目运行器部署专用环境。在各次运行之间，保持 Python 版本、软件包和外部 API 访问一致。
文档与相关功能
FAQ
Semaphore Python 任务使用哪个 Python 解释器？
Python 任务在执行环境中使用 python3。请在那里准备所需 Python 版本和脚本导入的软件包。任务模板选择仓库与 .py 路径，服务器或运行器提供运行时与网络访问。
每个任务都会自动安装 Python 依赖项吗？
在执行环境中准备所需软件包。对于 Docker 安装，挂载到 /etc/semaphore/requirements.txt 的 requirements.txt 文件会在容器启动时安装依赖。这不会为每个任务创建新的虚拟环境，也不会逐任务安装仓库依赖。
Python 脚本如何接收参数与凭据？
将变量组关联到任务模板。这些值会成为 Python 可通过 os.environ 读取的环境变量。敏感值应保存为密钥，而不是写入源代码。用于 API 请求或文件路径之前，应验证运行时输入。
生成的 CSV 或 JSON 报告应保存在哪里？
让脚本将报告写入流程使用的持久存储，例如对象存储或共享目标。在任务输出中打印有用的引用。Semaphore 任务历史保留状态和日志，并不是通用文件仓库。
能在部署前用 Python 验证配置吗？
可以。使用自己的验证脚本和库检查配置，检查失败时返回非零退出码。在工作流中将该任务模板放在 Terraform 或 Ansible 之前。Semaphore 负责协调任务，并不提供内置验证器。
能为 Python 清单同步或报告设置计划吗？
可以。创建包含脚本、环境输入及所需软件包的 Python 任务模板，再添加计划。API 同步或报告生成由代码完成，Semaphore 记录每次运行，并可针对配置的任务结果发送告警。
Python 检查能在 Ansible 或 Terraform 之后运行吗？
可以。在工作流中，将 Python 任务模板放在基础设施准备或配置步骤之后。用它验证应用就绪状态，或脚本可检查的其他条件。任务退出状态决定后续按配置进入成功还是失败路径。
团队无需在本地安装 Python 也能运行 Python 作业吗？
可以。Python 及其软件包在 Semaphore 执行环境中运行。团队成员通过 UI 或 API 使用已保存作业并查看输出。配置项目角色与模板输入，让成员能够以所需权限执行操作。