Package: ansible-tower-cli
Welcome to tower-clitower-cliis a legacy command line tool for Ansible Tower.It is also what the Ansibletower_*modules use under the hood. Such as:https://docs.ansible.com/ansible/latest/modules/tower_organization_module.htmlThese modules are now vendored as part of the AWX collection at:https://galaxy.ansible.com/awx/awxSupporting correct operation of the modules is the maintenance aim of this
package.Anyone developing new tooling around AWX or Ansible Tower via a Unix command
line is suggested to use the new CLI.https://github.com/ansible/awx/tree/devel/awxkit/awxkit/cli/docsRelease History3.3.9 (2020-03-12)Improve error handling for template specification in workflow schema command.Pin the click library to avoid changing look and feel of output.3.3.8 (2020-01-14)Process deprecated vault_credential parameter with extra request3.3.7 (2019-10-25)Job template associate_credential now uses “credentials” endpointInclude related credentials to job templates in send and receive commandsAdd field for job_slice_count to job template resource3.3.6 (2019-07-19)Fix formatting for upload to PyPI server3.3.5 (2019-07-19)Fix error with use of –insecure flagAllow notifications to be used with projectsFix send command error when job and workflow have the same nameFix receive command when schedules have survey answersFix error associating credential with workflow node3.3.4 (2019-04-22)Fix receive command bugs related template labelsFix receive command bug when importing to custom credential typesFix receive command bug when host name was in multiple inventoriesFix bugs with special characters in config optionsFix bug using HipChat notification “notify” optionPassword prompt written to stderr nowSupport prompting for inventory and variables with workflowsAllow managing certain user-configurable instance properties3.3.3 (2019-03-22)Fix bug where workflow schema would hang if there were too many nodesAdd organization job_template_role to role management3.3.2 (2019-01-28)Fix bug where verify_ssl config parameter was not respectedFix bug where –all-pages was ignored listing team roles3.3.1 (2019-01-24)Fixed associating labels to workflowsAssociating labels to job template now takes option as –job-templateAllow adding workflows inside of workflowsAllow exporting schedules of workflowsSend command now uses default terminal background colorFix some unicode errors in send/receive commandsHide display of page number for human-formatted single page resultsAllow setting the custom virtual environment on projects and organizations3.3.0 (2018-04-25)Added send and receive commands to export and import resourcesAdded support for import and export role memberships as wellAdded login command for token-based auth (AWX feature)Added options for workflow nodes and schedules (AWX feature)Added support for server-side copying (AWX feature)Added resource for activity streamAdded abstract resource for job eventsBug fixes for label creation, workflow monitor, global config, role list3.2.1 (2017-12-19)Added support for using settings from environment vars in normal CLI useMade many-to-many relations easier to manage with a new field typeInstalled new CLI entry point, awx-cliAllowed setup and testing to proceed without root privilegesAdded project and inventory update resources to enable more functionalityFixed bug when copying resources that use the variables field typeFixed bug that caused debug messages to hang with long line lengthsFixed bug with side-by-side install of v1 and v2Fixed bug where –all-pages was ignored for rolesAllowed use of –format=id with multiple resultsAdded cleaner handling of Unicode3.2.0 (2017-10-04)General:Officially support using tower_cli as a python library.Major documentation updates. From 3.2.0 docs are hosted onhttp://tower-cli.readthedocs.io.Added project_update and inventory_update resources to allow canceling and deleting.Updates from Tower 3.2:Migrated to API V2. All API calls will start with/api/v2instead of/api/v1.Made inventory_source an external resource and remove the old relationship to its associated group. Remove launching inventory updates from group resource.Added credential_type resource and significantly modified credential resource to reveal user-defined credentials feature of Tower 3.2.Added job template extra credential (dis)association to reveal extra_credential field of 3.2 job templates.Removed all source-specific inventory source fields and replaced them with acredentialfield.Updated inventory resource fields to reveal smart inventory and insights integration features of Tower 3.2.Addedlist_factandinsightscommands to host resource to reveal smart inventory and insights integration features of Tower 3.2.Addedinstanceandinstance_groupresources to reveal instance/instance group feature of Tower 3.2.Enabled (dis)associating instance groups to(from) organization, job_template and inventory resources to reveal instance/instance group feature of Tower 3.2.Added support for Tower 3.2 SCM inventory sources.Updated job_template resource fields to reveal changes in Tower 3.2, including–diffmode feature.Updated job resource launch command to reveal changes in Tower 3.2, including–diffmode feature.Updated ad_hoc resource fields to reveal changes in Tower 3.2, including–diffmode feature. Specifically, changed name of–becomeoflaunchcommand into–become-enabled.Deprecated features:Removed permission resource.Disabled launching a job using the jobs endpoint.Removed scan jobs in favor of new job fact cache.Removed Rackspace options.Remove outdated association function for project’s organization.Reflected from 3.1.8:Include method of installing with alias tower-cli-v2Fix bug of incomplete role membership lookup, preventing granting of roles.Combine click parameters from multiple base classes in metaclass.Fix unicode bug in human display format.Add new page_size parameter to list view.Add scm_update_cache_timeout field to project resource.Begin process to deprecate python 2.6.3.1.7 (2017-08-07)Follow up 3.1.6 by duplicating exceptions.py to supportimport tower_cli.utils.exceptionssyntax.3.1.6 (2017-07-18)Fix a usage compatibility issue for Ansible Tower modules.3.1.5 (2017-07-12)Major code base file structure refactor. Now all click-related logics are moved totower_cli/cli/directory,
andexceptions.pyas well ascompat.pyare moved out of utils directory into base directory.Categorize help text options for resource action commands (likeupdate) to increase readability.Behavior change of workflow schema command. Now schema will both create new nodes and delete existing nodes when
needed to make the resulting workflow topology exactly the same as described in schema file.Add commandjob_template callbackto enable conducting provisioning callback via Tower CLI.Add new format option to just echo id.Expand some resource fields, including hipchat rooms for notification template and allow_simultaneous for job
templates.Lookup related inventory sources with “starts with” logic if its name is not fully qualified.Fixed a python 3.5 compatibility issue that causes job monitor traceback.Minor typo and help text updates.3.1.4 (2017-06-07)Support resource copy subcommand.Support auth-token-based authentication for Tower CLI requests.Support managing workflow roles, labels and notifications via Tower CLI.Several fixes on RPM spec file.Name change from ‘foreman’ to ‘satellite6’ in credential kind choices.Fixed a bug where creating job templates with –extra-vars did not work after
3.1.0 upgrade.Fixed traceback when launching job with –use-job-endpoint.Enhanced json library usage to prevent traceback when using earlier python 2.6
versions.Prevent throwing unnecessary warning when reading from global configuration file.3.1.3 (2017-03-22)Fixed a bug where extra_vars were dropped in some commands.3.1.2 (2017-03-21)Fixed a bug where global flags are not added to some commands.3.1.1 (2017-03-13)Fixed a bug which blocks named resources from using runtime configure settings.Fixed a bug in 3.1.0 which sometimes causes traceback whenpkvalue is given.3.1.0 (2017-03-09)Improved job monitoring functionality to enable standard out streaming, which
displays real-time job output on command line.Added workflow, workflow_job and node endpoints to manipulate workflow graph
and manage workflow job resources. Reflecting workflows feature of Tower 3.1.Added settings command to manage Tower settings via Tower CLI. Reflecting
Configure Tower in Tower (CTiT) feature of Tower 3.1.Included timeout option to certain unified job template resources. Reflecting
job timeout feature of Tower 3.1.Added unicode support to extra_vars and variable types.Several minor bug fixes to improve user experience.3.0.3 (2017-02-07)Expose custom inventory script resource to the userInclude tests and docs in the release tarballAdded job template skip_tags prompting supportAdded job template callback support3.0.2 (2016-12-08)Enable configuring tower-cli via environment variables3.0.1 (2016-09-22)Added custom SSL certificate support3.0.0 (2016-08-05)Added text indicator for resource changeAllow hosts, inventory, and groups to use variables from the command line
and denote a file by starting with “@”Added resource role for tower3.0 and permission for previous tower versionsAdded notification templatesAdded labelsAdded description display optionAdded deprecation warningsHelp text upgradesGive indication of “changed” apart from colorNew credential fields to support openstack-v2, networking and azureNew options for inventory source/group. Add implicit resource inventory
script.credential updates (no longer require user/team)Added support for system auditorsprojects (do not post to organizations/N/projects)prompt-for JT fields + job launch options (allow blank inventory too)Update the POST protocol for associate and disassociate actionsNew job launch option for backwards compatibilityNew tower-cli option to display tower-cli versionEnhanced debug log format (support multi-line debug log)2.3.2 (2016-07-21)Add RPM specfile and MakefileTower compatibility fixesAllow scan JTs as an option for “job_type”Add ability to create group as subgroup of another groupAdd YAML output format against JSON and humanized output formatsAdd SSL corner case error handling and suggestionAllow resource disassociation with “null”2.3.1 (2015-12-10)Fixed bug affecting force-on-exists and fail_on_found optionsChanged extra_vars behavior to be more compliant by re-parsing vars,
even when only one source existsFixed group modify bug, avoid sending unwanted fields in modify requests2.3.0 (2015-10-20)Fixed an issue where the settings file could be world readableAdded the ability to associate a project with an organizationAdded setting “verify_ssl” to disallow insecure connectionsAdded support for additional cloud credentialsExposed additional options for a cloud inventory sourceCombined “ launch-time extra_vars” with “ job_template extra_vars”
for older Tower versionsChanged the extra_vars parameters to align with Ansible parameter
handlingAdded the ability to run ad hoc commandsIncluded more detail when displaying job informationAdded an example bash script to demonstrate tower-cli usage2.1.1 (2015-01-27)Added tests for Python versions 2.6 through 3.4Added shields for github READMEAdded job_tags on job launchesAdded option for project local path2.1.0 (2015-01-21)Added the ability to customize the set of fields used as options for
a resourceExpanded monitoring capability to include projects and inventory
sourcesAdded support for new job_template job launch endpoint2.0.2 (2014-10-02)Added ability to set local scope for config fileExpanded credential resource to allow options for cloud credentials2.0.1 (2014-07-18)Updated README and error text2.0.0 (2014-07-15)Pluggable resource architecture built around click