savaslabs/terminus-docker

Terminus Docker

镜像概述

本镜像提供Pantheon平台命令行工具Terminus的自动化构建版本，帮助用户在Docker环境中便捷管理Pantheon上的网站项目，支持多种操作场景及CI/CD集成。

核心功能

• Pantheon站点认证登录（通过机器令牌）
• 站点备份创建与获取
• 站点信息查询
• Drush命令执行（针对Pantheon站点）
• 支持非交互式运行（适配CI/CD环境如Travis）

使用场景

• 本地开发环境中管理Pantheon站点
• CI/CD流程（如Travis、Jenkins）中的自动化部署、备份操作
• 团队协作中统一Terminus工具版本

配置说明

• 通过TERMINUS_CACHE_DIR环境变量设置缓存目录
• 挂载卷保存缓存数据（如令牌）和SSH密钥（用于Drush操作）

部署示例

Docker Compose示例

yaml
terminus:
  image: docker.xuanyuan.run/savaslabs/terminus-docker
  environment:
    TERMINUS_CACHE_DIR: "/terminus/cache"
  volumes:
    - terminus-data:/terminus/cache
    - ./:/app:cached
  volumes_from:
    - php
volumes:
  terminus-data:
    driver: local

该配置需结合https://github.com/wodby/docker4drupal项目的标准`docker-compose.yml`使用。

构建脚本示例

sh
docker volume create --name=examplesite_terminus-data
docker-compose run --rm --entrypoint="sh -c" terminus "mkdir -p /terminus/cache/tokens"
ifdef TRAVIS
	docker-compose run --rm terminus auth:login --machine-token=$TERMINUS_TOKEN
else
	read -p "请输入Terminus令牌 [回车] " TERMINUS_TOKEN && docker-compose run --rm terminus auth:login --machine-token=$TERMINUS_TOKEN
endif
	docker-compose run --rm terminus site:info examplesite

若环境变量$TRAVIS已设置，将以非交互式方式运行。

常用命令示例

# 创建站点备份
docker-compose run --rm terminus backup:create examplesite.live -n --element=db --keep-for=1
# 获取站点备份
docker-compose run --rm terminus backup:get examplesite.live -n --element=db --to=cache/database.sql.gz

docker run示例

sh
#!/bin/sh
set -ex
docker pull docker.xuanyuan.run/savaslabs/terminus-docker:latest
docker volume create examplesite-terminus
docker run --rm -e TERMINUS_CACHE_DIR=/terminus/cache -v examplesite-terminus:/terminus/cache docker.xuanyuan.run/savaslabs/terminus-docker auth:login --machine-token=$MACHINE_TOKEN
docker run --rm -e TERMINUS_CACHE_DIR=/terminus/cache -v /var/lib/jenkins/.ssh:/root/.ssh:ro -v examplesite-terminus:/terminus/cache docker.xuanyuan.run/savaslabs/terminus-docker drush examplesite.live -- cron -v