ExternalVendorCode/devilbox
1
0
Fork 0
mirror of https://github.com/cytopia/devilbox.git synced 2025-05-03 09:13:08 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Generalize links

Browse Source
This commit is contained in:
cytopia 2018-07-26 09:37:30 +02:00
parent ddc23aafd8
commit dcbff8c44a
No known key found for this signature in database
GPG Key ID: 6D56EDB8695128A2
18 changed files with 227 additions and 124 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
docs/_includes/all.rst
View File

@ -22,6 +22,7 @@
============================================================ ============================================================
.. include:: /_includes/links/apps.rst .. include:: /_includes/links/apps.rst
.. include:: /_includes/links/blogs.rst
.. include:: /_includes/links/dns.rst .. include:: /_includes/links/dns.rst
.. include:: /_includes/links/documentation.rst .. include:: /_includes/links/documentation.rst
.. include:: /_includes/links/docker.rst .. include:: /_includes/links/docker.rst
@ -29,6 +30,7 @@
.. include:: /_includes/links/docker-images.rst .. include:: /_includes/links/docker-images.rst
.. include:: /_includes/links/examples.rst .. include:: /_includes/links/examples.rst
.. include:: /_includes/links/git.rst .. include:: /_includes/links/git.rst
.. include:: /_includes/links/prerequistes.rst
.. include:: /_includes/links/ssh.rst .. include:: /_includes/links/ssh.rst
.. include:: /_includes/links/ssl.rst .. include:: /_includes/links/ssl.rst
.. include:: /_includes/links/tools.rst .. include:: /_includes/links/tools.rst

23
docs/_includes/links/blogs.rst Normal file
View File

@ -0,0 +1,23 @@
.. |ext_lnk_blog_deliciousbrains| raw:: html
<a target="_blank" href="https://deliciousbrains.com/devilbox-local-wordpress-development-docker">
Using Devilbox For Local WordPress Development In Docker <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a>
.. |ext_lnk_blog_moritzkanzler| raw:: html
<a target="_blank" href="https://blog.moritzkanzler.de/devilbox-lokaler-webserver-mit-apache-php-und-mysql-im-docker-container/">
Devilbox: Lokaler Webserver mit Apache, PHP und MySQL im Docker Container <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a>
.. |ext_lnk_blog_joomla_pr_testing_platform| raw:: html
<a target="_blank" href="https://docs.joomla.org/PR_Testing_Platform">
PR Testing Platform <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a>
.. |ext_lnk_blog_joomla_gsoc2017| raw:: html
<a target="_blank" href="https://docs.joomla.org/GSOC_2017">
Google Summer of Code 2017 <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a>

7
docs/_includes/links/docker-compose.rst
View File

@ -79,3 +79,10 @@
<a target="_blank" href="https://docs.docker.com/compose/compose-file/#external_links"> <a target="_blank" href="https://docs.docker.com/compose/compose-file/#external_links">
Docker Compose: extra_hosts <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" /> Docker Compose: extra_hosts <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a> </a>
.. |ext_lnk_docker_compose_extends| raw:: html
<a target="_blank" href="https://docs.docker.com/compose/extends/">
Docker Compose: Share Compose configurations between files and projects <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a>

35
docs/_includes/links/prerequistes.rst Normal file
View File

@ -0,0 +1,35 @@
.. |ext_lnk_prereq_docker_lin| raw:: html
<a target="_blank" href="https://docs.docker.com/install/#server">
Docker <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a>
.. |ext_lnk_prereq_docker_mac| raw:: html
<a target="_blank" href="https://docs.docker.com/docker-for-mac/install/">
Docker for Mac <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a>
.. |ext_lnk_prereq_docker_mac_tb| raw:: html
<a target="_blank" href="https://docs.docker.com/toolbox/toolbox_install_mac/">
Docker Toolbox <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a>
.. |ext_lnk_prereq_docker_win| raw:: html
<a target="_blank" href="https://docs.docker.com/docker-for-windows/install/">
Docker for Windows <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a>
.. |ext_lnk_prereq_docker_win_tb| raw:: html
<a target="_blank" href="https://docs.docker.com/toolbox/toolbox_install_windows/">
Docker Toolbox <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a>
.. |ext_lnk_prereq_docker_win_ee| raw:: html
<a target="_blank" href="https://www.docker.com/docker-windows-server">
Docker EE <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a>

12
docs/_includes/links/ssl.rst
View File

@ -9,3 +9,15 @@
<a target="_blank" href="https://ma.ttias.be/chrome-force-dev-domains-https-via-preloaded-hsts/"> <a target="_blank" href="https://ma.ttias.be/chrome-force-dev-domains-https-via-preloaded-hsts/">
Chrome & Firefox now force .dev domains to HTTPS via preloaded HSTS <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" /> Chrome & Firefox now force .dev domains to HTTPS via preloaded HSTS <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a> </a>
.. |ext_lnk_ssl_certificate_authority| raw:: html
<a target="_blank" href="https://en.wikipedia.org/wiki/Certificate_authority">
Certificate Authority <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a>
.. |ext_lnk_ssl_gfi_root_cert_guide| raw:: html
<a target="_blank" href="https://manuals.gfi.com/en/kerio/connect/content/server-configuration/ssl-certificates/adding-trusted-root-certificates-to-the-server-1605.html">
GFI Root Certificate guide <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a>

34
docs/_includes/links/tools.rst
View File

@ -11,7 +11,7 @@
.. |ext_lnk_tool_linuxbrew| raw:: html .. |ext_lnk_tool_linuxbrew| raw:: html
<a target="_blank" href="http://linuxbrew.sh"> <a target="_blank" href="https://linuxbrew.sh">
Linux brew <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" /> Linux brew <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a> </a>
@ -87,6 +87,24 @@
MD linter <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" /> MD linter <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a> </a>
.. |ext_lnk_tool_mongodump| raw:: html
<a target="_blank" href="https://docs.mongodb.com/manual/reference/program/mongodump/">
mongodump <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a>
.. |ext_lnk_tool_mongorestore| raw:: html
<a target="_blank" href="https://docs.mongodb.com/manual/reference/program/mongorestore/">
mongorestore <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a>
.. |ext_lnk_tool_mysqldump| raw:: html
<a target="_blank" href="https://dev.mysql.com/doc/refman/5.7/en/mysqldump.html">
mysqldump <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a>
.. |ext_lnk_tool_mysqldump_secure| raw:: html .. |ext_lnk_tool_mysqldump_secure| raw:: html
<a target="_blank" href="https://mysqldump-secure.org"> <a target="_blank" href="https://mysqldump-secure.org">
@ -123,6 +141,18 @@
PHP Code Beautifier and Fixer <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" /> PHP Code Beautifier and Fixer <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a> </a>
.. |ext_lnk_tool_pg_dump| raw:: html
<a target="_blank" href="https://www.postgresql.org/docs/current/static/backup-dump.html">
pg_dump <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a>
.. |ext_lnk_tool_pgsql_restore| raw:: html
<a target="_blank" href="https://www.postgresql.org/docs/current/static/backup-dump.html#BACKUP-DUMP-RESTORE">
pgsql <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a>
.. |ext_lnk_tool_photon| raw:: html .. |ext_lnk_tool_photon| raw:: html
<a target="_blank" href="https://photoncms.com/resources/installing"> <a target="_blank" href="https://photoncms.com/resources/installing">
@ -131,7 +161,7 @@
.. |ext_lnk_tool_sass| raw:: html .. |ext_lnk_tool_sass| raw:: html
<a target="_blank" href="http://sass-lang.com"> <a target="_blank" href="https://sass-lang.com">
Sass <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" /> Sass <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a> </a>

42
docs/_includes/links/xdebug.rst
View File

@ -1,3 +1,9 @@
..
============================================================
Xdebug configuration
============================================================
.. |ext_lnk_github_devilbox_xdebug_on_mac| raw:: html .. |ext_lnk_github_devilbox_xdebug_on_mac| raw:: html
<a target="_blank" href="https://github.com/devilbox/xdebug"> <a target="_blank" href="https://github.com/devilbox/xdebug">
@ -9,3 +15,39 @@
<a target="_blank" href="https://gist.github.com/ralphschindler/535dc5916ccbd06f53c1b0ee5a868c93"> <a target="_blank" href="https://gist.github.com/ralphschindler/535dc5916ccbd06f53c1b0ee5a868c93">
Xdebug on MacOS (original) <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" /> Xdebug on MacOS (original) <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a> </a>
.. |ext_lnk_xdebug_settings| raw:: html
<a target="_blank" href="https://xdebug.org/docs/all_settings">
Xdebug: all settings <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a>
.. |ext_lnk_xdebug_remote_debugging| raw:: html
<a target="_blank" href="https://xdebug.org/docs/remote#browser_session">
Xdebug: remote debugging <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a>
..
============================================================
Xdebug IDE/editor configuration
============================================================
.. |ext_lnk_xdebug_ide_atom_php_debug| raw:: html
<a target="_blank" href="https://atom.io/packages/php-debug">
php-debug <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a>
.. |ext_lnk_xdebug_ide_sublime_xdebug_client| raw:: html
<a target="_blank" href="https://github.com/martomo/SublimeTextXdebug">
Xdebug client <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a>
.. |ext_lnk_xdebug_ide_vscode_php_debug| raw:: html
<a target="_blank" href="https://github.com/felixfbecker/vscode-php-debug">
vscode-php-debug <img src="https://raw.githubusercontent.com/cytopia/icons/master/11x11/ext-link.png" />
</a>

4
docs/configuration-files/docker-compose-override-yml.rst
View File

@ -1,3 +1,5 @@
.. include:: /_includes/all.rst
.. _docker_compose_override_yml: .. _docker_compose_override_yml:
*************************** ***************************
@ -14,7 +16,7 @@ By default, this file does not exist and you must create it. You can either copy
.. contents:: :local: .. contents:: :local:
.. seealso:: Official Docker documentation: `Share Compose configurations between files and projects <https://docs.docker.com/compose/extends>`_ .. seealso:: |ext_lnk_docker_compose_extends|
Create docker-compose.override.yml Create docker-compose.override.yml

79
docs/getting-started/prerequisites.rst
View File

@ -22,64 +22,27 @@ Supported host OS
The Devilbox runs on all major operating systems which provide ``Docker`` and ``Docker Compose``. The Devilbox runs on all major operating systems which provide ``Docker`` and ``Docker Compose``.
See the matrix below for supported versions: See the matrix below for supported versions:
+----------------+---------------------+---------------------+-------------+ +----------------+---------------------+--------------------------------+-------------+
| OS | Version | Type | Recommended | | OS | Version | Type | Recommended |
+================+=====================+=====================+=============+ +================+=====================+================================+=============+
| |img_logo_lin| | Any | |tbl_docker_lin| | yes | | |img_logo_lin| | Any | |ext_lnk_prereq_docker_lin| | yes |
+----------------+---------------------+---------------------+-------------+ +----------------+---------------------+--------------------------------+-------------+
| | | | | | | | | |
+----------------+---------------------+---------------------+-------------+ +----------------+---------------------+--------------------------------+-------------+
| |img_logo_mac| | Any | |tbl_docker_mac| | yes | | |img_logo_mac| | Any | |ext_lnk_prereq_docker_mac| | yes |
| | +---------------------+-------------+ | | +--------------------------------+-------------+
| | | |tbl_docker_tb_mac| | | | | | |ext_lnk_prereq_docker_mac_tb| | |
+----------------+---------------------+---------------------+-------------+ +----------------+---------------------+--------------------------------+-------------+
| | | | | | | | | |
+----------------+---------------------+---------------------+-------------+ +----------------+---------------------+--------------------------------+-------------+
| |img_logo_win| | Windows 7 | |tbl_docker_tb_win| | | | |img_logo_win| | Windows 7 | |ext_lnk_prereq_docker_win_tb| | yes |
| +---------------------+---------------------+-------------+ | +---------------------+--------------------------------+-------------+
| | Windows 10 | |tbl_docker_win| | yes | | | Windows 10 | |ext_lnk_prereq_docker_win| | yes |
| | +---------------------+-------------+ | | +--------------------------------+-------------+
| | | |tbl_docker_tb_win| | | | | | |ext_lnk_prereq_docker_win_tb| | |
| +---------------------+---------------------+-------------+ | +---------------------+--------------------------------+-------------+
| | Windows Server 2016 | |tbl_docker_win_ee| | yes | | | Windows Server 2016 | |ext_lnk_prereq_docker_win_ee| | yes |
+----------------+---------------------+---------------------+-------------+ +----------------+---------------------+--------------------------------+-------------+
.. |tbl_docker_lin| raw:: html
<a target="_blank" href="https://docs.docker.com/install/#server">
Docker <img src="/_static/img/icons/ext-link.svg" />
</a>
.. |tbl_docker_mac| raw:: html
<a target="_blank" href="https://docs.docker.com/docker-for-mac/install/">
Docker for Mac <img src="/_static/img/icons/ext-link.svg" />
</a>
.. |tbl_docker_tb_mac| raw:: html
<a target="_blank" href="https://docs.docker.com/toolbox/toolbox_install_mac/">
Docker Toolbox <img src="/_static/img/icons/ext-link.svg" />
</a>
.. |tbl_docker_win| raw:: html
<a target="_blank" href="https://docs.docker.com/docker-for-windows/install/">
Docker for Windows <img src="/_static/img/icons/ext-link.svg" />
</a>
.. |tbl_docker_tb_win| raw:: html
<a target="_blank" href="https://docs.docker.com/toolbox/toolbox_install_windows/">
Docker Toolbox <img src="/_static/img/icons/ext-link.svg" />
</a>
.. |tbl_docker_win_ee| raw:: html
<a target="_blank" href="https://www.docker.com/docker-windows-server">
Docker EE <img src="/_static/img/icons/ext-link.svg" />
</a>
Required software Required software

2
docs/intermediate/configure-php-xdebug/editor-atom.rst
View File

@ -52,7 +52,7 @@ Configuration
**1. Install php-debug for Atom** **1. Install php-debug for Atom**
.. seealso:: `php-debug <https://atom.io/packages/php-debug>`_ .. seealso:: |ext_lnk_xdebug_ide_atom_php_debug|
**2. Configure path mapping in config.cson or ui** **2. Configure path mapping in config.cson or ui**

2
docs/intermediate/configure-php-xdebug/editor-sublime3.rst
View File

@ -54,7 +54,7 @@ Configuration
Use Sublime's Package Control to search for and install ``Xdebug Client``. Use Sublime's Package Control to search for and install ``Xdebug Client``.
.. seealso:: `Xdebug Client <https://github.com/martomo/SublimeTextXdebug>`_ .. seealso:: |ext_lnk_xdebug_ide_sublime_xdebug_client|
**2. Configure Xdebug.sublime-settings** **2. Configure Xdebug.sublime-settings**

2
docs/intermediate/configure-php-xdebug/editor-vscode.rst
View File

@ -53,7 +53,7 @@ Configuration
**1. Install vscode-php-debug** **1. Install vscode-php-debug**
.. seealso:: `vscode-php-debug <https://github.com/felixfbecker/vscode-php-debug>`_ .. seealso:: |ext_lnk_xdebug_ide_vscode_php_debug|
**2. Configure launch.json** **2. Configure launch.json**

8
docs/intermediate/configure-php-xdebug/php-xdebug-options.rst
View File

@ -29,7 +29,7 @@ Consider the following ``xdebug.ini`` as an example:
xdebug.idekey="PHPSTORM" xdebug.idekey="PHPSTORM"
xdebug.remote_log=/var/log/php/xdebug.log xdebug.remote_log=/var/log/php/xdebug.log
.. seealso:: https://xdebug.org/docs/all_settings .. seealso:: |ext_lnk_xdebug_settings|
default_enable default_enable
-------------- --------------
@ -59,9 +59,9 @@ this setting unchanged.
remote_autostart remote_autostart
---------------- ----------------
Normally you need to use a specific HTTP GET/POST variable to start remote debugging (see Normally you need to use a specific HTTP GET/POST variable to start remote debugging (see
`Remote Debugging <https://xdebug.org/docs/remote#browser_session>`_). When this setting is set to |ext_lnk_xdebug_remote_debugging|). When this setting is set to ``1``, Xdebug will always attempt
``1``, Xdebug will always attempt to start a remote debugging session and try to connect to a client, to start a remote debugging session and try to connect to a client, even if the GET/POST/COOKIE
even if the GET/POST/COOKIE variable was not present. variable was not present.
idekey idekey
------ ------

8
docs/intermediate/setup-valid-https.rst
View File

@ -1,3 +1,5 @@
.. include:: /_includes/all.rst
.. _setup_valid_https: .. _setup_valid_https:
***************** *****************
@ -30,8 +32,8 @@ Certificate Authority
--------------------- ---------------------
When the Devilbox starts up for the first time, it will generate a When the Devilbox starts up for the first time, it will generate a
`Certificate Authority <https://en.wikipedia.org/wiki/Certificate_authority>`_ and will store its |ext_lnk_ssl_certificate_authority| and will store its public and private key in ``./ca/`` within
public and private key in ``./ca/`` within the Devilbox git directory. the Devilbox git directory.
The keys are only generated if they don't exist and kept permanently if you don't delete them The keys are only generated if they don't exist and kept permanently if you don't delete them
manually, i.e. they are not overwritten. manually, i.e. they are not overwritten.
@ -67,7 +69,7 @@ Import the CA into your browser
Importing the CA into the browser is also recommended and required for the Devilbox Importing the CA into the browser is also recommended and required for the Devilbox
intranet page to work properly. intranet page to work properly.
You may also import the CA into your Operating System's Keystore. Information on that You may also import the CA into your Operating System's Keystore. Information on that
is available at `GFI Root Certificate guide <https://manuals.gfi.com/en/kerio/connect/content/server-configuration/ssl-certificates/adding-trusted-root-certificates-to-the-server-1605.html>`_ is available at |ext_lnk_ssl_gfi_root_cert_guide|.
Chrome / Chromium Chrome / Chromium
----------------- -----------------

16
docs/maintenance/backup-and-restore-mongo.rst
View File

@ -1,3 +1,5 @@
.. include:: /_includes/all.rst
.. _backup_and_restore_mongo: .. _backup_and_restore_mongo:
************************** **************************
@ -24,8 +26,8 @@ Backup
mongodump mongodump
--------- ---------
`mongodump <https://docs.mongodb.com/manual/reference/program/mongodump>`_ is bundled with |ext_lnk_tool_mongodump| is bundled with each PHP container and reay to use.
each PHP container and reay to use. To backup all databases follow the below listed example: To backup all databases follow the below listed example:
.. code-block:: bash .. code-block:: bash
@ -38,9 +40,6 @@ each PHP container and reay to use. To backup all databases follow the below lis
# Run mongodump # Run mongodump
devilbox@php-7.1.6 in /shared/httpd $ mongodump --out /shared/backups/mongo devilbox@php-7.1.6 in /shared/httpd $ mongodump --out /shared/backups/mongo
To find out more about the configuration and options of mongodump, visit its project page under:
https://docs.mongodb.com/manual/reference/program/mongodump.
Restore Restore
======= =======
@ -48,8 +47,8 @@ Restore
mongorestore mongorestore
------------ ------------
`mongorestore <https://docs.mongodb.com/manual/reference/program/mongorestore>`_ is bundled with |ext_lnk_tool_mongorestore| is bundled with each PHP container and ready to use.
each PHP container and ready to use. To restore all MongoDB databases follow the below listed example: To restore all MongoDB databases follow the below listed example:
.. code-block:: bash .. code-block:: bash
@ -61,6 +60,3 @@ each PHP container and ready to use. To restore all MongoDB databases follow the
# Start the restore/import from /shared/backups/mongo # Start the restore/import from /shared/backups/mongo
devilbox@php-7.1.6 in /shared/httpd $ mongorestore /shared/backups/mongo devilbox@php-7.1.6 in /shared/httpd $ mongorestore /shared/backups/mongo
To find out more about the configuration and options of mongorestore, visit its project page under:
https://docs.mongodb.com/manual/reference/program/mongorestore/.

29
docs/maintenance/backup-and-restore-mysql.rst
View File

@ -1,3 +1,5 @@
.. include:: /_includes/all.rst
.. _backup_and_restore_mysql: .. _backup_and_restore_mysql:
************************ ************************
@ -30,8 +32,8 @@ dump date, dump options as well as the server version it came from.
Mysqldump-secure Mysqldump-secure
---------------- ----------------
`mysqldump-secure <https://mysqldump-secure.org/>`_ is bundled, setup and ready to use in every |ext_lnk_tool_mysqldump_secure| is bundled, setup and ready to use in every PHP container.
PHP container. You can run it without any arguments and it will dump each available database as a You can run it without any arguments and it will dump each available database as a
separated compressed file. Backups will be located in ``./backups/mysql/`` inside the Devilbox separated compressed file. Backups will be located in ``./backups/mysql/`` inside the Devilbox
git directory or in ``/shared/backups/mysql/`` inside the PHP container. git directory or in ``/shared/backups/mysql/`` inside the PHP container.
@ -185,8 +187,8 @@ occured during backups. Let's have a look at one of them:
mysqldump mysqldump
--------- ---------
`mysqldump <https://dev.mysql.com/doc/refman/5.7/en/mysqldump.html>`_ is bundled with each PHP |ext_lnk_tool_mysqldump| is bundled with each PHP container and ready to use.
container and ready to use. To backup a database named ``my_db_name`` follow the below listed To backup a database named ``my_db_name`` follow the below listed
example which shows you how to do that from within the PHP container: example which shows you how to do that from within the PHP container:
.. code-block:: bash .. code-block:: bash
@ -201,26 +203,21 @@ example which shows you how to do that from within the PHP container:
devilbox@php-7.1.6 in /shared/httpd $ mysqldump -h mysql -u root -p my_db_name > /shared/backups/mysql/my_db_name.sql devilbox@php-7.1.6 in /shared/httpd $ mysqldump -h mysql -u root -p my_db_name > /shared/backups/mysql/my_db_name.sql
To find out more about the configuration and options of mysqldump, visit its project page under: To find out more about the configuration and options of mysqldump, visit its project page under:
https://dev.mysql.com/doc/refman/5.7/en/mysqldump.html |ext_lnk_tool_mysqldump|
phpMyAdmin phpMyAdmin
---------- ----------
If you do not like to use the command line for backups, you can use If you do not like to use the command line for backups, you can use |ext_lnk_tool_phpmyadmin|.
`phpMyAdmin <https://www.phpmyadmin.net>`_. It comes bundled with the devilbox intranet. It comes bundled with the devilbox intranet.
To find out more about the usage of phpMyAdmin, visit its project page under:
https://www.phpmyadmin.net.
Adminer Adminer
------- -------
If you do not like to use the command line for backups, you can use If you do not like to use the command line for backups, you can use |ext_lnk_tool_adminer| .
`Adminer <https://www.adminer.org>`_. It comes bundled with the devilbox intranet. It comes bundled with the devilbox intranet.
To find out more about the usage of Adminer, visit its project page under: https://www.adminer.org.
Restore Restore
@ -281,7 +278,7 @@ binary. Here are a few examples for different file types:
phpMyAdmin phpMyAdmin
---------- ----------
`phpMyAdmin <https://www.phpmyadmin.net>`_ supports importing many different formats out-of-the-box. |ext_lnk_tool_phpmyadmin| supports importing many different formats out-of-the-box.
Simply select the compressed or uncompressed file and press ``Go`` in the import section of Simply select the compressed or uncompressed file and press ``Go`` in the import section of
the web interface. the web interface.
@ -289,6 +286,6 @@ the web interface.
Adminer Adminer
------- -------
`Adminer <https://www.adminer.org>`_ supports importing of plain (``*.sql``) or gzipped compressed |ext_lnk_tool_adminer| supports importing of plain (``*.sql``) or gzipped compressed
(``*.sql.gz``) files out-of-the-box. Simply select the compressed or uncompressed file and press (``*.sql.gz``) files out-of-the-box. Simply select the compressed or uncompressed file and press
``Execute`` in the import section of the web interface. ``Execute`` in the import section of the web interface.

21
docs/maintenance/backup-and-restore-pgsql.rst
View File

@ -1,3 +1,5 @@
.. include:: /_includes/all.rst
.. _backup_and_restore_pgsql: .. _backup_and_restore_pgsql:
***************************** *****************************
@ -24,9 +26,8 @@ Backup
pg_dump pg_dump
------- -------
`pg_dump <https://www.postgresql.org/docs/current/static/backup-dump.html>`_ is bundled with |ext_lnk_tool_pg_dump| is bundled with each PHP container and reay to use.
each PHP container and reay to use. To backup a database named ``my_db_name`` follow the below To backup a database named ``my_db_name`` follow the below listed example:
listed example:
.. code-block:: bash .. code-block:: bash
@ -39,17 +40,11 @@ listed example:
# Run pg_dump # Run pg_dump
devilbox@php-7.1.6 in /shared/httpd $ pg_dump -h pgsql -U postgres -W my_db_name > /shared/backups/pgsql/my_db_name.sql devilbox@php-7.1.6 in /shared/httpd $ pg_dump -h pgsql -U postgres -W my_db_name > /shared/backups/pgsql/my_db_name.sql
To find out more about the configuration and options of pg_dump, visit its project page under:
https://www.postgresql.org/docs/current/static/backup-dump.html.
Adminer Adminer
------- -------
If you do not like to use the command line for backups, you can use If you do not like to use the command line for backups, you can use |ext_lnk_tool_adminer|.
`Adminer <https://www.adminer.org>`_. It comes bundled with the devilbox intranet. It comes bundled with the devilbox intranet.
To find out more about the usage of Adminer, visit its project page under: https://www.adminer.org.
Restore Restore
@ -59,7 +54,7 @@ psql
---- ----
In order to restore or import PostgreSQL databases on the command line, you need to use In order to restore or import PostgreSQL databases on the command line, you need to use
`psql <https://www.postgresql.org/docs/current/static/backup-dump.html#BACKUP-DUMP-RESTORE>`_. |ext_lnk_tool_pgsql_restore|.
Here are a few examples for different file types: Here are a few examples for different file types:
``*.sql`` file ``*.sql`` file
@ -108,6 +103,6 @@ Here are a few examples for different file types:
Adminer Adminer
------- -------
`Adminer <https://www.adminer.org>`_ supports importing of plain (``*.sql``) or gzipped compressed |ext_lnk_tool_adminer| supports importing of plain (``*.sql``) or gzipped compressed
(``*.sql.gz``) files out-of-the-box. Simply select the compressed or uncompressed file and press (``*.sql.gz``) files out-of-the-box. Simply select the compressed or uncompressed file and press
``Execute`` in the import section of the web interface. ``Execute`` in the import section of the web interface.

25
docs/support/blogs-videos-and-use-cases.rst
View File

@ -1,3 +1,5 @@
.. include:: /_includes/all.rst
.. _blogs_videos_and_use_cases: .. _blogs_videos_and_use_cases:
*************************** ***************************
@ -19,17 +21,13 @@ Blog posts
The following shows a list of blogs that give a nice and objective introduction to the Devilbox. The following shows a list of blogs that give a nice and objective introduction to the Devilbox.
+------------------------------------------------------------------------------+----------+ +---------------------------------+----------+
| Title | Language | | Title | Language |
+==============================================================================+==========+ +=================================+==========+
| `Using Devilbox For Local WordPress Development In Docker`_ | English | | |ext_lnk_blog_deliciousbrains| | English |
+------------------------------------------------------------------------------+----------+ +---------------------------------+----------+
| `Devilbox: Lokaler Webserver mit Apache, PHP und MySQL im Docker Container`_ | German | | |ext_lnk_blog_moritzkanzler| | German |
+------------------------------------------------------------------------------+----------+ +---------------------------------+----------+
.. _`Using Devilbox For Local WordPress Development In Docker`: https://deliciousbrains.com/devilbox-local-wordpress-development-docker
.. _`Devilbox: Lokaler Webserver mit Apache, PHP und MySQL im Docker Container`: https://blog.moritzkanzler.de/devilbox-lokaler-webserver-mit-apache-php-und-mysql-im-docker-container/
Use-cases Use-cases
@ -38,9 +36,8 @@ Use-cases
Joomla's Continuous Integration Joomla's Continuous Integration
-------------------------------- --------------------------------
Joomla has created a `PR Testing Platform <https://docs.joomla.org/PR_Testing_Platform>`_ Joomla has created a |ext_lnk_blog_joomla_pr_testing_platform| as their
as their `Google Summer of Code 2017 <https://docs.joomla.org/GSOC_2017>`_ |ext_lnk_blog_joomla_gsoc2017| project using a modified version of the Devilbox.
project using a modified version of the Devilbox.
Add your story Add your story