The source of truth and where to begin at Taoti when creating composer-based website builds.
Welcome to this project! These instructions are for getting this specific project working on your local.
We are assuming that you have previously completed all these steps
Clone the repo, dawg!
Run: $ lando start in your command prompt, in the root of the repository
The above command will compile all the composer dependencies for you on your local
If all is successful, it should spit out a number of urls that look similar to this:
Waiting until database service is ready...
BOOMSHAKALAKA!!!
Your app has started up correctly.
Here are some vitals:
NAME composer-workbench
LOCATION /var/www/composer-workbench
SERVICES appserver_nginx, appserver, database, cache, edge, edge_ssl, index
APPSERVER_NGINX URLS https://localhost:32772
http://localhost:32773
EDGE URLS http://localhost:32775
http://example.lndo.site:8000
https://example.lndo.site
EDGE_SSL URLS https://localhost:32776
You want the one that ends with .lndo.site (https://example.lndo.site in this example). Some of these other URLs might be useful if you're having caching issues.
Dev away!
- Clone the Taoti composer upstream to your local. It should be located at https://github.com/Taoti/pantheon-upstream-d8-composer . Use the clone command to name your new site to match the variable your about to use for [NEW-MACHINE-SITE-NAME] below. (e.x.
git clone https://github.com/Taoti/pantheon-upstream-d8-composer.git my-new-site). 'my-new-site' will place this in a directory matching your new site name - Remove the git origin remote, this is important to do because the next command we run is going to establish the git remote and do everything else for us.
$ git remote remove origin - Run the following command to get everything started with GitHub, CircleCI and Pantheon:
Please note that "!" (exclamation points) don't work in the
--admin-password field.[NEW-SITE-MACHINE-NAME]should be lower case, hypenated and not contain symbols
$ terminus build:project:create --team="Taoti Creative" --admin-email="taotiadmin@taoti.com" --admin-password="[REDACTED]" --ci=circleci --git=github ./ [NEW-SITE-MACHINE-NAME] --preserve-local-repository
When you use this method, the github repository that gets set up will be owned by your github user. We need to transfer it to Taoti to allow other developers to work on it. https://help.github.com/en/articles/transferring-a-repository
TLDR: Go to github repo > settings > (scroll to bottom) Transfer Repository
First Time Installation Instructions
Documentation: https://getcomposer.org/download/
TLDR:
$ php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
$ php -r "if (hash_file('sha384', 'composer-setup.php') === '48e3236262b34d30969dca3c37281b3b4bbe3221bda826ac6a9a62d6444cdb0dcd0615698a5cbe587c3f0fe57a54d8f5') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
$ php composer-setup.php
$ php -r "unlink('composer-setup.php');"
Documentation: https://pantheon.io/docs/terminus/install/
TLDR (linux/MAC OS, Windows please read above documentation):
curl -O https://raw.githubusercontent.com/pantheon-systems/terminus-installer/master/builds/installer.phar && php installer.phar install
If you don't know what you're doing with docker, and you've tinkered with it (have it already installed locally), I HIGHLY SUGGEST completely uninstalling it before moving on.
At the very least you should be able to run $ docker --help and see meaningful output.
See Documentation here: https://docs.docker.com/install/ Select the OS applicable to your local environment
https://docs.devwithlando.io/installation/system-requirements.html Again, choose the OS that is applicable for your local environment This guide is tested with "v3.0.0-rc.16" and works but latest stable release should be dandy.