salt.modules.aptly¶

Aptly Debian repository manager.

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"