Author: CloudPassage & Tech Accelerator
Feedback: toolbox@cloudpassage.com
- Overview
- Requirements and dependencies
- Setup
- Usage
- Reference
- Limitations - OS compatibility, etc.
- Development
The cloudpassage module installs and configures the CloudPassage Halo agent.
- Ubuntu 14.04
- CentOS 6.7
- CentOS 7.1
- RHEL 7.2
- Amazon Linux 2015.09
- Windows Server 2012R2
- 2.2
- Puppet 4.9.0
- Puppet 4.9.1
- Puppet 4.9.2
- Puppet 4.9.3
- Puppet 4.9.4
- Puppet 5.4.0
There is no extra setup required.
cd /etc/puppetlabs/code/environments/production/modules
git clone https://github.com/cloudpassage/puppet-cloudpassage.git
mv puppet-cloudpassage cloudpassage
All interaction with the cloudpassage module can be done through the main cloudpassage class in the manifest (/etc/puppetlabs/code/environments/production/manifests) on Pupper Master. Below are example classes for Linux and Windows servers to function. Please see later section for required parameters.
class { 'cloudpassage':
agent_key => 'myagentkey',
}
class { 'cloudpassage':
agent_key => 'myagentkey',
package_file => 'cphalo-3.9.7-win64.exe',
package_url => 'https://production.packages.cloudpassage.com/windows/cphalo-3.9.7-win64.exe',
destination_dir => 'C:\\Users\Administrator\Downloads',
server_label => 'puppet_windows',
audit_mode => true
}
- cloudpassage: Main class, includes all other classes.
* cloudpassage::params: Handles the module's params and sets defaults.
* cloudpassage::install: Handles the packages.
* cloudpassage::config: Configures the cphalo daemon on installation.
* cloudpassage::service: Handles the cphalod service.
* cloudpassage::yum: Manages the cloudpassage yum repo where applicable.
* cloudpassage::apt: Manages the cloudpassage apt repo where applicable.
The following parameters are available in the cloudpassage
class:
The CloudPassage Agent key.
Unique identifer of the VM combined with the hostname. server_label will supersede azure_id if server_label field is populated.
Controls the Halo Agent's "read-only" attribute
Controls where we'll download the installer EXE
Set to true by default, will add cloudpassage package repo for install
Controls the package resource's "ensure" attribute
Controls the filename of the installer EXE
Controls the package resource's "name" attribute
Base URL from which we'll download the installer EXE
Controls the apt or yum repo's "ensure" attribute
The name of the service
Unique identifer of the VM
The CloudPassage tags that this node will be configured with. If nothing is provided will not include --tags in the agent registration process (default set to undef)
Proxing settings. To configure the agent to use an outbound pro
Proxy username
Proxy password
Controls DNS resolution (True | False)
This module uses the puppetlabs-apt module for the management of the NodeSource repository, [puppetlabs-stdlib module] and [puppetlabs-powershell module]
For Windows installations, this module uses the puppet-download_file module to download the necessary installers.
We welcome contributions to this module from the Puppet community - the preferred way would be to send a pull request to the module repo on GitHub (https://github.com/cloudpassage/puppet-cloudpassage). Bonus points if you follow this process:
- Fork the module on github
- pull it down
- run the acceptance tests included in the module
- make your changes
- add spec tests to test your changes
- then submit a pull request
This module is regularly reviewed and maintained by the CloudPassage integrations team. For any feedback, questions or support issues, please contact support@cloudpassage.com.