W3cubDocs

/SaltStack

salt.modules.macpackage

Install pkg, dmg and .app applications on macOS minions.

salt.modules.macpackage.get_mpkg_ids(mpkg)

Attempt to get the package IDs from a mounted .mpkg file

Parameters: mpkg (str) -- The location of the mounted mpkg file
Returns: List of package IDs
Return type: list

CLI Example:

salt '*' macpackage.get_mpkg_ids /dev/disk2

salt.modules.macpackage.get_pkg_id(pkg)

Attempt to get the package ID from a .pkg file

Parameters: pkg (str) -- The location of the pkg file
Returns: List of all of the package IDs
Return type: list

CLI Example:

salt '*' macpackage.get_pkg_id /tmp/test.pkg

salt.modules.macpackage.install(pkg, target='LocalSystem', store=False, allow_untrusted=False)

Install a pkg file

Parameters:
  • pkg (str) -- The package to install
  • target (str) -- The target in which to install the package to
  • store (bool) -- Should the package be installed as if it was from the store?
  • allow_untrusted (bool) -- Allow the installation of untrusted packages?
Returns:

A dictionary containing the results of the installation

Return type:

dict

CLI Example:

salt '*' macpackage.install test.pkg

salt.modules.macpackage.install_app(app, target='/Applications/')

Install an app file by moving it into the specified Applications directory

Parameters:
  • app (str) -- The location of the .app file
  • target (str) -- The target in which to install the package to Default is ''/Applications/''
Returns:

The results of the rsync command

Return type:

str

CLI Example:

salt '*' macpackage.install_app /tmp/tmp.app /Applications/

salt.modules.macpackage.installed_pkgs()

Return the list of installed packages on the machine

Returns: List of installed packages
Return type: list

CLI Example:

salt '*' macpackage.installed_pkgs

salt.modules.macpackage.mount(dmg)

Attempt to mount a dmg file to a temporary location and return the location of the pkg file inside

Parameters: dmg (str) -- The location of the dmg file to mount
Returns:
Tuple containing the results of the command along with the mount
point
Return type: tuple

CLI Example:

salt '*' macpackage.mount /tmp/software.dmg

salt.modules.macpackage.uninstall_app(app)

Uninstall an app file by removing it from the Applications directory

Parameters: app (str) -- The location of the .app file
Returns: True if successful, otherwise False
Return type: bool

CLI Example:

salt '*' macpackage.uninstall_app /Applications/app.app

salt.modules.macpackage.unmount(mountpoint)

Attempt to unmount a dmg file from a temporary location

Parameters: mountpoint (str) -- The location of the mount point
Returns: The results of the hdutil detach command
Return type: str

CLI Example:

salt '*' macpackage.unmount /dev/disk2

© 2019 SaltStack.
Licensed under the Apache License, Version 2.0.
https://docs.saltstack.com/en/latest/ref/modules/all/salt.modules.macpackage.html