From c5392cdbdb05726780c98672717d5203dd9c64a8 Mon Sep 17 00:00:00 2001 From: Salt Project Packaging Date: Mon, 29 Apr 2024 03:29:26 +0000 Subject: [PATCH] Release v3006.8 --- CHANGELOG.md | 81 ++ changelog/53363.fixed.md | 2 - changelog/60508.fixed.md | 2 - changelog/61807.fixed.md | 1 - changelog/62734.fixed.md | 3 - changelog/63060.fixed.md | 1 - changelog/63654.fixed.md | 1 - changelog/63667.fixed.md | 1 - changelog/63848.fixed.md | 2 - changelog/64933.fixed.md | 1 - changelog/65200.fixed.md | 1 - changelog/65611.fixed.md | 7 - changelog/65859.added.md | 1 - changelog/65860.deprecated.md | 1 - changelog/66049.fixed.md | 2 - changelog/66104.deprecated.md | 1 - changelog/66105.deprecated.md | 1 - changelog/66124.fixed.md | 1 - changelog/66126.fixed.md | 2 - changelog/66127.fixed.md | 1 - changelog/66139.deprecated.md | 1 - changelog/66141.security.md | 5 - changelog/66143.fixed.md | 1 - changelog/66147.removed.md | 7 - changelog/66205.fixed.md | 1 - changelog/66280.fixed.md | 1 - changelog/66284.fixed.md | 1 - changelog/66289.fixed.md | 1 - changelog/66290.fixed.md | 2 - changelog/66292.fixed.md | 1 - changelog/66377.security.md | 1 - changelog/66400.fixed.md | 1 - changelog/66402.fixed.md | 1 - changelog/66411.security.md | 1 - changelog/66705.fixed.md | 1 - doc/man/salt-api.1 | 2 +- doc/man/salt-call.1 | 2 +- doc/man/salt-cloud.1 | 2 +- doc/man/salt-cp.1 | 2 +- doc/man/salt-key.1 | 2 +- doc/man/salt-master.1 | 2 +- doc/man/salt-minion.1 | 2 +- doc/man/salt-proxy.1 | 2 +- doc/man/salt-run.1 | 2 +- doc/man/salt-ssh.1 | 2 +- doc/man/salt-syndic.1 | 2 +- doc/man/salt.1 | 2 +- doc/man/salt.7 | 1137 ++++++++++------- doc/man/spm.1 | 2 +- doc/topics/releases/3006.8.md | 96 ++ .../releases/templates/3006.8.md.template | 14 + pkg/debian/changelog | 79 ++ pkg/rpm/salt.spec | 78 +- 53 files changed, 1043 insertions(+), 526 deletions(-) delete mode 100644 changelog/53363.fixed.md delete mode 100644 changelog/60508.fixed.md delete mode 100644 changelog/61807.fixed.md delete mode 100644 changelog/62734.fixed.md delete mode 100644 changelog/63060.fixed.md delete mode 100644 changelog/63654.fixed.md delete mode 100644 changelog/63667.fixed.md delete mode 100644 changelog/63848.fixed.md delete mode 100644 changelog/64933.fixed.md delete mode 100644 changelog/65200.fixed.md delete mode 100644 changelog/65611.fixed.md delete mode 100644 changelog/65859.added.md delete mode 100644 changelog/65860.deprecated.md delete mode 100644 changelog/66049.fixed.md delete mode 100644 changelog/66104.deprecated.md delete mode 100644 changelog/66105.deprecated.md delete mode 100644 changelog/66124.fixed.md delete mode 100644 changelog/66126.fixed.md delete mode 100644 changelog/66127.fixed.md delete mode 100644 changelog/66139.deprecated.md delete mode 100644 changelog/66141.security.md delete mode 100644 changelog/66143.fixed.md delete mode 100644 changelog/66147.removed.md delete mode 100644 changelog/66205.fixed.md delete mode 100644 changelog/66280.fixed.md delete mode 100644 changelog/66284.fixed.md delete mode 100644 changelog/66289.fixed.md delete mode 100644 changelog/66290.fixed.md delete mode 100644 changelog/66292.fixed.md delete mode 100644 changelog/66377.security.md delete mode 100644 changelog/66400.fixed.md delete mode 100644 changelog/66402.fixed.md delete mode 100644 changelog/66411.security.md delete mode 100644 changelog/66705.fixed.md create mode 100644 doc/topics/releases/3006.8.md create mode 100644 doc/topics/releases/templates/3006.8.md.template diff --git a/CHANGELOG.md b/CHANGELOG.md index 2957e513df8..866cb70b9e3 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,87 @@ Versions are `MAJOR.PATCH`. # Changelog +## 3006.8 (2024-04-29) + + +### Removed + +- Removed deprecated code scheduled to be removed on 2024-01-01: + + * ``TemporaryLoggingHandler`` and ``QueueHandler`` in ``salt/_logging/handlers.py`` + * All of the ``salt/log`` package. + * The ``salt/modules/cassandra_mod.py`` module. + * The ``salt/returners/cassandra_return.py`` returner. + * The ``salt/returners/django_return.py`` returner. [#66147](https://github.com/saltstack/salt/issues/66147) + + +### Deprecated + +- Drop Fedora 37 and Fedora 38 support [#65860](https://github.com/saltstack/salt/issues/65860) +- Drop CentOS Stream 8 and 9 from CI/CD [#66104](https://github.com/saltstack/salt/issues/66104) +- Drop Photon OS 3 support [#66105](https://github.com/saltstack/salt/issues/66105) +- The ``salt.utils.psutil_compat`` module has been deprecated and will be removed in Salt 3008. Please use the ``psutil`` module directly. [#66139](https://github.com/saltstack/salt/issues/66139) + + +### Fixed + +- ``user.add`` on Windows now allows you to add user names that contain all + numeric characters [#53363](https://github.com/saltstack/salt/issues/53363) +- Fix an issue with the win_system module detecting established connections on + non-Windows systems. Uses psutils instead of parsing the return of netstat [#60508](https://github.com/saltstack/salt/issues/60508) +- pkg.refresh_db on Windows now honors saltenv [#61807](https://github.com/saltstack/salt/issues/61807) +- Fixed an issue with adding new machine policies and applying those same + policies in the same state by adding a ``refresh_cache`` option to the + ``lgpo.set`` state. [#62734](https://github.com/saltstack/salt/issues/62734) +- file.managed correctly handles file path with '#' [#63060](https://github.com/saltstack/salt/issues/63060) +- Fix master ip detection when DNS records change [#63654](https://github.com/saltstack/salt/issues/63654) +- Fix user and group management on Windows to handle the Everyone group [#63667](https://github.com/saltstack/salt/issues/63667) +- Fixes an issue in pkg.refresh_db on Windows where new package definition + files were not being picked up on the first run [#63848](https://github.com/saltstack/salt/issues/63848) +- Display a proper error when pki commands fail in the win_pki module [#64933](https://github.com/saltstack/salt/issues/64933) +- Prevent full system upgrade on single package install for Arch Linux [#65200](https://github.com/saltstack/salt/issues/65200) +- When using s3fs, if files are deleted from the bucket, they were not deleted in + the master or minion local cache, which could lead to unexpected file copies or + even state applications. This change makes the local cache consistent with the + remote bucket by deleting files locally that are deleted from the bucket. + + **NOTE** this could lead to **breakage** on your affected systems if it was + inadvertently depending on previously deleted files. [#65611](https://github.com/saltstack/salt/issues/65611) +- Fixed an issue with file.directory state where paths would be modified in test + mode if backupname is used. [#66049](https://github.com/saltstack/salt/issues/66049) +- Execution modules have access to regular fileclient durring pillar rendering. [#66124](https://github.com/saltstack/salt/issues/66124) +- Fixed a issue with server channel where a minion's public key + would be rejected if it contained a final newline character. [#66126](https://github.com/saltstack/salt/issues/66126) +- Fix content type backwards compatablity with http proxy post requests in the http utils module. [#66127](https://github.com/saltstack/salt/issues/66127) +- Fix systemctl with "try-restart" instead of "retry-restart" within the RPM spec, properly restarting upgraded services [#66143](https://github.com/saltstack/salt/issues/66143) +- Auto discovery of ssh, scp and ssh-keygen binaries. [#66205](https://github.com/saltstack/salt/issues/66205) +- Add leading slash to salt helper file paths as per dh_links requirement [#66280](https://github.com/saltstack/salt/issues/66280) +- Fixed x509.certificate_managed - ca_server did not return a certificate [#66284](https://github.com/saltstack/salt/issues/66284) +- removed log line that did nothing. [#66289](https://github.com/saltstack/salt/issues/66289) +- Chocolatey: Make sure the return dictionary from ``chocolatey.version`` + contains lowercase keys [#66290](https://github.com/saltstack/salt/issues/66290) +- fix cacheing inline pillar, by not rendering inline pillar during cache save function. [#66292](https://github.com/saltstack/salt/issues/66292) +- The file module correctly perserves file permissions on link target. [#66400](https://github.com/saltstack/salt/issues/66400) +- Upgrade relenv to 0.16.0 and python to 3.10.14 [#66402](https://github.com/saltstack/salt/issues/66402) +- backport the fix from #66164 to fix #65703. use OrderedDict to fix bad indexing. [#66705](https://github.com/saltstack/salt/issues/66705) + + +### Added + +- Add Fedora 39 support [#65859](https://github.com/saltstack/salt/issues/65859) + + +### Security + +- Upgrade to `cryptography==42.0.5` due to a few security issues: + + * https://github.com/advisories/GHSA-9v9h-cgj8-h64p + * https://github.com/advisories/GHSA-3ww4-gg4f-jr7f + * https://github.com/advisories/GHSA-6vqw-3v5j-54x4 [#66141](https://github.com/saltstack/salt/issues/66141) +- Bump to `idna==3.7` due to https://github.com/advisories/GHSA-jjg7-2v4v-x38h [#66377](https://github.com/saltstack/salt/issues/66377) +- Bump to `aiohttp==3.9.4` due to https://github.com/advisories/GHSA-7gpw-8wmc-pm8g [#66411](https://github.com/saltstack/salt/issues/66411) + + ## 3006.7 (2024-02-20) diff --git a/changelog/53363.fixed.md b/changelog/53363.fixed.md deleted file mode 100644 index 9ab50a6424c..00000000000 --- a/changelog/53363.fixed.md +++ /dev/null @@ -1,2 +0,0 @@ -``user.add`` on Windows now allows you to add user names that contain all -numeric characters diff --git a/changelog/60508.fixed.md b/changelog/60508.fixed.md deleted file mode 100644 index 9e3a4dd5491..00000000000 --- a/changelog/60508.fixed.md +++ /dev/null @@ -1,2 +0,0 @@ -Fix an issue with the win_system module detecting established connections on -non-Windows systems. Uses psutils instead of parsing the return of netstat diff --git a/changelog/61807.fixed.md b/changelog/61807.fixed.md deleted file mode 100644 index 88d16c6352d..00000000000 --- a/changelog/61807.fixed.md +++ /dev/null @@ -1 +0,0 @@ -pkg.refresh_db on Windows now honors saltenv diff --git a/changelog/62734.fixed.md b/changelog/62734.fixed.md deleted file mode 100644 index c10b0914d7f..00000000000 --- a/changelog/62734.fixed.md +++ /dev/null @@ -1,3 +0,0 @@ -Fixed an issue with adding new machine policies and applying those same -policies in the same state by adding a ``refresh_cache`` option to the -``lgpo.set`` state. diff --git a/changelog/63060.fixed.md b/changelog/63060.fixed.md deleted file mode 100644 index e0290447aca..00000000000 --- a/changelog/63060.fixed.md +++ /dev/null @@ -1 +0,0 @@ -file.managed correctly handles file path with '#' diff --git a/changelog/63654.fixed.md b/changelog/63654.fixed.md deleted file mode 100644 index d39d0212a0a..00000000000 --- a/changelog/63654.fixed.md +++ /dev/null @@ -1 +0,0 @@ -Fix master ip detection when DNS records change diff --git a/changelog/63667.fixed.md b/changelog/63667.fixed.md deleted file mode 100644 index 3015e6f4028..00000000000 --- a/changelog/63667.fixed.md +++ /dev/null @@ -1 +0,0 @@ -Fix user and group management on Windows to handle the Everyone group diff --git a/changelog/63848.fixed.md b/changelog/63848.fixed.md deleted file mode 100644 index d297d7a3467..00000000000 --- a/changelog/63848.fixed.md +++ /dev/null @@ -1,2 +0,0 @@ -Fixes an issue in pkg.refresh_db on Windows where new package definition -files were not being picked up on the first run diff --git a/changelog/64933.fixed.md b/changelog/64933.fixed.md deleted file mode 100644 index e6f233db29d..00000000000 --- a/changelog/64933.fixed.md +++ /dev/null @@ -1 +0,0 @@ -Display a proper error when pki commands fail in the win_pki module diff --git a/changelog/65200.fixed.md b/changelog/65200.fixed.md deleted file mode 100644 index 9da348e5e4e..00000000000 --- a/changelog/65200.fixed.md +++ /dev/null @@ -1 +0,0 @@ -Prevent full system upgrade on single package install for Arch Linux diff --git a/changelog/65611.fixed.md b/changelog/65611.fixed.md deleted file mode 100644 index 6124658f5fc..00000000000 --- a/changelog/65611.fixed.md +++ /dev/null @@ -1,7 +0,0 @@ -When using s3fs, if files are deleted from the bucket, they were not deleted in -the master or minion local cache, which could lead to unexpected file copies or -even state applications. This change makes the local cache consistent with the -remote bucket by deleting files locally that are deleted from the bucket. - -**NOTE** this could lead to **breakage** on your affected systems if it was -inadvertently depending on previously deleted files. diff --git a/changelog/65859.added.md b/changelog/65859.added.md deleted file mode 100644 index 533278e73b4..00000000000 --- a/changelog/65859.added.md +++ /dev/null @@ -1 +0,0 @@ -Add Fedora 39 support diff --git a/changelog/65860.deprecated.md b/changelog/65860.deprecated.md deleted file mode 100644 index ca1ae532af1..00000000000 --- a/changelog/65860.deprecated.md +++ /dev/null @@ -1 +0,0 @@ -Drop Fedora 37 and Fedora 38 support diff --git a/changelog/66049.fixed.md b/changelog/66049.fixed.md deleted file mode 100644 index baff6e063d3..00000000000 --- a/changelog/66049.fixed.md +++ /dev/null @@ -1,2 +0,0 @@ -Fixed an issue with file.directory state where paths would be modified in test -mode if backupname is used. diff --git a/changelog/66104.deprecated.md b/changelog/66104.deprecated.md deleted file mode 100644 index 0d0993fa120..00000000000 --- a/changelog/66104.deprecated.md +++ /dev/null @@ -1 +0,0 @@ -Drop CentOS Stream 8 and 9 from CI/CD diff --git a/changelog/66105.deprecated.md b/changelog/66105.deprecated.md deleted file mode 100644 index f3bc682f0af..00000000000 --- a/changelog/66105.deprecated.md +++ /dev/null @@ -1 +0,0 @@ -Drop Photon OS 3 support diff --git a/changelog/66124.fixed.md b/changelog/66124.fixed.md deleted file mode 100644 index 2721fed62b3..00000000000 --- a/changelog/66124.fixed.md +++ /dev/null @@ -1 +0,0 @@ -Execution modules have access to regular fileclient durring pillar rendering. diff --git a/changelog/66126.fixed.md b/changelog/66126.fixed.md deleted file mode 100644 index 9879189e644..00000000000 --- a/changelog/66126.fixed.md +++ /dev/null @@ -1,2 +0,0 @@ -Fixed a issue with server channel where a minion's public key -would be rejected if it contained a final newline character. diff --git a/changelog/66127.fixed.md b/changelog/66127.fixed.md deleted file mode 100644 index aac9709212d..00000000000 --- a/changelog/66127.fixed.md +++ /dev/null @@ -1 +0,0 @@ -Fix content type backwards compatablity with http proxy post requests in the http utils module. diff --git a/changelog/66139.deprecated.md b/changelog/66139.deprecated.md deleted file mode 100644 index aa7f4cf64f9..00000000000 --- a/changelog/66139.deprecated.md +++ /dev/null @@ -1 +0,0 @@ -The ``salt.utils.psutil_compat`` module has been deprecated and will be removed in Salt 3008. Please use the ``psutil`` module directly. diff --git a/changelog/66141.security.md b/changelog/66141.security.md deleted file mode 100644 index b5ef0f14974..00000000000 --- a/changelog/66141.security.md +++ /dev/null @@ -1,5 +0,0 @@ -Upgrade to `cryptography==42.0.5` due to a few security issues: - -* https://github.com/advisories/GHSA-9v9h-cgj8-h64p -* https://github.com/advisories/GHSA-3ww4-gg4f-jr7f -* https://github.com/advisories/GHSA-6vqw-3v5j-54x4 diff --git a/changelog/66143.fixed.md b/changelog/66143.fixed.md deleted file mode 100644 index 58ecbd163c5..00000000000 --- a/changelog/66143.fixed.md +++ /dev/null @@ -1 +0,0 @@ -Fix systemctl with "try-restart" instead of "retry-restart" within the RPM spec, properly restarting upgraded services diff --git a/changelog/66147.removed.md b/changelog/66147.removed.md deleted file mode 100644 index c72f46820ac..00000000000 --- a/changelog/66147.removed.md +++ /dev/null @@ -1,7 +0,0 @@ -Removed deprecated code scheduled to be removed on 2024-01-01: - -* ``TemporaryLoggingHandler`` and ``QueueHandler`` in ``salt/_logging/handlers.py`` -* All of the ``salt/log`` package. -* The ``salt/modules/cassandra_mod.py`` module. -* The ``salt/returners/cassandra_return.py`` returner. -* The ``salt/returners/django_return.py`` returner. diff --git a/changelog/66205.fixed.md b/changelog/66205.fixed.md deleted file mode 100644 index b6963809d01..00000000000 --- a/changelog/66205.fixed.md +++ /dev/null @@ -1 +0,0 @@ -Auto discovery of ssh, scp and ssh-keygen binaries. diff --git a/changelog/66280.fixed.md b/changelog/66280.fixed.md deleted file mode 100644 index dafd798295b..00000000000 --- a/changelog/66280.fixed.md +++ /dev/null @@ -1 +0,0 @@ -Add leading slash to salt helper file paths as per dh_links requirement diff --git a/changelog/66284.fixed.md b/changelog/66284.fixed.md deleted file mode 100644 index a8299a70161..00000000000 --- a/changelog/66284.fixed.md +++ /dev/null @@ -1 +0,0 @@ -Fixed x509.certificate_managed - ca_server did not return a certificate diff --git a/changelog/66289.fixed.md b/changelog/66289.fixed.md deleted file mode 100644 index 7c689bb2b9b..00000000000 --- a/changelog/66289.fixed.md +++ /dev/null @@ -1 +0,0 @@ -removed log line that did nothing. diff --git a/changelog/66290.fixed.md b/changelog/66290.fixed.md deleted file mode 100644 index c013043dd6b..00000000000 --- a/changelog/66290.fixed.md +++ /dev/null @@ -1,2 +0,0 @@ -Chocolatey: Make sure the return dictionary from ``chocolatey.version`` -contains lowercase keys diff --git a/changelog/66292.fixed.md b/changelog/66292.fixed.md deleted file mode 100644 index 1055bb65797..00000000000 --- a/changelog/66292.fixed.md +++ /dev/null @@ -1 +0,0 @@ -fix cacheing inline pillar, by not rendering inline pillar during cache save function. diff --git a/changelog/66377.security.md b/changelog/66377.security.md deleted file mode 100644 index 58f36f19402..00000000000 --- a/changelog/66377.security.md +++ /dev/null @@ -1 +0,0 @@ -Bump to `idna==3.7` due to https://github.com/advisories/GHSA-jjg7-2v4v-x38h diff --git a/changelog/66400.fixed.md b/changelog/66400.fixed.md deleted file mode 100644 index 34ce1fdded9..00000000000 --- a/changelog/66400.fixed.md +++ /dev/null @@ -1 +0,0 @@ -The file module correctly perserves file permissions on link target. diff --git a/changelog/66402.fixed.md b/changelog/66402.fixed.md deleted file mode 100644 index 1714eb2600f..00000000000 --- a/changelog/66402.fixed.md +++ /dev/null @@ -1 +0,0 @@ -Upgrade relenv to 0.16.0 and python to 3.10.14 diff --git a/changelog/66411.security.md b/changelog/66411.security.md deleted file mode 100644 index af726e19345..00000000000 --- a/changelog/66411.security.md +++ /dev/null @@ -1 +0,0 @@ -Bump to `aiohttp==3.9.4` due to https://github.com/advisories/GHSA-7gpw-8wmc-pm8g diff --git a/changelog/66705.fixed.md b/changelog/66705.fixed.md deleted file mode 100644 index 2c4d59d058a..00000000000 --- a/changelog/66705.fixed.md +++ /dev/null @@ -1 +0,0 @@ -backport the fix from #66164 to fix #65703. use OrderedDict to fix bad indexing. diff --git a/doc/man/salt-api.1 b/doc/man/salt-api.1 index f82b64a4acf..96f6e137793 100644 --- a/doc/man/salt-api.1 +++ b/doc/man/salt-api.1 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SALT-API" "1" "Generated on February 20, 2024 at 09:55:17 PM UTC." "3006.7" "Salt" +.TH "SALT-API" "1" "Generated on April 29, 2024 at 03:20:12 AM UTC." "3006.8" "Salt" .SH NAME salt-api \- salt-api Command .sp diff --git a/doc/man/salt-call.1 b/doc/man/salt-call.1 index 01a8c6c5900..2ed60593bb7 100644 --- a/doc/man/salt-call.1 +++ b/doc/man/salt-call.1 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SALT-CALL" "1" "Generated on February 20, 2024 at 09:55:17 PM UTC." "3006.7" "Salt" +.TH "SALT-CALL" "1" "Generated on April 29, 2024 at 03:20:12 AM UTC." "3006.8" "Salt" .SH NAME salt-call \- salt-call Documentation .SH SYNOPSIS diff --git a/doc/man/salt-cloud.1 b/doc/man/salt-cloud.1 index e2c57db40fc..cc2139878bc 100644 --- a/doc/man/salt-cloud.1 +++ b/doc/man/salt-cloud.1 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SALT-CLOUD" "1" "Generated on February 20, 2024 at 09:55:17 PM UTC." "3006.7" "Salt" +.TH "SALT-CLOUD" "1" "Generated on April 29, 2024 at 03:20:12 AM UTC." "3006.8" "Salt" .SH NAME salt-cloud \- Salt Cloud Command .sp diff --git a/doc/man/salt-cp.1 b/doc/man/salt-cp.1 index bbd76b69121..952c6008c9d 100644 --- a/doc/man/salt-cp.1 +++ b/doc/man/salt-cp.1 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SALT-CP" "1" "Generated on February 20, 2024 at 09:55:17 PM UTC." "3006.7" "Salt" +.TH "SALT-CP" "1" "Generated on April 29, 2024 at 03:20:12 AM UTC." "3006.8" "Salt" .SH NAME salt-cp \- salt-cp Documentation .sp diff --git a/doc/man/salt-key.1 b/doc/man/salt-key.1 index c6de3044097..f6ac175d835 100644 --- a/doc/man/salt-key.1 +++ b/doc/man/salt-key.1 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SALT-KEY" "1" "Generated on February 20, 2024 at 09:55:17 PM UTC." "3006.7" "Salt" +.TH "SALT-KEY" "1" "Generated on April 29, 2024 at 03:20:12 AM UTC." "3006.8" "Salt" .SH NAME salt-key \- salt-key Documentation .SH SYNOPSIS diff --git a/doc/man/salt-master.1 b/doc/man/salt-master.1 index e7c04e2c15f..e7004f2fcaf 100644 --- a/doc/man/salt-master.1 +++ b/doc/man/salt-master.1 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SALT-MASTER" "1" "Generated on February 20, 2024 at 09:55:17 PM UTC." "3006.7" "Salt" +.TH "SALT-MASTER" "1" "Generated on April 29, 2024 at 03:20:12 AM UTC." "3006.8" "Salt" .SH NAME salt-master \- salt-master Documentation .sp diff --git a/doc/man/salt-minion.1 b/doc/man/salt-minion.1 index 70e2f1879c7..1231e4d5551 100644 --- a/doc/man/salt-minion.1 +++ b/doc/man/salt-minion.1 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SALT-MINION" "1" "Generated on February 20, 2024 at 09:55:17 PM UTC." "3006.7" "Salt" +.TH "SALT-MINION" "1" "Generated on April 29, 2024 at 03:20:12 AM UTC." "3006.8" "Salt" .SH NAME salt-minion \- salt-minion Documentation .sp diff --git a/doc/man/salt-proxy.1 b/doc/man/salt-proxy.1 index 93bdd1f6fae..18346acad6f 100644 --- a/doc/man/salt-proxy.1 +++ b/doc/man/salt-proxy.1 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SALT-PROXY" "1" "Generated on February 20, 2024 at 09:55:17 PM UTC." "3006.7" "Salt" +.TH "SALT-PROXY" "1" "Generated on April 29, 2024 at 03:20:12 AM UTC." "3006.8" "Salt" .SH NAME salt-proxy \- salt-proxy Documentation .sp diff --git a/doc/man/salt-run.1 b/doc/man/salt-run.1 index 5231095e460..5b456b4f1bc 100644 --- a/doc/man/salt-run.1 +++ b/doc/man/salt-run.1 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SALT-RUN" "1" "Generated on February 20, 2024 at 09:55:17 PM UTC." "3006.7" "Salt" +.TH "SALT-RUN" "1" "Generated on April 29, 2024 at 03:20:12 AM UTC." "3006.8" "Salt" .SH NAME salt-run \- salt-run Documentation .sp diff --git a/doc/man/salt-ssh.1 b/doc/man/salt-ssh.1 index 1835a0ba620..186d13f2fea 100644 --- a/doc/man/salt-ssh.1 +++ b/doc/man/salt-ssh.1 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SALT-SSH" "1" "Generated on February 20, 2024 at 09:55:17 PM UTC." "3006.7" "Salt" +.TH "SALT-SSH" "1" "Generated on April 29, 2024 at 03:20:12 AM UTC." "3006.8" "Salt" .SH NAME salt-ssh \- salt-ssh Documentation .SH SYNOPSIS diff --git a/doc/man/salt-syndic.1 b/doc/man/salt-syndic.1 index 652fbeb0c94..8207be769d1 100644 --- a/doc/man/salt-syndic.1 +++ b/doc/man/salt-syndic.1 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SALT-SYNDIC" "1" "Generated on February 20, 2024 at 09:55:17 PM UTC." "3006.7" "Salt" +.TH "SALT-SYNDIC" "1" "Generated on April 29, 2024 at 03:20:12 AM UTC." "3006.8" "Salt" .SH NAME salt-syndic \- salt-syndic Documentation .sp diff --git a/doc/man/salt.1 b/doc/man/salt.1 index 5faa32466d7..21511c9e035 100644 --- a/doc/man/salt.1 +++ b/doc/man/salt.1 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SALT" "1" "Generated on February 20, 2024 at 09:55:17 PM UTC." "3006.7" "Salt" +.TH "SALT" "1" "Generated on April 29, 2024 at 03:20:12 AM UTC." "3006.8" "Salt" .SH NAME salt \- salt .SH SYNOPSIS diff --git a/doc/man/salt.7 b/doc/man/salt.7 index 108bbdf6bf4..25cf54d9fbb 100644 --- a/doc/man/salt.7 +++ b/doc/man/salt.7 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SALT" "7" "Generated on February 20, 2024 at 09:55:17 PM UTC." "3006.7" "Salt" +.TH "SALT" "7" "Generated on April 29, 2024 at 03:20:12 AM UTC." "3006.8" "Salt" .SH NAME salt \- Salt Documentation .SH SALT PROJECT @@ -9225,7 +9225,9 @@ Default: \fB0\fP .sp Configures how often, in seconds, the minion will verify that the current master is alive and responding. The minion will try to establish a connection -to the next master in the list if it finds the existing one is dead. +to the next master in the list if it finds the existing one is dead. This +setting can also be used to detect master DNS record changes when a minion has +been disconnected. .INDENT 0.0 .INDENT 3.5 .sp @@ -15745,9 +15747,8 @@ For reference, see: #ping_interval: 0 # To auto recover minions if master changes IP address (DDNS) -# auth_tries: 10 -# auth_safemode: True -# ping_interval: 2 +# master_alive_interval: 10 +# master_tries: \-1 # # Minions won\(aqt know master is missing until a ping fails. After the ping fail, # the minion will attempt authentication and likely fails out and cause a restart. @@ -24890,11 +24891,6 @@ Return data to a cassandra server T} _ T{ -\fI\%cassandra_return\fP -T} T{ -T} -_ -T{ \fI\%couchbase_return\fP T} T{ Simple returner for Couchbase. @@ -24907,12 +24903,6 @@ Simple returner for CouchDB. T} _ T{ -\fI\%django_return\fP -T} T{ -Deprecated since version 3006.0. -T} -_ -T{ \fI\%elasticsearch_return\fP T} T{ Return data to an elasticsearch server for indexing. @@ -25586,57 +25576,6 @@ Save the load to the specified jid id .B salt.returners.cassandra_cql_return.save_minions(jid, minions, syndic_id=None) Included for API consistency .UNINDENT -.SS salt.returners.cassandra_return -.sp -\fBWARNING:\fP -.INDENT 0.0 -.INDENT 3.5 -The \fIcassandra\fP returner is deprecated in favor of the \fIcassandra_cql\fP -returner. -.UNINDENT -.UNINDENT -.sp -Return data to a Cassandra ColumnFamily -.sp -Here\(aqs an example Keyspace / ColumnFamily setup that works with this -returner: -.INDENT 0.0 -.INDENT 3.5 -.sp -.nf -.ft C -create keyspace salt; -use salt; -create column family returns - with key_validation_class=\(aqUTF8Type\(aq - and comparator=\(aqUTF8Type\(aq - and default_validation_class=\(aqUTF8Type\(aq; -.ft P -.fi -.UNINDENT -.UNINDENT -.sp -Required python modules: pycassa -.INDENT 0.0 -.INDENT 3.5 -To use the cassandra returner, append \(aq\-\-return cassandra\(aq to the salt command. ex: -.INDENT 0.0 -.INDENT 3.5 -salt \(aq*\(aq test.ping \-\-return cassandra -.UNINDENT -.UNINDENT -.UNINDENT -.UNINDENT -.INDENT 0.0 -.TP -.B salt.returners.cassandra_return.prep_jid(nocache=False, passed_jid=None) -Do any work necessary to prepare a JID, including sending a custom id -.UNINDENT -.INDENT 0.0 -.TP -.B salt.returners.cassandra_return.returner(ret) -Return data to a Cassandra ColumnFamily -.UNINDENT .SS salt.returners.couchbase_return .sp Simple returner for Couchbase. Optional configuration @@ -25887,63 +25826,6 @@ Included for API consistency Helper function that sets the salt design document. Uses get_valid_salt_views and some hardcoded values. .UNINDENT -.SS salt.returners.django_return -.sp -Deprecated since version 3006.0. - -.sp -\fBWARNING:\fP -.INDENT 0.0 -.INDENT 3.5 -This module has been deprecated and will be removed after January 2024. -.UNINDENT -.UNINDENT -.sp -A returner that will inform a Django system that -returns are available using Django\(aqs signal system. -.sp -\fI\%https://docs.djangoproject.com/en/dev/topics/signals/\fP -.sp -It is up to the Django developer to register necessary -handlers with the signals provided by this returner -and process returns as necessary. -.sp -The easiest way to use signals is to import them from -this returner directly and then use a decorator to register -them. -.sp -An example Django module that registers a function called -\(aqreturner_callback\(aq with this module\(aqs \(aqreturner\(aq function: -.INDENT 0.0 -.INDENT 3.5 -.sp -.nf -.ft C -import salt.returners.django_return -from django.dispatch import receiver - -@receiver(salt.returners.django_return, sender=returner) -def returner_callback(sender, ret): - print(\(aqI received {0} from {1}\(aq.format(ret, sender)) -.ft P -.fi -.UNINDENT -.UNINDENT -.INDENT 0.0 -.TP -.B salt.returners.django_return.prep_jid(nocache=False, passed_jid=None) -Do any work necessary to prepare a JID, including sending a custom ID -.UNINDENT -.INDENT 0.0 -.TP -.B salt.returners.django_return.returner(ret) -Signal a Django server that a return is available -.UNINDENT -.INDENT 0.0 -.TP -.B salt.returners.django_return.save_load(jid, load, minions=None) -Save the load to the specified jid -.UNINDENT .SS salt.returners.elasticsearch_return .sp Return data to an elasticsearch server for indexing. @@ -50782,7 +50664,7 @@ the requirements for the tests. .SS Add a system dependency to the test run .sp If you need to add a system dependency for the test run, this will need to be added in -the \fI\%salt jenkins\fP repo. This repo uses salt states to install system dependencies. +the \fI\%salt\-ci\-images\fP repo. This repo uses salt states to install system dependencies. You need to update the \fBstate\-tree/golden\-images\-provision.sls\fP file with your dependency to ensure it is installed. Once your PR is merged the core team will need to promote the new images with your new dependency installed. @@ -50912,13 +50794,6 @@ test:core .IP \(bu 2 test:flaky\-jail .UNINDENT -.SS Automated Test Runs -.sp -SaltStack maintains a Jenkins server which can be viewed at -\fI\%https://jenkins.saltproject.io\fP\&. The tests executed from this Jenkins server -create fresh virtual machines for each test run, then execute the destructive -tests on the new, clean virtual machine. This allows for the execution of tests -across supported platforms. .SS Additional Testing Documentation .sp In addition to this tutorial, there are some other helpful resources and documentation @@ -54093,6 +53968,7 @@ the case when the dependency is unavailable. \(dq\(dq\(dq Cheese execution (or returner/beacon/etc.) module \(dq\(dq\(dq + try: import enzymes @@ -54589,8 +54465,7 @@ the \fBexecute\fP function with the following signature: .sp .nf .ft C -def execute(opts, data, func, args, kwargs): - ... +def execute(opts, data, func, args, kwargs): ... .ft P .fi .UNINDENT @@ -83419,7 +83294,6 @@ def fix_outage(): def uptodate(name): - \(dq\(dq\(dq Call the REST endpoint to see if the packages on the \(dqserver\(dq are up to date. \(dq\(dq\(dq @@ -83430,7 +83304,6 @@ def uptodate(name): def package_remove(name): - \(dq\(dq\(dq Remove a \(dqpackage\(dq on the REST server \(dq\(dq\(dq @@ -111386,11 +111259,6 @@ Cassandra Database Module T} _ T{ -\fI\%cassandra_mod\fP -T} T{ -T} -_ -T{ \fI\%celery\fP T} T{ Support for scheduling celery tasks. @@ -147448,197 +147316,6 @@ salt \(aqminion1\(aq cassandra_cql.version contact_points=minion1 .UNINDENT .UNINDENT .UNINDENT -.SS salt.modules.cassandra_mod -.sp -\fBWARNING:\fP -.INDENT 0.0 -.INDENT 3.5 -The \fIcassandra\fP module is deprecated in favor of the \fIcassandra_cql\fP -module. -.UNINDENT -.UNINDENT -.sp -Cassandra NoSQL Database Module -.INDENT 0.0 -.TP -.B depends -.INDENT 7.0 -.IP \(bu 2 -pycassa Cassandra Python adapter -.UNINDENT -.TP -.B configuration -The location of the \(aqnodetool\(aq command, host, and thrift port needs to be -specified via pillar: -.INDENT 7.0 -.INDENT 3.5 -.sp -.nf -.ft C -cassandra.nodetool: /usr/local/bin/nodetool -cassandra.host: localhost -cassandra.thrift_port: 9160 -.ft P -.fi -.UNINDENT -.UNINDENT -.UNINDENT -.INDENT 0.0 -.TP -.B salt.modules.cassandra_mod.column_families(keyspace=None) -Return existing column families for all keyspaces -or just the provided one. -.sp -CLI Example: -.INDENT 7.0 -.INDENT 3.5 -.sp -.nf -.ft C -salt \(aq*\(aq cassandra.column_families -salt \(aq*\(aq cassandra.column_families -.ft P -.fi -.UNINDENT -.UNINDENT -.UNINDENT -.INDENT 0.0 -.TP -.B salt.modules.cassandra_mod.column_family_definition(keyspace, column_family) -Return a dictionary of column family definitions for the given -keyspace/column_family -.sp -CLI Example: -.INDENT 7.0 -.INDENT 3.5 -.sp -.nf -.ft C -salt \(aq*\(aq cassandra.column_family_definition -.ft P -.fi -.UNINDENT -.UNINDENT -.UNINDENT -.INDENT 0.0 -.TP -.B salt.modules.cassandra_mod.compactionstats() -Return compactionstats info -.sp -CLI Example: -.INDENT 7.0 -.INDENT 3.5 -.sp -.nf -.ft C -salt \(aq*\(aq cassandra.compactionstats -.ft P -.fi -.UNINDENT -.UNINDENT -.UNINDENT -.INDENT 0.0 -.TP -.B salt.modules.cassandra_mod.info() -Return cassandra node info -.sp -CLI Example: -.INDENT 7.0 -.INDENT 3.5 -.sp -.nf -.ft C -salt \(aq*\(aq cassandra.info -.ft P -.fi -.UNINDENT -.UNINDENT -.UNINDENT -.INDENT 0.0 -.TP -.B salt.modules.cassandra_mod.keyspaces() -Return existing keyspaces -.sp -CLI Example: -.INDENT 7.0 -.INDENT 3.5 -.sp -.nf -.ft C -salt \(aq*\(aq cassandra.keyspaces -.ft P -.fi -.UNINDENT -.UNINDENT -.UNINDENT -.INDENT 0.0 -.TP -.B salt.modules.cassandra_mod.netstats() -Return netstats info -.sp -CLI Example: -.INDENT 7.0 -.INDENT 3.5 -.sp -.nf -.ft C -salt \(aq*\(aq cassandra.netstats -.ft P -.fi -.UNINDENT -.UNINDENT -.UNINDENT -.INDENT 0.0 -.TP -.B salt.modules.cassandra_mod.ring() -Return cassandra ring info -.sp -CLI Example: -.INDENT 7.0 -.INDENT 3.5 -.sp -.nf -.ft C -salt \(aq*\(aq cassandra.ring -.ft P -.fi -.UNINDENT -.UNINDENT -.UNINDENT -.INDENT 0.0 -.TP -.B salt.modules.cassandra_mod.tpstats() -Return tpstats info -.sp -CLI Example: -.INDENT 7.0 -.INDENT 3.5 -.sp -.nf -.ft C -salt \(aq*\(aq cassandra.tpstats -.ft P -.fi -.UNINDENT -.UNINDENT -.UNINDENT -.INDENT 0.0 -.TP -.B salt.modules.cassandra_mod.version() -Return the cassandra version -.sp -CLI Example: -.INDENT 7.0 -.INDENT 3.5 -.sp -.nf -.ft C -salt \(aq*\(aq cassandra.version -.ft P -.fi -.UNINDENT -.UNINDENT -.UNINDENT .SS salt.modules.celery .sp Support for scheduling celery tasks. The worker is independent of salt and thus can run in a different @@ -194495,7 +194172,7 @@ Passes through all the parameters described in the \fI\%utils.http.query function\fP: .INDENT 7.0 .TP -.B salt.utils.http.query(url, method=\(aqGET\(aq, params=None, data=None, data_file=None, header_dict=None, header_list=None, header_file=None, username=None, password=None, auth=None, decode=False, decode_type=\(aqauto\(aq, status=False, headers=False, text=False, cookies=None, cookie_jar=None, cookie_format=\(aqlwp\(aq, persist_session=False, session_cookie_jar=None, data_render=False, data_renderer=None, header_render=False, header_renderer=None, template_dict=None, test=False, test_url=None, node=\(aqminion\(aq, port=80, opts=None, backend=None, ca_bundle=None, verify_ssl=None, cert=None, text_out=None, headers_out=None, decode_out=None, stream=False, streaming_callback=None, header_callback=None, handle=False, agent=\(aqSalt/3006.7\(aq, hide_fields=None, raise_error=True, formdata=False, formdata_fieldname=None, formdata_filename=None, decode_body=True, **kwargs) +.B salt.utils.http.query(url, method=\(aqGET\(aq, params=None, data=None, data_file=None, header_dict=None, header_list=None, header_file=None, username=None, password=None, auth=None, decode=False, decode_type=\(aqauto\(aq, status=False, headers=False, text=False, cookies=None, cookie_jar=None, cookie_format=\(aqlwp\(aq, persist_session=False, session_cookie_jar=None, data_render=False, data_renderer=None, header_render=False, header_renderer=None, template_dict=None, test=False, test_url=None, node=\(aqminion\(aq, port=80, opts=None, backend=None, ca_bundle=None, verify_ssl=None, cert=None, text_out=None, headers_out=None, decode_out=None, stream=False, streaming_callback=None, header_callback=None, handle=False, agent=\(aqSalt/3006.8\(aq, hide_fields=None, raise_error=True, formdata=False, formdata_fieldname=None, formdata_filename=None, decode_body=True, **kwargs) Query a resource, and decode the return data .UNINDENT .INDENT 7.0 @@ -269141,8 +268818,6 @@ See \fI\%http://code.google.com/p/psutil\fP\&. .B depends .INDENT 7.0 .IP \(bu 2 -psutil Python module, version 0.3.0 or later -.IP \(bu 2 python\-utmp package (optional) .UNINDENT .UNINDENT @@ -325445,6 +325120,24 @@ salt.utils.win_reg .UNINDENT .INDENT 0.0 .TP +.B salt.modules.win_lgpo.clear_policy_cache() +Clears the policy definitions and resource stored in \fB__context__\fP\&. They +will be rebuilt the next time a policy is applied. +.sp +CLI Example: +.INDENT 7.0 +.INDENT 3.5 +.sp +.nf +.ft C +salt \(aq*\(aq lgpo.clear_policy_cache +.ft P +.fi +.UNINDENT +.UNINDENT +.UNINDENT +.INDENT 0.0 +.TP .B salt.modules.win_lgpo.get(policy_class=None, return_full_policy_names=True, hierarchical_return=False, adml_language=\(aqen\-US\(aq, return_not_configured=False) Get a policy value .INDENT 7.0 @@ -327297,7 +326990,35 @@ salt \-G \(aqos:windows\(aq pkg.genrepo saltenv=base .INDENT 0.0 .TP .B salt.modules.win_pkg.get_package_info(name, saltenv=\(aqbase\(aq) -Return package info. Returns empty map if package not available. +Get information about the package as found in the winrepo database +.INDENT 7.0 +.TP +.B Parameters +.INDENT 7.0 +.IP \(bu 2 +\fBname\fP (\fI\%str\fP) \-\- The name of the package +.IP \(bu 2 +\fBsaltenv\fP (\fI\%str\fP) \-\- The salt environment to use. Default is \(dqbase\(dq +.UNINDENT +.TP +.B Returns +A dictionary of package info, empty if package not available +.TP +.B Return type +\fI\%dict\fP +.UNINDENT +.sp +CLI Example: +.INDENT 7.0 +.INDENT 3.5 +.sp +.nf +.ft C +salt \(aq*\(aq pkg.get_package_info chrome +.ft P +.fi +.UNINDENT +.UNINDENT .UNINDENT .INDENT 0.0 .TP @@ -327857,7 +327578,7 @@ Generates the local software metadata database (\fIwinrepo.p\fP) on the minion. The database is stored in a serialized format located by default at the following location: .sp -\fBC:\esalt\evar\ecache\esalt\eminion\efiles\ebase\ewin\erepo\-ng\ewinrepo.p\fP +\fBC:\eProgramData\eSalt Project\eSalt\evar\ecache\esalt\eminion\efiles\ebase\ewin\erepo\-ng\ewinrepo.p\fP .sp This module performs the following steps to generate the software metadata database: @@ -327866,7 +327587,7 @@ database: Fetch the package definition files (.sls) from \fIwinrepo_source_dir\fP (default \fIsalt://win/repo\-ng\fP) and cache them in \fIfiles\fP -(default: \fBC:\esalt\evar\ecache\esalt\eminion\efiles\ebase\ewin\erepo\-ng\fP) +(default: \fBC:\eProgramData\eSalt Project\eSalt\evar\ecache\esalt\eminion\efiles\ebase\ewin\erepo\-ng\fP) .IP \(bu 2 Call \fI\%pkg.genrepo\fP to parse the package definition files and generate the repository metadata database @@ -327961,7 +327682,7 @@ minion: \fIsalt\-call \-l debug pkg.refresh saltenv=base\fP .INDENT 7.0 .INDENT 3.5 When calling this command from a state using \fImodule.run\fP be sure to -pass \fIfailhard: False\fP\&. Otherwise the state will report failure if it +pass \fIfailhard: False\fP\&. Otherwise, the state will report failure if it encounters a bad software definition file. .UNINDENT .UNINDENT @@ -335300,7 +335021,7 @@ Add a user to the minion. .B Parameters .INDENT 7.0 .IP \(bu 2 -\fBname\fP (\fI\%str\fP) \-\- User name +\fBname\fP (\fI\%str\fP) \-\- The username for the new account .IP \(bu 2 \fBpassword\fP (\fI\%str\fP\fI, \fP\fIoptional\fP) \-\- User\(aqs password in plain text. .IP \(bu 2 @@ -335325,7 +335046,7 @@ logs on. .UNINDENT .TP .B Returns -True if successful. False is unsuccessful. +\fBTrue\fP if successful, otherwise \fBFalse\fP\&. .TP .B Return type \fI\%bool\fP @@ -335352,13 +335073,13 @@ Add user to a group .B Parameters .INDENT 7.0 .IP \(bu 2 -\fBname\fP (\fI\%str\fP) \-\- The user name to add to the group +\fBname\fP (\fI\%str\fP) \-\- The username to add to the group .IP \(bu 2 \fBgroup\fP (\fI\%str\fP) \-\- The name of the group to which to add the user .UNINDENT .TP .B Returns -True if successful, otherwise False +\fBTrue\fP if successful, otherwise \fBFalse\fP\&. .TP .B Return type \fI\%bool\fP @@ -335385,13 +335106,13 @@ Change the full name of the user .B Parameters .INDENT 7.0 .IP \(bu 2 -\fBname\fP (\fI\%str\fP) \-\- The user name for which to change the full name +\fBname\fP (\fI\%str\fP) \-\- The username for which to change the full name .IP \(bu 2 \fBfullname\fP (\fI\%str\fP) \-\- The new value for the full name .UNINDENT .TP .B Returns -True if successful, otherwise False +\fBTrue\fP if successful, otherwise \fBFalse\fP\&. .TP .B Return type \fI\%bool\fP @@ -335419,7 +335140,7 @@ member of only the specified groups .B Parameters .INDENT 7.0 .IP \(bu 2 -\fBname\fP (\fI\%str\fP) \-\- The user name for which to change groups +\fBname\fP (\fI\%str\fP) \-\- The username for which to change groups .IP \(bu 2 \fBgroups\fP (\fI\%str\fP\fI, \fP\fI\%list\fP) \-\- A single group or a list of groups to assign to the user. For multiple groups this can be a comma delimited string or a @@ -335431,7 +335152,7 @@ only. Default is True. .UNINDENT .TP .B Returns -True if successful, otherwise False +\fBTrue\fP if successful, otherwise \fBFalse\fP\&. .TP .B Return type \fI\%bool\fP @@ -335465,7 +335186,7 @@ to the new home directory if the old home directory exist. .UNINDENT .TP .B Returns -True if successful, otherwise False +\fBTrue\fP if successful, otherwise \fBFalse\fP\&. .TP .B Return type \fI\%bool\fP @@ -335498,7 +335219,7 @@ Change the profile directory of the user .UNINDENT .TP .B Returns -True if successful, otherwise False +\fBTrue\fP if successful, otherwise \fBFalse\fP\&. .TP .B Return type \fI\%bool\fP @@ -335573,7 +335294,7 @@ user out and delete user. .UNINDENT .TP .B Returns -True if successful, otherwise False +\fBTrue\fP if successful, otherwise \fBFalse\fP\&. .TP .B Return type \fI\%bool\fP @@ -335594,11 +335315,28 @@ salt \(aq*\(aq user.delete name .INDENT 0.0 .TP .B salt.modules.win_useradd.getUserSid(username) +Deprecated function. Please use get_user_sid instead +.sp +CLI Example: +.INDENT 7.0 +.INDENT 3.5 +.sp +.nf +.ft C +salt \(aq*\(aq user.get_user_sid jsnuffy +.ft P +.fi +.UNINDENT +.UNINDENT +.UNINDENT +.INDENT 0.0 +.TP +.B salt.modules.win_useradd.get_user_sid(username) Get the Security ID for the user .INDENT 7.0 .TP .B Parameters -\fBusername\fP (\fI\%str\fP) \-\- The user name for which to look up the SID +\fBusername\fP (\fI\%str\fP) \-\- The username for which to look up the SID .TP .B Returns The user SID @@ -335613,7 +335351,7 @@ CLI Example: .sp .nf .ft C -salt \(aq*\(aq user.getUserSid jsnuffy +salt \(aq*\(aq user.get_user_sid jsnuffy .ft P .fi .UNINDENT @@ -335699,6 +335437,8 @@ account_disabled .IP \(bu 2 account_locked .IP \(bu 2 +expiration_date +.IP \(bu 2 password_never_expires .IP \(bu 2 disallow_change_password @@ -335731,7 +335471,7 @@ Return a list of groups the named user belongs to .INDENT 7.0 .TP .B Parameters -\fBname\fP (\fI\%str\fP) \-\- The user name for which to list groups +\fBname\fP (\fI\%str\fP) \-\- The username for which to list groups .TP .B Returns A list of groups to which the user belongs @@ -335786,13 +335526,13 @@ Remove user from a group .B Parameters .INDENT 7.0 .IP \(bu 2 -\fBname\fP (\fI\%str\fP) \-\- The user name to remove from the group +\fBname\fP (\fI\%str\fP) \-\- The username to remove from the group .IP \(bu 2 \fBgroup\fP (\fI\%str\fP) \-\- The name of the group from which to remove the user .UNINDENT .TP .B Returns -True if successful, otherwise False +\fBTrue\fP if successful, otherwise \fBFalse\fP\&. .TP .B Return type \fI\%bool\fP @@ -335819,13 +335559,13 @@ Change the username for a named user .B Parameters .INDENT 7.0 .IP \(bu 2 -\fBname\fP (\fI\%str\fP) \-\- The user name to change +\fBname\fP (\fI\%str\fP) \-\- The username to change .IP \(bu 2 \fBnew_name\fP (\fI\%str\fP) \-\- The new name for the current user .UNINDENT .TP .B Returns -True if successful, otherwise False +\fBTrue\fP if successful, otherwise \fBFalse\fP\&. .TP .B Return type \fI\%bool\fP @@ -335852,13 +335592,13 @@ Set the user\(aqs password .B Parameters .INDENT 7.0 .IP \(bu 2 -\fBname\fP (\fI\%str\fP) \-\- The user name for which to set the password +\fBname\fP (\fI\%str\fP) \-\- The username for which to set the password .IP \(bu 2 \fBpassword\fP (\fI\%str\fP) \-\- The new password .UNINDENT .TP .B Returns -True if successful, otherwise False +\fBTrue\fP if successful, otherwise \fBFalse\fP\&. .TP .B Return type \fI\%bool\fP @@ -335879,7 +335619,7 @@ salt \(aq*\(aq user.setpassword jsnuffy sup3rs3cr3t .INDENT 0.0 .TP .B salt.modules.win_useradd.update(name, password=None, fullname=None, description=None, home=None, homedrive=None, logonscript=None, profile=None, expiration_date=None, expired=None, account_disabled=None, unlock_account=None, password_never_expires=None, disallow_change_password=None) -Updates settings for the windows user. Name is the only required parameter. +Updates settings for the Windows user. Name is the only required parameter. Settings will only be changed if the parameter is passed a value. .sp New in version 2015.8.0. @@ -335889,7 +335629,7 @@ New in version 2015.8.0. .B Parameters .INDENT 7.0 .IP \(bu 2 -\fBname\fP (\fI\%str\fP) \-\- The user name to update. +\fBname\fP (\fI\%str\fP) \-\- The username to update. .IP \(bu 2 \fBpassword\fP (\fI\%str\fP\fI, \fP\fIoptional\fP) \-\- New user password in plain text. .IP \(bu 2 @@ -335930,7 +335670,7 @@ changing the password. False allows the user to change the password. .UNINDENT .TP .B Returns -True if successful. False is unsuccessful. +\fBTrue\fP if successful, otherwise \fBFalse\fP\&. .TP .B Return type \fI\%bool\fP @@ -381432,6 +381172,16 @@ Serialize Python data to environment file. Implements MsgPack serializer. .INDENT 0.0 .TP +.B exception salt.serializers.msgpack.DeserializationError(message, line_num=None, buf=\(aq\(aq, marker=\(aq <======================\(aq, trace=None) +Raised when stream of string failed to be deserialized +.UNINDENT +.INDENT 0.0 +.TP +.B exception salt.serializers.msgpack.SerializationError(message=\(aq\(aq) +Raised when stream of string failed to be serialized +.UNINDENT +.INDENT 0.0 +.TP .B salt.serializers.msgpack.deserialize(stream_or_string, **options) Deserialize any string of stream like object into a Python data structure. .INDENT 7.0 @@ -381616,7 +381366,7 @@ Raised when stream of string failed to be deserialized Overwrites Dumper as not for pollute legacy Dumper .INDENT 7.0 .TP -.B yaml_multi_representers = {: , : , : , : , : , : , : , : , : , : , : , : , None: , : } +.B yaml_multi_representers = {: , : , : , : , : , : , : , : , : , : , : , : , None: , : } .UNINDENT .UNINDENT .INDENT 0.0 @@ -381647,6 +381397,66 @@ Overwrites Loader as not for pollute legacy Loader .INDENT 0.0 .TP .B class salt.serializers.yaml.OrderedDict +Dictionary that remembers insertion order +.INDENT 7.0 +.TP +.B clear() -> None. Remove all items from od. +.UNINDENT +.INDENT 7.0 +.TP +.B copy() -> a shallow copy of od +.UNINDENT +.INDENT 7.0 +.TP +.B fromkeys(value=None) +Create a new ordered dictionary with keys from iterable and values set to value. +.UNINDENT +.INDENT 7.0 +.TP +.B items() -> a set\-like object providing a view on D\(aqs items +.UNINDENT +.INDENT 7.0 +.TP +.B keys() -> a set\-like object providing a view on D\(aqs keys +.UNINDENT +.INDENT 7.0 +.TP +.B move_to_end(key, last=True) +Move an existing element to the end (or beginning if last is false). +.sp +Raise KeyError if the element does not exist. +.UNINDENT +.INDENT 7.0 +.TP +.B pop(key[, default]) -> v, remove specified key and return the corresponding value. +If the key is not found, return the default if given; otherwise, +raise a KeyError. +.UNINDENT +.INDENT 7.0 +.TP +.B popitem(last=True) +Remove and return a (key, value) pair from the dictionary. +.sp +Pairs are returned in LIFO order if last is true or FIFO order if false. +.UNINDENT +.INDENT 7.0 +.TP +.B setdefault(key, default=None) +Insert key with a value of default if key is not in the dictionary. +.sp +Return the value for key if key is in the dictionary, else default. +.UNINDENT +.INDENT 7.0 +.TP +.B update([E], **F) -> None. Update D from dict/iterable E and F. +If E is present and has a .keys() method, then does: for k in E: D[k] = E[k] +If E is present and lacks a .keys() method, then does: for k, v in E: D[k] = v +In either case, this is followed by: for k in F: D[k] = F[k] +.UNINDENT +.INDENT 7.0 +.TP +.B values() -> an object providing a view on D\(aqs values +.UNINDENT .UNINDENT .INDENT 0.0 .TP @@ -381971,6 +381781,66 @@ Map aggregation. .INDENT 0.0 .TP .B class salt.serializers.yamlex.OrderedDict +Dictionary that remembers insertion order +.INDENT 7.0 +.TP +.B clear() -> None. Remove all items from od. +.UNINDENT +.INDENT 7.0 +.TP +.B copy() -> a shallow copy of od +.UNINDENT +.INDENT 7.0 +.TP +.B fromkeys(value=None) +Create a new ordered dictionary with keys from iterable and values set to value. +.UNINDENT +.INDENT 7.0 +.TP +.B items() -> a set\-like object providing a view on D\(aqs items +.UNINDENT +.INDENT 7.0 +.TP +.B keys() -> a set\-like object providing a view on D\(aqs keys +.UNINDENT +.INDENT 7.0 +.TP +.B move_to_end(key, last=True) +Move an existing element to the end (or beginning if last is false). +.sp +Raise KeyError if the element does not exist. +.UNINDENT +.INDENT 7.0 +.TP +.B pop(key[, default]) -> v, remove specified key and return the corresponding value. +If the key is not found, return the default if given; otherwise, +raise a KeyError. +.UNINDENT +.INDENT 7.0 +.TP +.B popitem(last=True) +Remove and return a (key, value) pair from the dictionary. +.sp +Pairs are returned in LIFO order if last is true or FIFO order if false. +.UNINDENT +.INDENT 7.0 +.TP +.B setdefault(key, default=None) +Insert key with a value of default if key is not in the dictionary. +.sp +Return the value for key if key is in the dictionary, else default. +.UNINDENT +.INDENT 7.0 +.TP +.B update([E], **F) -> None. Update D from dict/iterable E and F. +If E is present and has a .keys() method, then does: for k in E: D[k] = E[k] +If E is present and lacks a .keys() method, then does: for k, v in E: D[k] = v +In either case, this is followed by: for k in F: D[k] = F[k] +.UNINDENT +.INDENT 7.0 +.TP +.B values() -> an object providing a view on D\(aqs values +.UNINDENT .UNINDENT .INDENT 0.0 .TP @@ -453654,7 +453524,7 @@ quotes to make yaml see it as raw data, or escape the back slashes. .UNINDENT .INDENT 0.0 .TP -.B salt.states.win_lgpo.set_(name, setting=None, policy_class=None, computer_policy=None, user_policy=None, cumulative_rights_assignments=True, adml_language=\(aqen\-US\(aq) +.B salt.states.win_lgpo.set_(name, setting=None, policy_class=None, computer_policy=None, user_policy=None, cumulative_rights_assignments=True, adml_language=\(aqen\-US\(aq, refresh_cache=False) Ensure the specified policy is set. .sp \fBWARNING:\fP @@ -453692,6 +453562,23 @@ explicit .IP \(bu 2 \fBadml_language\fP (\fI\%str\fP) \-\- The adml language to use for AMDX policy data/display conversions. Default is \fBen\-US\fP +.IP \(bu 2 +\fBrefresh_cache\fP (\fI\%bool\fP) \-\- +.sp +Clear the cached policy definitions before applying the state. This +is useful when the underlying policy files (ADMX/ADML) have been +added/modified in the same state. This will allow those new policies +to be picked up. This adds time to the state run when applied to +multiple states within the same run. Therefore, it is best to only +apply this to the first policy that is applied. For individual runs +this will have no effect. Default is \fBFalse\fP +.sp +New in version 3006.8. + +.sp +New in version 3007.1. + + .UNINDENT .UNINDENT .UNINDENT @@ -465129,17 +465016,17 @@ The file name of the winrepo cache file. The file is placed at the root of .sp \fI\%winrepo_source_dir\fP (str) .sp -The location of the .sls files on the Salt file server. This allows for using -different environments. Default is \fBsalt://win/repo\-ng/\fP\&. +The location of the .sls files on the Salt file server. Default is +\fBsalt://win/repo\-ng/\fP\&. .sp \fBWARNING:\fP .INDENT 0.0 .INDENT 3.5 -If the default for \fBwinrepo_dir_ng\fP is changed, this setting may need to -changed on each minion. The default setting for \fBwinrepo_dir_ng\fP is -\fB/srv/salt/win/repo\-ng\fP\&. If that were changed to \fB/srv/salt/new/repo\-ng\fP -then the \fBwinrepo_source_dir\fP would need to be changed to -\fBsalt://new/repo\-ng\fP +If the default for \fBwinrepo_dir_ng\fP is changed, then this setting will +also need to be changed on each minion. The default setting for +\fBwinrepo_dir_ng\fP is \fB/srv/salt/win/repo\-ng\fP\&. If that were changed to +\fB/srv/salt/new/repo\-ng\fP then the \fBwinrepo_source_dir\fP would need to be +changed to \fBsalt://new/repo\-ng\fP .UNINDENT .UNINDENT .SS Masterless Minion Configuration @@ -465165,13 +465052,13 @@ minion config options for winrepo. .sp This setting is maintained for backwards compatibility with legacy minions. It points to the location in the \fBfile_roots\fP where the winrepo files are kept. -The default is: \fBC:\esalt\esrv\esalt\ewin\erepo\fP +The default is: \fBC:\eProgramData\eSalt Project\eSalt\esrv\esalt\ewin\erepo\fP .SS winrepo_dir_ng .sp \fI\%winrepo_dir_ng\fP (str) .sp The location in the \fBfile_roots where the winrepo files are kept. The default -is \(ga\(gaC:\esalt\esrv\esalt\ewin\erepo\-ng\fP\&. +is \(ga\(gaC:\eProgramData\eSalt Project\eSalt\esrv\esalt\ewin\erepo\-ng\fP\&. .sp \fBWARNING:\fP .INDENT 0.0 @@ -465340,6 +465227,163 @@ Use \fBpkg.refresh_db\fP when developing new Windows package definitions to check for errors in the definitions against one or more Windows minions. .UNINDENT .UNINDENT +.SS Sample Configurations +.SS Masterless +.sp +The configs in this section are for working with winrepo on a Windows minion +using \fBsalt\-call \-\-local\fP\&. +.SS Default Configuration +.sp +This is the default configuration if nothing is configured in the minion config. +The config is shown here for clarity. These are the defaults: +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +file_roots: + base: + \- C:\eProgramData\eSalt Project\eSalt\esrv\esalt +winrepo_source_dir: \(aqsalt://win/repo\-ng\(aq +winrepo_dir_ng: C:\eProgramData\eSalt Project\eSalt\esrv\esalt\ewin\erepo\-ng +.ft P +.fi +.UNINDENT +.UNINDENT +.sp +The \fI\%winrepo.update_git_repos\fP +command will clone the repository to \fBwin\erepo\-ng\fP on the file_roots. +.SS Multiple Salt Environments +.sp +This starts to get a little tricky. The winrepo repository doesn\(aqt +get cloned to each environment when you run +\fI\%winrepo.update_git_repos\fP, so to +make this work, all environments share the same winrepo. Applying states using +the \fBsaltenv\fP option will find the state files in the appropriate environment, +but the package definition files will always be pulled from the same location. +Therefore, you have to put the same winrepo location in each saltenv. Here\(aqs how +this would look: +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +file_roots: + base: + \- C:\eProgramData\eSalt Project\eSalt\esrv\esalt\ebase + \- C:\eProgramData\eSalt Project\eSalt\esrv\esalt\ewinrepo + test: + \- C:\eProgramData\eSalt Project\eSalt\esrv\esalt\etest + \- C:\eProgramData\eSalt Project\eSalt\esrv\esalt\ewinrepo +winrepo_source_dir: \(aqsalt://salt\-winrepo\-ng\(aq +winrepo_dir_ng: C:\eProgramData\eSalt Project\eSalt\esrv\esalt\ewinrepo +winrepo_dir: C:\eProgramData\eSalt Project\eSalt\esrv\esalt\ewinrepo +.ft P +.fi +.UNINDENT +.UNINDENT +.sp +When you run +\fI\%winrepo.update_git_repos\fP the +Git repository will be cloned to the location specified in the +\fBwinrepo_dir_ng\fP setting. I specified the \fBwinrepo_dir\fP setting just so +everything gets cloned to the same place. The directory that gets cloned is +named \fBsalt\-winrepo\-ng\fP so you specify that in the \fBwinrepo_source_dir\fP +setting. +.sp +The \fBwinrepo\fP directory should only contain the package definition files. You +wouldn\(aqt want to place any states in the \fBwinrepo\fP directory as they will be +available to both environments. +.SS Master +.sp +When working in a Master/Minion environment you have to split up some of the +config settings between the master and the minion. Here are some sample configs +for winrepo in a Master/Minion environment. +.SS Default Configuration +.sp +This is the default configuration if nothing is configured. The config is shown +here for clarity. These are the defaults on the master: +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +file_roots: + base: + \- /srv/salt +winrepo_dir_ng: /srv/salt/win/repo\-ng +.ft P +.fi +.UNINDENT +.UNINDENT +.sp +This is the default in the minion config: +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +winrepo_source_dir: \(aqsalt://win/repo\-ng\(aq +.ft P +.fi +.UNINDENT +.UNINDENT +.sp +The \fI\%winrepo.update_git_repos\fP +command will clone the repository to \fBwin\erepo\-ng\fP on the file_roots. +.SS Multiple Salt Environments +.sp +To set up multiple saltenvs using a Master/Minion configuration set the +following in the master config: +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +file_roots: + base: + \- /srv/salt/base + \- /srv/salt/winrepo + test: + \- /srv/salt/test + \- /srv/salt/winrepo +winrepo_dir_ng: /srv/salt/winrepo +winrepo_dir: /srv/salt/winrepo +.ft P +.fi +.UNINDENT +.UNINDENT +.sp +Use the winrepo runner to set up the winrepo repository on the master. +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +salt\-run winrepo.update_git_repos +.ft P +.fi +.UNINDENT +.UNINDENT +.sp +The winrepo will be cloned to \fB/srv/salt/winrepo\fP under a directory named +\fBsalt\-winrepo\-ng\fP\&. +.sp +Set the following on the minion config so the minion knows where to find the +package definition files in the file_roots: +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +winrepo_source_dir: \(aqsalt://salt\-winrepo\-ng\(aq +.ft P +.fi +.UNINDENT +.UNINDENT +.sp +The same stipulations apply in a Master/Minion configuration as they do in a +Masterless configuration .SS Usage .sp After completing the configuration and initialization steps, you are ready to @@ -469698,6 +469742,64 @@ changes outside of the salt directory .UNINDENT .UNINDENT .UNINDENT +.SS Pull Request CI/CD test suite +.sp +By default, PRs run a limited subset of the test suite against the following +operating systems: +.INDENT 0.0 +.IP \(bu 2 +.INDENT 2.0 +.TP +.B Linux: +.INDENT 7.0 +.IP \(bu 2 +Latest \fBRocky Linux x86_64\fP +.IP \(bu 2 +Latest \fBAmazon Linux aarch64\fP +.IP \(bu 2 +Latest \fBUbuntu LTS arm64\fP +.IP \(bu 2 +Latest \fBArch Linux x86_64\fP +.UNINDENT +.UNINDENT +.IP \(bu 2 +Latest \fBWindows Server x86_64\fP +.IP \(bu 2 +Latest \fBMacOS arm64\fP +.UNINDENT +.SS Optional OS additions +.sp +There are times where a PR is specifically addressing a target OS, or a core component of +Salt is being updated that needs to be tested against all support operating systems. This +is often required to fix \fBnightly\fP builds, or introduce a new operating system into CI/CD. +.sp +Labels can be applied to a PR, via those who have the appropriate permissions, using the +\fBtest:os:\fP format. +.INDENT 0.0 +.IP \(bu 2 +Example: \fBtest:os:debian\-11\-arm64\fP would also ensure the Debian 11 arm64 OS is included. +.UNINDENT +.sp +Optionally, \fBtest:os:all\fP can be used as a way to target all operating systems +that nightlies, staging, release target without having to add them all individually. +.SS Optional test additions +.sp +If wanting to also increase the scope of tests themselves, not just the scope of operating +systems, then additional labels can be used such as: +.INDENT 0.0 +.IP \(bu 2 +\fBtest:pkg\fP: Run all package\-related tests that are otherwise not included by default +on the currently selected operating systems. +.IP \(bu 2 +\fBtest:full\fP: Run all tests in the Salt test suite that can be ran on the currently +selected operating systems. +.IP \(bu 2 +\fBtest:coverage\fP: Run all tests in the Salt test suite on all operating systems while +collecting code coverage. +.IP \(bu 2 +\fBtest:random\-cache\-seed\fP: Randomize the GH Actions cache seed to make sure no caches +are used during the build. +.UNINDENT .SS Release Notes .sp You can edit the release notes to highlight a new feature being added @@ -470680,7 +470782,7 @@ _ T{ Log Handler T} T{ -\fBsalt.log.handlers\fP (\fI\%index\fP) +\fBsalt.log_handlers\fP (\fI\%index\fP) T} T{ \fBlog_handlers\fP T} T{ @@ -471596,13 +471698,10 @@ A template factory for extending the salt ecosystem .sp Salt comes with a powerful integration and unit test suite allowing for the fully automated run of integration and/or unit tests from a single -interface. It uses the combination of pytest, nox and \fI\%Kitchen Salt\fP to -run these tests. Nox is used to manage all of the test python dependencies. +interface. It uses the combination of pytest and nox to run these tests. +Nox is used to manage all of the test python dependencies. When you run the test runner with nox, you will be installing the same python dependencies that we use to run our test suite on PRs and branch tests. -\fI\%Kitchen Salt\fP is used to spin up our virtual machines based off of golden -images. These virtual machines use the \fI\%salt\-jenkins\fP sls states to configure -any system dependencies. .sp To learn the basics of how Salt\(aqs test suite works, be sure to check out the \fI\%Salt\(aqs Test Suite: An Introduction\fP @@ -471682,26 +471781,15 @@ nox \-\-list\-sessions For the most part you will only need nox to run the test suite, as this tool will install the exact same python dependencies we use to run on our test runs. The exception to this is when a system dependency is required, for example \fBmysql\fP\&. -These system dependencies are installed with sls states managed in the \fI\%salt\-jenkins\fP +These system dependencies are installed with sls states managed in the \fI\%salt\-ci\-images\fP repo or you can manually install the dependency yourself. .SS System Dependencies .sp -The system dependencies are installed from the \fI\%salt\-jenkins\fP repo. The +The system dependencies are installed from the \fI\%salt\-ci\-images\fP repo. The \fBgolden\-images\-provision\fP state is what is run to determine what dependencies to install on which platform. We run this state only when we want to update our current VM images with new dependencies. -.SS Kitchen Salt -.sp -We also use \fI\%Kitchen Salt\fP to spin up the VM\(aqs used for testing. You can view the -kitchen\-salt \fI\%getting started\fP for instructions on how to install and set it up. -\fI\%Kitchen Salt\fP uses Test Kitchen to spin up the VM or container in the configured -provider. Once the VM is spun up, \fI\%Kitchen Salt\fP can install salt and run a particular -set of states. In the case of our branch and PR tests we create \(dqGolden Images\(dq which -run the \fI\%salt\-jenkins\fP states and install salt system dependencies beforehand. We only -update these \(dqGolden Images\(dq when we need to upgrade or install a system dependency. You can -view the \fI\%kitchen\-salt jenkins setup\fP docs for instructions on how to set up \fI\%Kitchen Salt\fP -similar to the jenkins environment we use to run branch and PR tests. .SS Test Directory Structure .sp Salt\(aqs test suite is located in the \fBtests/\fP directory in the root of @@ -472027,8 +472115,7 @@ the actual testing, such as functions containing assertions, must start with .sp .nf .ft C -def test_user_present(self): - ... +def test_user_present(self): ... .ft P .fi .UNINDENT @@ -472872,37 +472959,6 @@ created directory, options to run the new integration tests must be added to can be found here: \fI\%tests/runtests.py\fP\&. The functions that need to be edited are \fBsetup_additional_options\fP, \fBvalidate_options\fP, and \fBrun_integration_tests\fP\&. -.SS Test Pipeline -.sp -Salt\(aqs test suite is run on \fI\%jenkins\fP\&. We have added the \fB@pytest.mark.slow_test\fP -pytest decorator to help designate tests that take a significant amount of time to -run. These tests are only run on our branch tests, unless your PR is editing code -that requires running a specific slow test. When you submit a PR it will by default, -only run the tests that do not include the \fB@pytest.mark.slow_test\fP pytest decorator. -.SS Process to Fix Test Failures on Branch Tests -.sp -If there is a failure on the branch tests on \fI\%jenkins\fP, this is the process to follow -to ensure it is fixed. -.INDENT 0.0 -.IP \(bu 2 -Review the issues in Salt repo with the label \fBTest\-Failure\fP to ensure there isn\(aqt -an already open issue assigned to someone to fix. -.IP \(bu 2 -If there is not an issue open for the failing test, create a new issue in Salt\(aqs repo -.IP \(bu 2 -Select \(dqTest Failure\(dq and the issue will create the correct template you need. -.IP \(bu 2 -Include the name of the test that is failing in the title -.IP \(bu 2 -Include the jenkins URL to the test in the body and any additional information needed. -.IP \(bu 2 -When you create the issue it will automatically add the label \fBTest\-Failure\fP\&. -.IP \(bu 2 -If you are going to fix the test assign yourself to the issue. -.IP \(bu 2 -If you are not going to fix the test, there is nothing else to do. The core team will -review these open issues and ensure they are assinged out to be fixed. -.UNINDENT .SS Writing Unit Tests .SS Introduction .sp @@ -475969,40 +476025,38 @@ Ensure all required bug fixes are merged. .IP 2. 4 Create release branch with the version of the release. (ex. 3000.1) .IP 3. 4 -Create jenkins jobs that test the new release branch. -.IP 4. 4 Run through a manual test run based off of the head of the branch. -.IP 5. 4 +.IP 4. 4 Generate the new man pages for the release. -.IP 6. 4 +.IP 5. 4 Create internal tag for testing.(ex v3000.1) -.IP 7. 4 +.IP 6. 4 Build all release packages. -.IP 8. 4 +.IP 7. 4 Run manual and package tests against new packages. -.IP 9. 4 +.IP 8. 4 Update installation instructions with new release number at \fI\%repo.saltproject.io\fP\&. -.IP 10. 4 +.IP 9. 4 Update and build docs to include new version. (ex. 3000.1) -.IP 11. 4 +.IP 10. 4 Pre\-announce on salt\-users google groups that we are about to update our repo. -.IP 12. 4 +.IP 11. 4 Push the internal tag live to salt\(aqs repo. -.IP 13. 4 +.IP 12. 4 Publish release archive to pypi based off tag. -.IP 14. 4 +.IP 13. 4 Push the packages live. -.IP 15. 4 +.IP 14. 4 Publish release (v3000) archive to pypi based off tag. -.IP 16. 4 +.IP 15. 4 Publish all packages live to repo. -.IP 17. 4 +.IP 16. 4 Publish the docs. -.IP 18. 4 +.IP 17. 4 Create release at \fI\%github\fP -.IP 19. 4 +.IP 18. 4 Update win\-repo\-ng with new salt versions. -.IP 20. 4 +.IP 19. 4 Announce release is live to irc, salt\-users, salt\-announce and release slack channel. .UNINDENT .SS Salt Coding Style @@ -476400,6 +476454,66 @@ Map aggregation. .INDENT 0.0 .TP .B class salt.utils.aggregation.OrderedDict +Dictionary that remembers insertion order +.INDENT 7.0 +.TP +.B clear() -> None. Remove all items from od. +.UNINDENT +.INDENT 7.0 +.TP +.B copy() -> a shallow copy of od +.UNINDENT +.INDENT 7.0 +.TP +.B fromkeys(value=None) +Create a new ordered dictionary with keys from iterable and values set to value. +.UNINDENT +.INDENT 7.0 +.TP +.B items() -> a set\-like object providing a view on D\(aqs items +.UNINDENT +.INDENT 7.0 +.TP +.B keys() -> a set\-like object providing a view on D\(aqs keys +.UNINDENT +.INDENT 7.0 +.TP +.B move_to_end(key, last=True) +Move an existing element to the end (or beginning if last is false). +.sp +Raise KeyError if the element does not exist. +.UNINDENT +.INDENT 7.0 +.TP +.B pop(key[, default]) -> v, remove specified key and return the corresponding value. +If the key is not found, return the default if given; otherwise, +raise a KeyError. +.UNINDENT +.INDENT 7.0 +.TP +.B popitem(last=True) +Remove and return a (key, value) pair from the dictionary. +.sp +Pairs are returned in LIFO order if last is true or FIFO order if false. +.UNINDENT +.INDENT 7.0 +.TP +.B setdefault(key, default=None) +Insert key with a value of default if key is not in the dictionary. +.sp +Return the value for key if key is in the dictionary, else default. +.UNINDENT +.INDENT 7.0 +.TP +.B update([E], **F) -> None. Update D from dict/iterable E and F. +If E is present and has a .keys() method, then does: for k in E: D[k] = E[k] +If E is present and lacks a .keys() method, then does: for k, v in E: D[k] = v +In either case, this is followed by: for k in F: D[k] = F[k] +.UNINDENT +.INDENT 7.0 +.TP +.B values() -> an object providing a view on D\(aqs values +.UNINDENT .UNINDENT .INDENT 0.0 .TP @@ -478467,6 +478581,126 @@ In the process, we were also required to update to \fBpyOpenSSL==24.0.0\fP \fI\% .IP \(bu 2 Bump to \fBcryptography==42.0.3\fP due to \fI\%https://github.com/advisories/GHSA\-3ww4\-gg4f\-jr7f\fP \fI\%#66090\fP .UNINDENT +(release\-3006.8)= +.SS Salt 3006.8 release notes +.SS Changelog +.SS Removed +.INDENT 0.0 +.IP \(bu 2 +Removed deprecated code scheduled to be removed on 2024\-01\-01: +.INDENT 2.0 +.IP \(bu 2 +\fBTemporaryLoggingHandler\fP and \fBQueueHandler\fP in \fBsalt/_logging/handlers.py\fP +.IP \(bu 2 +All of the \fBsalt/log\fP package. +.IP \(bu 2 +The \fBsalt/modules/cassandra_mod.py\fP module. +.IP \(bu 2 +The \fBsalt/returners/cassandra_return.py\fP returner. +.IP \(bu 2 +The \fBsalt/returners/django_return.py\fP returner. \fI\%#66147\fP +.UNINDENT +.UNINDENT +.SS Deprecated +.INDENT 0.0 +.IP \(bu 2 +Drop Fedora 37 and Fedora 38 support \fI\%#65860\fP +.IP \(bu 2 +Drop CentOS Stream 8 and 9 from CI/CD \fI\%#66104\fP +.IP \(bu 2 +Drop Photon OS 3 support \fI\%#66105\fP +.IP \(bu 2 +The \fBsalt.utils.psutil_compat\fP module has been deprecated and will be removed in Salt 3008. Please use the \fBpsutil\fP module directly. \fI\%#66139\fP +.UNINDENT +.SS Fixed +.INDENT 0.0 +.IP \(bu 2 +\fBuser.add\fP on Windows now allows you to add user names that contain all +numeric characters \fI\%#53363\fP +.IP \(bu 2 +Fix an issue with the win_system module detecting established connections on +non\-Windows systems. Uses psutils instead of parsing the return of netstat \fI\%#60508\fP +.IP \(bu 2 +pkg.refresh_db on Windows now honors saltenv \fI\%#61807\fP +.IP \(bu 2 +Fixed an issue with adding new machine policies and applying those same +policies in the same state by adding a \fBrefresh_cache\fP option to the +\fBlgpo.set\fP state. \fI\%#62734\fP +.IP \(bu 2 +file.managed correctly handles file path with \(aq#\(aq \fI\%#63060\fP +.IP \(bu 2 +Fix master ip detection when DNS records change \fI\%#63654\fP +.IP \(bu 2 +Fix user and group management on Windows to handle the Everyone group \fI\%#63667\fP +.IP \(bu 2 +Fixes an issue in pkg.refresh_db on Windows where new package definition +files were not being picked up on the first run \fI\%#63848\fP +.IP \(bu 2 +Display a proper error when pki commands fail in the win_pki module \fI\%#64933\fP +.IP \(bu 2 +Prevent full system upgrade on single package install for Arch Linux \fI\%#65200\fP +.IP \(bu 2 +When using s3fs, if files are deleted from the bucket, they were not deleted in +the master or minion local cache, which could lead to unexpected file copies or +even state applications. This change makes the local cache consistent with the +remote bucket by deleting files locally that are deleted from the bucket. +.sp +\fBNOTE\fP this could lead to \fBbreakage\fP on your affected systems if it was +inadvertently depending on previously deleted files. \fI\%#65611\fP +.IP \(bu 2 +Fixed an issue with file.directory state where paths would be modified in test +mode if backupname is used. \fI\%#66049\fP +.IP \(bu 2 +Execution modules have access to regular fileclient durring pillar rendering. \fI\%#66124\fP +.IP \(bu 2 +Fixed a issue with server channel where a minion\(aqs public key +would be rejected if it contained a final newline character. \fI\%#66126\fP +.IP \(bu 2 +Fix content type backwards compatablity with http proxy post requests in the http utils module. \fI\%#66127\fP +.IP \(bu 2 +Fix systemctl with \(dqtry\-restart\(dq instead of \(dqretry\-restart\(dq within the RPM spec, properly restarting upgraded services \fI\%#66143\fP +.IP \(bu 2 +Auto discovery of ssh, scp and ssh\-keygen binaries. \fI\%#66205\fP +.IP \(bu 2 +Add leading slash to salt helper file paths as per dh_links requirement \fI\%#66280\fP +.IP \(bu 2 +Fixed x509.certificate_managed \- ca_server did not return a certificate \fI\%#66284\fP +.IP \(bu 2 +removed log line that did nothing. \fI\%#66289\fP +.IP \(bu 2 +Chocolatey: Make sure the return dictionary from \fBchocolatey.version\fP +contains lowercase keys \fI\%#66290\fP +.IP \(bu 2 +fix cacheing inline pillar, by not rendering inline pillar during cache save function. \fI\%#66292\fP +.IP \(bu 2 +The file module correctly perserves file permissions on link target. \fI\%#66400\fP +.IP \(bu 2 +Upgrade relenv to 0.16.0 and python to 3.10.14 \fI\%#66402\fP +.IP \(bu 2 +backport the fix from #66164 to fix #65703. use OrderedDict to fix bad indexing. \fI\%#66705\fP +.UNINDENT +.SS Added +.INDENT 0.0 +.IP \(bu 2 +Add Fedora 39 support \fI\%#65859\fP +.UNINDENT +.SS Security +.INDENT 0.0 +.IP \(bu 2 +Upgrade to \fBcryptography==42.0.5\fP due to a few security issues: +.INDENT 2.0 +.IP \(bu 2 +\fI\%https://github.com/advisories/GHSA\-9v9h\-cgj8\-h64p\fP +.IP \(bu 2 +\fI\%https://github.com/advisories/GHSA\-3ww4\-gg4f\-jr7f\fP +.IP \(bu 2 +\fI\%https://github.com/advisories/GHSA\-6vqw\-3v5j\-54x4\fP \fI\%#66141\fP +.UNINDENT +.IP \(bu 2 +Bump to \fBidna==3.7\fP due to \fI\%https://github.com/advisories/GHSA\-jjg7\-2v4v\-x38h\fP \fI\%#66377\fP +.IP \(bu 2 +Bump to \fBaiohttp==3.9.4\fP due to \fI\%https://github.com/advisories/GHSA\-7gpw\-8wmc\-pm8g\fP \fI\%#66411\fP +.UNINDENT .sp See \fI\%Install a release candidate\fP for more information about installing an RC when one is available. @@ -531770,8 +532004,7 @@ environment setting is with a variable called \fBsaltenv\fP: .sp .nf .ft C -def fcn(msg=\(dq\(dq, env=\(dqbase\(dq, refresh=True, saltenv=\(dqbase\(dq, **kwargs): - ... +def fcn(msg=\(dq\(dq, env=\(dqbase\(dq, refresh=True, saltenv=\(dqbase\(dq, **kwargs): ... .ft P .fi .UNINDENT @@ -531783,8 +532016,7 @@ has been changed to .sp .nf .ft C -def fcn(msg=\(dq\(dq, refresh=True, saltenv=\(dqbase\(dq, **kwargs): - ... +def fcn(msg=\(dq\(dq, refresh=True, saltenv=\(dqbase\(dq, **kwargs): ... .ft P .fi .UNINDENT @@ -531800,8 +532032,7 @@ removed in Salt 2017.7.0. .sp .nf .ft C -def fcn(msg=\(dq\(dq, refresh=True, saltenv=\(dqbase\(dq, **kwargs): - ... +def fcn(msg=\(dq\(dq, refresh=True, saltenv=\(dqbase\(dq, **kwargs): ... .ft P .fi .UNINDENT @@ -531826,8 +532057,7 @@ error. .sp .nf .ft C -def fcn(msg=\(dq\(dq, refresh=True, saltenv=\(dqbase\(dq): - ... +def fcn(msg=\(dq\(dq, refresh=True, saltenv=\(dqbase\(dq): ... .ft P .fi .UNINDENT @@ -531853,8 +532083,7 @@ signature. .sp .nf .ft C -def fcn(msg=\(dq\(dq, refresh=True, saltenv=\(dqbase\(dq): - ... +def fcn(msg=\(dq\(dq, refresh=True, saltenv=\(dqbase\(dq): ... .ft P .fi .UNINDENT @@ -602075,7 +602304,7 @@ The mysql_user state enables mysql user management. The virtualenv state can manage the state of Python virtual environments. Thanks to Whitinge for the virtualenv state .SS New Returners -.SS \fI\%cassandra_returner\fP +.SS \fBcassandra_returner\fP .sp A returner allowing Salt to send data to a cassandra server. Thanks to Byron Clark for contributing this returner diff --git a/doc/man/spm.1 b/doc/man/spm.1 index f9be92b6be5..38440ca7407 100644 --- a/doc/man/spm.1 +++ b/doc/man/spm.1 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SPM" "1" "Generated on February 20, 2024 at 09:55:17 PM UTC." "3006.7" "Salt" +.TH "SPM" "1" "Generated on April 29, 2024 at 03:20:12 AM UTC." "3006.8" "Salt" .SH NAME spm \- Salt Package Manager Command .sp diff --git a/doc/topics/releases/3006.8.md b/doc/topics/releases/3006.8.md new file mode 100644 index 00000000000..da2b75bab67 --- /dev/null +++ b/doc/topics/releases/3006.8.md @@ -0,0 +1,96 @@ +(release-3006.8)= +# Salt 3006.8 release notes + + + + + + + +## Changelog + +### Removed + +- Removed deprecated code scheduled to be removed on 2024-01-01: + + * ``TemporaryLoggingHandler`` and ``QueueHandler`` in ``salt/_logging/handlers.py`` + * All of the ``salt/log`` package. + * The ``salt/modules/cassandra_mod.py`` module. + * The ``salt/returners/cassandra_return.py`` returner. + * The ``salt/returners/django_return.py`` returner. [#66147](https://github.com/saltstack/salt/issues/66147) + + +### Deprecated + +- Drop Fedora 37 and Fedora 38 support [#65860](https://github.com/saltstack/salt/issues/65860) +- Drop CentOS Stream 8 and 9 from CI/CD [#66104](https://github.com/saltstack/salt/issues/66104) +- Drop Photon OS 3 support [#66105](https://github.com/saltstack/salt/issues/66105) +- The ``salt.utils.psutil_compat`` module has been deprecated and will be removed in Salt 3008. Please use the ``psutil`` module directly. [#66139](https://github.com/saltstack/salt/issues/66139) + + +### Fixed + +- ``user.add`` on Windows now allows you to add user names that contain all + numeric characters [#53363](https://github.com/saltstack/salt/issues/53363) +- Fix an issue with the win_system module detecting established connections on + non-Windows systems. Uses psutils instead of parsing the return of netstat [#60508](https://github.com/saltstack/salt/issues/60508) +- pkg.refresh_db on Windows now honors saltenv [#61807](https://github.com/saltstack/salt/issues/61807) +- Fixed an issue with adding new machine policies and applying those same + policies in the same state by adding a ``refresh_cache`` option to the + ``lgpo.set`` state. [#62734](https://github.com/saltstack/salt/issues/62734) +- file.managed correctly handles file path with '#' [#63060](https://github.com/saltstack/salt/issues/63060) +- Fix master ip detection when DNS records change [#63654](https://github.com/saltstack/salt/issues/63654) +- Fix user and group management on Windows to handle the Everyone group [#63667](https://github.com/saltstack/salt/issues/63667) +- Fixes an issue in pkg.refresh_db on Windows where new package definition + files were not being picked up on the first run [#63848](https://github.com/saltstack/salt/issues/63848) +- Display a proper error when pki commands fail in the win_pki module [#64933](https://github.com/saltstack/salt/issues/64933) +- Prevent full system upgrade on single package install for Arch Linux [#65200](https://github.com/saltstack/salt/issues/65200) +- When using s3fs, if files are deleted from the bucket, they were not deleted in + the master or minion local cache, which could lead to unexpected file copies or + even state applications. This change makes the local cache consistent with the + remote bucket by deleting files locally that are deleted from the bucket. + + **NOTE** this could lead to **breakage** on your affected systems if it was + inadvertently depending on previously deleted files. [#65611](https://github.com/saltstack/salt/issues/65611) +- Fixed an issue with file.directory state where paths would be modified in test + mode if backupname is used. [#66049](https://github.com/saltstack/salt/issues/66049) +- Execution modules have access to regular fileclient durring pillar rendering. [#66124](https://github.com/saltstack/salt/issues/66124) +- Fixed a issue with server channel where a minion's public key + would be rejected if it contained a final newline character. [#66126](https://github.com/saltstack/salt/issues/66126) +- Fix content type backwards compatablity with http proxy post requests in the http utils module. [#66127](https://github.com/saltstack/salt/issues/66127) +- Fix systemctl with "try-restart" instead of "retry-restart" within the RPM spec, properly restarting upgraded services [#66143](https://github.com/saltstack/salt/issues/66143) +- Auto discovery of ssh, scp and ssh-keygen binaries. [#66205](https://github.com/saltstack/salt/issues/66205) +- Add leading slash to salt helper file paths as per dh_links requirement [#66280](https://github.com/saltstack/salt/issues/66280) +- Fixed x509.certificate_managed - ca_server did not return a certificate [#66284](https://github.com/saltstack/salt/issues/66284) +- removed log line that did nothing. [#66289](https://github.com/saltstack/salt/issues/66289) +- Chocolatey: Make sure the return dictionary from ``chocolatey.version`` + contains lowercase keys [#66290](https://github.com/saltstack/salt/issues/66290) +- fix cacheing inline pillar, by not rendering inline pillar during cache save function. [#66292](https://github.com/saltstack/salt/issues/66292) +- The file module correctly perserves file permissions on link target. [#66400](https://github.com/saltstack/salt/issues/66400) +- Upgrade relenv to 0.16.0 and python to 3.10.14 [#66402](https://github.com/saltstack/salt/issues/66402) +- backport the fix from #66164 to fix #65703. use OrderedDict to fix bad indexing. [#66705](https://github.com/saltstack/salt/issues/66705) + + +### Added + +- Add Fedora 39 support [#65859](https://github.com/saltstack/salt/issues/65859) + + +### Security + +- Upgrade to `cryptography==42.0.5` due to a few security issues: + + * https://github.com/advisories/GHSA-9v9h-cgj8-h64p + * https://github.com/advisories/GHSA-3ww4-gg4f-jr7f + * https://github.com/advisories/GHSA-6vqw-3v5j-54x4 [#66141](https://github.com/saltstack/salt/issues/66141) +- Bump to `idna==3.7` due to https://github.com/advisories/GHSA-jjg7-2v4v-x38h [#66377](https://github.com/saltstack/salt/issues/66377) +- Bump to `aiohttp==3.9.4` due to https://github.com/advisories/GHSA-7gpw-8wmc-pm8g [#66411](https://github.com/saltstack/salt/issues/66411) diff --git a/doc/topics/releases/templates/3006.8.md.template b/doc/topics/releases/templates/3006.8.md.template new file mode 100644 index 00000000000..599a7d0cb2d --- /dev/null +++ b/doc/topics/releases/templates/3006.8.md.template @@ -0,0 +1,14 @@ +(release-3006.8)= +# Salt 3006.8 release notes{{ unreleased }} +{{ warning }} + + + + +## Changelog +{{ changelog }} diff --git a/pkg/debian/changelog b/pkg/debian/changelog index 0ba69f84d07..0dddaac68ec 100644 --- a/pkg/debian/changelog +++ b/pkg/debian/changelog @@ -1,3 +1,82 @@ +salt (3006.8) stable; urgency=medium + + + # Removed + + * Removed deprecated code scheduled to be removed on 2024-01-01: + + * ``TemporaryLoggingHandler`` and ``QueueHandler`` in ``salt/_logging/handlers.py`` + * All of the ``salt/log`` package. + * The ``salt/modules/cassandra_mod.py`` module. + * The ``salt/returners/cassandra_return.py`` returner. + * The ``salt/returners/django_return.py`` returner. [#66147](https://github.com/saltstack/salt/issues/66147) + + # Deprecated + + * Drop Fedora 37 and Fedora 38 support [#65860](https://github.com/saltstack/salt/issues/65860) + * Drop CentOS Stream 8 and 9 from CI/CD [#66104](https://github.com/saltstack/salt/issues/66104) + * Drop Photon OS 3 support [#66105](https://github.com/saltstack/salt/issues/66105) + * The ``salt.utils.psutil_compat`` module has been deprecated and will be removed in Salt 3008. Please use the ``psutil`` module directly. [#66139](https://github.com/saltstack/salt/issues/66139) + + # Fixed + + * ``user.add`` on Windows now allows you to add user names that contain all + numeric characters [#53363](https://github.com/saltstack/salt/issues/53363) + * Fix an issue with the win_system module detecting established connections on + non*Windows systems. Uses psutils instead of parsing the return of netstat [#60508](https://github.com/saltstack/salt/issues/60508) + * pkg.refresh_db on Windows now honors saltenv [#61807](https://github.com/saltstack/salt/issues/61807) + * Fixed an issue with adding new machine policies and applying those same + policies in the same state by adding a ``refresh_cache`` option to the + ``lgpo.set`` state. [#62734](https://github.com/saltstack/salt/issues/62734) + * file.managed correctly handles file path with '#' [#63060](https://github.com/saltstack/salt/issues/63060) + * Fix master ip detection when DNS records change [#63654](https://github.com/saltstack/salt/issues/63654) + * Fix user and group management on Windows to handle the Everyone group [#63667](https://github.com/saltstack/salt/issues/63667) + * Fixes an issue in pkg.refresh_db on Windows where new package definition + files were not being picked up on the first run [#63848](https://github.com/saltstack/salt/issues/63848) + * Display a proper error when pki commands fail in the win_pki module [#64933](https://github.com/saltstack/salt/issues/64933) + * Prevent full system upgrade on single package install for Arch Linux [#65200](https://github.com/saltstack/salt/issues/65200) + * When using s3fs, if files are deleted from the bucket, they were not deleted in + the master or minion local cache, which could lead to unexpected file copies or + even state applications. This change makes the local cache consistent with the + remote bucket by deleting files locally that are deleted from the bucket. + + **NOTE** this could lead to **breakage** on your affected systems if it was + inadvertently depending on previously deleted files. [#65611](https://github.com/saltstack/salt/issues/65611) + * Fixed an issue with file.directory state where paths would be modified in test + mode if backupname is used. [#66049](https://github.com/saltstack/salt/issues/66049) + * Execution modules have access to regular fileclient durring pillar rendering. [#66124](https://github.com/saltstack/salt/issues/66124) + * Fixed a issue with server channel where a minion's public key + would be rejected if it contained a final newline character. [#66126](https://github.com/saltstack/salt/issues/66126) + * Fix content type backwards compatablity with http proxy post requests in the http utils module. [#66127](https://github.com/saltstack/salt/issues/66127) + * Fix systemctl with "try-restart" instead of "retry-restart" within the RPM spec, properly restarting upgraded services [#66143](https://github.com/saltstack/salt/issues/66143) + * Auto discovery of ssh, scp and ssh-keygen binaries. [#66205](https://github.com/saltstack/salt/issues/66205) + * Add leading slash to salt helper file paths as per dh_links requirement [#66280](https://github.com/saltstack/salt/issues/66280) + * Fixed x509.certificate_managed - ca_server did not return a certificate [#66284](https://github.com/saltstack/salt/issues/66284) + * removed log line that did nothing. [#66289](https://github.com/saltstack/salt/issues/66289) + * Chocolatey: Make sure the return dictionary from ``chocolatey.version`` + contains lowercase keys [#66290](https://github.com/saltstack/salt/issues/66290) + * fix cacheing inline pillar, by not rendering inline pillar during cache save function. [#66292](https://github.com/saltstack/salt/issues/66292) + * The file module correctly perserves file permissions on link target. [#66400](https://github.com/saltstack/salt/issues/66400) + * Upgrade relenv to 0.16.0 and python to 3.10.14 [#66402](https://github.com/saltstack/salt/issues/66402) + * backport the fix from #66164 to fix #65703. use OrderedDict to fix bad indexing. [#66705](https://github.com/saltstack/salt/issues/66705) + + # Added + + * Add Fedora 39 support [#65859](https://github.com/saltstack/salt/issues/65859) + + # Security + + * Upgrade to `cryptography==42.0.5` due to a few security issues: + + * https://github.com/advisories/GHSA*9v9h-cgj8-h64p + * https://github.com/advisories/GHSA*3ww4-gg4f-jr7f + * https://github.com/advisories/GHSA*6vqw-3v5j-54x4 [#66141](https://github.com/saltstack/salt/issues/66141) + * Bump to `idna==3.7` due to https://github.com/advisories/GHSA-jjg7-2v4v-x38h [#66377](https://github.com/saltstack/salt/issues/66377) + * Bump to `aiohttp==3.9.4` due to https://github.com/advisories/GHSA-7gpw-8wmc-pm8g [#66411](https://github.com/saltstack/salt/issues/66411) + + + -- Salt Project Packaging Mon, 29 Apr 2024 03:18:46 +0000 + salt (3006.7) stable; urgency=medium diff --git a/pkg/rpm/salt.spec b/pkg/rpm/salt.spec index acbf360872e..b9f9577d826 100644 --- a/pkg/rpm/salt.spec +++ b/pkg/rpm/salt.spec @@ -31,7 +31,7 @@ %define fish_dir %{_datadir}/fish/vendor_functions.d Name: salt -Version: 3006.7 +Version: 3006.8 Release: 0 Summary: A parallel remote execution system Group: System Environment/Daemons @@ -646,6 +646,82 @@ if [ $1 -ge 1 ] ; then fi %changelog +* Mon Apr 29 2024 Salt Project Packaging - 3006.8 + +# Removed + +- Removed deprecated code scheduled to be removed on 2024-01-01: + + * ``TemporaryLoggingHandler`` and ``QueueHandler`` in ``salt/_logging/handlers.py`` + * All of the ``salt/log`` package. + * The ``salt/modules/cassandra_mod.py`` module. + * The ``salt/returners/cassandra_return.py`` returner. + * The ``salt/returners/django_return.py`` returner. [#66147](https://github.com/saltstack/salt/issues/66147) + +# Deprecated + +- Drop Fedora 37 and Fedora 38 support [#65860](https://github.com/saltstack/salt/issues/65860) +- Drop CentOS Stream 8 and 9 from CI/CD [#66104](https://github.com/saltstack/salt/issues/66104) +- Drop Photon OS 3 support [#66105](https://github.com/saltstack/salt/issues/66105) +- The ``salt.utils.psutil_compat`` module has been deprecated and will be removed in Salt 3008. Please use the ``psutil`` module directly. [#66139](https://github.com/saltstack/salt/issues/66139) + +# Fixed + +- ``user.add`` on Windows now allows you to add user names that contain all + numeric characters [#53363](https://github.com/saltstack/salt/issues/53363) +- Fix an issue with the win_system module detecting established connections on + non-Windows systems. Uses psutils instead of parsing the return of netstat [#60508](https://github.com/saltstack/salt/issues/60508) +- pkg.refresh_db on Windows now honors saltenv [#61807](https://github.com/saltstack/salt/issues/61807) +- Fixed an issue with adding new machine policies and applying those same + policies in the same state by adding a ``refresh_cache`` option to the + ``lgpo.set`` state. [#62734](https://github.com/saltstack/salt/issues/62734) +- file.managed correctly handles file path with '#' [#63060](https://github.com/saltstack/salt/issues/63060) +- Fix master ip detection when DNS records change [#63654](https://github.com/saltstack/salt/issues/63654) +- Fix user and group management on Windows to handle the Everyone group [#63667](https://github.com/saltstack/salt/issues/63667) +- Fixes an issue in pkg.refresh_db on Windows where new package definition + files were not being picked up on the first run [#63848](https://github.com/saltstack/salt/issues/63848) +- Display a proper error when pki commands fail in the win_pki module [#64933](https://github.com/saltstack/salt/issues/64933) +- Prevent full system upgrade on single package install for Arch Linux [#65200](https://github.com/saltstack/salt/issues/65200) +- When using s3fs, if files are deleted from the bucket, they were not deleted in + the master or minion local cache, which could lead to unexpected file copies or + even state applications. This change makes the local cache consistent with the + remote bucket by deleting files locally that are deleted from the bucket. + + **NOTE** this could lead to **breakage** on your affected systems if it was + inadvertently depending on previously deleted files. [#65611](https://github.com/saltstack/salt/issues/65611) +- Fixed an issue with file.directory state where paths would be modified in test + mode if backupname is used. [#66049](https://github.com/saltstack/salt/issues/66049) +- Execution modules have access to regular fileclient durring pillar rendering. [#66124](https://github.com/saltstack/salt/issues/66124) +- Fixed a issue with server channel where a minion's public key + would be rejected if it contained a final newline character. [#66126](https://github.com/saltstack/salt/issues/66126) +- Fix content type backwards compatablity with http proxy post requests in the http utils module. [#66127](https://github.com/saltstack/salt/issues/66127) +- Fix systemctl with "try-restart" instead of "retry-restart" within the RPM spec, properly restarting upgraded services [#66143](https://github.com/saltstack/salt/issues/66143) +- Auto discovery of ssh, scp and ssh-keygen binaries. [#66205](https://github.com/saltstack/salt/issues/66205) +- Add leading slash to salt helper file paths as per dh_links requirement [#66280](https://github.com/saltstack/salt/issues/66280) +- Fixed x509.certificate_managed - ca_server did not return a certificate [#66284](https://github.com/saltstack/salt/issues/66284) +- removed log line that did nothing. [#66289](https://github.com/saltstack/salt/issues/66289) +- Chocolatey: Make sure the return dictionary from ``chocolatey.version`` + contains lowercase keys [#66290](https://github.com/saltstack/salt/issues/66290) +- fix cacheing inline pillar, by not rendering inline pillar during cache save function. [#66292](https://github.com/saltstack/salt/issues/66292) +- The file module correctly perserves file permissions on link target. [#66400](https://github.com/saltstack/salt/issues/66400) +- Upgrade relenv to 0.16.0 and python to 3.10.14 [#66402](https://github.com/saltstack/salt/issues/66402) +- backport the fix from #66164 to fix #65703. use OrderedDict to fix bad indexing. [#66705](https://github.com/saltstack/salt/issues/66705) + +# Added + +- Add Fedora 39 support [#65859](https://github.com/saltstack/salt/issues/65859) + +# Security + +- Upgrade to `cryptography==42.0.5` due to a few security issues: + + * https://github.com/advisories/GHSA-9v9h-cgj8-h64p + * https://github.com/advisories/GHSA-3ww4-gg4f-jr7f + * https://github.com/advisories/GHSA-6vqw-3v5j-54x4 [#66141](https://github.com/saltstack/salt/issues/66141) +- Bump to `idna==3.7` due to https://github.com/advisories/GHSA-jjg7-2v4v-x38h [#66377](https://github.com/saltstack/salt/issues/66377) +- Bump to `aiohttp==3.9.4` due to https://github.com/advisories/GHSA-7gpw-8wmc-pm8g [#66411](https://github.com/saltstack/salt/issues/66411) + + * Tue Feb 20 2024 Salt Project Packaging - 3006.7 # Deprecated