跳转到内容
安装

Changelog

[Unreleased] Latest

0.1.0-alpha.13

Added

  • (transport) run the agent over AWS Systems Manager sessions (#1011)
  • (executor) run the fact modules a play names (#1005)
  • (cli) run volant console natively, one ad hoc task per line (#999)
  • (cli) run volant pull natively, with git and no Python (#989)
  • (transport) run the agent in pods through kubectl (#991)
  • (transport) drive the community.general.lxd and incus connections (#982)
  • (yaml) warn about a mapping key written twice (#977)
  • (transport) drive the containers.podman.buildah connection (#973)
  • (transport) drive the community.general.chroot connection (#965)
  • (agent) create a missing link natively in file (#952)
  • (transport) drive the containers.podman.podman connection (#962)
  • (transport) copy the agent into a target with no shell (#954)
  • (transport) drive the community.docker.docker connection (#946)
  • (transport) run the agent link over an exec command (#944)
  • (transport) resolve connection names through ansible-core (#942)
  • (agent) keep a private apt cache where the host turns it off (#974)
  • (agent) run apt natively with policy_rc_d and apt-mark (#947)

Fixed

  • (executor) print a task’s banner and retry lines as they happen (#1010)
  • (executor) render a loop item’s fields when the loop reaches it (#1008)
  • (agent) hand shell and raw lines to /bin/sh as the reference does (#1002)
  • (bridge) give a bridged lookup the hostvars it reads (#1000)
  • (bridge) resolve action-only plugins and keep their deprecation (#1004)
  • (bridge) hand a lookup the variables that do not render (#998)
  • (executor) keep the vault mark through a string filter in set_fact (#997)
  • (bridge) give a plugin the action name the task wrote (#990)
  • (template) report a missing src as the reference raises it (#992)
  • (vault) point each undecryptable value’s error at its own tag (#993)
  • (agent) give stat’s failure its errno cause (#985)
  • (bridge) print a plugin’s deprecation after its warnings (#988)
  • (copy) word a source the controller cannot read as the reference (#987)
  • (agent) return invocation from command and shell (#983)
  • (yaml) keep escapes in template literals of YAML values (#981)
  • (executor) keep the vault mark on a bare vaulted set_fact (#980)
  • (inventory) list only the host named all when one exists (#970)
  • (playbook) word a missing role or playbook as [ERROR] (#976)
  • (vars) order and ungroup hosts that group_by moves (#972)
  • (playbook) know a playbook’s plugin directories before its imports (#971)
  • (vars) keep the inventory’s order in the keys of groups (#969)
  • (template) fail a division by zero as Python does (#967)
  • (template) render another host’s variable in that host’s context (#966)
  • (template) answer the vars magic variable (#963)
  • (collection) match module_defaults groups on the resolved name (#961)
  • (playbook) print a task’s load error as an [ERROR] block (#960)
  • (executor) report include load failures and register includes (#957)
  • (executor) register a task that fails before it runs (#959)
  • (agent) fail the task when the agent dies under it (#949)
  • (executor) end a loop at the item whose label raises (#950)
  • (transport) make a missing remote_tmp as the login user (#951)
  • (agent) ask apt-cache policy again only after a cache update (#964)
  • (agent) read extended attribute names, not only their size (#956)
  • (agent) write a plugin’s put_file onto an existing file (#953)

0.1.0-alpha.12

Added

  • (transport) start a cached agent in the same ssh as the probe (#923)
  • (executor) run the items of a copy or template loop side by side (#919)
  • (shadow) keep a ledger and give a verdict per playbook (#918)
  • (agent) send the copy plugin’s stat and file in one trip (#917)
  • (shadow) an unknown value for what changes between runs (#916)
  • (shadow) report divergences by kind, with host, task and values (#886)
  • (agent) start the Python server ahead of the first module (#885)
  • (shadow) answer pause prompts and count skipped steps in a replay (#882)
  • (template) run the dict, together, nested and subelements lookups (#883)
  • (shadow) replay a recorded run without contacting a host (#881)
  • (agent) run apt cache updates and installs natively (#879)
  • (shadow) read recordings and check them against the checkout
  • (compat) add the volant.compat collection with a record callback (#877)
  • (facts) follow a template src from a loop item attribute (#875)
  • (facts) follow first_found in include_vars (#874)
  • (agent) answer file links, SELinux options and string booleans (#880)
  • (agent) share a Python server across task environments (#873)

Changed

  • (controller) allocate with mimalloc (#871)

Fixed

  • (python) scan each module_utils file once per union build (#941)
  • (executor) give items staging the same file separate rounds (#925)
  • (bridge) start the helper before the first bridged loop (#876)

0.1.0-alpha.11

Added

  • (inventory) add toml output (#865)
  • (roles) set the play’s role name lists (#862)
  • (runtime) add console and pull through the managed runtime (#852)
  • (adhoc) add one-line and tree output (#853)
  • (agent) keep the payload’s compiled code beside it (#849)
  • (adhoc) add check, diff, async and task timeout (#848)
  • (inventory) add yaml output with anchors (#851)
  • (runtime) add config and galaxy through the managed runtime (#850)
  • (runtime) run ansible-doc through the managed runtime (#843)
  • (adhoc) list hosts and report empty host sets (#840)
  • (profile) count renders, layer copies, bridge calls and wire bytes (#839)
  • (vault) add encrypt_string (#837)
  • (inventory) add graph output (#835)
  • (vault) add create, edit and rekey (#829)
  • (profile) flamegraph recipe for the controller and the agent (#830)
  • (adhoc) run one module against a host pattern (#827)
  • (inventory) add the inventory command with list and host (#826)
  • (vault) add encrypt, decrypt and view (#825)
  • (cli) add shims install and remove (#823)
  • (cli) dispatch on the program name (#821)

Changed

  • (vars) share the play’s host lists instead of copying them (#870)
  • (vars) share each host’s view in the hostvars map (#868)
  • (executor) publish batch progress only when it changes (#866)

Fixed

  • (union-cache) cap the cache size and cut two fixed run costs (#869)
  • (roles) render a roles entry named by a template (#860)
  • (roles) set role_name, ansible_role_name and the parent roles (#859)
  • (facts) follow a file name built from part of a fact (#846)
  • (python) keep the union cached for namespace module_utils packages (#844)
  • (agent) keep the Python server when its directory is not searchable (#847)

0.1.0-alpha.10

Added

  • (runtime) print and check the SHA-256 of a packed runtime (#769)
  • (become) run su over a local connection (#755)
  • (config) read force_color, nocolor and deprecation_warnings (#752)
  • (ssh) read usetty and ANSIBLE_SSH_USETTY (#753)

Fixed

  • (copy) print the hint line for a missing source (#773)
  • (bridge) run plugin jobs in parallel and escalate only when asked (#776)
  • (vault) fail on an undecryptable value as ansible-core does (#774)
  • (bridge) give bridged lookups the play’s variables (#775)
  • (template) chain a raising filter, bridge import_playbook (#770)
  • (lookups) chain a lookup failure in when or a template (#768)
  • (executor) fail a bad meta, action or role task when reached (#761)
  • (render) print skipped, no_log and add_host results as ansible-core (#757)
  • (lookups) fail native lookups with their own message (#764)
  • (cli) match the implicit Gathering Facts with –start-at-task (#765)
  • (inventory) word constructed and generator errors as ansible-core (#766)
  • (preflight) report a missing collection as ansible-core does (#763)
  • (template) word and chain an undefined variable as ansible-core (#754)
  • (agent) keep a replaced file’s owner and bound PutFile (#756)
  • (inventory) reject an invalid regex pattern as ansible-core does (#759)
  • (template) hide volant_unsafe and accept !unsafe on a mapping key (#758)
  • (executor) render a loop item’s fields when the loop reaches it (#760)

0.1.0-alpha.9

Added

  • (fetch) write a dest a host named by default, protection opt-in (#748)
  • (template) run dict.fromkeys and str.encode (#702)
  • (template) define ansible_playbook_python (#721)
  • (render) honour show_task_path_on_failure (#723)
  • (template) format a text with the % operator as Python does (#538)
  • (fetch) add host_named_dest_dirs for a dest a host named (#692)
  • (template) run list and dict methods that change a value (#535)
  • (template) add the now() and lipsum() globals (#691)
  • (template) run Python str methods with their arguments and errors (#528)
  • (template) read custom delimiters, a #jinja2: line and output_encoding (#497)
  • (include) honor the options of include_role, include_tasks and import_role (#468)
  • (actions) add host_named_paths for host-named sources (#519)
  • (executor) read a directory with include_vars (#480)
  • (ssh) read ansible_password and the legacy connection variables (#469)
  • (executor) accept async where ansible does, fail it where not (#449)
  • (strategy) run free and host_pinned plays the reference accepts (#447)
  • (debugger) redo a task from the debugger prompt (#442)
  • (cli) print every -vvvv line ansible prints (#440)
  • (runtime) pack a runtime and install it offline (#443)
  • (runtime) install collections into the runtime (#441)
  • (runtime) use the managed runtime and install it on first need (#439)
  • (debugger) answer every debugger command as ansible does (#437)
  • (runtime) install and manage Volant’s Python runtime (#438)
  • (executor) template throttle and coerce it as ansible does (#436)
  • (runtime) pin and fetch a verified Python build (#434)

Fixed

  • (template) keep braces a computation builds as text (#741)
  • (executor) take a raised module’s message from its exception (#729)
  • (template) read base and default of int as ansible-core does (#725)
  • (roles) make roles_path entries and the playbook directory absolute (#714)
  • (template) render variables that read the inventory’s names (#730)
  • (render) drop invocation from result lines below -vvv (#722)
  • (vars) keep inventory names that hold template syntax as data (#724)
  • (template) keep integers of any width in results and templates (#693)
  • (test) make the dangling link of with-filetree at run time (#546)
  • (actions) turn each argv item of command into text (#686)
  • (executor) let failed_when decide a task whose retries ran out (#687)
  • (template) render statement blocks and comments in strings (#532)
  • (template) follow Python re in the regex filters and tests (#485)
  • (executor) render boolean and integer keywords written as templates (#473)
  • (yaml) refuse deep nesting and large alias expansion (#515)
  • (executor) render a play’s hosts when the play starts (#529)
  • (template) render a variable’s template when a template reads it (#483)
  • (yaml) load aliases and tags the way PyYAML does (#496)
  • (playbook) run every with_ form whose lookup ansible-core has (#484)
  • (template) build dict() from any iterable of pairs (#527)
  • (ssh) accept an agent directory another link just made (#543)
  • (executor) give a looped set_fact’s facts to the next item (#525)
  • (playbook) pass the when, tags and vars of an import_playbook on (#533)
  • (vars) answer hostvars for the implicit localhost and its three names (#489)
  • (agent) bound the values in one result frame from a host (#512)
  • (yaml) merge the mappings a merge key names (#481)
  • (ssh) refuse an agent directory another user can write (#513)
  • (roles) keep role option files inside the role directory (#508)
  • (vars) keep an add_host name that holds a template as data (#514)
  • (executor) keep a delegate name that holds a template as data (#506)
  • (ssh) keep the password file in a private directory (#511)
  • (config) skip ./ansible.cfg in a world-writable directory (#517)
  • (template) render a raw block’s text once (#499)
  • (actions) run ansible.posix.synchronize over ssh (#495)
  • (executor) share the host’s variables between the items of a loop (#539)
  • (compile) give the play keywords to its own handlers (#505)
  • (executor) read the options of a free-form command line (#463)
  • (executor) resolve yum as the dnf action it redirects to (#462)
  • (ssh) refuse an address that ssh would read as an option (#471)
  • (python) keep the working directory off the interpreter module path (#475)
  • (yaml) load a large vars file in linear time (#490)
  • (executor) count a failure for the exit code when it arrives (#461)
  • (executor) close the remaining deferred executor gaps (#457)
  • (strategy) report a failure under free as soon as it happens (#455)
  • (inventory) close the remaining deferred inventory and output gaps (#453)
  • (template) close the deferred template, inventory and output gaps (#451)
  • (executor) close the deferred executor output gaps (#450)
  • (actions) close the deferred action and vault gaps (#444)
  • (inventory) run the implicit localhost under the controller Python (#448)
  • (executor) keep hosts forgiven by clear_host_errors in play (#430)
  • (agent) import Instant only where the Linux tests use it (#540)
  • (agent) count a huge async limit or timeout in one step (#482)

0.1.0-alpha.8

Added

  • (inventory) build constructed and generated inventories (#372)
  • (inventory) load collection inventory plugins through the helper (#371)
  • (inventory) read yaml and toml inventories and host ranges (#370)
  • (inventory) run inventory scripts (#368)
  • (executor) refresh every inventory source mid-run (#369)
  • (facts) cache facts in json files and gather only when needed (#366)
  • (inventory) read every source the way ansible does (#367)
  • (cli) print the -vv to -vvvv lines and load modules from -M (#360)
  • (render) print diffs as ansible-playbook does (#361)
  • (actions) answer check mode the way each module does (#358)
  • (vault) read vaulted values and files in playbooks (#359)
  • (ssh) take connection and become passwords from a prompt or a file (#356)
  • (executor) run plays in check and diff mode (#355)
  • (cli) start at a task, step through tasks, print the version (#352)
  • (vault) decrypt ansible-vault data (#353)
  • (ssh) run raw and script commands on a terminal (#351)
  • (actions) run collection action plugins on the bridge (#347)
  • (bridge) run plugins that ignore options or wrap async (#346)
  • (executor) run the remaining action plugins on the bridge (#345)
  • (executor) prompt at a pause on a terminal (#344)
  • (bridge) run action plugins in the Python helper (#343)
  • (executor) apply add_host, group_by and set_stats results (#342)
  • (agent) put a staged file at a path (#340)
  • (agent) run async tasks and async_status (#337)
  • (executor) run the free, host_pinned and debug strategies (#338)
  • (playbook) run gather_subset and vars_prompt (#336)
  • (executor) run every meta action (#334)
  • (become) run su and the become_exe and become_flags keywords (#333)
  • (playbook) run module_defaults and collections (#332)
  • (executor) run any_errors_fatal and its sibling keywords (#330)
  • (handlers) resolve templated notify names (#331)
  • (transport) run the remote_user, port and connection keywords (#329)
  • (loops) run index_var, extended, pause and break_when (#328)
  • (template) send unknown filters, tests and lookups to the bridge (#324)
  • (loops) run every with_ lookup loop (#323)
  • (yaml) load !unsafe values as data (#322)
  • (bridge) run filters, tests and lookups in the Python helper (#321)
  • (executor) see cross-host reads under the batching opt-in (#245)
  • (cli) add –profile and a switch for native modules (#236)
  • (agent) run a native module and hand the task back to python (#230)
  • (template) add the extract filter (#222)
  • (reboot) reboot the host and wait for a new boot id (#219)
  • loop with lookups, set the run tags, retry an action plugin (#216)
  • (fetch) write a host’s file under dest and nowhere else (#215)
  • (dnf) run dnf through its action plugin (#213)
  • (python) run modules from installed collections (#211)
  • (template) add fileglob, ipwrap and the builtin aliases (#210)
  • embed the agents in the release controller (#206)
  • (template) add the remaining filters and two lookups (#193)
  • (actions) unarchive a local or remote archive (#194)
  • (actions) render a template on the controller and copy it (#192)
  • (actions) copy a file, sending it only when it differs (#190)
  • (template) add python methods, result and version tests (#189)
  • (template) render a template file once, as the module does (#188)
  • (actions) run package and service through their manager (#186)
  • (protocol) stage files the agent hands to a module (#183)
  • (agent) collect cpu, memory and routes natively (#242)
  • (agent) collect the minimal facts natively (#237)

Changed

  • (agent) run user and group natively (#254)
  • (agent) run the copy module natively (#256)
  • (protocol) send blobs as compressed binary frames (#253)
  • (agent) run package_facts and service_facts natively (#250)
  • (controller) use the native setup when plays read only its keys (#249)
  • (vars) read host variables through shared layers (#239)
  • (transport) share one ssh connection per inventory host (#238)
  • (controller) cache the python module union between runs (#235)
  • (agent) run lineinfile natively (#252)
  • (agent) run systemd natively (#251)
  • (agent) answer an already satisfied apt task natively (#248)
  • (agent) run stat and file natively (#246)
  • (agent) import a module in the python server while its child runs (#244)

Fixed

  • (template) render containers, none and undefined as ansible does (#365)
  • (actions) find role files from the bridged plugins (#364)
  • (actions) match the reference on script, uri, wait_for_connection (#348)
  • (agent) expand ~ and variables in chdir, creates and removes (#341)
  • (agent) fail a missing program and expand arguments as command does (#316)
  • (executor) report the discovered interpreter as a fact (#315)
  • (render) print chained errors and origins as ansible-playbook does (#319)
  • (cli) exit with the reference’s code in the remaining cases (#317)
  • (executor) report loop items and retries as ansible-playbook does (#318)
  • (render) censor a no_log task’s error block (#308)
  • (render) print results and errors as ansible-playbook does (#306)
  • (yaml) keep the last value of a key written twice (#294)
  • (executor) match the reference in conditions and set_fact keys (#293)
  • run library modules and print warnings like the reference (#263)
  • (executor) match the reference in handlers, retries and batches (#262)
  • (agent) survive a native panic and keep release builds honest (#261)
  • (template) match the reference in more templating cases (#260)
  • (agent) keep argument values out of hand-back reasons (#258)
  • (template) fail a concatenation holding an undefined value (#234)
  • (template) fail a text filter over a container holding undefined (#229)
  • (template) propagate undefined through filters like ansible-core (#228)
  • (executor) count a looped include whose items all skip (#227)
  • (executor) read when before failing on an undefined loop (#223)
  • (transport) reuse a cached agent only if it is the same binary (#221)
  • (render) print a loop’s skipping line when every item skipped (#202)
  • (executor) set the search path before a task’s own vars resolve (#200)
  • (include) hand a role’s keywords to the tasks it includes (#199)
  • (vars) load an empty vars file and render ignore_errors late (#196)
  • (agent) keep a staged file to the connection that sent it (#191)

Added

  • Answer common modules natively in the agent: setup, stat, file, apt (when nothing needs doing), systemd and systemd_service, lineinfile, copy, package_facts, service_facts, user and group. A native module gives the reference module’s result, key for key, when a task’s arguments stay within what it implements. Otherwise it hands the task to the Python module before it changes anything on the host. dnf and every other module still run in Python. (#230, #246, #248, #250, #251, #252, #254, #256)
  • Gather facts natively on Debian and Ubuntu: the collectors of gather_subset: min, the processor and memory facts and the default routes and addresses. Volant uses the native collector only when every fact the run can read is one it produces, and ansible-core’s setup otherwise. --facts auto|python|native overrides the choice. (#237, #242, #249)
  • --profile prints where a run’s time went after the recap, on standard error, with the path each module’s tasks took and why a native module handed a task back. VOLANT_PROFILE_JSON=<file> writes the same data as JSON lines. (#236)
  • [volant] native_modules (VOLANT_NATIVE_MODULES) and [volant] ssh_control_master (VOLANT_SSH_CONTROL_MASTER), both on by default, turn native modules and ssh connection sharing off. (#236, #238)
  • Add the extract filter. (#222)
  • Run copy as an action plugin: stat the destination, then file or a staged copy, sending nothing when the file already matches.
  • Run package as an action plugin: pick the module from the host’s package manager, gathered with a filtered setup when it is not already a fact.
  • Run service as an action plugin: pick the module from the host’s init system (use:, then a fact, then a filtered setup), falling back to the service module for a name none of the known backends carries rather than failing the task.
  • Run template as an action plugin: render the file on the controller once, then hand it to the same path copy uses.
  • Run unarchive as an action plugin: extract a controller archive or one already on the host, skipping the task when creates: already exists.
  • Add the Jinja filters, tests, methods and lookups the template engine was missing: b64decode, b64encode, comment, difference, intersect, union, flatten, from_yaml, to_yaml, to_nice_yaml, to_uuid, type_debug, quote and regex_escape; the changed, failed, succeeded, skipped and version tests; a handful of Python methods on strings and mappings, through minijinja-contrib; and the first_found and template lookups.
  • Run reboot as an action plugin: shut the host down, then reconnect until it answers with a new boot id and its test command succeeds.
  • Run with_first_found and with_fileglob loops, set ansible_run_tags and ansible_skip_tags from --tags and --skip-tags, and retry a task backed by an action plugin under until, running its whole sequence of sub-tasks again on each attempt. retries: R is now up to R + 1 runs, as in the reference. (#216)
  • Run fetch as an action plugin, writing a host’s file onto the controller under dest and nowhere else, refusing a path that would land outside it. (#215)
  • Run dnf as an action plugin, picking the dnf or dnf5 module from the host’s package manager. (#213)
  • Run modules from installed collections, such as ansible.posix.sysctl or community.general.ufw, on the warm Python path. The controller’s ansible-core says what each name is, and a missing collection, a collection’s action plugin or a module that cannot be built is refused before the first connection. Volant never installs a collection. (#211)
  • Add the fileglob lookup and the ansible.utils.ipwrap filter, and answer every filter and test under its ansible.builtin.* name too. (#210)
  • An install script: curl -fsSL https://volant.sh/install.sh | sh installs the newest release, controller and agents together, after checking its checksum.
  • The release controller carries its agents. cargo binstall volant, the shell installer and the release archives give a volant that runs local and SSH tasks with nothing else installed. On first use the agents are extracted to ~/.cache/volant/agents/<version>, or under $XDG_CACHE_HOME.

Changed

  • Share one OpenSSH connection per inventory host (ControlMaster, a ControlPath of Volant’s own, ControlPersist=30s), unless your ssh configuration or ansible_ssh_*_args already set up sharing. At startup Volant raises its soft limit on open files up to the hard limit. (#238)
  • Cache the union of Python modules on the controller between runs, under $XDG_CACHE_HOME/volant/unions/. It is rebuilt whenever a source file of ansible-core or a collection, the interpreter, ansible.cfg or the ANSIBLE_* environment changes. (#235)
  • Protocol version 6 sends module blobs and staged files as raw bytes, compressed with deflate, instead of base64 inside JSON. A controller and an agent of different versions refuse each other, as before. (#253)
  • The Python server on the host imports a module while that module’s first child runs, so later tasks of the same module start with it loaded. (#244)
  • Host variables are read through shared layers instead of being merged and copied for every task. (#239)
  • Under the batching opt-in, a host also waits in front of a task that reads another host through a template body, a variable’s definition or delegate_to. Batching stays off by default. (#245)
  • A filter given an undefined value now lets it through as ansible-core does, so nope | dict2items | default('x') gives x. join, string, quote, sum and the ~ operator now fail when their input holds an undefined value anywhere inside, as the reference does, where they used to render a partial value and report the task green. (#228, #229, #234)
  • A registered result no longer carries the module’s top-level invocation, as in the reference. The items of a loop keep theirs. (#236)
  • Agents are looked up in VOLANT_AGENT_DIR first, then among the agents built into the controller, then beside the executable.
  • Release archives no longer contain the agents. They are still published on their own, in the volant-agent-* archives.
  • A copy, template or unarchive task whose src was named by a managed host is now rejected before the file is looked up, rather than sent the way the reference sends it: a host that controls a command’s output or a fact could otherwise have any file the operator can read copied to it.
  • The documentation site moves to volant.sh and is rebuilt with sections, search and diagrams. It adds pages on installation, compatibility, the command line, configuration, inventories and exit codes.

Fixed

  • A task whose loop names an undefined variable reads its when first, and is skipped when it is false, as in the reference. (#223)
  • A looped include_tasks or include_role whose items all skip prints its skipping: line and counts the host as skipped. (#227)
  • A cached agent on a host is reused only if it is the exact binary the controller would upload. A different build that reported the same version used to be run as the agent. Reusing a cached agent now needs an agent for the host’s architecture on the controller; the release controller embeds both.
  • A controller started through a symbolic link finds its agents next to the file the link points at. On macOS it used to look in the directory of the link.
  • A file staged for a module belongs to the connection that sent it. Two links to one host no longer consume each other’s files, and a staged file left by a cancelled batch, a lost link or a killed agent is cleaned up. (#191)
  • A vars file holding only --- and a comment loads as an empty mapping, a templated ignore_errors is rendered when the task runs, ansible_search_path is set for every task and role_path for a role’s, and Python module results get stdout_lines and stderr_lines. (#196)
  • Tasks brought in by include_tasks or include_role inherit the tags and other keywords of the play, role and blocks around the statement. Under --tags, a tagged role’s included files used to run nothing while the run exited 0. The Python union also carries the modules of every file of the roles in play, and a failed module’s exception no longer shows as a raw object. (#199)
  • A task’s own vars: built from a lookup that needs the role’s search path, such as lookup('template'), now resolve. (#200)
  • A loop whose every item was skipped prints the task’s own skipping: line after the item lines, as ansible-core does. (#202)
  • A notify naming no handler in a dynamically included file ends the run with exit code 1, as ansible-core does. fatal: lines no longer show "failed": true, module warnings are printed as [WARNING]: lines, and an interrupted pause ends the run without counting a failure. (#204)

0.1.0-alpha.7

Security

  • A managed host can no longer set its own connection settings through the facts a module returns. Until this release, a fact module’s ansible_facts reached the host’s variables unfiltered, so a host could change the address, user and ssh arguments of its own next task, including -oProxyCommand, which runs a command on the controller. It could also pick the Python interpreter its next module ran under, switch the connection to local to move its next task onto the controller, and move ansible_remote_tmp so that a planted agent ran as root on the next become task. Volant now strips the names ansible-core’s clean_facts() strips, plus ansible_remote_tmp, which ansible-core does not use this way, and prints the same warning. (#181)

Added

  • Run ansible-core’s Python modules on managed hosts. The controller builds one content-addressed zip of the modules a run needs and their module_utils, and sends it to each host once. A Python server in the agent loads it once and forks a child per task, so running a module costs tens of milliseconds rather than starting a new interpreter for each one. The host needs a Python interpreter but not ansible-core; the controller needs ansible-core. Modules the reference runs through an action plugin, such as copy, template, service and package, are still refused before the first connection. (#158, #159, #163, #166, #171)
  • Gather facts with ansible-core’s own setup module when a play asks for them. Gathered facts are data from the host and are never rendered as templates. (#173)
  • Run assert, fail and pause on the controller. (#179)

Changed

  • A play that does not write gather_facts: false now gathers facts, so it needs ansible-core on the controller and is refused before the first connection without it. (#173)
  • Gathered facts now rank above the inventory and below the play’s, role’s and task’s own variables, as in ansible-core. A playbook that sets a variable with the same name as a gathered fact now reads its own value. (#181)
  • An escalated connection is kept for the whole play instead of being rebuilt at every task. On a thirty-five task playbook against one host this took the run from 872 ms to 226 ms per task. A run can now hold two connections per host, so a controller limited to 1024 open files reaches that limit at about 169 escalating hosts. (#178)

Fixed

  • ansible_facts[...] uses the same keys as ansible-core, without an ansible_ prefix, and a fact a module returns without the prefix keeps its name. (#181)
  • A command skipped because of creates: or removes: is reported as ok, as in ansible-core, rather than as skipped. (#181)
  • A registered result carries changed and failed the way ansible-core’s does, and a result such as rc: "2" counts as a failure as it does there. (#181)
  • The timeout: keyword applies to tasks that run on the controller. (#179)

0.1.0-alpha.6

Added

  • Every release archive now carries the two Linux agents, so one download is enough for a first run over SSH. (#147)
  • The documentation lists which arguments each native module reads, and the pre-flight refuses the ones it does not. (#145)

Changed

  • Hosts now meet in front of every task, as Ansible’s linear strategy promises. The previous behavior, where each host ran ahead through tasks that did not read another host’s state, is available behind the [volant] batching option. (#140)
  • Resolving variables on large inventories is faster: inventory-wide values are built once per batch and shared across hosts. (#134)

Fixed

  • A module result is data and is never rendered again as a template on the controller. (#139)
  • The connection settings come from a host’s effective variables, including group_vars, task vars, set_fact and --extra-vars, not only from the inventory. (#141)
  • creates and removes are resolved in the directory the command runs in. (#142)
  • A task’s timeout covers the child process, its output streams and the write to its standard input. (#144), (#154)
  • A remote_tmp whose ~ part is not a user name is refused. (#146)
  • Every event a task produces is shown, through the same output renderer as the rest of the run. (#143)
  • What a dynamic include brings in is checked by the pre-flight before it runs. (#155)

0.1.0-alpha.5

Added

  • The whole ansible-core 2.19 grammar loads, and whatever this release cannot run is refused by name before the first connection. (#98)
  • Plays compile into a flat list of steps, with blocks kept as spans. (#101)
  • Roles load from the standard paths, with dependencies, argument specs and import_tasks. (#102)
  • --tags, --skip-tags and the listing commands, with output identical to Ansible’s. (#103)
  • Blocks with rescue and always, and the ansible_failed_task and ansible_failed_result facts. (#104)
  • Handlers, run at every flush point. (#105)
  • until, retries and delay, no_log, and environment. (#107)
  • serial batches, with the run stopping when a batch loses every host. (#108)
  • include_tasks, include_role and include_vars, resolved while the play runs. (#109)
  • run_once and delegate_to, with the delegated task running over the delegate’s own connection. (#115)

Changed

  • Every host reads one shared hostvars map instead of its own copy. (#116)

Fixed

  • The host that runs a run_once task is elected once for the whole batch. (#118)