LEMPer/scripts/install_nginx_from_source.sh

#!/bin/bash
# Licensed to the Apache Software Foundation (ASF) under one
# or more contributor license agreements.    See the NOTICE file
# distributed with this work for additional information
# regarding copyright ownership.    The ASF licenses this file
# to you under the Apache License, Version 2.0 (the
# "License"); you may not use this file except in compliance
# with the License.    You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing,
# software distributed under the License is distributed on an
# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
# KIND, either express or implied.    See the License for the
# specific language governing permissions and limitations
# under the License.

function usage() {
    echo "
Usage: build_ngx_pagespeed.sh [options]

    Installs ngx_pagespeed and its dependencies. Can optionally build and install
    nginx as well. Can be run either as:

    bash <(curl -f -L -sS https://ngxpagespeed.com/install) [options]

    Or:

    git clone -q git@github.com:pagespeed/ngx_pagespeed.git
    cd ngx_pagespeed/
    git checkout <branch>
    scripts/build_ngx_pagespeed.sh [options]

Options:
    -v, --ngx-pagespeed-version <ngx_pagespeed version>
        What version of ngx_pagespeed to build. Valid options include:
        * latest-beta
        * latest-stable
        * a version number, such as 1.11.33.4

        If you don't specify a version, defaults to latest-stable unless --devel
        is specified, in which case it defaults to master.

        This option doesn't make sense if we're running within an existing
        ngx_pagespeed checkout.

    -n, --nginx-version <nginx version>
        What version of nginx to build. If not set, this script only prepares the
        ngx_pagespeed module, and expects you to handle including it when you
        build nginx. Valid options include:
        * latest | mainline
        * stable | lts
        * a version number, such as 1.16.0

        If you pass in 'latest' or 'stable' then this script scrapes the nginx download page
        and attempts to determine the latest or stable version automatically.

    -m, --dynamic-module
        Build ngx_pagespeed and Nginx extra modules as a dynamic module.

    -b, --builddir <directory>
        Where to build. Defaults to \$HOME.

    -p, --no-deps-check
        By default, this script checks for the packages it depends on and tries to
        install them. If you have installed dependencies from source or are on a
        non-deb non-rpm system, this won't work. In that case, install the
        dependencies yourself and pass --no-deps-check.

    -s, --psol-from-source
        Build PSOL from source instead of downloading a pre-built binary module.

    -l, --devel
        Sets up a development environment in ngx_pagespeed/nginx, building with
        testing-only dependencies. Includes --psol-from-source, conflicts with
        --nginx-version.    Uses a 'git clone' checkout for ngx_pagespeed and nginx
        instead of downloading a tarball.

    -t, --build-type
        When building PSOL from source, what to tell it for BUILD_TYPE. Defaults
        to 'Release' unless --devel is set in which case it defaults to 'Debug'.

    -y, --assume-yes
        Assume the answer to all prompts is 'yes, please continue'. Intended for
        automated usage, such as buildbots.

    -a, --additional-nginx-configure-arguments
        When running ./configure for nginx, you may want to specify additional
        arguments, such as --with-http_ssl_module. By default this script will
        pause and prompt you for them, but this option lets you pass them in. For
        example, you might do:
        -a '--with-http_ssl_module --with-cc-opt=\"-I /usr/local/include\"'

    -d, --dryrun
        Don't make any changes to the system, just print what changes you
        would have made.

    -x, --extra-modules
        Add default extra modules such as ngx_cache_purge for production environment.

    -h, --help
        Print this message and exit."
}

RED=61
GREEN=62
YELLOW=63

function begin_color() {
    color="$1"
    echo -e -n "\e[${color}m"
}

function end_color() {
    echo -e -n "\e[0m"
}

function echo_color() {
    color="$1"
    shift
    begin_color "$color"
    echo "$@"
    end_color
}

function error() {
    local error_message="$@"
    echo_color "$RED" -n "Error: " >&2
    echo "$@" >&2
}

# Prints an error message and exits with an error code.
function fail() {
    error "$@"

    # Normally I'd use $0 in "usage" here, but since most people will be running
    # this via curl, that wouldn't actually give something useful.
    echo >&2
    echo "For usage information, run this script with --help" >&2
    exit 1
}

function status() {
    echo_color "$GREEN" "$@"
}

function warning() {
    echo_color "$YELLOW" "$@"
}

# Intended to be called as:
#     bash <(curl dl.google.com/.../build_ngx_pagespeed.sh) <args>

# If we set -e or -u then users of this script will see it silently exit on
# failure.    Instead we need to check the exit status of each command manually.
# The run function handles exit-status checking for system-changing commands.
# Additionally, this allows us to easily have a dryrun mode where we don't
# actually make any changes.
INITIAL_ENV=$(printenv | sort)
function run() {
    if "$DRYRUN"; then
        echo_color "$YELLOW" -n "would run"
        echo " $@"
        env_differences=$(comm -13 <(echo "$INITIAL_ENV") <(printenv | sort))
        if [ -n "$env_differences" ]; then
            echo " with the following additional environment variables:"
            echo "$env_differences" | sed 's/^/    /'
        fi
    else
        if ! "$@"; then
            error "Failure running '$@', exiting."
            exit 1
        fi
    fi
}

function redhat_is_installed() {
    local package_name="$1"
    rpm -qa $package_name | grep -q .
}

function debian_is_installed() {
    local package_name="$1"
    dpkg -l $package_name | grep ^ii | grep -q .
}

function version_sort() {
    # We'd rather use sort -V, but that's not available on Centos 5.    This works
    # for versions in the form A.B.C.D or shorter, which is enough for our use.
    sort -t '.' -k 1,1 -k 2,2 -k 3,3 -k 4,4 -g
}

# Compare two numeric versions in the form "A.B.C".    Works with version numbers
# having up to four components, since that's enough to handle both nginx (3) and
# ngx_pagespeed (4).
function version_older_than() {
    local test_version && \
    test_version=$(echo "$@" | tr ' ' '\n' | version_sort | head -n 1)
    local compare_to="$2"
    local older_version="${test_version}"

    test "$older_version" != "$compare_to"
}

function nginx_download_report_error() {
    fail "Couldn't automatically determine the latest nginx version: failed to $* Nginx's download page"
}

function get_nginx_versions_available() {
    # Scrape nginx's download page to try to find the all available nginx versions.
    nginx_download_url="https://nginx.org/en/download.html"

    local nginx_download_page
    nginx_download_page=$(curl -sS --fail "$nginx_download_url") || \
        nginx_download_report_error "download"

    local download_refs
    download_refs=$(echo "$nginx_download_page" | \
        grep -owE '"/download/nginx-[0-9.]*\.tar\.gz"') || \
        nginx_download_report_error "parse"

    versions_available=$(echo "$download_refs" | \
        sed -e 's~^"/download/nginx-~~' -e 's~\.tar\.gz"$~~') || \
        nginx_download_report_error "extract versions from"

    echo "$versions_available"
}

# Try to find the most recent nginx version (mainline).
function determine_latest_nginx_version() {
    local versions_available
    local latest_version

    versions_available=$(get_nginx_versions_available)
    latest_version=$(echo "$versions_available" | version_sort | tail -n 1) || \
        report_error "determine latest (mainline) version from"

    if version_older_than "$latest_version" "1.14.2"; then
        fail "Expected the latest version of nginx to be at least 1.14.2 but found
$latest_version on $nginx_download_url"
    fi

    echo "$latest_version"
}

# Try to find the stable nginx version (mainline).
function determine_stable_nginx_version() {
    local versions_available
    local stable_version

    versions_available=$(get_nginx_versions_available)
    stable_version=$(echo "$versions_available" | version_sort | tail -n 2 | sort -r | tail -n 1) || \
        report_error "determine stable (LTS) version from"

    if version_older_than "1.14.2" "$latest_version"; then
        fail "Expected the latest version of nginx to be at least 1.14.2 but found
$latest_version on $nginx_download_url"
    fi

    echo "$stable_version"
}

# Usage:
# install_dependencies install_pkg_cmd is_pkg_installed_cmd dep1 dep2 ...
#
# install_pkg_cmd is a command to install a dependency
# is_pkg_installed_cmd is a command that returns true if the dependency is
# already installed
# each dependency is a package name
function install_dependencies() {
    local install_pkg_cmd="$1"
    local is_pkg_installed_cmd="$2"
    shift 2

    local missing_dependencies=""

    for package_name in "$@"; do
        if ! $is_pkg_installed_cmd $package_name; then
            missing_dependencies+="$package_name "
        fi
    done
    if [ -n "$missing_dependencies" ]; then
        status "Detected that we're missing the following depencencies:"
        echo " $missing_dependencies"
        status "Installing them:"
        run sudo $install_pkg_cmd $missing_dependencies
    fi
}

function gcc_too_old() {
    # We need gcc >= 4.8
    local gcc_major_version=$(gcc -dumpversion | awk -F. '{print $1}')
    if [ "$gcc_major_version" -lt 4 ]; then
        return 0 # too old
    elif [ "$gcc_major_version" -gt 4 ]; then
        return 1 # plenty new
    fi
    # It's gcc 4.x, check if x >= 8:
    local gcc_minor_version=$(gcc -dumpversion | awk -F. '{print $2}')
    test "$gcc_minor_version" -lt 8
}

function continue_or_exit() {
    if "$ASSUME_YES"; then
        return
    fi

    local prompt="$1"
    echo_color "$YELLOW" -n "$prompt"
    read -p " [y/n] " yn
    if [[ "$yn" == N* || "$yn" == n* ]]; then
        echo "Cancelled."
        exit 0
    fi
}

# If a string is very simple we don't need to quote it.    But we should quote
# everything else to be safe.
function needs_quoting() {
    echo "$@" | grep -q '[^a-zA-Z0-9./_=-]'
}

function escape_for_quotes() {
    echo "$@" | sed -e 's~\\~\\\\~g' -e "s~'~\\\\'~g"
}

function quote_arguments() {
    local argument_str=""
    for argument in "$@"; do
        if [ -n "$argument_str" ]; then
            argument_str+=" "
        fi
        if needs_quoting "$argument"; then
            argument="'$(escape_for_quotes "$argument")'"
        fi
        argument_str+="$argument"
    done
    echo "$argument_str"
}

function build_ngx_pagespeed() {
    getopt --test
    if [ "$?" != 4 ]; then
        # Even Centos 5 and Ubuntu 10 LTS have new-style getopt, so I don't expect
        # this to be hit in practice on systems that are actually able to run
        # PageSpeed.
        fail "Your version of getopt is too old. Exiting with no changes made."
    fi

    opts=$(getopt -o v:n:mxb:pslt:ya:dh \
        --longoptions ngx-pagespeed-version:,nginx-version:,dynamic-module,extra-modules \
        --longoptions buildir:,no-deps-check,psol-from-source,devel,build-type: \
        --longoptions assume-yes,additional-nginx-configure-arguments:,dryrun,help \
        -n "$(basename "$0")" -- "$@")
    if [ $? != 0 ]; then
        usage
        exit 1
    fi
    eval set -- "$opts"

    NPS_VERSION="DEFAULT"
    NGINX_VERSION=""
    # Current working directory as default build dir
    BUILDDIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" >/dev/null && pwd )/nginx_build"
    DO_DEPS_CHECK=true
    PSOL_FROM_SOURCE=false
    DEVEL=false
    BUILD_TYPE=""
    ASSUME_YES=false
    DRYRUN=false
    NGINX_DYNAMIC_MODULE=false
    NGINX_EXTRA_MODULES=false

    # Extra Modules
    NGX_BROTLI=${NGX_BROTLI:-true}
    NGX_CACHE_PURGE=${NGX_CACHE_PURGE:-true}
    NGX_ECHO=${NGX_ECHO:-false}
    NGX_FANCYINDEX=${NGX_FANCYINDEX:-false}
    NGX_HEADERS_MORE=${NGX_HEADERS_MORE:-true}
    NGX_HTTP_AUTH_PAM=${NGX_HTTP_AUTH_PAM:-false}
    NGX_HTTP_GEOIP2=${NGX_HTTP_GEOIP2:-false}
    NGX_HTTP_SUBS_FILTER=${NGX_HTTP_SUBS_FILTER:-false}
    NGX_MEMCACHED=${NGX_MEMCACHED:-false}
    NGX_NAXSI=${NGX_NAXSI:-true}
    NGX_NCHAN=${NGX_NCHAN:-false}
    NGX_PAGESPEED=${NGX_PAGESPEED:-true}
    NGX_REDIS2=${NGX_REDIS2:-false}
    NGX_RTMP=${NGX_RTMP:-false}
    NGX_UPSTREAM_FAIR=${NGX_UPSTREAM_FAIR:-false}
    NGX_VTS=${NGX_VTS:-true}
    NGX_WEB_DAV_EXT=${NGX_WEB_DAV_EXT:-false}

    while true; do
        case "$1" in
            -v | --ngx-pagespeed-version) shift
                NPS_VERSION="$1"
                shift
                ;;
            -n | --nginx-version) shift
                NGINX_VERSION="$1"
                shift
                ;;
            -m | --dynamic-module) shift
                NGINX_DYNAMIC_MODULE=true
                ;;
            -b | --builddir) shift
                BUILDDIR="$1"
                shift
                ;;
            -p | --no-deps-check) shift
                DO_DEPS_CHECK=false
                ;;
            -s | --psol-from-source) shift
                PSOL_FROM_SOURCE=true
                ;;
            -l | --devel) shift
                DEVEL=true
                ;;
            -t | --build-type) shift
                BUILD_TYPE="$1"
                shift
                ;;
            -y | --assume-yes) shift
                ASSUME_YES="true"
                ;;
            -x | --extra-modules) shift
                NGINX_EXTRA_MODULES=true
                ;;
            -a | --additional-nginx-configure-arguments) shift
                ADDITIONAL_NGINX_CONFIGURE_ARGUMENTS="$1"
                shift
                ;;
            -d | --dryrun) shift
                DRYRUN="true"
                ;;
            -h | --help) shift
                usage
                exit 0
                ;;
            --) shift
                break
                ;;
            *)
                echo "Invalid argument: $1"
                usage
                exit 1
                ;;
        esac
    done

    USE_GIT_CHECKOUT="$DEVEL"
    ALREADY_CHECKED_OUT=false
    if [ -e PSOL_BINARY_URL ]; then
        status "Detected that we're running in an existing ngx_pagespeed checkout."
        USE_GIT_CHECKOUT=true
        ALREADY_CHECKED_OUT=true
    fi

    if "$ALREADY_CHECKED_OUT"; then
        if [ "$NPS_VERSION" != "DEFAULT" ]; then
            fail "The --ngx-pagespeed-version argument doesn't make sense when running within an existing checkout."
        fi
    elif [ "$NPS_VERSION" = "DEFAULT" ]; then
        if "$DEVEL"; then
            NPS_VERSION="master"
        else
            NPS_VERSION="latest-stable"
        fi
    fi

    if [ ! -d "$BUILDDIR" ]; then
        run mkdir "$BUILDDIR"
        warning "Told to build in $BUILDDIR, but that directory doesn't exist. Try to create it."
    fi

    BUILD_NGINX=false
    if [ -n "$NGINX_VERSION" ]; then
        BUILD_NGINX=true
    fi

    if "$DEVEL"; then
        PSOL_FROM_SOURCE=true
        BUILD_NGINX=true
        if [ -n "$NGINX_VERSION" ]; then
            fail "The --devel argument conflicts with --nginx. 
In devel mode we use the version of nginx that's included as a submodule."
        fi
        if "$NGINX_DYNAMIC_MODULE"; then
            fail "Can't currently build a dynamic module in --devel mode."
        fi
    fi

    if "$PSOL_FROM_SOURCE" && [ -z "$BUILD_TYPE" ]; then
        if "$DEVEL"; then
            BUILD_TYPE="Debug"
        else
            BUILD_TYPE="Release"
        fi
    elif [ -n "$BUILD_TYPE" ]; then
        fail "Setting --build-type requires --psol-from-source or --devel."
    fi

    if [[ "$NGINX_VERSION" = "latest" || "$NGINX_VERSION" = "mainline" ]]; then
        # When this function fails it prints the debugging information needed first
        # to stderr.
        NGINX_VERSION=$(determine_latest_nginx_version) || exit 1
    elif [[ "$NGINX_VERSION" = "stable" || "$NGINX_VERSION" = "lts" ]]; then
        NGINX_VERSION=$(determine_stable_nginx_version) || exit 1
    fi

    if "$NGINX_DYNAMIC_MODULE"; then
        # Check that ngx_pagespeed and nginx are recent enough to support dynamic
        # modules. Unfortunately NPS_VERSION might be a tag, in which case we don't
        # know. If it's not a numeric version number, then assume it's recent
        # enough and if it's not they'll get an ugly compilation error later.
        # Luckily 1.10.33.5 was a while ago now.
        #
        # I'd like to use =~ here, but they changed syntax between v3 and v4 (quotes
        # moved from mandatory to optional to prohibited).
        if [[ "${NPS_VERSION#*[^0-9.]}" = "$NPS_VERSION" ]] &&
                 version_older_than "$NPS_VERSION" "1.10.33.5"; then
            fail "You're trying to build ngx_pagespeed $NPS_VERSION as a dynamic module, but
ngx_pagespeed didn't add support for dynamic modules until 1.10.33.5."
        fi

        if [ -n "${NGINX_VERSION}" ]; then
            if version_older_than "$NGINX_VERSION" "1.9.13"; then
                fail "You're trying to build nginx $NGINX_VERSION as a dynamic module but nginx didn't
add support for dynamic modules in a way compatible with ngx_pagespeed until 1.9.13."
            fi
        fi
    fi

    if "$DRYRUN"; then
        TEMPDIR="/tmp/output-of-mktemp"
    else
        TEMPDIR=$(mktemp -d)
        function cleanup_tempdir {
            rm -rf "$TEMPDIR"
        }
        trap cleanup_tempdir EXIT
    fi

    extra_flags=()
    # Now make sure our dependencies are installed.
    if "$DO_DEPS_CHECK"; then
        INSTALL_FLAGS=""

        if "$ASSUME_YES"; then
            INSTALL_FLAGS="-y"
        fi

        if [ -f /etc/debian_version ]; then
            status "Detected debian-based distro."

            install_dependencies "apt-get install ${INSTALL_FLAGS}" debian_is_installed \
                build-essential zlib1g-dev libpcre3 libpcre3-dev unzip wget uuid-dev

            if gcc_too_old; then
                if [ ! -e /usr/lib/gcc-mozilla/bin/gcc ]; then
                    status "Detected that gcc is older than 4.8. Installing gcc-mozilla"
                    status "which installs gcc-4.8 into /usr/lib/gcc-mozilla/ and doesn't"
                    status "affect your global gcc installation."
                    run sudo apt-get install ${INSTALL_FLAGS} gcc-mozilla
                fi

                extra_flags=("--with-cc=/usr/lib/gcc-mozilla/bin/gcc" \
                            "--with-ld-opt=-static-libstdc++")
            fi

        elif [ -f /etc/redhat-release ]; then
            status "Detected redhat-based distro."

            install_dependencies "yum install ${INSTALL_FLAGS}" redhat_is_installed \
                gcc-c++ pcre-devel zlib-devel make unzip wget libuuid-devel

            if gcc_too_old; then
                if [ ! -e /opt/rh/devtoolset-2/root/usr/bin/gcc ]; then
                    redhat_major_version=$(
                        cat /etc/redhat-release | grep -o -E '[0-9]+' | head -n 1)
                    if [ "$redhat_major_version" == 5 ]; then
                        slc_version=5
                    elif [ "$redhat_major_version" == 6 ]; then
                        slc_version=6
                    else
                        fail "Unexpected major version $redhat_major_version in /etc/redhat-release:
$(cat /etc/redhat-release) Expected 5 or 6."
                    fi

                    status "Detected that gcc is older than 4.8. Scientific Linux"
                    status "provides a gcc package that installs gcc-4.8 into /opt/ and"
                    status "doesn't affect your global gcc installation."
                    slc_key="https://linux.web.cern.ch/linux/scientific6/docs/repository/"
                    slc_key+="cern/slc6X/i386/RPM-GPG-KEY-cern"
                    slc_key_out="$TEMPDIR/RPM-GPG-KEY-cern"
                    run sudo wget -q "$slc_key" -O "$slc_key_out"
                    run sudo rpm --import "$slc_key_out"

                    repo_fname="/etc/yum.repos.d/slc${slc_version}-devtoolset.repo"
                    if [ -e "$repo_fname" ]; then
                        fail "Expected $repo_fname not to exist; aborting."
                    fi

                    repo_url="https://linux.web.cern.ch/linux/scientific${slc_version}/"
                    repo_url+="/docs/repository/cern/devtoolset/"
                    repo_url+="slc${slc_version}-devtoolset.repo"
                    run sudo wget -q -O "$repo_fname" "$repo_url"
                    run sudo yum install ${INSTALL_FLAGS} devtoolset-2-gcc-c++ devtoolset-2-binutils
                fi
                extra_flags=("--with-cc=/opt/rh/devtoolset-2/root/usr/bin/gcc")
            fi
        else
            fail "
This doesn't appear to be a deb-based distro or an rpm-based one Not going to
be able to install dependencies. Please install dependencies manually and rerun
with --no-deps-check."
        fi
        status "Operating system dependencies are all set."
    else
        status "Not checking whether operating system dependencies are installed."
    fi

    function delete_if_already_exists() {
        if "$DRYRUN"; then return; fi

        local directory="$1"
        if [ -d "$directory" ]; then
            if [ ${#directory} -lt 8 ]; then
                fail "Not deleting $directory; name is suspiciously short. Something is wrong."
            fi

            continue_or_exit "OK to delete $directory?"
            run rm -rf "$directory"
        fi
    }

    # In general, the zip github builds for tag foo unzips to ngx_pagespeed-foo,
    # but it looks like they special case vVERSION tags to ngx_pagespeed-VERSION
    if [[ "$NPS_VERSION" =~ ^[0-9]*[.][0-9]*[.][0-9]*[.][0-9]*$ ]]; then
        # We've been given a numeric version number.    This has an associated tag
        # in the form vVERSION-beta.
        tag_name="v${NPS_VERSION}-beta"
        nps_downloaded_fname="ngx_pagespeed-${NPS_VERSION}-beta"
    else
        # We've been given a tag name, like latest-beta.    Download that directly.
        tag_name="$NPS_VERSION"
        nps_downloaded_fname="ngx_pagespeed-${NPS_VERSION}"
    fi

    install_dir="this-only-makes-sense-in-devel-mode"
    if "$USE_GIT_CHECKOUT"; then
        # We're either doing a --devel build, or someone is running us from an
        # existing git checkout.
        nps_module_dir="$PWD"
        install_dir="$nps_module_dir"
        if "$ALREADY_CHECKED_OUT"; then
            run cd "$nps_module_dir"
        else
            echo "Downloading ngx_pagespeed..."
            run git clone -q "git@github.com:pagespeed/ngx_pagespeed.git" \
                "$nps_module_dir"
            run cd "$nps_module_dir"
            run git checkout "$tag_name"
        fi

        submodules_dir="$nps_module_dir/testing-dependencies"
        if "$DEVEL"; then
            echo "Downloading dependencies..."
            run git submodule update --init --recursive
            if [[ "$CONTINUOUS_INTEGRATION" != true ]]; then
                status "Switching submodules over to git protocol."
                # This lets us push to github by public key.
                for config in $(find .git/ -name config) ; do
                    run sed -i "s|https://github.com/|git@github.com:|" $config ;
                done
            fi
        fi
    else
        nps_baseurl="https://github.com/apache/incubator-pagespeed-ngx/archive"
        nps_downloaded="$TEMPDIR/$nps_downloaded_fname.zip"
        echo "Downloading ngx_pagespeed..."
        run wget -q "$nps_baseurl/$tag_name.zip" -O "$nps_downloaded"
        # Read the directory name from the zip, the first line is expected to have it.
        nps_module_dir=$(unzip -qql "$nps_downloaded" | head -n1 | tr -s ' ' | cut -d' ' -f5-)
        nps_module_dir="$BUILDDIR/${nps_module_dir::-1}"
        delete_if_already_exists "$nps_module_dir"
        status "Extracting ngx_pagespeed..."
        run unzip -q "$nps_downloaded" -d "$BUILDDIR"
        run cd "$nps_module_dir"
    fi

    MOD_PAGESPEED_DIR=""
    PSOL_BINARY=""
    if "$PSOL_FROM_SOURCE"; then
        MOD_PAGESPEED_DIR="$PWD/testing-dependencies/mod_pagespeed"
        git submodule update --init --recursive -- "$MOD_PAGESPEED_DIR"
        run pushd "$MOD_PAGESPEED_DIR"

        if "$DEVEL"; then
            if [ ! -d "$HOME/apache2" ]; then
                run install/build_development_apache.sh 2.2 prefork
            fi
            cd devel
            run make apache_debug_psol
            PSOL_BINARY="$MOD_PAGESPEED_DIR/out/$BUILD_TYPE/pagespeed_automatic.a"
        else
            if "$DO_DEPS_CHECK"; then
                skip_deps_arg=""
            else
                skip_deps_arg="--skip_deps"
            fi

            run install/build_psol.sh --skip_tests --skip_packaging "$skip_deps_arg"
            PSOL_BINARY="$MOD_PAGESPEED_DIR/pagespeed/automatic/pagespeed_automatic.a"
        fi
        run popd
    else
        # Now we need to figure out what precompiled version of PSOL to build
        # ngx_pagespeed against.
        if "$DRYRUN"; then
            psol_url="https://psol.example.com/cant-get-psol-version-in-dry-run.tar.gz"
        elif [ -e PSOL_BINARY_URL ]; then
            # Releases after 1.11.33.4 there is a PSOL_BINARY_URL file that tells us
            # where to look.
            psol_url="$(scripts/format_binary_url.sh PSOL_BINARY_URL)"
            if [[ "$psol_url" != https://* ]]; then
                fail "Got bad psol binary location information: $psol_url"
            fi
        else
            # For past releases we have to grep it from the config file.    The url has
            # always looked like this, and the config file has contained it since
            # before we started tagging our ngx_pagespeed releases.
            psol_url="$(grep -o \
                    "https://dl.google.com/dl/page-speed/psol/[0-9.]*.tar.gz" config)"
            if [ -z "$psol_url" ]; then
                fail "Couldn't find PSOL url in $PWD/config"
            fi
        fi

        echo "Downloading PSOL binary..."
        run wget -q "$psol_url"

        status "Extracting PSOL..."
        run tar -xzf $(basename "$psol_url") # extracts to psol/
    fi

    if "$NGINX_DYNAMIC_MODULE"; then
        add_nps_module="--add-dynamic-module=$nps_module_dir"
    else
        add_nps_module="--add-module=$nps_module_dir"
    fi
    configure_args=("$add_nps_module" "${extra_flags[@]}")

    if "$DEVEL"; then
        # Development env
        if "$NGINX_DYNAMIC_MODULE"; then
            add_modules=("--add-dynamic-module=$submodules_dir/ngx_cache_purge"
                        "--add-dynamic-module=$submodules_dir/ngx_devel_kit"
                        "--add-dynamic-module=$submodules_dir/set-misc-nginx-module"
                        "--add-dynamic-module=$submodules_dir/headers-more-nginx-module")
        else
            add_modules=("--add-module=$submodules_dir/ngx_cache_purge"
                        "--add-module=$submodules_dir/ngx_devel_kit"
                        "--add-module=$submodules_dir/set-misc-nginx-module"
                        "--add-module=$submodules_dir/headers-more-nginx-module")
        fi
        configure_args=("${configure_args[@]}"
                        "--prefix=$install_dir/nginx"
                        "--with-http_v2_module"
                        "${add_modules[@]}")
        if [ "$BUILD_TYPE" = "Debug" ]; then
            configure_args=("${configure_args[@]}" "--with-debug")
        fi
    else
        # Production env
        configure_args=("${configure_args[@]}"
                        "--prefix=/usr/share/nginx"
                        "--sbin-path=/usr/sbin/nginx"
                        "--modules-path=/usr/lib/nginx/modules"
                        "--conf-path=/etc/nginx/nginx.conf"
                        "--error-log-path=/var/log/nginx/error.log"
                        "--http-log-path=/var/log/nginx/access.log"
                        "--pid-path=/run/nginx.pid"
                        "--lock-path=/var/lock/nginx.lock"
                        "--user=www-data"
                        "--group=www-data"
                        "--with-compat"
                        "--with-file-aio"
                        "--with-http_addition_module"
                        "--with-http_auth_request_module"
                        "--with-http_flv_module"
                        "--with-http_geoip_module=dynamic"
                        "--with-http_gunzip_module"
                        "--with-http_gzip_static_module"
                        "--with-http_image_filter_module=dynamic"
                        "--with-http_mp4_module"
                        "--with-http_random_index_module"
                        "--with-http_realip_module"
                        "--with-http_secure_link_module"
                        "--with-http_slice_module"
                        "--with-http_ssl_module"
                        "--with-http_stub_status_module"
                        "--with-http_sub_module"
                        "--with-http_v2_module"
                        "--with-http_xslt_module=dynamic"
                        "--with-mail=dynamic"
                        "--with-mail_ssl_module"
                        "--with-stream=dynamic"
                        "--with-stream_realip_module"
                        "--with-stream_ssl_module"
                        "--with-stream_ssl_preread_module"
                        "--with-threads")
    fi

    if ! "$BUILD_NGINX"; then
        # Just prepare the module for them to install.
        status "ngx_pagespeed is ready to be built against nginx."
        echo "When running ./configure:"
        if "$PSOL_FROM_SOURCE"; then
            echo "Set the following environment variables:"
            echo "  MOD_PAGESPEED_DIR=$MOD_PAGESPEED_DIR"
            echo "  PSOL_BINARY=$PSOL_BINARY"
        fi
        echo "  Give ./configure the following arguments:"
        echo "      $(quote_arguments "${configure_args[@]}")"
        echo ""

        if [[ ${#extra_flags[@]} -eq 0 ]]; then
            echo "If this is for integration with an already-built nginx, make sure"
            echo "to include any other arguments you originally passed to"
            echo "./configure. You can see these with 'nginx -V'."
        else
            echo "Note: because we need to set $(quote_arguments "${extra_flags[@]}")"
            echo "on this platform, if you want to integrate ngx_pagespeed with an"
            echo "already-built nginx you're going to need to rebuild your nginx with"
            echo "those flags set."
        fi
    else
        # Development env
        if "$DEVEL"; then
            # Use the nginx we loaded as a submodule
            nginx_dir="$submodules_dir/nginx"
            configure_location="auto"
        else
            # Download and build the specified nginx version.
            nginx_leaf="nginx-${NGINX_VERSION}.tar.gz"
            nginx_fname="$TEMPDIR/$nginx_leaf"
            echo "Downloading nginx..."
            run wget -q "http://nginx.org/download/$nginx_leaf" -O "$nginx_fname"
            nginx_dir="$BUILDDIR/nginx-${NGINX_VERSION}/"
            delete_if_already_exists "$nginx_dir"
            status "Extracting nginx..."
            run tar -xzf "$nginx_fname" --directory "$BUILDDIR"
            configure_location="."
        fi
        run cd "$nginx_dir"

        configure=("$configure_location/configure" "${configure_args[@]}")
        additional_configure_args=""
        if [ -z "${ADDITIONAL_NGINX_CONFIGURE_ARGUMENTS+x}" ]; then
            if ! "$ASSUME_YES"; then
                echo "About to build nginx. Do you have any additional ./configure"
                echo "arguments you would like to set? For example, if you would like"
                echo "to build nginx with https support give --with-http_ssl_module"
                echo "If you don't have any, just press enter."
                read -p "> " additional_configure_args
            fi
        else
            additional_configure_args="$ADDITIONAL_NGINX_CONFIGURE_ARGUMENTS"
        fi

        if [ -n "$additional_configure_args" ]; then
            # Split additional_configure_args respecting any internal quotation.
            # Otherwise things like --with-cc-opt='-foo -bar' won't work.
            eval additional_configure_args=("$additional_configure_args")
            configure=("${configure[@]}" "${additional_configure_args[@]}")
        fi

        echo "About to configure nginx with:"
        echo "  $(quote_arguments "${configure[@]}")"
        continue_or_exit "Does this look right?"
        MOD_PAGESPEED_DIR="$MOD_PAGESPEED_DIR" \
            PSOL_BINARY="$PSOL_BINARY" \
            run "${configure[@]}"

        if ! "$DEVEL"; then
            continue_or_exit "Build nginx?"
        fi
        run make

        if "$DEVEL"; then
            run make install

            status "Nginx installed with ngx_pagespeed, and set up for development."
            echo "To run tests:"
            echo "  cd $nps_module_dir"
            echo "  test/run_tests.sh"
            echo
            echo "To rebuild after changes:"
            echo "  scripts/rebuild.sh"
        else
            continue_or_exit "Install nginx?"
            run sudo make install

            # Create default ngx_pagespeed cache directory
            if [ ! -d /var/cache/nginx/pagespeed_cache ]; then
                run mkdir -p /var/cache/nginx/pagespeed_cache
                run chown -hR root:www-data /var/cache/nginx
            fi

            # Create log dir.
            if [ ! -d /var/log/pagespeed ]; then
                run mkdir -p /var/log/pagespeed
            fi

            # Cleanup build dir
            if [ -d "$BUILDDIR" ]; then
                run rm -fr "$BUILDDIR"
            fi

            if "$NGINX_DYNAMIC_MODULE"; then
                echo "Nginx installed with ngx_pagespeed support available as a"
                echo "loadable module."
                echo
                echo "To load the ngx_pagespeed module, you'll need to add:"
                echo "  load_module \"modules/ngx_pagespeed.so\";"
                echo "at the top of your main nginx configuration file."
            else
                echo "Nginx installed with ngx_pagespeed support compiled-in."
            fi
            echo
            echo "If this is a new installation you probably need an init script to"
            echo "manage starting and stopping the nginx service. See:"
            echo "http://wiki.nginx.org/InitScripts"
            echo
            echo "You'll also need to configure ngx_pagespeed if you haven't yet:"
            echo "https://developers.google.com/speed/pagespeed/module/configuration"
            echo
            echo "We have created default ngx_pagespeed File Cache directory located at:"
            echo "/var/cache/nginx/pagespeed_cache/"
        fi
    fi
    if "$DRYRUN"; then
        echo_color "$YELLOW" "[this was a dry run; your system is unchanged]"
    fi
}

# Start running things from a call at the end so if this script is executed
# after a partial download it doesn't do anything.
build_ngx_pagespeed "$@"