整体流程

• 在服务器上使用 myoung34/github-runner 镜像运行自托管 Runner
• 在 GitHub 仓库中配置 Secrets（Docker Hub 凭证）
• 编写工作流文件：build-and-push 使用 ubuntu-latest 构建镜像并推送到 Docker Hub，deploy 使用 self-hosted 拉取镜像并运行容器

推送代码自动触发部署

第一步：在服务器上运行自托管 Runner

1.1 创建持久化目录

mkdir -p /home/runner/config_data

1.2 获取 GitHub Runner 令牌
打开你的 GitHub 仓库 https://github.com/你的用户名/flask-ci-demo

进入 Settings → Actions → Runners → New self-hosted runner

选择 Linux、x64，复制页面中显示的一次性令牌（例如 AABBCCDD...）

1.3 运行容器（使用 myoung34/github-runner）

docker run -d --name github-runner --restart always \
  -e REPO_URL="https://github.com/你的用户名/flask-ci-demo" \
  -e RUNNER_TOKEN="上面复制的令牌" \
  -e RUNNER_NAME="my-runner" \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /home/runner/config_data:/runner/data \
  myoung34/github-runner:latest

• RUNNER_LABELS="self-hosted,linux,x64,production" 这个可以带上标签，
  在deploy文件runs-on: [self-hosted,production]可以指定同时满足这些标签。是AND（与）的关系，这样可以区分不同的环境。
• 这里一定要用myoung34/github-runner:latest这个三方集成镜像，用官方的镜像，浪费很多时间还不成功的。

1.4 验证 Runner 在线

docker logs github-runner

看到 Listening for Jobs 表示成功。回到 GitHub 仓库的 Runners 页面，状态应变为 Idle。

第二步：配置 GitHub Secrets

在仓库 Settings → Secrets and variables → Actions 中添加以下 Secrets：

第三步：编写 GitHub Actions 工作流文件

在项目根目录下创建 .github/workflows/deploy.yml，内容如下：

name: Deploy Flask App to Server

on:
  push:
    branches: [ "main" ]
  workflow_dispatch:

jobs:
  build-and-push:
    name: Build and Push Docker Image
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Log in to Docker Hub
        uses: docker/login-action@v3
        with:
          username: ${{ secrets.DOCKERHUB_USERNAME }}
          password: ${{ secrets.DOCKERHUB_TOKEN }}

      - name: Build and push Docker image
        uses: docker/build-push-action@v5
        with:
          context: .
          push: true
          tags: ${{ secrets.DOCKERHUB_USERNAME }}/flask-ci-demo:latest

  deploy:
    name: Deploy to Server
    runs-on: self-hosted          # 关键：使用自托管 Runner
    needs: build-and-push
    steps:
      - name: Pull and run container
        run: |
          docker pull ${{ secrets.DOCKERHUB_USERNAME }}/flask-ci-demo:latest
          docker stop flask-app || true
          docker rm flask-app || true
          docker run -d --name flask-app -p 5000:5000 ${{ secrets.DOCKERHUB_USERNAME }}/flask-ci-demo:latest

说明：

• build-and-push 任务在 GitHub 官方 Ubuntu 环境中运行（速度快，无需担心网络）
• deploy 任务在您的自托管 Runner（服务器）上执行，直接拉取镜像并启动容器
• 不再需要 appleboy/ssh-action，因为 Runner 已经运行在目标服务器上

第四步：提交并推送工作流文件

git add .github/workflows/deploy.yml
git commit -m "Add CI/CD with self-hosted runner"
git push origin main

推送后，GitHub Actions 会自动运行。您可以在 Actions 标签页观察：

• build-and-push 任务在 ubuntu-latest 上构建并推送镜像
• deploy 任务在您的服务器上拉取镜像并启动容器

第五步：测试自动化更新

修改本地 app.py 中的返回内容，例如：

    return f'{greeting} from Docker and CI! (Auto deployed with self-hosted runner)'

提交并推送：

git add app.py
git commit -m "Update message"
git push origin main

再次观察 Actions，完成后访问 http://你的服务器IP:5000 查看更新。