.. include:: /_includes/all.rst .. _vhost_gen_virtual_host_templates: ********************** Virtual host templates ********************** **Table of Contents** .. contents:: :local: Overview ======== What is it? ----------- vhost-gen templates are yaml files which contain a general definition for a virtual host definition. Those templates contain placeholders in the form of ``____`` which will be replaced by settings applied to the Devilbox. .. seealso:: |ext_lnk_project_vhost_gen| Template files -------------- By default, vhost-gen templates are located within the Devilbox root directory under ``cfg/vhost-gen/``. The templates file names are suffixed with ``-example-`` and are absolutely identical to what is shipped inside each Devilbox web server Docker container. .. note:: Also note that nginx stable and nginx mainline share the same template as their configuration syntax is identical. Normal virtual host ^^^^^^^^^^^^^^^^^^^ All template files ending by ``-example-vhost`` can be used to customize a normal file serving virtual host. .. code-block:: bash :emphasize-lines: 5,7,9 host> tree -L 1 cfg/vhost-gen/ cfg/vhost-gen/ ├── apache22.yml-example-rproxy ├── apache22.yml-example-vhost ├── apache24.yml-example-rproxy ├── apache24.yml-example-vhost ├── nginx.yml-example-rproxy ├── nginx.yml-example-vhost └── README.md 0 directories, 7 files Reverse proxy ^^^^^^^^^^^^^ All template files ending by ``-example-rproxy`` can be used to create a reverse proxy for your project. .. code-block:: bash :emphasize-lines: 4,6,8 host> tree -L 1 cfg/vhost-gen/ cfg/vhost-gen/ ├── apache22.yml-example-rproxy ├── apache22.yml-example-vhost ├── apache24.yml-example-rproxy ├── apache24.yml-example-vhost ├── nginx.yml-example-rproxy ├── nginx.yml-example-vhost └── README.md 0 directories, 7 files Template sections ----------------- All vhost-gen templates consist of three sections: +----------------+----------------+ | Section | Description | +================+================+ | ``vhost`` | |vhost| | +----------------+----------------+ | ``vhost_type`` | |vhost_type| | +----------------+----------------+ | ``features`` | |features| | +----------------+----------------+ .. |vhost| replace:: This is the part that is actually rendered into the vhost configuration. All other |br| sections will be inserted into this one. .. |vhost_type| replace:: The vhost type determines the type of vhost: reverse proxy or document root based |br| vhost. The Devilbox currently does not support reverse proxy vhost. .. |features| replace:: The feature section contains many sub-sections that are replaced into the ``vhost`` |br| section before final rendering. Virtual host Templates ====================== These templates can be used to alter the behaviour of the vhost on a per project base or globally. Apache 2.2 template ------------------- .. literalinclude:: ../../cfg/vhost-gen/apache22.yml-example-vhost :caption: apache22.yml-example-vhost :language: yaml Apache 2.4 template ------------------- .. literalinclude:: ../../cfg/vhost-gen/apache24.yml-example-vhost :caption: apache24.yml-example-vhost :language: yaml Nginx template -------------- .. literalinclude:: ../../cfg/vhost-gen/nginx.yml-example-vhost :caption: nginx.yml-example-vhost :language: yaml Reverse proxy Templates ======================= These templates can be used to change a normal vhost into a reverse proxy project. This might be useful if you use NodeJs applications for example. .. important:: Do not apply those templates globally. They are intended to be used on a per project base. .. note:: In order to use the Reverse Proxy templates you will only need to adjust the listening port, everything else will work as already defined. So you simply need to copy those files into your project directory. Lines that need to be changed are marked below. The currently set default listening port is ``8000``. Apache 2.2 template ------------------- .. literalinclude:: ../../cfg/vhost-gen/apache22.yml-example-rproxy :caption: apache22.yml-example-rproxy :language: yaml :emphasize-lines: 51,52 Apache 2.4 template ------------------- .. literalinclude:: ../../cfg/vhost-gen/apache24.yml-example-rproxy :caption: apache24.yml-example-rproxy :language: yaml :emphasize-lines: 51,52 Nginx template -------------- .. literalinclude:: ../../cfg/vhost-gen/nginx.yml-example-rproxy :caption: nginx.yml-example-rproxy :language: yaml :emphasize-lines: 53