acquia/blt

Name: blt

Owner: Acquia

Description: Acquia's toolset for automating Drupal 8 development, testing, and deployment.

Created: 2016-04-27 19:04:48.0

Updated: 2018-01-19 05:13:24.0

Pushed: 2018-01-19 16:04:37.0

Homepage: https://acquia-pso.github.io/blt-blog/

Size: 3377

Language: PHP

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

BLT

BLT (Build and Launch Tool) provides an automation layer for testing, building, and launching Drupal 8 applications.

You can find all BLT documentation on Read the Docs:

• Latest documentation (9.0.x / 9.1.x) (best for guidance on general issues and best practices)
• Stable release documentation (8.9.x) (best for features specific to 8.9.x)

Getting started

See INSTALL.md for a list of prequisites and links to instructions for creating new projects, adding BLT to existing projects, and updating BLT.

Videos

• BLT Project Creation
• Deploying to Acquia Cloud

Releases and versioning

Typically, the last two most major versions of BLT are supported actively. The newest major version will recieve both bug fixes and new features, while the penultimate major version will recieve bug fixes for at least two months. For example, if 8.8.1 is the most recent version of BLT:

• As of the first cut tag for 8.8.x, 8.7.x will enter “LTS”.
  • 8.7.x will continue to receive bug fixes and minor features
  • 8.7.x will not receive any major new features or backwards incompatible changes
• Two months after the first cut tag for 8.8.x
  • 8.7.x will no longer be supported
  • 8.9.x will be created for major new features.
• At some point later, 8.9.0 will be cut, and 8.8.x will enter “LTS”.

Release support status

| Major Version | Support Status | Drupal | Drush | Dev Status | |—————|—————————–|——–|—————-|————–| | 9.x | Supported | >=8.4 | >=9.0.0-rc2 | *active dev | | 8.9.x | LTS (see below) | <=8.4 | ~8 | bug fixes | | 8.8.x | Unsupported, EOL | <=8.3 | ~8 | | | 8.7.x | Unsupported, EOL | <=8.3 | ~8 | |

9.x branch

The 9.1.x branch is currently in development. It requires Drush 9 instead of Drush 8.

8.9.x End of Life (EOL)

8.9.x is currently in maintenance / long-term support mode (receiving only bug fixes) while we focus on feature development for 9.1.x. 8.9.x will continue to be supported until the following conditions are met:

• Drush 9 has a stable release
• ACSF is compatible with Drush 9
• BLT 9.1.0 is released with full support for ACSF users

The current ETA for this cutoff is Q1 2018.

Philosophy and Purpose

BLT is designed to improve efficiency and collaboration across Drupal projects by providing a common set of tools and standardized structure. It was born out of the need to reduce re-work, project set up time, and developer onboarding time.

Its explicit goals are to:

• Provide a standard project template for Drupal based projects
• Provide tools that automate the setup, testing, launching, and maintenance work for projects
• Document and enforce Drupal standards and best practices via default configuration, automated testing, and continuous integration

Its scope is discretely defined. It is not intended to provide:

• Drupal application features (e.g., workflow, media, layout, pre-fabbed content types, etc.)
• A local hosting environment
• A replacement for good judgement (as with Drupal, it leaves you the freedom to make mistakes)

Features

• Local Git Hooks
  • pre-commit: Checks for Drupal coding standards compliance
  • commit-msg: Check for proper formatting and syntax
• Testing Framework.
  • Behat: default local.yml configuration, example tests, FeatureContext.php
  • PHPUnit: default tests for ensuring proper functioning of BLT provided components
• Commands to automate project tasks, like:
  • Test execution
  • Frontend asset compilation
  • Syncing environments
• Deployment Artifact Generation
  • Building production-only dependencies
  • Sanitation of production code
• Continuous Integration & Deployment
  • Acquia Pipelines
  • Travis CI
  • GitHub

Support and contribution

BLT is provided as an open source tool in the hope that it will enable developers to easily generate new Drupal projects that conform to Acquia Professional Services' best practices.

Please feel free to contribute to the project or file issues via the GitHub issue queue. See CONTRIBUTING.md for contribution guidelines and instructions.

License

Copyright © 2016 Acquia, Inc.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.