Notices: This section not yet converted to new layout. Download stats are rolling back out.

This is not the latest version of Salt Minion available.

Salt Minion

2016.11.1

Package test results are passing.

This package was approved by moderator flcdrg on 2/4/2017.

This package installs a salt minion on your system as a windows service. The Salt minion receives commands from the central Salt master and replies with the results of said commands. It can also be used in standalone mode to apply states to a machine without a master by using C:\salt\salt-call.bat --local state.sls [yoursls] or similar commands with --local.
Note that this package supports two arguments: /master=yoursaltmaster and /minion=yourminionname (note the installer itself uses /minion-name, but parsing dictionary keys with the - is painful).
These arguments can be passed to the package via the --params '/master=yoursaltmaster'. The custom salt master is recommended in most environments, the minion name is optional will default to the hostname if not supplied.

To install Salt Minion, run the following command from the command line or from PowerShell:

C:\> choco install saltminion --version 2016.11.1

To upgrade Salt Minion, run the following command from the command line or from PowerShell:

C:\> choco upgrade saltminion --version 2016.11.1

Files

Hide
  • tools\chocolateyBeforeModify.ps1 Show
    # Need to keep a copy of the C:\salt\conf\minion and minion.d files in case the user is upgrading and wants to persist their existing settings.
    $chocoBackup =  '$env:ProgramData\chocolatey\lib-bkp\saltconfig'
    $saltConfig = 'C:\salt\conf\'
    # Items to keep around, 'pki' is "identity", 'minion[_id]' is settings and ID, 'minion.d' is additional settings
    #if (Test-Path $saltConfig ) { copy-item $saltConfig $chocoBackup -recurse }
    # In chocolateyInstall.ps1 will need to look for a previous backup and restore files either before install or after upgrade (only IF the master & minion ID match?)
    # if (Test-Path $chocoBackup) { copy-item $chocoBackup $saltConfig -recurse }
    # Maybe do the backup via another package that simply assumes C:\salt\conf and performs the backup? but reverse-depends don't work here
    # In chocolateyUninstall.ps1 will need to remove $chocoBackup if it exists but only if doing a real uninstall and not an upgrade
    
  • tools\chocolateyInstall.ps1 Show
    $packageName = 'saltminion'
    
    # Update these URLs and checksums when deploying a new version
    $url = 'https://repo.saltstack.com/windows/Salt-Minion-2016.11.1-x86-Setup.exe'
    $checksum = 'c2e29c95320974b900d9dfa42754e29c'
    $url64 = 'https://repo.saltstack.com/windows/Salt-Minion-2016.11.1-AMD64-Setup.exe'
    $checksum64 = 'f51f5ea3a7aa6cf03bfecac603b7ebe9'
    
    # Get arguments to download the file from the URLs and checksums above
    $packageArgs = @{
      packageName   = $packageName
      fileType      = 'exe'
      url           = $url
      url64bit      = $url64
      silentArgs    = "/S"
      softwareName  = 'Salt*'
      checksum      = $checksum
      checksumType  = 'md5'
      checksum64    = $checksum64
      checksumType64= 'md5'
    }
    
    $arguments = @{};
    # /master=myMaster /minion=myMinion
    $packageParameters = $env:chocolateyPackageParameters;
    $packageParameters
    # Default the values
    $saltMaster = ''
    $minionName = ''
    
    # Now parse the packageParameters using good old regular expression
    if ($packageParameters) {
        $match_pattern = "\/(?<option>([a-zA-Z]+))=(?<value>([`"'])?([a-zA-Z0-9- _\\:\.]+)([`"'])?)|\/(?<option>([a-zA-Z]+))"
        #"
        $option_name = 'option'
        $value_name = 'value'
    
        if ($packageParameters -match $match_pattern ){
            $results = $packageParameters | Select-String $match_pattern -AllMatches
            $results.matches | % {
              $arguments.Add(
                  $_.Groups[$option_name].Value.Trim(),
                  $_.Groups[$value_name].Value.Trim())
          }
        }
        else
        {
          throw "Package Parameters were found but were invalid (REGEX Failure)"
        }
    
        if ($arguments.ContainsKey("master")) {
            Write-Host "You specified a custom master address"
            $saltMaster = $arguments['master']
            $packageArgs['silentArgs'] += " /master=$saltMaster"
        }
    
        if ($arguments.ContainsKey("minion")) {
            Write-Host "You specified a custom minion ID"
            $minionName = $arguments['minion']
            $packageArgs['silentArgs'] += " /minion-name=$minionName"
        }
    } else {
        Write-Debug "No Package Parameters Passed in, using defaults of /master=salt and /minion=$env:COMPUTERNAME"
    }
    install-ChocolateyPackage @packageArgs
    
    
  • tools\chocolateyUninstall.ps1 Show
    # By default, salt installs in c:\salt This package will attempt to call the uninstall executable from there. 
    C:\salt\uninst.exe /S

Virus Scan Results

In cases where actual malware is found, the packages are subject to removal. Software sometimes has false positives. Moderators do not necessarily validate the safety of the underlying software, only that a package retrieves software from the official distribution point and/or validate embedded software against official distribution point (where distribution rights allow redistribution).

Chocolatey Pro provides runtime protection from possible malware.

Dependencies

Maintainer(s)

Software Author(s)

  • SaltStack

Tags

Release Notes

  • Supports /master and /minion parameters

    • Updated to latest version

    • Installer waits for the service to finish registering

Version History

Version Downloads Last updated Status
Salt Minion 2017.7.1 666 Tuesday, August 15, 2017 approved
Salt Minion 2017.7.0 302 Wednesday, July 26, 2017 approved
Salt Minion 2016.11.6 808 Wednesday, June 28, 2017 approved
Salt Minion 2016.11.5 617 Friday, May 19, 2017 approved
Salt Minion 2016.11.4 480 Thursday, April 27, 2017 approved
Salt Minion 2016.11.3 426 Wednesday, March 1, 2017 approved
Salt Minion 2016.11.2 333 Tuesday, January 31, 2017 approved
Salt Minion 2016.11.1 58 Sunday, January 29, 2017 approved
Salt Minion 2016.3.4 275 Wednesday, December 21, 2016 approved
Show More

Discussion for the Salt Minion Package

Ground rules:

  • This discussion is only about Salt Minion and the Salt Minion package. If you have feedback for Chocolatey, please contact the google group.
  • This discussion will carry over multiple versions. If you have a comment about a particular version, please note that in your comments.
  • The maintainers of this Chocolatey Package will be notified about new comments that are posted to this Disqus thread, however, it is NOT a guarantee that you will get a response. If you do not hear back from the maintainers after posting a message below, please follow up by using the link on the left side of this page or follow this link to contact maintainers. If you still hear nothing back, please follow the package triage process.
  • Tell us what you love about the package or Salt Minion, or tell us what needs improvement.
  • Share your experiences with the package, or extra configuration or gotchas that you've found.
  • If you use a url, the comment will be flagged for moderation until you've been whitelisted. Disqus moderated comments are approved on a weekly schedule if not sooner. It could take between 1-5 days for your comment to show up.

comments powered by Disqus