Manage Chocolatey package installs .. versionadded:: 2016.3.0
Note
Chocolatey pulls data from the Chocolatey internet database to determine current versions, find available versions, etc. This is normally a slow operation and may be optimized by specifying a local, smaller chocolatey repo.
salt.states.chocolatey.
installed
(name, version=None, source=None, force=False, pre_versions=False, install_args=None, override_args=False, force_x86=False, package_args=None, allow_multiple=False, execution_timeout=None)¶Installs a package if not already installed
name (str) -- The name of the package to be installed. Required.
version (str) -- Install a specific version of the package. Defaults to latest version. If the version is different to the one installed then the specified version will be installed. Default is None.
source (str) -- Chocolatey repository (directory, share or remote URL, feed). Defaults to the official Chocolatey feed. Default is None.
force (bool) -- Reinstall the current version of an existing package. Do not use
with allow_multiple
. Default is False.
pre_versions (bool) -- Include pre-release packages. Default is False.
install_args (str) -- Install arguments you want to pass to the installation process, i.e product key or feature list. Default is None.
override_args (bool) -- Set to True if you want to override the original install arguments (for the native installer) in the package and use your own. When this is set to False install_args will be appended to the end of the default arguments. Default is False.
force_x86 (bool) -- Force x86 (32bit) installation on 64 bit systems. Default is False.
package_args (str) -- Arguments you want to pass to the package. Default is None.
allow_multiple (bool) --
Allow mulitiple versions of the package to be installed. Do not use
with force
. Does not work with all packages. Default is False.
New in version 2017.7.0.
execution_timeout (str) -- Chocolatey execution timeout value you want to pass to the installation process. Default is None.
Installsomepackage:
chocolatey.installed:
- name: packagename
- version: '12.04'
- source: 'mychocolatey/source'
- force: True
salt.states.chocolatey.
source_present
(name, source_location, username=None, password=None, force=False, priority=None)¶Instructs Chocolatey to add a source if not already present.
The name of the source to be added as a chocolatey repository.
Location of the source you want to work with.
Provide username for chocolatey sources that need authentication credentials.
Provide password for chocolatey sources that need authentication credentials.
Salt will not modify a existing repository with the same name. Set this option to true to update an existing repository.
The priority order of this source as compared to other sources, lower is better. Defaults to 0 (no priority). All priorities above 0 will be evaluated first, then zero-based values will be evaluated in config file order.
CLI Example:
add_some_source:
chocolatey.source_present:
- name: reponame
- source: https://repo.exemple.com
- username: myuser
- password: mypassword
- priority: 100
salt.states.chocolatey.
uninstalled
(name, version=None, uninstall_args=None, override_args=False)¶Uninstalls a package
The name of the package to be uninstalled
Uninstalls a specific version of the package. Defaults to latest version installed.
A list of uninstall arguments you want to pass to the uninstallation process i.e product key or feature list
Set to true if you want to override the original uninstall arguments ( for the native uninstaller)in the package and use your own. When this is set to False uninstall_args will be appended to the end of the default arguments
Removemypackage:
chocolatey.uninstalled:
- name: mypackage
- version: '21.5'
salt.states.chocolatey.
upgraded
(name, version=None, source=None, force=False, pre_versions=False, install_args=None, override_args=False, force_x86=False, package_args=None)¶Upgrades a package. Will install the package if not installed.
New in version 2018.3.0.
name (str) -- The name of the package to be installed. Required.
version (str) -- Install a specific version of the package. Defaults to latest
version. If the version is greater than the one installed then the
specified version will be installed. Default is None
.
source (str) -- Chocolatey repository (directory, share or remote URL, feed).
Defaults to the official Chocolatey feed. Default is None
.
force (bool) -- True
will reinstall an existing package with the same version.
Default is False
.
pre_versions (bool) -- True
will nclude pre-release packages. Default is False
.
install_args (str) -- Install arguments you want to pass to the installation process, i.e
product key or feature list. Default is None
.
override_args (bool) -- True
will override the original install arguments (for the
native installer) in the package and use those specified in
install_args
. False
will append install_args to the end of
the default arguments. Default is False
.
force_x86 (bool) -- True
forces 32bit installation on 64 bit systems. Default is
False
.
package_args (str) -- Arguments you want to pass to the package. Default is None
.
upgrade_some_package:
chocolatey.upgraded:
- name: packagename
- version: '12.04'
- source: 'mychocolatey/source'