Salt Bundle
1. What is Salt Bundle?
The Salt Bundle is a single binary package containing Salt Minion, Python 3, required Python modules and libraries.
As the Salt Bundle is shipped with Python 3 and all the requirements for Salt to run, the Salt Bundle is not using the Python version coming from the system, so it can be installed on clients which doesn’t meet the requirements for a given Salt version.
It is also possible to use the Salt Bundle on systems that run a Salt Minion connected to a Salt Master other than {poductname} Salt Master.
2. Client Registration with Salt Bundle as a Minion
The registration method with the Salt Bundle is the recommended registration method as long as it covers your use case.
This section explains the advantages and limitations of the current implementation.
The Salt Bundle is provided as the venv-salt-minion
that consists of Salt, Python 3, and the Python modules Salt depends on.
Bootstrapping with Web UI is using Salt Bundle as well, so bootstrapping with Web UI is not Python dependant.
Using the Salt Bundle, it is no longer needed that the client provides any Python interpreter or modules.
If you bootstrap new clients, registration with the Salt Bundle is the default method.
You can switch existing clients to the Salt Bundle method.
If you switch, the salt-minion
package and its dependencies will stay installed.
2.1. Switching from Salt Minion to Salt Bundle
The Salt state util.mgr_switch_to_venv_minion
is available to switch from salt-minion
to venv-salt-minion
.
It is recommended to switch to venv-salt-minion
in two steps to avoid trouble with shifting processes:
util.mgr_switch_to_venv_minion
state to venv-salt-minion
-
Apply
util.mgr_switch_to_venv_minion
with no pillar specified first. This will result in the switch tovenv-salt-minion
with copying configuration files etc. It will not clean up the originalsalt-minion
configurations and its packages.salt <minion_id> state.apply util.mgr_switch_to_venv_minion
-
Apply
util.mgr_switch_to_venv_minion
withmgr_purge_non_venv_salt
set toTrue
to removesalt-minion
and withmgr_purge_non_venv_salt_files
set toTrue
to remove all the files related tosalt-minion
. This second step ensures the first step was processed, and then removes the old configuration files and the now obsoletesalt-minion
package.salt <minion_id> state.apply util.mgr_switch_to_venv_minion pillar='{"mgr_purge_non_venv_salt_files": True, "mgr_purge_non_venv_salt": True}'
In case of running the second step of switching with skipping the first step, state apply process could fail as it requires stopping the |
On the other hand, it is also possible to avoid installing the Salt Bundle and keep using salt-minion
instead.
In this case, specify one of these options:
-
Execute
mgr-bootstrap
with--no-bundle
option. -
Set
AVOID_VENV_SALT_MINION
to1
in the generated bootstrap script. -
For bootstrap state set the
mgr_avoid_venv_salt_minion
pillar toTrue
.
3. Salt SSH with the Salt Bundle
The Salt Bundle is also used when performing Salt SSH actions to clients.
A shell script deploys the Salt Bundle onto the target system without installing venv-salt-minion
before any Salt command is executed. Since the Salt Bundle contains the whole Salt code base, no salt-thin
is deployed. Salt SSH (including bootstrapping using the Web UI) uses the Python 3 interpreter within the bundle. The target system does not need to have any other Python interpreter installed.
The Python 3 deployed with the Bundle is used to handle Salt SSH session on the client, so Salt SSH (including bootstrapping with Web UI) is not dependant on Python installed on the system.
The bootstrap repository must be created before bootstrapping the client with Web UI. The pre flight script is detecting the OS on the client and using the bootstrap repository relevant for the OS version. For more information, see Prepare to Create a Bootstrap Repository |
Using |
4. Using the Salt Bundle with the Salt Minion
The Salt Bundle can be used with the Salt Minion managed by the Salt Master other than Uyuni Server at the same time.
To bootstrap a client with the Salt Minion managed by the Salt Master other than Uyuni Server it is recommended to use |