feat: Add a Tugboat scaffold #96

[deviantintegral]

This PR adds support for Tugboat resolving #96.

To turn it on, add tugboat to Drainpipe's extra section in composer.json following the README such as:

        "drainpipe": {
            "tugboat": {
              "provider": {
                "host": "acquia",
                "downsync": true
              }
            }
        },

This PR adds twig as a dependency to assist in rendering configuration files. I first tried to make it so each section was composed "simply" by concatenating files, but that didn't work well. Twig is already part of Drupal so it's not being added completely new. I still refactored the commands out just to save having to edit tugboat command steps directly in YAML.

We talked about pulling in the PHP version from hosting provider files, but that won't cover Acquia hosts. Instead, we use composer to determine the PHP version.

If you set the host to acquia, you get mysql and memcached. If you set pantheon you get mariadb and redis.

Testing:

• There are three PRs at https://github.com/Lullabot/drainpipe-tugboat-test/pulls. One has no special setup, one is for Pantheon with Redis, and one is for Acquia with memcache.

I turned on memcache admin and see it working for Acquia. I need to double check that for Pantheon too:

• As well, I added some basic tests to the workflow that make sure the right config files are generated. They picked up some good bugs like f333b68. I wonder if later we want to convert these to use bats or similar.

To do:

• Automatically add credentials to settings.php.
• Add a tugboat.acquia-example.yml file that includes memcache.
• Add a tugboat.pantheon-example.yml file that includes redis.
• Support setting acquia or tugboat in the tugboat composer array to select one.
• Configure GD with something like:

        apt-get update && apt-get install -y libpng-dev libjpeg-dev libfreetype6-dev
        docker-php-ext-configure gd --with-jpeg --with-freetype && docker-php-ext-install gd

• Document in the README what environment variables to set so task can download and import a database.
• Update the configs so if those variables aren't set we run a site:install instead.
• Fix the workflow
• Switch to nginx for the Pantheon option
• Ensure we don't have any issues with stale redis caches

[deviantintegral]

It turns out Tugboat validates configurations by sending them to a tugboat API. We'll need to generate and provide an access token for the new job to pass.

[deviantintegral]

TIL'ed you have to opt in via your job config for repository secrets to be visible. It's not mentioned on the settings UI at all. Eventually I found it at https://docs.github.com/en/actions/security-guides/encrypted-secrets#using-encrypted-secrets-in-a-workflow.

[edutrul]

The Readme has already been updated, with the new Tugboat variables and it is in a pull request.

And also in the composer, you can support "acquia" and "tugboat"

[edutrul]

@deviantintegral
Configure GD with something like:
apt-get update && apt-get install -y libpng-dev libjpeg-dev libfreetype6-dev
docker-php-ext-configure gd --with-jpeg --with-freetype && docker-php-ext-install gd

I don't understand what this code would be for, if you can please explain it to me in more detail. Thank you

[edutrul]

Update the configs so if those variables aren't set we run a site:install instead.
When you say site:install, you mean that only the config file will appear in tugboat and the settings

[deviantintegral]

😮 tests are passing! Well, except the env one which I think is unrelated and being fixed elsewhere.

[deviantintegral]

Without this actions was treating these as numbers and dropping the .0 from 8.0.

[justafish]

🤦‍♀️

[deviantintegral]

These could be turned into matrix parameters in the future, but it's fast now and saves burning CI time on the setup steps.

[deviantintegral]

It turns out we don't actually have a task command to downsync from Acquia. @marcoscano or @hawkeyetwolf think that's something you'd like to contribute based on your other project work?

[deviantintegral]

I moved this up as it's common to group php and extensions together.

[deviantintegral]

I'm currently working on building a tugboat nginx + php image. I have it building, but nginx is not fully configured yet. Once I have something I can point the tugboat image too I will update this PR.