mikemadison13 / blt-gitlab-pipelines
Acquia BLT的Gitlab流水线集成。
Conflicts
- acquia/blt: <13.5.1
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部署所需的所有默认值,但还需要手动步骤来完成此过程。
总体来说,过程如下
- 在您的本地机器上生成一个新的SSH密钥,用于流水线使用。请注意,您必须在Acquia Cloud中使用RSA密钥。
- 将SSH密钥的公共版本上传到您的Gitlab / Acquia Code Studio账户以及您的Acquia Cloud账户
- 将SSH密钥的私人版本上传到您的Gitlab设置,作为名为SSH_KEY的CI/CD变量
请注意,此插件假定“变量”在Gitlab中名为SSH_KEY。如果您将变量命名为其他名称(或如果您使用密码短语),则需要自定义部署步骤中的before_script部分,以确保您正在使用正确的变量名称。
4. 自定义生成的.gitlab-ci.yml文件
gitlab文件中的变量部分包括一些应进行自定义的项目。这包括
PHP_VERSION默认为8.0 NODE_VERSION默认为14.x
这些变量应与您项目对这些技术的默认值匹配。
许可协议
本程序是自由软件:您可以在自由软件基金会发布的GNU通用公共许可证的第2版下重新分发和/或修改该程序。
本程序的分发是希望它会有用,但没有任何保证;甚至没有关于其商誉或适用于特定目的的暗示保证。有关详细信息,请参阅GNU通用公共许可证。