SALTSTACK CHANGE MINION NAME CODE

Usage: qubesctl Ĭommand Salt command to execute (e.g., state.highstate) If you do so, then you need to pass additional arguments to the qubesctl tool: You can also use the qubes pillar module to select VMs with a particular Simply set the VM name as the target minion name in the top file. Salt in Qubes can be used to configure VMs from dom0. It accepts all the same arguments of the vanilla tool.

SALTSTACK CHANGE MINION NAME CODE

srv/formulas/dom0/virtual-machines-formula/qvm, which are used by firstboot.īecause we use some code that is not found in older versions of Salt, there isĪ tool called qubesctl that should be run instead of salt-call -local. The formulas are in /srv/formulas, including stock formulas for domains in Templates and the configuration is done in pillars from formulas. However, the states that are part of the standard Qubes distribution are mostly The main directory is /srv/salt/ where all state files reside. Salt Configuration, QubesOS layoutĪll Salt configuration files are in the /srv/ directory, as usual. So you should take a look at the Jinja API documentation.ĭocumentation about using Jinja to directly call Salt functions and get dataĪbout your system can be found in the official Instead, to get this behavior, you would use a do statement. There are sometimes differences when, for example, you set some variable insideĪ loop: the variable outside will not get changed. Jinja is similar to Python and in many cases behaves in a similar fashion, but To solve this, there is the ability to template files or states. You will sometimes find yourself writing repetitive states. (More information on the qubesctl command further down.) Template Files The smallest unit of configuration is a state.Ī state is written in YAML and looks like this: State of the system with the administrator’s configuration/desires. There is another function called state.highstate which will synchronize the When issued, will immediately halt a domain. It exposes some imperative functions for the administrator.įor example, there is a system module that has a system.halt function that, It also contains other information about the kernel,Ī module is a Python extension to Salt that is responsible for actuallyĮnforcing the state in a particular area. There are many formulas made by helpful people all over the Internet.Ī grain is some data that is also available in templates, but its value is notįor example, the distribution (e.g., 'Debian' or 'Gentoo') is a value of Pillar (possibly with some file templates and other auxiliary files). Template engine (preferably Jinja2) which can use data structures specified inĪ formula is a ready to use, packaged solution that combines a state and a

When states become repetitive, instead of pure YAML they can be written using a This is the most important concept in the entire engine.Īll configurations (i.e., the states) are written in YAML.Ī pillar is a data back-end declared by the administrator.

Salt is a management engine (similar to Ansible, Puppet, and Chef), thatĮnforces a particular state of a minion system.Ī state is an end effect declaratively expressed by the administrator. Instead we have one minion which resides in dom0 and manages domains from With the master and keeps the configurations there. In typical situations, it is intended that the administrator interacts only Salt is a client-server model, where the server (called master) manages

Must warn you that it is not easy to read if you just start working with Salt This document is not meant to be comprehensive Salt documentation however,īefore writing anything it is required you have at least some understanding ofįor more exhaustive documentation, visit official site, though we In the current form the API is provisional and subject to change between In this guide we will show how it is set up and how you can modify it for your Salt allows administrators to easily configure their systems. Management engine in dom0 as default (with some states already configured). Since the Qubes R3.1 release we have included the Salt (also called SaltStack) Caution: This page is intended for advanced users.

Saltstack change minion name