Module undine_rsync
In: /vagrant/modules/undine_rsync/manifests/directory.pp
/vagrant/modules/undine_rsync/manifests/init.pp
/vagrant/modules/undine_rsync/manifests/directory.pp
/vagrant/modules/undine_rsync/manifests/init.pp

Defines

Classes and Modules

Class undine_rsync::undine_rsync

Defines

directory( $src_hostname => 'undef', $logoutput => 'false', $src_known_host_key => 'undef', $dest_path => 'title', $src_path, $src_username => 'undef' )

Define: directory

The directory defined type is responsible for the management of rsync‘d directories in Undine. It only supports rsync from local or remote hosts to a destination directory on the VM.

It also provides a means of authenticating via SSH using a combination of agent forwarding to use your host environment‘s SSH keys (enabled in Undine by default) and manipulating the known_hosts file on the guest VM. To find a given known_hosts entry on your host system, simply use the command `ssh-keygen -H -F example.com` to display the correct key to provide.

Parameters

dest_path
The destination directory on the local VM. Defaults to the resource title.
src_path
The source directory from which to rsync files. Provide src_hostname to rsync from a remote host.
src_hostname
Optional. The source hostname from which to rsync files.
src_known_host_key
Optional. The known_host key of the remote src_hostname provided.
src_username
Optional. The username to use when authenticating to the remote host.

Examples

Simple local usage.

  undine_rsync::directory { '/path/to/dest':
    src_path => '/path/to/my/src',
  }

Usage via SSH with a defined remote host and associated known_host entry.

  undine_rsync::directory { '/path/to/dest':
    src_path => '/path/to/my/remote/src',
    src_hostname => 'example.com',
    src_known_host_key => '|1|nddsvUkIUHNdM31TTSc+sPT57yg=|nQqEyJJthk/DTVaRmJW ...',
    src_username => 'jsmith',
  }
directory( $src_hostname => 'undef', $logoutput => 'false', $src_known_host_key => 'undef', $dest_path => 'title', $src_path, $src_username => 'undef' )

Define: directory

The directory defined type is responsible for the management of rsync‘d directories in Undine. It only supports rsync from local or remote hosts to a destination directory on the VM.

It also provides a means of authenticating via SSH using a combination of agent forwarding to use your host environment‘s SSH keys (enabled in Undine by default) and manipulating the known_hosts file on the guest VM. To find a given known_hosts entry on your host system, simply use the command `ssh-keygen -H -F example.com` to display the correct key to provide.

Parameters

dest_path
The destination directory on the local VM. Defaults to the resource title.
src_path
The source directory from which to rsync files. Provide src_hostname to rsync from a remote host.
src_hostname
Optional. The source hostname from which to rsync files.
src_known_host_key
Optional. The known_host key of the remote src_hostname provided.
src_username
Optional. The username to use when authenticating to the remote host.

Examples

Simple local usage.

  undine_rsync::directory { '/path/to/dest':
    src_path => '/path/to/my/src',
  }

Usage via SSH with a defined remote host and associated known_host entry.

  undine_rsync::directory { '/path/to/dest':
    src_path => '/path/to/my/remote/src',
    src_hostname => 'example.com',
    src_known_host_key => '|1|nddsvUkIUHNdM31TTSc+sPT57yg=|nQqEyJJthk/DTVaRmJW ...',
    src_username => 'jsmith',
  }

[Validate]