OP#409 initial commit after fork
This commit is contained in:
25
README.md
25
README.md
@@ -1,14 +1,27 @@
|
||||
# README
|
||||
|
||||
[](https://jenkins.confdroid.com/job/cd_apache/)
|
||||
[](https://jenkins.confdroid.com/job/confdroid_apache/)
|
||||
|
||||
- [README](#readme)
|
||||
- [Synopsis](#synopsis)
|
||||
- [WARNING](#warning)
|
||||
- [Features](#features)
|
||||
- [vHosts](#vhosts)
|
||||
- [Dependencies](#dependencies)
|
||||
- [Deployment](#deployment)
|
||||
- [Parameters](#parameters)
|
||||
- [SELINUX](#selinux)
|
||||
- [Support](#support)
|
||||
- [Tests](#tests)
|
||||
- [Contact Us](#contact-us)
|
||||
- [Disclaimer](#disclaimer)
|
||||
|
||||
[[_TOC_]]
|
||||
|
||||
## Synopsis
|
||||
|
||||
`Apache httpd` is a very powerful and widely used web server.
|
||||
|
||||
`cd_apache` automates the installation and configuration of httpd. This module is a base module simply providing the httpd service itself to be used by other role- or profile modules, adding more detailed configurations specific to the particular use case, like for instance Wordpress.
|
||||
`confdroid_apache` automates the installation and configuration of httpd. This module is a base module simply providing the httpd service itself to be used by other role- or profile modules, adding more detailed configurations specific to the particular use case, like for instance Wordpress.
|
||||
|
||||
## WARNING
|
||||
|
||||
@@ -43,7 +56,7 @@ As stated in the synopsis, this module was written particularly for usage as bas
|
||||
* WordPress
|
||||
* Nagios etc.
|
||||
|
||||
With those use cases, you would provide the vHosts at the Puppet module for the application, not the base module. Also, if you plan to use this module to run a plain fully fledged web server, you would use a role- or profile class/module on top of `cd_apache` to set up your vHost exactly as needed. Examples for regular basic vHost configuration files are included in the examples directory as parameterized .erb files. You would create a define for vHosts, i.e. using the example parameters, and simply add `cd_apache` as requirement (i.e. require cd_apache) so it gets installed automatically.
|
||||
With those use cases, you would provide the vHosts at the Puppet module for the application, not the base module. Also, if you plan to use this module to run a plain fully fledged web server, you would use a role- or profile class/module on top of `confdroid_apache` to set up your vHost exactly as needed. Examples for regular basic vHost configuration files are included in the examples directory as parameterized .erb files. You would create a define for vHosts, i.e. using the example parameters, and simply add `confdroid_apache` as requirement (i.e. require confdroid_apache) so it gets installed automatically.
|
||||
|
||||
### Dependencies
|
||||
|
||||
@@ -59,13 +72,13 @@ via site.pp or nodes.pp
|
||||
|
||||
```bash
|
||||
node 'example.example.net' {
|
||||
include cd_apache
|
||||
include confdroid_apache
|
||||
}
|
||||
```
|
||||
|
||||
* through Foreman:
|
||||
|
||||
In order to apply parameters through Foreman, **__cd_apache::params__** must be added to the host or host group in question.
|
||||
In order to apply parameters through Foreman, **__confdroid_apache::params__** must be added to the host or host group in question.
|
||||
|
||||
See [more details about class deployment on Confdroid.com](https://confdroid.com/2017/05/deploying-our-puppet-modules/).
|
||||
|
||||
|
||||
Reference in New Issue
Block a user