Merge pull request #709 from stevenpost/manifest_docs

Move documentation from README into the manifests

lib/puppet/type/mongodb_conn_validator.rb

@@ -8,7 +8,7 @@
  purposes such as monitoring."
 
  ensurable do
- desc 'Ensurable property'
+ desc 'Ensure to verify the connection to mongodb'
  defaultvalues
  defaultto :present
  end

lib/puppet/type/mongodb_replset.rb

@@ -8,7 +8,7 @@
  @doc = 'Manage a MongoDB replicaSet'
 
  ensurable do
- desc 'Ensurable property'
+ desc 'Ensure the replicaset is either present or absent'
  defaultto :present
 
  newvalue(:present) do

lib/puppet/type/mongodb_shard.rb

@@ -8,7 +8,7 @@
  @doc = 'Manage a MongoDB Shard'
 
  ensurable do
- desc 'Ensurable property'
+ desc 'Ensure the shard is either present or absent'
  defaultto :present
 
  newvalue(:present) do

manifests/client.pp

@@ -1,9 +1,14 @@
 # @summary Class for installing a MongoDB client shell (CLI).
 #
+# @example Basic usage
+# include mongodb::client
+
 # @param ensure
-# Desired ensure state of the package.
+# Used to ensure that the package is installed, or that the package is absent/purged
+#
 # @param package_name
-# Name of the package to install the client from. Default is repository dependent.
+# This setting can be used to specify the name of the package that should be installed.
+# If not specified, the module will use whatever service name is the default for your OS distro.
 #
 class mongodb::client (
  String[1] $ensure = $mongodb::client::params::package_ensure,

manifests/db.pp

@@ -1,19 +1,26 @@
 # @summary Class for creating mongodb databases and users.
 #
-# @param user 
+# @param user
 # Database username.
+#
 # @param auth_mechanism
 # Authentication mechanism. scram_sha_256 password verification is not supported. Defaults to 'scram_sha_1'.
+#
 # @param db_name
 # Database name. Defaults to $name.
+#
 # @param password_hash
 # Hashed password. Hex encoded md5 hash of "$username:mongo:$password".
+#
 # @param password
 # Plain text user password. This is UNSAFE, use 'password_hash' instead.
+#
 # @param roles
 # Array with user roles. Deaults to ['dbAdmin']
+#
 # @param tries
 # The maximum amount of two second tries to wait MongoDB startup. Defaults to 10.
+#
 # @param update_password
 # Force an update of the password when scram_sha_256 is used. Defaults to false.
 #

manifests/globals.pp

@@ -1,29 +1,119 @@
-# @summary Class for setting cross-class global overrides. See README.md for more details.
+# @summary Class for setting cross-class global overrides.
+#
+# @example Use a specific MongoDB version to install from the community repository.
+#
+# class {'mongodb::globals':
+# manage_package_repo => true,
+# repo_version => '4.4',
+# }
+# -> class {'mongodb::client': }
+# -> class {'mongodb::server': }
+#
+# @example Use a specific MongoDB version to install from the enterprise repository.
+#
+# class {'mongodb::globals':
+# manage_package_repo => true,
+# repo_version => '4.4',
+# use_enterprise_repo => true,
+# }
+# -> class {'mongodb::client': }
+# -> class {'mongodb::server': }
+#
+# @example To disable managing of repository, but still enable managing packages.
+#
+# class {'mongodb::globals':
+# manage_package_repo => false,
+# manage_package => true,
+# }
+# -> class {'mongodb::server': }
+# -> class {'mongodb::client': }
 #
 # @param server_package_name
+# This setting can be used to override the default MongoDB server package name.
+# If not specified, the module will use whatever package name is the default for your OS distro.
+#
 # @param client_package_name
+# This setting can be used to specify the name of the client package that should be installed.
+# If not specified, the module will use whatever service name is the default for your OS distro.
+#
 # @param mongod_service_manage
+# This setting can be used to override the default management of the mongod service.
+# By default the module will manage the mongod process.
 # @param service_enable
+# This setting can be used to specify if the service should be enable at boot
+#
 # @param service_ensure
+# This setting can be used to specify if the service should be running
+#
 # @param service_name
+# This setting can be used to override the default MongoDB service name.
+# If not specified, the module will use whatever service name is the default for your OS distro.
+#
 # @param service_provider
+# This setting can be used to override the default MongoDB service provider.
+# If not specified, the module will use whatever service provider is the default for your OS distro.
+#
 # @param service_status
+# This setting can be used to override the default status check command for your MongoDB service.
+# If not specified, the module will use whatever service name is the default for your OS distro.
+#
 # @param user
+# This setting can be used to override the default MongoDB user and owner of the service and related files in the file system.
+# If not specified, the module will use the default for your OS distro.
+#
 # @param group
+# This setting can be used to override the default MongoDB user group to be used for related files in the file system.
+# If not specified, the module will use the default for your OS distro.
+#
 # @param ipv6
+# This setting is used to configure MongoDB to turn on ipv6 support.
+# If not specified and ipv6 address is passed to MongoDB bind_ip it will just fail.
+#
 # @param bind_ip
-# @param version Version of mongodb to install
-# @param repo_version Version of mongodb repo to install
-# @param manage_package_repo If `true` configure upstream mongodb repos
+# This setting can be used to configure MonogDB process to bind to and listen for connections from applications on this address.
+# If not specified, the module will use the default for your OS distro.
+# Note: This value should be passed as an array.
+#
+# @param version
+# The version of MonogDB to install/manage. This is needed when managing repositories.
+# If not specified, the module will use the default for your OS distro.
+#
+# @param repo_version
+# The version of the package repo.
+#
+# @param manage_package_repo
+# Whether to use the MongoDB software repository or the OS packages (True) or a Custom repo (False)
+#
 # @param manage_package
+# wgether this module willm manage the mongoDB server package
+#
 # @param repo_proxy
+# This will allow you to set a proxy for your repository in case you are behind a corporate firewall.
+# Currently this is only supported with yum repositories
+#
 # @param proxy_username
+# This sets the username for the proxyserver, should authentication be required.
+#
 # @param proxy_password
+# This sets the password for the proxyserver, should authentication be required
+#
 # @param repo_location
+# This setting can be used to override the default MongoDB repository location.
+# If not specified, the module will use the default repository for your OS distro.
+#
 # @param use_enterprise_repo
+# When manage_package_repo is set to true, this setting indicates if it will use the Community Edition
+# (false, the default) or the Enterprise one (true).
+#
 # @param pidfilepath
+# Specify a file location to hold the PID or process ID of the mongod process.
+# If not specified, the module will use the default for your OS distro.
+#
 # @param pidfilemode
+# The file mode of the pid file
+#
 # @param manage_pidfile
+# If true, the pidfile will be managed by puppet
 #
 class mongodb::globals (
  $server_package_name = undef,

manifests/mongos.pp

@@ -1,28 +1,88 @@
-# @summary This installs a Mongo Shard daemon. See README.md for more details.
+# @summary This installs a Mongo Shard daemon.
+#
+# This class should only be used if you want to implement sharding within your mongodb deployment.
+# This class allows you to configure the mongos daemon (responsible for routing) on your platform.
+#
+# @example mongos can be installed the following way.
+# class {'mongodb::mongos' :
+# configdb => ['configsvr1.example.com:27018'],
+# }
 #
 # @param config
+# Path of the config file. If not specified, the module will use the default for your OS distro.
+#
 # @param config_content
+# Config content if the default doesn't match one needs.
+#
 # @param config_template
+# Path to the config template if the default doesn't match one needs.
+#
 # @param configdb
+# Array of the config servers IP addresses the mongos should connect to.
+#
 # @param config_data
+# Hash containing key-value pairs to allow for additional configuration options to be set in user-provided template.
+#
 # @param service_manage
+# Whether or not the MongoDB sharding service resource should be part of the catalog.
+#
 # @param service_provider
+# This setting can be used to override the default Mongos service provider.
+# If not specified, the module will use whatever service provider is the default for your OS distro.
+#
 # @param service_name
+# This setting can be used to override the default Mongos service name.
+# If not specified, the module will use whatever service name is the default for your OS distro.
+#
 # @param service_user
+# The user used by Systemd for running the service.
+#
 # @param service_group
+# The group used by Systemd for running the service
+#
 # @param service_template
+# Path to the service template if the default doesn't match one needs.
+#
 # @param service_enable
+# This setting can be used to specify if the service should be enable at boot
+#
 # @param service_ensure
+# This setting can be used to specify if the service should be running
+#
 # @param service_status
+# This setting can be used to override the default status check command for your Mongos service.
+# If not specified, the module will use whatever service name is the default for your OS distro.
+#
 # @param package_ensure
+# This setting can be used to specify if puppet should install the package or not
+#
 # @param package_name
+# This setting can be used to specify the name of the package that should be installed.
+# If not specified, the module will use whatever service name is the default for your OS distro.
+#
 # @param unixsocketprefix
+# The path for the UNIX socket. If this option has no value, the mongos process creates a socket with /tmp as a prefix.
+#
 # @param pidfilepath
+# Specify a file location to hold the PID or process ID of the mongod process.
+# If not specified, the module will use the default for your OS distro.
+#
 # @param logpath
+# Specify the path to a file name for the log file that will hold all diagnostic logging information.
+# Unless specified, mongod will output all log information to the standard output.
+#
 # @param fork
+# Set to true to fork server process at launch time. The default setting depends on the operating system.
+#
 # @param bind_ip
+# Set this option to configure the mongod or mongos process to bind to and listen for connections from applications on this address.
+# If not specified, the module will use the default for your OS distro.
+#
 # @param port
+# Specifies a TCP port for the server instance to listen for client connections.
+#
 # @param restart
+# Specifies whether the service should be restarted on config changes.
 #
 class mongodb::mongos (
  Stdlib::Absolutepath $config = $mongodb::mongos::params::config,

manifests/mongos/config.pp

@@ -1,20 +1,48 @@
-# @summary Manages mongos config
-#
 # @api private
 #
+# @summary Manages mongos config
+#
 # @param package_ensure
+# This setting can be used to specify if puppet should install the package or not
+#
 # @param config
+# Path of the config file. If not specified, the module will use the default for your OS distro.
+#
 # @param config_content
+# Config content if the default doesn't match one needs.
+#
 # @param config_template
+# Path to the config template if the default doesn't match one needs.
+#
 # @param service_manage
+# Whether or not the MongoDB sharding service resource should be part of the catalog.
+#
 # @param configdb
+# Array of the config servers IP addresses the mongos should connect to.
+#
 # @param bind_ip
+# Set this option to configure the mongod or mongos process to bind to and listen for connections from applications on this address.
+# If not specified, the module will use the default for your OS distro.
+#
 # @param port
+# Specifies a TCP port for the server instance to listen for client connections.
+#
 # @param fork
+# Set to true to fork server process at launch time. The default setting depends on the operating system.
+#
 # @param pidfilepath
+# Specify a file location to hold the PID or process ID of the mongod process.
+# If not specified, the module will use the default for your OS distro.
+#
 # @param logpath
+# Specify the path to a file name for the log file that will hold all diagnostic logging information.
+# Unless specified, mongod will output all log information to the standard output.
+#
 # @param unixsocketprefix
+# The path for the UNIX socket. If this option has no value, the mongos process creates a socket with /tmp as a prefix.
+#
 # @param config_data
+# Hash containing key-value pairs to allow for additional configuration options to be set in user-provided templ ate.
 #
 class mongodb::mongos::config (
  $package_ensure = $mongodb::mongos::package_ensure,

manifests/mongos/install.pp

@@ -1,9 +1,13 @@
-# @summary Manages the mongos package
-#
 # @api private
 #
+# @summary Installs mongos
+#
 # @param package_ensure
+# This setting can be used to specify if puppet should install the package or not
+#
 # @param package_name
+# This setting can be used to specify the name of the package that should be installed.
+# If not specified, the module will use whatever service name is the default for your OS distro.
 #
 class mongodb::mongos::install (
  $package_ensure = $mongodb::mongos::package_ensure,

manifests/mongos/service.pp

@@ -1,17 +1,40 @@
-# @summary Manages the mongos service
-#
 # @api private
 #
+# @summary Manages the mongos service
+#
 # @param package_ensure
+# This setting can be used to specify if puppet should install the package or not.
+#
 # @param service_manage
+# Whether or not the MongoDB sharding service resource should be part of the catalog.
+#
 # @param service_name
+# This setting can be used to override the default Mongos service name.
+# If not specified, the module will use whatever service name is the default for your OS distro.
+#
 # @param service_enable
+# This setting can be used to specify if the service should be enable at boot.
+#
 # @param service_ensure
+# This setting can be used to specify if the service should be running.
+#
 # @param service_status
+# This setting can be used to override the default status check command for your Mongos service.
+# If not specified, the module will use whatever service name is the default for your OS distro.
+#
 # @param service_provider
+# This setting can be used to override the default Mongos service provider.
+# If not specified, the module will use whatever service provider is the default for your OS distro.
+#
 # @param bind_ip
+# Set this option to configure the mongod or mongos process to bind to and listen for connections from applicati ons on this address.
+# If not specified, the module will use the default for your OS distro.
+#
 # @param port
+# Specifies a TCP port for the server instance to listen for client connections.
+#
 # @param service_template
+# Path to the service template if the default doesn't match one needs.
 #
 class mongodb::mongos::service (
  $package_ensure = $mongodb::mongos::package_ensure,