PHPackages                             mikemadison13/blt-gitlab-pipelines - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [DevOps &amp; Deployment](/categories/devops)
4. /
5. mikemadison13/blt-gitlab-pipelines

AbandonedArchivedLibrary[DevOps &amp; Deployment](/categories/devops)

mikemadison13/blt-gitlab-pipelines
==================================

Gitlabs Pipelines integration for Acquia BLT.

2.x-dev(4y ago)864.1k↓34.6%5[1 issues](https://github.com/mikemadison13/blt-gitlab-pipelines/issues)GPL-2.0+Shell

Since Dec 16Pushed 2y ago2 watchersCompare

[ Source](https://github.com/mikemadison13/blt-gitlab-pipelines)[ Packagist](https://packagist.org/packages/mikemadison13/blt-gitlab-pipelines)[ RSS](/packages/mikemadison13-blt-gitlab-pipelines/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (4)Used By (0)

Acquia BLT Gitlab Pipelines integration
=======================================

[](#acquia-blt-gitlab-pipelines-integration)

This is an [Acquia BLT](https://github.com/acquia/blt) plugin providing [Gitlab Pipelines](https://docs.gitlab.com/ee/ci/pipelines/) integration. This plugin will work with both Gitlab and Acquia Code Studio Pipelines!

This plugin is **community-created** and **community-supported**. Acquia does not provide any direct support for this software or provide any warranty as to its stability.

Installation and usage
----------------------

[](#installation-and-usage)

To use this plugin, you must already have a Drupal project using BLT 11.3 (or higher). While the Environment Detector was added in BLT 10, the fix to properly [subclass was not introduced until this commit](https://github.com/acquia/blt/pull/4017) (and released in [11.3](https://github.com/acquia/blt/releases/tag/11.3.0))

### 1. In your project, require the plugin with Composer:

[](#1-in-your-project-require-the-plugin-with-composer)

`composer require mikemadison13/blt-gitlab-pipelines`

### 2. Initialize the Gitlab integration by calling `recipes:ci:gitlab:init`, which is provided by this plugin:

[](#2-initialize-the-gitlab-integration-by-calling-recipescigitlabinit-which-is-provided-by-this-plugin)

`blt recipes:ci:gitlab:init`

This will copy a template version of the .gitlab-ci.yml to your project root directory. Make sure to commit this as well as your updated composer.json to Git.

Note: the template YAML file assumes standard BLT steps for builds (and is similar to the templated Travis CI and Acquia Piplines files). Modifications can be made as necessary! Build scripts can also be modified by copying them out of this plugin and changing the file path as needed in the YAML file.

### 3. Generate and Integrate SSH Keys

[](#3-generate-and-integrate-ssh-keys)

In order to utilize Pipelines to deploy into your hosting environment, you must utilize SSH keys for security. While the Plugin does come with the necessary defaults for Acquia Cloud deployments, there are manual steps required to complete the process.

Overall, the process looks like:

- [Generate a new SSH key](https://docs.gitlab.com/ee/ssh/#generate-an-ssh-key-pair) on your local machine for use by Pipelines. Note that you must generate an RSA key for use in the Acquia Cloud.
- Upload the public version of the SSH key into both your [Gitlab / Acquia Code Studio Account](https://docs.gitlab.com/ee/ssh/#add-an-ssh-key-to-your-gitlab-account) AND your [Acquia Cloud Account](https://docs.acquia.com/cloud-platform/manage/ssh/enable/add-key/)
- Upload the private version of the SSH key into your [Settings in Gitlab](https://docs.gitlab.com/ee/ci/ssh_keys/#how-it-works) as a CI/CD Variable called SSH\_KEY

Note that this plugin assumes that the "variable" is called SSH\_KEY in Gitlab. If you name your variable anything else (or if you use a passphrase) you will need to customize the before\_script section of the deploy step to ensure that you are utilizing the correct variable name.

### 4. Customize the generated .gitlab-ci.yml file

[](#4-customize-the-generated-gitlab-ciyml-file)

The variables section of the gitlab file includes a number of items that should be customized. This includes:

PHP\_VERSION which defaults to 8.0 NODE\_VERSION which defaults to 14.x

These variables should match your project defaults for these technologies.

License
=======

[](#license)

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.

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance18

Infrequent updates — may be unmaintained

Popularity36

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 77.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

1659d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/dd56c7b8003d53fe5384c01ce50fbc0cc41978a60e2920ad99f4103092bee540?d=identicon)[mikemadison13](/maintainers/mikemadison13)

---

Top Contributors

[![mikemadison13](https://avatars.githubusercontent.com/u/22753451?v=4)](https://github.com/mikemadison13 "mikemadison13 (7 commits)")[![ssu-carlsoni](https://avatars.githubusercontent.com/u/115494275?v=4)](https://github.com/ssu-carlsoni "ssu-carlsoni (1 commits)")[![thafner](https://avatars.githubusercontent.com/u/2973245?v=4)](https://github.com/thafner "thafner (1 commits)")

### Embed Badge

![Health badge](/badges/mikemadison13-blt-gitlab-pipelines/health.svg)

```
[![Health](https://phpackages.com/badges/mikemadison13-blt-gitlab-pipelines/health.svg)](https://phpackages.com/packages/mikemadison13-blt-gitlab-pipelines)
```

###  Alternatives

[deployer/deployer

Deployment Tool

11.0k25.4M207](/packages/deployer-deployer)[appwrite/server-ce

End to end backend server for frontend and mobile apps.

55.3k84.2k](/packages/appwrite-server-ce)[pragmarx/health

Laravel Server &amp; App Health Monitor and Notifier

2.0k1.0M2](/packages/pragmarx-health)[felixfbecker/language-server-protocol

PHP classes for the Language Server Protocol

22476.7M6](/packages/felixfbecker-language-server-protocol)[heroku/heroku-buildpack-php

Toolkit for starting a PHP application locally, with or without foreman, using the same config for PHP and Apache2/Nginx as on Heroku

8161.3M10](/packages/heroku-heroku-buildpack-php)[tiamo/phpas2

PHPAS2 is a php-based implementation of the EDIINT AS2 standard

4674.7k](/packages/tiamo-phpas2)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
