使用YAML管理Jenkins作业
项目描述
Jenkins Job Builder 可以使用 YAML 或 JSON 格式描述 Jenkins 任务的简单描述,并使用这些描述来配置 Jenkins。您可以将任务描述保存在可读的文本格式中,以便在版本控制系统中进行更改和审计,从而简化操作。它还具有灵活的模板系统,因此创建具有相似配置的多个任务变得容易。
安装
$ pip install --user jenkins-job-builder
在线文档
开发者
错误报告
存储库
克隆
git clone https://opendev.org/jjb/jenkins-job-builder.git
为了在您的提交上运行一些基本的测试,请从 https://pre-commit.git-scm.cn/#intro 安装 pre-commit。
建议在开发中使用虚拟环境。例如,可以从顶层目录安装 Jenkins Job Builder
$ virtualenv .venv $ source .venv/bin/activate $ pip install -r test-requirements.txt -e .
补丁通过 Gerrit 在以下网址提交
请勿提交 GitHub pull 请求,它们将被自动关闭。
邮件列表
IRC
#openstack-jjb 在 OFTC
有关如何贡献的更多详细信息,请访问我们的维基百科
编写补丁
我们要求所有代码提交都通过 pep8 和 pyflakes 清理。最简单的方法是在将代码提交到 Gerrit 进行审查之前运行 tox。它将以与将要运行在提议的补丁集上的自动化测试套件相同的方式运行 pep8 和 pyflakes。
创建新的 YAML 组件时,请注意以下风格约定
所有 YAML 标识符(包括组件名称和参数)应使用小写,并且多词标识符应使用连字符。例如,“build-trigger”。
实现组件的 Python 函数应与 YAML 关键字具有相同的名称,但应使用下划线而不是连字符。例如,“build_trigger”。
这种一致性将帮助用户在编写 YAML 时避免简单的错误,同时也帮助开发人员在将 YAML 组件与 Python 实现匹配时避免错误。
单元测试
已包含单元测试,并在 tests 文件夹中。我们的文档中包含了许多单元测试示例,以确保示例与现有行为保持一致。要运行单元测试,请执行以下命令
tox -e py38
可以使用 pytest-parallel 插件并行运行单元测试
tox -e py38 -- --workers=auto
注意:查看 tox.ini 以在 Python 的其他版本上运行测试,生成文档,并查看有关在代理后运行测试以验证文档外部 URL 的任何特殊说明。
无需 setup.py 安装
对于 YAML 支持,您需要安装 libyaml。
Mac OS X
$ brew install libyaml
然后使用 pip 安装所需的 Python 包
$ sudo pip install PyYAML python-jenkins
项目详情
下载文件
下载适用于您平台的文件。如果您不确定选择哪一个,请了解有关安装包的更多信息。
源分发
构建分发
jenkins-job-builder-6.4.1.tar.gz 的散列值
算法 | 散列摘要 | |
---|---|---|
SHA256 | 45eeeb340726d1ca52c75b664b34e37c3956ef2db7ea5cc52858d5c34b944e6c |
|
MD5 | 73bd5fc4f6e072e95bfe42e8494f2fa0 |
|
BLAKE2b-256 | c7a10182d77739b546830015d8ff180e7287ed2f7f2533f0b4f98e1e371287e6 |
jenkins_job_builder-6.4.1-py2.py3-none-any.whl 的散列值
算法 | 散列摘要 | |
---|---|---|
SHA256 | 96802a42088e1a8e54c6702fb07caf5d1d1e49fca2d6efd49a6b589699ea337c |
|
MD5 | 88af0270a9ce928fe40ffa9468380803 |
|
BLAKE2b-256 | f0d89ce554c33bcb5364bd9ebcf9761066d084aa8c3baa25e7953dadb7256d20 |