跳转到主要内容

Ansible Tower和AWX的CLI工具。

项目描述

Build Status Coverage Status Version Downloads License Supported Python Versions

欢迎使用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_factinsights命令,以展示Tower 3.2的智能库存和洞察集成功能。

  • 添加了instanceinstance_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.pycompat.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 构建的可插拔资源架构。

项目详细信息


下载文件

下载适用于您平台的文件。如果您不确定选择哪个,请了解有关安装包的更多信息。

源代码分发

ansible-tower-cli-3.3.9.tar.gz (203.9 kB 查看哈希值)

上传时间 源代码

由以下支持