22.14.2. salt.fileserver.hgfs

Mercurial Fileserver Backend

To enable, add hg to the fileserver_backend option in the master config file.

After enabling this backend, branches, bookmarks, and tags in a remote mercurial repository are exposed to salt as different environments. This feature is managed by the fileserver_backend option in the salt master config file.

This fileserver has an additional option hgfs_branch_method that will set the desired branch method. Possible values are: branches, bookmarks, or mixed. If using branches or mixed, the default branch will be mapped to base.

Changed in version 2014.1.0: The hgfs_base master config parameter was added, allowing for a branch other than default to be used for the base environment, and allowing for a base environment to be specified when using an hgfs_branch_method of bookmarks.

depends:
  • mercurial
  • python bindings for mercurial (python-hglib)
salt.fileserver.hgfs.dir_list(load)

Return a list of all directories on the master

salt.fileserver.hgfs.envs(ignore_cache=False)

Return a list of refs that can be used as environments

salt.fileserver.hgfs.file_hash(load, fnd)

Return a file hash, the hash type is set in the master config file

salt.fileserver.hgfs.file_list(load)

Return a list of all files on the file server in a specified environment

salt.fileserver.hgfs.file_list_emptydirs(load)

Return a list of all empty directories on the master

salt.fileserver.hgfs.find_file(path, tgt_env='base', **kwargs)

Find the first file to match the path and ref, read the file out of hg and send the path to the newly cached file

salt.fileserver.hgfs.init()

Return a list of hglib objects for the various hgfs remotes

salt.fileserver.hgfs.purge_cache()

Purge the fileserver cache

salt.fileserver.hgfs.serve_file(load, fnd)

Return a chunk from a file based on the data received

salt.fileserver.hgfs.update()

Execute an hg pull on all of the repos

Docs for previous releases are available on salt.rtfd.org.

Latest Salt release: 2014.1.13

Try the shiny new release candidate of Salt, v2014.7.0rc6! More info here.

Previous topic

22.14.1. salt.fileserver.gitfs

Next topic

22.14.3. salt.fileserver.minionfs

SaltStack News

Upcoming SaltStack events, webinars and local meet ups and user groups.