Salt Install Guide Overhaul and salt-bootstrap updates

This is a continuation of several blog post announcements related to infrastructure migration:

• Salt Project Blog - Upcoming Salt Project Docs and Repo Migrations
• Salt Project Blog - Salt Project Package Repository (repo.saltproject.io) Migration and Guidance
• Salt Project Blog - salt-bootstrap Breakage and Next Steps: New Updates

Salt Install Guide

The Salt Install Guide has had a gigantic overhaul in order to accurately work with packages.broadcom.com hosted Salt repositories, including quite a bit of simplification:

• There are no longer multiple versions of the Salt Install Guide: directions for each operating system include tabs or tables for LTS and STS installations.
• Linux directions have been reduced down to two types: RPM (RHEL-like systems) and DEB (Debian-like systems). We’re able to do this because of onedir (via relenv), and how we’ve been merely duplicating a single .deb and .rpm across many repositories rather than having custom packages per target operating system.
• For pinning to major versions, or even specific minor point release versions, we now depend on built-in package manager configurations rather than providing a large collection of isolated repositories.

NOTE: The install guide does still have areas of it that need updates, that have TBD placeholders, and salt-bootstrap is currently non-functional (see below). For issues discovered in the Salt Install Guide, open issues in the Salt Install Guide source repo and post in the #documentation channel of the Salt Project Community Discord.

salt-bootstrap

Though salt-bootstrap scripts expect to be downloaded from a new location now, the script itself no longer works as current releases don’t support the new packages.broadcom.com repository.

A dedicated issue has been created and assigned for fixing these issues:

• salt-bootstrap scripts broken: Need a new release to work with packages.broadcom.com repos

We apologize for any inconvenience this may cause and appreciate your patience as we work to improve your Salt Project experience.

– Salt Project Team