mittwald / deployer-recipes
A collection of Deployer recipies for easily deploying your applications onto the mittwald platform
Requires
- php: ^8.2
- composer/semver: ^3.4
- league/flysystem: ^3.0
- mittwald/api-client: ^2.0
Requires (Dev)
- deployer/deployer: ^7.3
- league/flysystem-memory: ^3.0
- phpunit/phpunit: ^10.5
- vimeo/psalm: ^5.15
- dev-master
- v1.0.0-beta10
- v1.0.0-beta9
- v1.0.0-beta8
- v1.0.0-beta7
- v1.0.0-beta6
- v1.0.0-beta5
- v1.0.0-beta4
- v1.0.0-beta3
- v1.0.0-beta2
- v1.0.0-beta1
- v1.0.0-alpha2
- v1.0.0-alpha1
- dev-dependabot/composer/mittwald/api-client-2.1.77
- dev-dependabot/composer/mittwald/api-client-2.1.76
- dev-dependabot/composer/deployer/deployer-7.5.4
- dev-dependabot/composer/league/flysystem-3.29.1
- dev-dependabot/composer/league/flysystem-memory-3.29.0
- dev-bugfix/fix-functional-tests
- dev-bugfix/functionaltest-master
- dev-bugfix-sshuser-wait
- dev-feature-opcache-flush
- dev-refact/test-refactor-apprecipe
- dev-task/increase-logging
- dev-feature/ssh-private-key
This package is auto-updated.
Last update: 2024-10-28 18:30:23 UTC
README
⚒️ Installation instructions | 🙆 Usage | ⚙️ Configuration options | 📖 Documentation
Important
This library is currently in an beta state. We welcome any feedback and contributions.
This repository contains a set of mittwald-specific helper functions and recipes for Deployer.
Installation
Via Composer
In order to use this recipe collection, you need to install it via Composer:
composer require --dev mittwald/deployer-recipes
Using Docker
There is also a pre-built docker image, providing both deployer and the mittwald deployer recipes. You can use it like this:
docker run --rm -it -v $(pwd):/app -w /app mittwald/deployer:latest deploy
Usage
Note
Find configuration examples for common CI/CD tools like Github Actions and Gitlab CI at the bottom of this document.
This recipe needs a mittwald API token to work. It can be either
provided via the MITTWALD_API_TOKEN
environment variable, or by setting the mittwald_token
value in your Deployer
configuration.
$ export MITTWALD_API_TOKEN=...
In order to use the recipes provided by this library, you need to include them in your deploy.php
file:
require __DIR__ . '/vendor/autoload.php'; require __DIR__ . '/vendor/mittwald/deployer-recipes/recipes/deploy.php';
To enable the automatic deployment for a host, set the mittwald_app_id
variable to the ID of the mittwald application
you want to deploy to (the ID may either be the full UUID of the application, or the short ID that is displayed in the
UI or CLI). In this case, the hostname becomes irrelevant, as the recipe will automatically determine the correct
hostname for the SSH connection:
host('mittwald') ->set('public_path', '/') ->set('mittwald_app_id', '<uuid|short-id>') ->set('mittwald_app_dependencies', [ 'php' => '{{php_version}}', 'gm' => '*', 'composer' => '*', ]);
Alternatively, you can also use the mittwald_app
shorthand function for the same effect:
mittwald_app('<uuid|short-id>') ->set('public_path', '/') ->set('mittwald_app_dependencies', [ 'php' => '{{php_version}}', 'gm' => '*', 'composer' => '*', ]);
What does it do?
This recipe automates the provisioning of PHP applications on the mittwald cloud platform. You will only need to provide the recipe with the ID of the mittwald application you want to deploy to, and the recipe will take care of the rest by automatically determining the correct deployment path, database credentials, and so on.
More precisely, the recipe will:
- Look up the deployment directory for the given application ID and set it as the
deploy_path
for deployer. - Correctly configure a virtual host for the domain configured in
domain
- Look up the necessary SSH connection data, create and manage an SSH user for the deployment, and configure the deployer host accordingly.
- Make sure that the app's system environment matches the one configured in
mittwald_app_dependencies
Configuration options
-
mittwald_app_id
: The ID of the mittwald application you want to deploy to. This is the only required option, and should be set per host. -
mittwald_app_dependencies
: A map of system dependencies that should be installed on the mittwald application. The recipe will make sure that the app's system environment matches the one configured here.The expected format is a map, using system package names as keys and semver compatible version constraints as values.
Defaults to
["php" => "{{php_version}}", "composer" => "*"]
. -
mittwald_domains
may be used to override the domains that should be configured. Defaults to["{{domain}}"]
. -
mittwald_domain_path_prefix
can be used to configure a prefix for the domain path. Defaults to"/"
. -
mittwald_ssh_public_key
andmittwald_ssh_private_key
may contain an SSH public/private key pair that should be used for deployment. If not set, thessh_copy_id
variable will be used.
Documentation & How-Tos
For more information on how to use this recipe, please refer to the documentation.