跳转到内容
安装

Changelog

Version 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)