Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

RSS

zen_apache (1) Versions 1.1.0

Installs/Configures zen_apache

Berkshelf/Librarian
Policyfile
Knife
cookbook 'zen_apache', '~> 1.1.0'
cookbook 'zen_apache', '~> 1.1.0', :supermarket
knife cookbook site install zen_apache
knife cookbook site download zen_apache
README
Dependencies
Changelog
Quality

zen_apache Cookbook

This cookbook will configure an Apache server with PHP/SSL based on virtual hosts defined in a data bag in JSON format. Examples of configurations are posted below.

Requirements

platform

  • This cookbook has been developed and tested on CentOS 7 (7.0.1406) only. It may or may not work for other releases, or for derivatives such as RHEL itself.

packages

  • All required packages are installed via this cookbook

Attributes

GENERAL

default['zen_apache']['alt_files_owner'] Files default to being owned by the UID of the user running chef-client (usually root). This attribute will override that in some areas to an alternate user ownership.

default['zen_apache']['alt_files_group'] Files default to being owned by the GID of the user running chef-client (usually root). This attribute will override that in some areas to an alternate group ownership.

default['zen_apache']['alt_files_mode'] Files default to 644 permissions generally. This attribute will override that in some areas to provide an alternate mode.

default['zen_apache']['alt_dirs_mode'] Folders default to 755 permissions generally. This attribute will override that in some areas to provide an alternate mode.

HTTPD:

default['zen_apache']['httpd']['listen_port'] This defines the port in which the httpd pid listens on. Default is port 80.

default['zen_apache']['httpd']['root'] Defines the base folder where the folders for configs, sites, etc. are to be stored

default['zen_apache']['httpd']['conf_root'] Location under default['zen_apache']['httpd']['root'] in which to store the configuration data

default['zen_apache']['httpd']['vhosts'] Location under default['zen_apache']['httpd']['conf_root'] in which to store the virtual host configuration data.

default['zen_apache']['httpd']['sites'] Location under default['zen_apache']['httpd']['root'] in which to store the site content

default['zen_apache']['httpd']['httpd_conf'] Filename for your httpd.conf. Default is httpd.conf.

default['zen_apache']['httpd']['default_conf'] Location and filename to the default distribution httpd.conf. This file is backed up and then a symlink is created pointing back to the config written to default['zen_apache']['httpd']['conf_root'].

default['zen_apache']['httpd']['vhost_data_bag'] The name of the Data Bag residing on your Chef Server

PHP:

default['zen_apache']['php']['php_ini'] Path and filename for your php.ini

default['zen_apache']['php']['default_ini'] Location and filename of the default php.ini. This file is backed up and then a symlink is created pointing back to this custom one.

default['zen_apache']['php']['mem_limit'] Value in MB (megabytes) for the memory_limit configuration option in php.ini which controls the maximum amount of memory a script may consume.

default['zen_apache']['php']['post_max'] Value in MB (megabytes) for the post_max_size configuration option in php.ini which controls the maximum size of POST data that PHP will accept.

default['zen_apache']['php']['upld_max'] Value in MB (megabytes) for the upload_max_filesize configuration option in php.ini which controls the maximum allowed size for uploaded files.

default['zen_apache']['php']['timezone'] Defines the default timezone used by the date functions

default['zen_apache']['php']['mysql_persistance'] Allow or prevent persistent links. Valid values are "On" or "Off".

default['zen_apache']['php']['sess_handler'] PHP handler used to store/retrieve data.

default['zen_apache']['php']['sess_path'] Path to the session data. Can be either a path to a folder for a 'files' handler, or a server:port for a 'memcached' handler.

default['zen_apache']['php']['geoip_dir'] Path to your GeoIP IP location data (if available).

Usage

zen_apache::default

  • Include zen_apache in your node's run_list:
{
  "name":"my_node",
  "run_list": [
    "recipe[zen_apache]"
  ]
}
  • Create a data bag to hold your Virtual Hosts
  • Create a data bag to store your SSL certs (if any)
  • Attach one or more sites to the node which should be serving them:
{
  "name":"my_node",
  "normal": {
    "sitelist": [
      "mysite.com",
      "myothersite.com"
    ]
  }
}
  • Execute a chef-client run to deploy

Example JSON's for Site Configuration

Standard Site:

{
  "id"           : "resources.thezengarden.net",
  "site_root"    : "/virtual",
  "doc_root"     : "htdocs",
  "log_root"     : "logs",
  "site_admin"   : "chris@thezengarden.net",
  "site_ip"      : "*",
  "site_port"    : "80",
  "host_lookups" : "Off",
  "ip_whitelist" : ["10","209.97.6.5"],

  "site" : {
    "directories"       : {
      "/virtual/resources.thezengarden.net/htdocs"          : {
        "AllowOverride" : "All",
        "Options"       : "ExecCGI Includes FollowSymLinks",
        "Require"       : "all granted"
      }
    },
    "customlog"         : "access_log combined",
    "clog_opts"         : "env=!dontlog",
    "dontlog"           : true,
    "errorlog"          : "error_log",
    "server_status"     : true
  }
}

SSL Site:

{
  "id"           : "thezengarden.net_ssl",
  "site_alias"   : "www.thezengarden.net",
  "site_root"    : "/virtual",
  "doc_root"     : "htdocs",
  "log_root"     : "logs",
  "site_admin"   : "chris@thezengarden.net",
  "site_ip"      : "*",
  "site_port"    : "443",
  "host_lookups" : "Off",
  "ip_whitelist" : ["10","209.97.6.5"],

  "site" : {
    "blocked_files"     : ["wp-login.php","xmlrpc.php"],
    "directories"       : {
      "/virtual/thezengarden.net/htdocs"          : {
        "AllowOverride" : "All",
        "Options"       : "ExecCGI Includes FollowSymLinks",
        "Require"       : "all granted"
      },
      "/virtual/thezengarden.net/htdocs/wp-admin" : {
        "Require"       : ["all denied", "ip 10 209.97.6.5"]
      }
    },
    "customlog"        : "access_log combined",
    "clog_opts"         : "env=!dontlog",
    "dontlog"           : true,
    "errorlog"          : "error_log",
    "ssl"               : {
      "SSLEngine"               : "On",
      "SSLCertificateFile"      : "/www/conf/ssl/thezengarden.net.crt",
      "SSLCertificateKeyFile"   : "/www/conf/ssl/thezengarden.net.key",
      "SSLCertificateChainFile" : "/www/conf/ssl/thezengarden.net.bundle"
    }
  }
}

ProxyPass Site:

{
  "id"           : "cdn.thezengarden.net",
  "site_root"    : "/virtual",
  "doc_root"     : "htdocs",
  "log_root"     : "logs",
  "site_admin"   : "chris@thezengarden.net",
  "site_ip"      : "*",
  "site_port"    : "80",
  "host_lookups" : "Off",
  "ip_whitelist" : ["10","209.97.6.5"],

  "site" : {
    "customlog"        : "access_log combined",
    "clog_opts"        : "env=!dontlog",
    "dontlog"          : true,
    "errorlog"         : "error_log",
    "proxyreqs"        : true,
    "proxy"            : {
      "path"           : "/",
      "dest"           : "http://zg-cdn01.thezengarden.net:8000/",
      "preserve_hosts" : true
    }
  }
}

SSL Certs:

Example for Data Bag:

{
  "id"     : "thezengarden.net.crt",
  "header" : "-----BEGIN CERTIFICATE-----",
  "footer" : "-----END CERTIFICATE-----",
  "data"   : "98erjeproigerp8gerhgeprogierg erpogih rgpoier gpeor "
}

NOTE: You will need to put the cert data on a single line with each former line being denoted by a space

Contributing

  1. Fork the repository on Github
  2. Create a named feature branch (like add_component_x)
  3. Write your change
  4. Write tests for your change (if applicable)
  5. Run the tests, ensuring they all pass
  6. Submit a Pull Request using Github

License and Authors

License: GPL v2 Authors: Chris Hammer chris@thezengarden.net

Dependent cookbooks

This cookbook has no specified dependencies.

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

zen_apache CHANGELOG

This file is used to list changes made in each version of the zen_apache cookbook.

0.1.0

  • [your_name] - Initial release of zen_apache

Check the Markdown Syntax Guide for help with Markdown.

The Github Flavored Markdown page describes the differences between markdown on github and standard markdown.

Collaborator Number Metric
            

1.1.0 failed this metric

Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric
            

1.1.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file

Foodcritic Metric
            

1.1.0 failed this metric

FC064: Ensure issues_url is set in metadata: zen_apache/metadata.rb:1
FC065: Ensure source_url is set in metadata: zen_apache/metadata.rb:1
FC066: Ensure chef_version is set in metadata: zen_apache/metadata.rb:1
FC067: Ensure at least one platform supported in metadata: zen_apache/metadata.rb:1
FC069: Ensure standardized license defined in metadata: zen_apache/metadata.rb:1
Run with Foodcritic Version 11.1.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

License Metric
            

1.1.0 failed this metric

zen_apache does not have a valid open source license.
Acceptable licenses include Apache-2.0, apachev2, Apache 2.0, MIT, mit, GPL-2.0, gplv2, GNU Public License 2.0, GPL-3.0, gplv3, GNU Public License 3.0.

No Binaries Metric
            

1.1.0 passed this metric

Publish Metric
            

1.1.0 passed this metric

Supported Platforms Metric
            

1.1.0 failed this metric

zen_apache should declare what platform(s) it supports.

Testing File Metric
            

1.1.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file

Version Tag Metric
            

1.1.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number