diff --git a/CHANGELOG.md b/CHANGELOG.md index 4d3a90c..7105b6b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,6 +8,61 @@ Changelog of Git Changelog.
+
+
+
+
+
+
+
+
+
|Repo Name| version | Build
Status|
|---|---|---|---|
-|cd_apache| 0.0.1.0 | cd_apache| 0.0.1.2 | {Build
Status/]|
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 providing the httpd service itself,
-meaning that it is designed to be used by other role- or profile modules,
-adding more detailed configurations specific to the particular use case,
-i.e. full content servers, front-end for application servers, proxies etc.
Maintenance * manage the service
+As stated in the ynopsis, this module was written particularly for usage as
+base module. Apache httpd has a great number of usae cases
+where it actually is not used directly as full blown webser, but instead as
+'sub-service'. Examples here would be
frontend proxy for other applications to avoid having to put the port +number into the URL
+applications like phpMyAdmin, phpPgAdmin
+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.
Repostructure as been moved to REPOSTRUCTURE.md
@@ -251,7 +277,7 @@ environments. diff --git a/doc/index.html b/doc/index.html index 850257d..ab6ed9a 100644 --- a/doc/index.html +++ b/doc/index.html @@ -61,7 +61,7 @@|Repo Name| version | Build
Status|
|---|---|---|---|
-|cd_apache| 0.0.1.0 | cd_apache| 0.0.1.2 | {Build
Status/]|
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 providing the httpd service itself,
-meaning that it is designed to be used by other role- or profile modules,
-adding more detailed configurations specific to the particular use case,
-i.e. full content servers, front-end for application servers, proxies etc.
Maintenance * manage the service
+As stated in the ynopsis, this module was written particularly for usage as
+base module. Apache httpd has a great number of usae cases
+where it actually is not used directly as full blown webser, but instead as
+'sub-service'. Examples here would be
frontend proxy for other applications to avoid having to put the port +number into the URL
+applications like phpMyAdmin, phpPgAdmin
+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.
Repostructure as been moved to REPOSTRUCTURE.md
@@ -251,7 +277,7 @@ environments. diff --git a/doc/puppet_classes/cd_apache.html b/doc/puppet_classes/cd_apache.html index 3dda502..53585c5 100644 --- a/doc/puppet_classes/cd_apache.html +++ b/doc/puppet_classes/cd_apache.html @@ -140,7 +140,7 @@ class cd_apache { diff --git a/doc/puppet_classes/cd_apache_3A_3Amain_3A_3Aconfig.html b/doc/puppet_classes/cd_apache_3A_3Amain_3A_3Aconfig.html index b4077c0..70a700c 100644 --- a/doc/puppet_classes/cd_apache_3A_3Amain_3A_3Aconfig.html +++ b/doc/puppet_classes/cd_apache_3A_3Amain_3A_3Aconfig.html @@ -153,7 +153,7 @@ class cd_apache::main::config ( diff --git a/doc/puppet_classes/cd_apache_3A_3Aparams.html b/doc/puppet_classes/cd_apache_3A_3Aparams.html index a089ffe..f1acf58 100644 --- a/doc/puppet_classes/cd_apache_3A_3Aparams.html +++ b/doc/puppet_classes/cd_apache_3A_3Aparams.html @@ -525,7 +525,7 @@ $ae_userdir_erb = 'cd_apache/userdir_conf.erb' diff --git a/doc/puppet_classes/cd_apache_3A_3Aserver_3A_3Adirs.html b/doc/puppet_classes/cd_apache_3A_3Aserver_3A_3Adirs.html index 9b662ff..1748e5d 100644 --- a/doc/puppet_classes/cd_apache_3A_3Aserver_3A_3Adirs.html +++ b/doc/puppet_classes/cd_apache_3A_3Aserver_3A_3Adirs.html @@ -528,7 +528,7 @@ class cd_apache::server::dirs ( diff --git a/doc/puppet_classes/cd_apache_3A_3Aserver_3A_3Afiles.html b/doc/puppet_classes/cd_apache_3A_3Aserver_3A_3Afiles.html index ad06225..e747b04 100644 --- a/doc/puppet_classes/cd_apache_3A_3Aserver_3A_3Afiles.html +++ b/doc/puppet_classes/cd_apache_3A_3Aserver_3A_3Afiles.html @@ -323,7 +323,7 @@ class cd_apache::server::files ( diff --git a/doc/puppet_classes/cd_apache_3A_3Aserver_3A_3Ainstall.html b/doc/puppet_classes/cd_apache_3A_3Aserver_3A_3Ainstall.html index f50efe5..71a408a 100644 --- a/doc/puppet_classes/cd_apache_3A_3Aserver_3A_3Ainstall.html +++ b/doc/puppet_classes/cd_apache_3A_3Aserver_3A_3Ainstall.html @@ -159,7 +159,7 @@ class cd_apache::server::install ( diff --git a/doc/puppet_classes/cd_apache_3A_3Aserver_3A_3Aservice.html b/doc/puppet_classes/cd_apache_3A_3Aserver_3A_3Aservice.html index bea0fed..ce9297d 100644 --- a/doc/puppet_classes/cd_apache_3A_3Aserver_3A_3Aservice.html +++ b/doc/puppet_classes/cd_apache_3A_3Aserver_3A_3Aservice.html @@ -165,7 +165,7 @@ class cd_apache::server::service ( diff --git a/doc/puppet_classes/cd_apache_3A_3Aserver_3A_3Auser.html b/doc/puppet_classes/cd_apache_3A_3Aserver_3A_3Auser.html index 50acad4..74a4652 100644 --- a/doc/puppet_classes/cd_apache_3A_3Aserver_3A_3Auser.html +++ b/doc/puppet_classes/cd_apache_3A_3Aserver_3A_3Auser.html @@ -209,7 +209,7 @@ class cd_apache::server::user ( diff --git a/doc/top-level-namespace.html b/doc/top-level-namespace.html index 1cc195c..1d55399 100644 --- a/doc/top-level-namespace.html +++ b/doc/top-level-namespace.html @@ -90,7 +90,7 @@