Salt .top vs top.sls

Hi all,

I’m new to salt - I’m confused with respect to the naming of the top file.

Some guides use ‘file_name.top’ whereas others use ‘top.sls’.

Is this just a convention? If so what are the best practices?

top.sls is the name given to a “top file”, a Salt configuration file whose purpose is to gather many other Salt configuration files in order to make it easier to apply all of them with a single command, called highstate:

https://docs.saltproject.io/salt/user-guide/en/latest/topics/states.html#the-top-sls-file

As far as I can tell, calling a file file_name.top is a convention used in Qubes OS for Salt configuration files whose purpose is to be “enabled” or “disabled” using the qubesctl command:

1 Like