Ansible Tower和AWX的CLI工具。
项目描述
欢迎使用tower-cli
tower-cli 是Ansible Tower的遗留命令行工具。
它也是Ansible tower_* 模块在底层所使用的工具。例如
https://docs.ansible.org.cn/ansible/latest/modules/tower_organization_module.html
这些模块现在是AWX集合的一部分,在
https://galaxy.ansible.com/awx/awx
支持这些模块的正确运行是此包的维护目标。
建议所有通过Unix命令行开发AWX或Ansible Tower新工具的开发者使用新的CLI。
https://github.com/ansible/awx/tree/devel/awxkit/awxkit/cli/docs
发布历史
3.3.9 (2020-03-12)
改进了工作流架构命令中模板规范的错误处理。
将点击库固定以避免输出外观和感觉发生变化。
3.3.8 (2020-01-14)
使用额外请求处理已弃用的 vault_credential 参数。
3.3.7 (2019-10-25)
作业模板 associate_credential 现在使用 "credentials" 端点。
在发送和接收命令中包含与作业模板相关的凭据。
在作业模板资源中添加 job_slice_count 字段。
3.3.6 (2019-07-19)
修复上传到 PyPI 服务器时的格式问题。
3.3.5 (2019-07-19)
修复使用 –insecure 标志时的错误。
允许与项目一起使用通知。
修复作业和工作流程名称相同时的发送命令错误。
修复当计划有调查答案时的接收命令。
修复将凭据与工作流程节点关联时的错误。
3.3.4 (2019-04-22)
修复与模板标签相关的接收命令错误。
修复导入到自定义凭据类型时的接收命令错误。
修复主机名在多个清单中时的接收命令错误。
修复配置选项中特殊字符的错误。
修复使用 HipChat 通知 "notify" 选项时的错误。
密码提示已写入 stderr。
支持与工作流程一起提示库存和变量。
允许管理某些用户可配置的实例属性。
3.3.3 (2019-03-22)
修复工作流程方案由于节点过多而挂起的问题。
将组织作业模板角色添加到角色管理中。
3.3.2 (2019-01-28)
修复了未尊重 verify_ssl 配置参数的错误。
修复了在列出团队角色时忽略 –all-pages 的错误。
3.3.1 (2019-01-24)
修复了将标签关联到工作流程的错误。
将标签关联到作业模板现在使用 –job-template 选项。
允许在工作流程内部添加工作流程。
允许导出工作流程的计划。
发送命令现在使用默认终端背景颜色。
修复了发送/接收命令中的某些 Unicode 错误。
隐藏人类格式单页结果的页面编号显示。
允许在项目和组织中设置自定义虚拟环境。
3.3.0 (2018-04-25)
添加了发送和接收命令以导出和导入资源。
添加了对导入和导出角色成员资格的支持。
添加了基于令牌的认证的登录命令(AWX 功能)。
添加了工作流程节点和计划的选项(AWX 功能)。
添加了对服务器端复制(AWX 功能)的支持。
添加了活动流资源。
添加了作业事件的抽象资源。
修复了标签创建、工作流程监控、全局配置、角色列表的错误。
3.2.1 (2017-12-19)
添加了对在正常 CLI 使用中从环境变量中使用的设置的支持。
使用新字段类型使多对多关系更容易管理。
安装了新的 CLI 入口点,awx-cli。
允许在没有 root 权限的情况下进行设置和测试。
添加了项目和库存更新资源以启用更多功能。
修复了复制使用变量字段类型的资源时的错误。
修复了由于行长度过长而导致的调试消息挂起的错误。
修复了 v1 和 v2 并行安装的错误。
修复了对于角色忽略 –all-pages 的错误。
允许使用 –format=id 在多个结果中使用。
添加了对 Unicode 的更清洁处理。
3.2.0 (2017-10-04)
一般
官方支持将 tower_cli 作为 Python 库使用。
主要文档更新。从 3.2.0 版本开始,文档托管在 http://tower-cli.readthedocs.io。
添加了 project_update 和 inventory_update 资源以允许取消和删除。
Tower 3.2 更新
迁移到 API V2。所有 API 调用都将从 /api/v2 开始,而不是从 /api/v1。
将 inventory_source 资源设为外部资源,并删除了与其关联的组的旧关系。从组资源中删除启动库存更新。
添加了 credential_type 资源,并显著修改了凭据资源,以揭示 Tower 3.2 的用户定义凭据功能。
添加了作业模板额外凭据(取消)关联,以揭示 3.2 作业模板的 extra_credential 字段。
删除了所有特定于源的资源 inventory_source 字段,并用 credential 字段替换。
更新库存资源字段,以展示Tower 3.2的智能库存和洞察集成功能。
向主机资源添加了
list_fact
和insights
命令,以展示Tower 3.2的智能库存和洞察集成功能。添加了
instance
和instance_group
资源,以展示Tower 3.2的实例/实例组功能。启用(禁用)将实例组与组织、作业模板和库存资源(从/到)关联的功能,以展示Tower 3.2的实例/实例组功能。
添加了对Tower 3.2源代码管理(SCM)库存源的支持。
更新了作业模板资源字段,以展示Tower 3.2中的更改,包括
–diff
模式功能。更新了作业资源启动命令,以展示Tower 3.2中的更改,包括
–diff
模式功能。更新了ad_hoc资源字段,以展示Tower 3.2中的更改,包括
–diff
模式功能。具体来说,将launch
命令中的–become
的名称更改为–become-enabled
。
已弃用的功能
删除了权限资源。
禁用了通过作业端点启动作业。
移除了扫描作业,改为使用新的作业事实缓存。
移除了Rackspace选项。
移除了项目组织中的过时关联功能。
自3.1.8以来进行更新
包含使用别名tower-cli-v2安装的方法
修复了不完整的角色成员查找问题,防止授予角色。
在元类中合并了多个基类的click参数。
修复了人类显示格式中的Unicode错误。
向列表视图添加了新的页面大小参数。
将scm_update_cache_timeout字段添加到项目资源中。
开始逐步弃用python 2.6。
3.1.7 (2017-08-07)
通过复制exceptions.py支持
import tower_cli.utils.exceptions
语法,以跟进3.1.6。
3.1.6 (2017-07-18)
修复了Ansible Tower模块的使用兼容性问题。
3.1.5 (2017-07-12)
对主要代码库文件结构进行重构。现在所有与click相关的逻辑都已移动到
tower_cli/cli/
目录,而exceptions.py
和compat.py
也已从utils目录移至基本目录。对资源动作命令(如
update
)的帮助文本选项进行分类,以提高可读性。工作流程模式命令的行为变更。现在,当需要使结果工作流程拓扑与模式文件中描述的完全相同时,模式将创建新节点并删除现有节点。
添加了
job_template callback
命令,以通过Tower CLI执行供应回调。添加了新的格式选项,仅回显ID。
扩展了一些资源字段,包括通知模板的HipChat房间和作业模板的allow_simultaneous。
如果名称不是完全限定,则使用“以...开头”的逻辑查找相关库存源。
修复了导致作业监控跟踪的python 3.5兼容性问题。
进行了少量拼写和帮助文本更新。
3.1.4 (2017-06-07)
支持资源复制子命令。
支持基于auth-token的认证 Tower CLI请求。
支持通过Tower CLI管理工作流程角色、标签和通知。
在RPM规范文件上进行了几个修复。
在凭证种类选择中将“foreman”重命名为“satellite6”。
修复了3.1.0升级后使用–extra-vars创建作业模板不起作用的问题。
修复了使用–use-job-endpoint启动作业时的跟踪。
增强了json库的使用,以防止使用较早的python 2.6版本时抛出跟踪。
在读取全局配置文件时防止抛出不必要的警告。
3.1.3 (2017-03-22)
修复了某些命令中丢失extra_vars的bug。
3.1.2 (2017-03-21)
修复了某些命令中未添加全局标志的bug。
3.1.1 (2017-03-13)
修复了阻止命名资源使用运行时配置设置的bug。
修复了3.1.0中的bug,有时在给出
pk
值时会导致跟踪。
3.1.0 (2017-03-09)
改进了作业监控功能,以启用标准输出流,这在命令行上显示实时作业输出。
增加了工作流程、工作流程作业和节点端点,用于操作工作流程图和管理工作流程作业资源。反映了 Tower 3.1 的工作流程功能。
增加了设置命令,通过 Tower CLI 管理Tower设置。反映了 Tower 3.1 中的“在 Tower 中配置 Tower”(CTiT)功能。
为某些统一作业模板资源包括超时选项。反映了 Tower 3.1 中的作业超时功能。
为 extra_vars 和变量类型增加了对 Unicode 的支持。
进行了几个小的错误修复,以提高用户体验。
3.0.3 (2017-02-07)
向用户公开自定义库存脚本资源。
在发布 tarball 中包括测试和文档。
增加了作业模板跳过标记的提示支持。
增加了作业模板回调支持。
3.0.2 (2016-12-08)
通过环境变量启用配置 tower-cli。
3.0.1 (2016-09-22)
增加了对自定义 SSL 证书的支持。
3.0.0 (2016-08-05)
增加了资源更改的文字指示器。
允许主机、库存和组使用命令行中的变量,并以“@”开头表示文件。
为 tower3.0 增加了资源角色,并为以前的 tower 版本增加了权限。
增加了通知模板。
增加了标签。
增加了描述显示选项。
增加了弃用警告。
帮助文本升级。
除了颜色外,给出“已更改”的指示。
增加了支持 openstack-v2、网络和 azure 的新凭证字段。
增加了库存源/组的选项,添加了隐式资源库存脚本。
凭证更新(不再需要用户/团队)。
增加了对系统审计员的支持。
项目(不发布到组织/N/项目)。
提示 JT 字段 + 作业启动选项(允许空白库存)。
更新关联和取消关联操作的 POST 协议。
增加向后兼容的新作业启动选项。
添加了显示 tower-cli 版本的新 tower-cli 选项。
增强了调试日志格式(支持多行调试日志)。
2.3.2 (2016-07-21)
添加了 RPM specfile 和 Makefile。
修复了 Tower 兼容性问题。
允许将扫描 JTs 作为“job_type”选项。
增加了将一个组作为另一个组的子组创建的能力。
添加了针对 YAML 和人类化输出格式的 YAML 输出格式。
增加了 SSL 边缘情况错误处理和建议。
允许使用“null”取消资源关联。
2.3.1 (2015-12-10)
修复了影响强制存在和 fail_on_found 选项的 bug。
将 extra_vars 的行为更改为更符合规范,即使只有一个源存在也会重新解析变量。
修复了组修改 bug,避免在修改请求中发送不必要的字段。
2.3.0 (2015-10-20)
修复了设置文件可能被世界可读的问题。
增加了将项目与组织关联的能力。
增加了“verify_ssl”设置,以禁止不安全连接。
增加了对其他云凭证的支持。
公开了云库存源的其他选项。
将旧版本的“启动时间 extra_vars”与“作业模板 extra_vars”合并。
将 extra_vars 参数更改为与 Ansible 参数处理一致。
增加了运行 ad hoc 命令的能力。
显示作业信息时包括更多细节。
添加了一个示例 bash 脚本,以演示 tower-cli 的使用。
2.1.1 (2015-01-27)
为 Python 2.6 到 3.4 版本添加了测试。
为 github README 添加了 shields。
在作业启动时添加了 job_tags。
添加了项目本地路径选项。
2.1.0 (2015-01-21)
增加了自定义资源选项集中字段的选项。
扩展了监控能力,包括项目和库存源。
增加了对新作业模板作业启动端点的支持。
2.0.2 (2014-10-02)
增加了为配置文件设置本地作用域的选项。
扩展了凭证资源,允许为云凭证提供选项。
2.0.1 (2014-07-18)
更新了 README 和错误文本。
2.0.0 (2014-07-15)
基于 click 构建的可插拔资源架构。