78 lines
4.2 KiB
Markdown
78 lines
4.2 KiB
Markdown
---
|
||
title: "Build Configs - configuration files as a service"
|
||
products:
|
||
-
|
||
price: 2500
|
||
link: https://buy.stripe.com/14kbJs98K1fc0p29AC
|
||
buttonText: Get started
|
||
-
|
||
price: 1000
|
||
link: https://buy.stripe.com/7sIdRAbgS8HEfjWfZ1
|
||
buttonText: Sign up
|
||
---
|
||
|
||
**Sprint zero in a box.**
|
||
|
||
All of my projects contain similar build configuration files, such as Docker and Docker Compose files, PHPUnit and PHPStan configuration, and CI/CD pipeline workflows. I used to maintain these manually which was time-intensive and there was no guarantee that the same features or options were available from project to project.
|
||
|
||
Build Configs is a tool I've written to maintain a canonical set of templates and generate them for each project based on a per-project configuration file.
|
||
|
||
This makes it quicker and easier for me to create or onboard new projects to work on and, as all of the base files are centralised, when I fix something or add a new feature, the changes can be pushed to every project that uses it.
|
||
|
||
I've been using this on personal projects such as my [Drupal](https://github.com/opdavies/docker-example-drupal), [LocalGov Drupal](https://github.com/opdavies/docker-example-drupal-localgov) and [Drupal Commerce Kickstart](https://github.com/opdavies/docker-example-drupal-commerce-kicksart) Docker examples and for various client projects.
|
||
|
||
## How does it work?
|
||
|
||
- I create a `build.yaml` file for the project that contains its configuration - what version of PHP it needs, which web server to use, which paths to run automated tests from or static analysis on, etc.
|
||
- I run the `build-configs` tool which generates the required files, such as a Dockerfile, Docker Compose file, PHPStan and PHPUnit configuration files, and a `run` script for automating project commands.
|
||
- The files are committed to version control and pushed to your code repository (GitHub, GitLab, Bitbucket, etc).
|
||
- As I add new features or make changes, I will re-run the process to re-generate the files and push any changes - ensuring you’re always up to date.
|
||
|
||
## What are some of the recent new features?
|
||
|
||
* Adding additional databases for working with migrations or multi-site projects.
|
||
* Adding additional `run` tasks.
|
||
* Adding CI pipelines with GitHub Actions to run automated quality checks.
|
||
* Creating and running Git hooks to run automated checks before changes are pushed.
|
||
|
||
## Example
|
||
|
||
In this short video, I show how Build Configs works by creating a new Drupal 10 project, generating its configuration files, and opening it in a browser.
|
||
|
||
From nothing to a ready-to-work-on Drupal website in less than a minute.
|
||
|
||
{% include 'youtube-video.html.twig' with { id: 'LkhsdmxReUc'} %}
|
||
|
||
## Options
|
||
|
||
### Initial project setup - £{{ page.products.0.price|number_format() }}
|
||
|
||
To get your project started on the right foot, I will create a new Drupal project skeleton for you using `build-configs` that is ready to work on, including all of the generated files. You can even edit them if you like as they will get no ongoing updates.
|
||
|
||
{% include 'button.html.twig' with {
|
||
text: page.products.0.buttonText,
|
||
url: page.products.0.link,
|
||
} %}
|
||
|
||
### Ongoing updates and support (single site) - £{{ page.products.1.price|number_format }} per month
|
||
|
||
Once you have a project with `build-configs`, if you want to receive ongoing updates to the generated files, I can automatically refresh your files once changes are available and push them to your code repository.
|
||
|
||
This also includes unlimited support via a dedicated Slack channel and you can make feature requests for me to consider adding to the roadmap.
|
||
|
||
If you like, I can add you to a beta users list and you’ll get new experimental features before anyone else.
|
||
|
||
{% include 'button.html.twig' with {
|
||
text: page.products.1.buttonText,
|
||
url: page.products.1.link,
|
||
} %}
|
||
|
||
|
||
If you have multiple Drupal sites, [contact me](/contact) and we can work something out.
|
||
|
||
### Retro-fitting into an existing project
|
||
|
||
`build-configs` can also be added to an existing project. It can be tricky and will be different from project to project so [contact me](/contact) and we can discuss it further.
|
||
|
||
Once I know more about your project, I’ll be happy to give you a fixed-price quote to do the work.
|