salt.modules.aptly

Aptly Debian repository manager.

New in version 2018.3.0.

salt.modules.aptly.cleanup_db(config_path='/etc/aptly.conf', dry_run=False)
Remove data regarding unreferenced packages and delete files in the package pool that

are no longer being used by packages.

Parameters:

dry_run (bool) -- Report potential changes without making any changes.

Returns:

A dictionary of the package keys and files that were removed.

Return type:

dict

CLI Example:

salt '*' aptly.cleanup_db
salt.modules.aptly.delete_repo(name, config_path='/etc/aptly.conf', force=False)

Remove the repository.

Parameters:
  • name (str) -- The name of the repository.

  • config_path (str) -- The path to the configuration file for the aptly instance.

  • force (bool) -- Whether to remove the repository even if it is used as the source of an existing snapshot.

Returns:

A boolean representing whether all changes succeeded.

Return type:

bool

CLI Example:

salt '*' aptly.delete_repo name="test-repo"
salt.modules.aptly.get_config(config_path='/etc/aptly.conf')

Get the configuration data.

Parameters:

config_path (str) -- The path to the configuration file for the aptly instance.

Returns:

A dictionary containing the configuration data.

Return type:

dict

CLI Example:

salt '*' aptly.get_config
salt.modules.aptly.get_repo(name, config_path='/etc/aptly.conf', with_packages=False)

Get the details of the repository.

Parameters:
  • name (str) -- The name of the repository.

  • config_path (str) -- The path to the configuration file for the aptly instance.

  • with_packages (bool) -- Return a list of packages in the repo.

Returns:

A dictionary containing information about the repository.

Return type:

dict

CLI Example:

salt '*' aptly.get_repo name="test-repo"
salt.modules.aptly.list_mirrors(config_path='/etc/aptly.conf')

Get a list of all the mirrors.

Parameters:

config_path (str) -- The path to the configuration file for the aptly instance.

Returns:

A list of the mirror names.

Return type:

list

CLI Example:

salt '*' aptly.list_mirrors
salt.modules.aptly.list_published(config_path='/etc/aptly.conf')

Get a list of all the published repositories.

Parameters:

config_path (str) -- The path to the configuration file for the aptly instance.

Returns:

A list of the published repository names.

Return type:

list

CLI Example:

salt '*' aptly.list_published
salt.modules.aptly.list_repos(config_path='/etc/aptly.conf', with_packages=False)

List all of the repos.

Parameters:
  • config_path (str) -- The path to the configuration file for the aptly instance.

  • with_packages (bool) -- Return a list of packages in the repo.

Returns:

A dictionary of the repositories.

Return type:

dict

CLI Example:

salt '*' aptly.list_repos
salt.modules.aptly.list_snapshots(config_path='/etc/aptly.conf', sort_by_time=False)

Get a list of all the snapshots.

Parameters:
  • config_path (str) -- The path to the configuration file for the aptly instance.

  • sort_by_time (bool) -- Whether to sort by creation time instead of by name.

Returns:

A list of the snapshot names.

Return type:

list

CLI Example:

salt '*' aptly.list_snapshots
salt.modules.aptly.new_repo(name, config_path='/etc/aptly.conf', comment=None, component=None, distribution=None, uploaders_file=None, from_snapshot=None, saltenv='base')

Create the new repository.

Parameters:
  • name (str) -- The name of the repository.

  • config_path (str) -- The path to the configuration file for the aptly instance.

  • comment (str) -- The description of the repository.

  • component (str) -- The default component to use when publishing.

  • distribution (str) -- The default distribution to use when publishing.

  • uploaders_file (str) -- The repository upload restrictions config.

  • from_snapshot (str) -- The snapshot to initialize the repository contents from.

  • saltenv (str) -- The environment the file resides in.

Returns:

A boolean representing whether all changes succeeded.

Return type:

bool

CLI Example:

salt '*' aptly.new_repo name="test-repo" comment="Test main repo" component="main" distribution="trusty"
salt.modules.aptly.set_repo(name, config_path='/etc/aptly.conf', comment=None, component=None, distribution=None, uploaders_file=None, saltenv='base')

Configure the repository settings.

Parameters:
  • name (str) -- The name of the repository.

  • config_path (str) -- The path to the configuration file for the aptly instance.

  • comment (str) -- The description of the repository.

  • component (str) -- The default component to use when publishing.

  • distribution (str) -- The default distribution to use when publishing.

  • uploaders_file (str) -- The repository upload restrictions config.

  • from_snapshot (str) -- The snapshot to initialize the repository contents from.

  • saltenv (str) -- The environment the file resides in.

Returns:

A boolean representing whether all changes succeeded.

Return type:

bool

CLI Example:

salt '*' aptly.set_repo name="test-repo" comment="Test universe repo" component="universe" distribution="xenial"