agaric/documentation
10
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
documentation/creating-new-drutopia-site.md
benjamin melançon d19f2efb1a start to give quickstart commands
2020-06-23 10:48:43 -04:00

2.5 KiB
Raw Blame History

Deploying Drutopia Sites

Agaric manages a large number of Drupal, primarily Drutopia sites, on a

Please see the Drutopia Platform README for an overview of hosting and deploying Drutopia sites If you won't be deploying, skip overall setup.

Overall setup

Strongly recommended to set up locally like this:

mkdir -p ~/Projects/drutopia-platform
cd ~/Projects/drutopia-platform
git clone git@gitlab.com:drutopia-platform/build_source.git
git clone git@gitlab.com:drutopia-platform/drutopia_host.git
cd drutopia_host
git clone git@gitlab.com:drutopia-platform/build_artifacts.git
git clone git@gitlab.com:drutopia-platform/hosting_private.git

These last two repositories are private to Agaric and others maintaining the Drutopia platform, so if you're following along at home you'll have to create your own analogs, per [the documentation](https://gitlab.com/drutopia-platform/drutopia_host#introduction).

Commands for copying throughout will assume this above setup.

Create a new site project

Ordinarily this will live under https://gitlab.com/agaric/sites (for Agaric clients) or https://gitlab.com/drutopia-platform/sites (for direct Drutopia platform members).

Copy the composer.json used by the appropriate build source, such as the default build source for the Drutopia Platform.

Replace EXAMPLE below with name of the site, usually derived from the main domain name, for instance example-com:

mkdir -p ~/Projects/agaric/sites/EXAMPLE
cd ~/Projects/agaric/sites/EXAMPLE

Once you have created and are in this directory, whether agaric/sites or drutopia-platform/sites or wherever you want your project to live within the GitLab namespace, you can copy-paste these commands for a quick start:

wget https://gitlab.com/drutopia-platform/build_source/-/raw/master/composer.json
ddev config --docroot=web --project-type=drupal8 --webserver-type=apache-fpm --mariadb-version=10.1 --php-version=7.3 --xdebug-enabled=true --use-dns-when-possible=false

Webserver, PHP, and MySQL versions and types are selected here to match those used on Elizabeth and should be adjusted to match your live environment, including double-checking that they are still valid for `elizabeth.mayfirst.org`.  Please update this documentation if it changes!  The last two options (enabling Xdebug by default and not using DNS for your local site) are optional at the developer's preference.