mikemadison13/blt-gitlab-pipelines

Acquia BLT的Gitlab流水线集成。

dev-main 2023-09-02 16:19 UTC

This package is auto-updated.

Last update: 2024-08-31 00:38:52 UTC


README

这是一个Acquia BLT插件,提供Gitlab Pipelines集成。此插件将与Gitlab和Acquia Code Studio Pipelines兼容!

此插件是社区创建的社区支持的。Acquia不会为此软件提供任何直接支持,也不提供任何关于其稳定性的保证。

安装和使用

要使用此插件,您必须已经有一个使用BLT 11.3(或更高版本)的Drupal项目。虽然环境检测器是在BLT 10中添加的,但正确子类化的修复直到这个提交(并在11.3中发布)

1. 在您的项目中,使用Composer要求插件

composer require mikemadison13/blt-gitlab-pipelines

2. 通过调用此插件提供的recipes:ci:gitlab:init来初始化Gitlab集成

blt recipes:ci:gitlab:init

这会将模板版本的.gitlab-ci.yml复制到您的项目根目录。请确保将其以及更新的composer.json提交到Git。

注意:模板YAML文件假定标准BLT步骤用于构建(类似于模板化的Travis CI和Acquia Piplines文件)。根据需要可以进行修改!也可以通过将它们复制出来并根据需要更改YAML文件中的文件路径来修改构建脚本。

3. 生成和集成SSH密钥

为了利用流水线将代码部署到您的托管环境,您必须使用SSH密钥进行安全操作。虽然该插件自带了Acquia Cloud部署所需的所有默认值,但还需要手动步骤来完成此过程。

总体来说,过程如下

请注意,此插件假定“变量”在Gitlab中名为SSH_KEY。如果您将变量命名为其他名称(或如果您使用密码短语),则需要自定义部署步骤中的before_script部分,以确保您正在使用正确的变量名称。

4. 自定义生成的.gitlab-ci.yml文件

gitlab文件中的变量部分包括一些应进行自定义的项目。这包括

PHP_VERSION默认为8.0 NODE_VERSION默认为14.x

这些变量应与您项目对这些技术的默认值匹配。

许可协议

本程序是自由软件:您可以在自由软件基金会发布的GNU通用公共许可证的第2版下重新分发和/或修改该程序。

本程序的分发是希望它会有用,但没有任何保证;甚至没有关于其商誉或适用于特定目的的暗示保证。有关详细信息,请参阅GNU通用公共许可证。