sc_apache

Table of Contents

1. Overview
2. Module Description - What the module does and why it is useful
3. Setup - The basics of getting started with sc_apache
   • What sc_apache affects
   • Beginning with sc_apache
4. Usage - Configuration options and additional functionality

Overview

ScaleCommerce Wrapper Module for puppetlabs-apache. Manages Supervisord, vhosts, OPCache, ZendGuard Loader, IonCube.

Module Description

This module uses hiera to configure Apache ressources.

Setup

What sc_apache affects

• apache
• apache modules
• supervisord
• ZendGuard Loader
• PHP OPCache
• IonCube Loader
• Local vhosts for monitoring

Beginning with sc_apache

You will need a working hiera-Setup (https://docs.puppetlabs.com/hiera/3.1/complete_example.html).

Check out our solultion for Puppet-Hiera-Roles (https://github.com/ScaleCommerce/puppet-hiera-roles).

Usage: Apache vhosts

Put this into your node.yaml or role.yaml. See Documentation of puppetlabs-apache for details on vhost syntax.

---
classes:
  - sc_apache

sc_apache::vhosts:
  # Default vhost matches all servernames which are not configured in any vhost
  default:
    docroot: /var/www/catchall/web
    default_vhost: true
  # other vhosts
  www.example.com:
    server_aliases: ['example.com']
    docroot: /var/www/www.example.com/web
    override: ['All']
  # add php.ini settings per vhost
  www.domain.de:
    server_aliases: ['deomain.de']
    docroot: /var/www/www.domain.de/web
    override: ['All']
    php_values:
      tideways.api_key: 'xxx'
      tideways.framework: 'shopware'

Usage: Apache Modules

sc_apache::modules:
  - rewrite
  - auth_basic
  - deflate
  - expires
  - headers
  - remoteip
  - status
  - authz_user
  - authz_groupfile
  - alias
  - authn_core
  - authn_file
  - reqtimeout
  - negotiation
  - autoindex
  - access_compat
  - env

Usage: PHP

classes:
  - sc_apache
  - sc_apache::php
  - sc_apache::tideways
  - sc_apache::zendopcache # this class installs zendopcache in php 5.4
  - sc_apache::ioncube
  - sc_apache::zendguard

sc_apache::php::major_version: '5.6'
sc_apache::php::ini_settings:
  apache2:
    session.gc_maxlifetime: 604800
    error_reporting: "E_ALL & ~E_DEPRECATED & ~E_STRICT & ~E_NOTICE"
    max_execution_time: 60
  cli:
    max_execution_time: 1200

sc_apache::php::modules:
  - mysql
  - gd
  - mcrypt
  - curl
  - intl
  - xsl

Testing

When making changes you can test this module locally with gitlab-runner on Mac OSX

gitlab-runner exec docker --env "GIT_STRATEGY=none" --docker-volumes pwd:/builds/project-0 xenial:7.2:puppet5