Errata

Salt Essentials

Errata for Salt Essentials

Submit your own errata for this product.

The errata list is a list of errors and their corrections that were found after the product was released.

The following errata were submitted by our customers and have not yet been approved or disproved by the author or editor. They solely represent the opinion of the customer.

Color Key: Serious technical mistake Minor technical mistake Language or formatting error Typo Question Note Update

Version Location Description Submitted by Date submitted
Printed Page viii
2nd paragraph, 2nd line

Under the section "What this Book is not". The third sentence says
"Mew" instead of New.

Anonymous  Mar 24, 2016 
Printed Page 34
2nd par

2nd paragraph contains in italic "virutal", which should be "virtual".

doj  Nov 03, 2015 
PDF Page 34
Para 2

s/virutal/virtual/

George V. Reilly  Nov 08, 2015 
Printed Page 88
2nd YAML example

the YAML line "{% include 'jinja/some_vars.jinja' with context %}" contains two space characters after the file name. A single space character should be sufficient.

doj  Nov 04, 2015 
Printed Page 91
hello.py code example

In the "Custom Execution Module" section the python source code starts with the line "hello.py". This would be the file name of this python source code, but not part of the source code itself. As shown here, this is not a valid python program.
The book always used a "cat" command line, to show the location of files. The following paragraph explains where this python source code file should be placed, but I suggest the author also uses a "cat" command line to show the location of this python file for this hello.py example.

doj  Nov 04, 2015 
PDF Page 92
Para 2

> But there are a couple of “reserved directories”: _modules, _grains, and _states.

couple => exactly two. Say "handful" or "a small number"

George V. Reilly  Nov 08, 2015 
PDF Page 93
Para 2

> As with Jinja templates, Salt adds some custom data into the module’s namespace: grains ,salt, and opts.

Should be:
> As with Jinja templates, Salt adds some custom data into the module’s namespace: __grains__, __salt__, and __opts__.

George V. Reilly  Nov 08, 2015 
Printed Page 107
4th par

In the 4th paragraph, on the first line, the word "orchestrate runner" is badly split between the first and second line. Since "orchestrate" is split in the middle, but also not hyphenated, it looks like there are 3 separate words: "orches trate runner".

Also on the last line of the 4th paragraph, orchestrate runner is mentioned again, but here the "runner" is not using monospace font, but the regular font. But maybe "runner" should be a regular word, then on the second line in the 4th paragraph this word should use the regular font instead.

doj  Nov 04, 2015 
Printed Page 135
gitfs_remotes: snipped

It is not clear to which salt file the gitfs_remotes: YAML block should be added. The usual "cat" command line to show the complete file should be used here.

doj  Nov 04, 2015 
Printed Page 135
2nd par

The 2nd paragraph contains the phrase "The base option used when we set up our Git directory..." However such a "base" option is not mentioned anywhere in this section. It's not clear how/where this base option relates to the GIT branches used.

doj  Nov 04, 2015 
PDF Page 152
First code snippet

The following code snippet no longer works:

[vagrant@minion1 ~]$ sudo /srv/se-book/bin/setup

This is due to Salt Bootstrap no longer supporting the -Z option, which is being supplied by script in the above code snippet.

I've submitted an issue on Salt Essential's GitHub about this:

https://github.com/craig5/salt-essentials-utils/issues/8

My current work around was just to edit /srv/se-book/bin/setup and remove the '-Z' option from the cmd list at line 72:

cmd = ['sudo', 'bash', install_script]

Hope this helps anyone trying to learn Salt.

Anonymous  Oct 17, 2018