MariaDB: 4. GitHub Actions

本文档属于GitHub Actions & GitLab CI指南的一部分。您可以在此处查看完整指南:通过您的 GitHub Actions 或 GitLab CI 流水线启动一个真实的 MariaDB 服务,运行测试并自动销毁

👋 欢迎查阅 Stackhero 文档

Stackhero 提供即开即用的 MariaDB 云服务,专为生产级工作负载设计。您将获得:

  • 无限制的连接数和数据传输。
  • 内置 phpMyAdmin Web 管理界面,便于数据库管理。
  • 一键 更新,维护更轻松。
  • 私有专用基础设施,确保高 性能与强大 安全性

几分钟内即可启动全托管 MariaDB 实例。 Stackhero 负责部署、更新与安全,您只需专注于您的应用。了解更多 MariaDB 云托管信息

您可以将以下内容保存为 .github/workflows/ci.yml。此后,每次 push 或 pull request 都会针对真实的 MariaDB 实例运行测试。

name: CI with MariaDB

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    env:
      STACKHERO_TOKEN: ${{ secrets.STACKHERO_TOKEN }}
      STACK_NAME: ci-mariadb-${{ github.run_id }}-${{ github.run_attempt }}
      INSTANCE: "10G"   # 如有需要可修改(见第 3 步)
      REGION: europe
    steps:
      - uses: actions/checkout@v4

      - name: 安装 Stackhero CLI 及客户端
        run: |
          curl -fsSL https://www.stackhero.io/install.sh | sh
          apt-get update && apt-get install -y --no-install-recommends jq curl mariadb-client

      - name: 创建 MariaDB 服务
        run: |
          set -euo pipefail
          STACK_ID=$(stackhero --format=script stack-create --name="$STACK_NAME")
          echo "STACK_ID=$STACK_ID" >> "$GITHUB_ENV"
          SERVICE_ID=$(stackhero --format=script service-add \
            --stack="$STACK_ID" \
            --service-store="mariadb" \
            --instance="$INSTANCE" \
            --region="$REGION")
          echo "SERVICE_ID=$SERVICE_ID" >> "$GITHUB_ENV"
          stackhero service-wait-for --service="$SERVICE_ID"

      - name: 运行 MariaDB 测试
        run: |
          set -euo pipefail
          config=$(stackhero service-configuration-get --service="$SERVICE_ID" --format=json)
          host=$(echo "$config" | jq -r '.configuration.domain')
password=$(echo "$config" | jq -r '.configuration.mariadbRootPassword')
          # Run a trivial query against the database.
          mariadb --host="$host" --port=3306 --user=root --password="$password" --ssl -e "SELECT 1;"
          echo "✅ MariaDB 已可从 CI 访问。"
          # 您也可以在此处使用上述凭据运行自定义测试套件 ...

      - name: 清理(始终执行,包括失败时)
        if: always()
        run: |
          if [ -n "${SERVICE_ID:-}" ]; then
            stackhero service-delete --service="$SERVICE_ID" --confirm
            stackhero service-wait-for --service="$SERVICE_ID"
          fi
          if [ -n "${STACK_ID:-}" ]; then
            stackhero stack-delete --stack="$STACK_ID" --confirm
          fi

清理步骤配置了 if: always(),确保无论结果如何都会执行,保证您的 MariaDB 实例被删除,避免因未使用资源而产生费用。