Gyurci08 at 15:28, 27 August 2025

2025-08-27T15:28:08Z

← Older revision		Revision as of 15:28, 27 August 2025
Line 1:		Line 1:
	[[Category:~~SALT~~]]		[[Category:SaltStack]]

	== Using Grains with Salt ==		== Using Grains with Salt ==

Gyurci08 at 18:12, 16 July 2025

2025-07-16T18:12:36Z

@@ Line 45: / Line 45: @@
 To change a grain value, simply set it again with <code>grains.setval</code>.
 ----
 By leveraging grains, you improve targeting, organization, and automation across your SaltStack infrastructure.

Gyurci08: Created page with "Category:SALT == Using Grains with Salt == This guide demonstrates how to use grains—static, easily accessible bits of information about minions—in Salt. === 1. Set Custom Grains === Assign custom grains to your minions for targeting and configuration: salt 'ctr-1' grains.setval roles '[ "primary-controller", "promtail-node" ]' salt 'ctr-2' grains.setval roles '[ "controller", "promtail-node" ]' salt 'wkr-' grains.setval..."

2025-07-16T18:12:03Z

Created page with "Category:SALT == Using Grains with Salt == This guide demonstrates how to use grains—static, easily accessible bits of information about minions—in Salt. === 1. Set Custom Grains === Assign custom grains to your minions for targeting and configuration: <syntaxhighlight lang="bash"> salt '*ctr-1*' grains.setval roles '[ "primary-controller", "promtail-node" ]' salt '*ctr-2*' grains.setval roles '[ "controller", "promtail-node" ]' salt '*wkr-*' grains.setval..."

New page

[[Category:SALT]]

== Using Grains with Salt ==

This guide demonstrates how to use grains—static, easily accessible bits of information about minions—in Salt.

=== 1. Set Custom Grains ===

Assign custom grains to your minions for targeting and configuration:

<syntaxhighlight lang="bash">
salt '*ctr-1*' grains.setval roles '[ "primary-controller", "promtail-node" ]'
salt '*ctr-2*' grains.setval roles '[ "controller", "promtail-node" ]'
salt '*wkr-*' grains.setval roles '[ "worker", "promtail-node" ]'
</syntaxhighlight>

* The first argument specifies the minion targeting pattern (e.g., <code>*ctr-1*</code>, <code>*wkr-*</code>).
* <code>grains.setval</code> assigns a value to a custom grain (here, <code>roles</code>).
* Custom grains are stored locally on the minion and persist across reboots.

=== 2. View Grains ===

Confirm grain values:

<syntaxhighlight lang="bash">
salt '*' grains.item roles
salt 'minion-id' grains.items
</syntaxhighlight>

=== 3. Target Using Grains ===

Use grains to target sets of minions:

<syntaxhighlight lang="bash">
salt -G 'roles:worker' test.ping
</syntaxhighlight>

=== 4. Modify or Remove Custom Grains ===

To remove a custom grain:

<syntaxhighlight lang="bash">
salt 'minion-id' grains.delval roles
</syntaxhighlight>

To change a grain value, simply set it again with <code>grains.setval</code>.

=== 5. Set Grains Manually on the Minion ===

Alternatively, set static grains in <code>/etc/salt/grains</code> in YAML:

<syntaxhighlight lang="yaml">
roles:
- worker
- promtail-node
location: budapest
</syntaxhighlight>

Apply changes by restarting the salt-minion:

<syntaxhighlight lang="bash">
systemctl restart salt-minion
</syntaxhighlight>

----

By leveraging grains, you improve targeting, organization, and automation across your SaltStack infrastructure.

Using grains with SALT - Revision history

Gyurci08 at 15:28, 27 August 2025

Gyurci08 at 18:12, 16 July 2025