如何将非Web后端二进制服务部署至GitLab测试环境？

针对你要部署非Web类桌面GUI后端服务的需求，以下是几个适配GitLab环境的落地方案：

方案1：GitLab CI/CD + 远程SSH执行部署脚本 #

利用GitLab CI的SSH能力直接操作测试服务器，完成服务的安装、启动与停止：

• 配置步骤：
  1. 在GitLab项目的「设置→CI/CD→变量」中添加测试服务器的SSH私钥（SSH_PRIVATE_KEY）、服务器地址（TEST_SERVER_IP）、用户名（TEST_SERVER_USER）等敏感信息。
  2. 在项目根目录创建.gitlab-ci.yml，定义部署、停止两个阶段：

     stages:
       - deploy
       - stop
     
     deploy_to_test:
       stage: deploy
       script:
         - 'which ssh-agent || (apt-get update -y && apt-get install openssh-client -y)'
         - eval $(ssh-agent -s)
         - echo "$SSH_PRIVATE_KEY" | tr -d '\r' | ssh-add -
         - mkdir -p ~/.ssh
         - chmod 700 ~/.ssh
         - ssh-keyscan $TEST_SERVER_IP >> ~/.ssh/known_hosts
         - chmod 644 ~/.ssh/known_hosts
         # 复制安装包到测试服务器
         - scp ./path/to/your/installer $TEST_SERVER_USER@$TEST_SERVER_IP:/tmp/
         # 执行安装+启动服务（根据你的安装程序调整命令）
         - ssh $TEST_SERVER_USER@$TEST_SERVER_IP "cd /tmp && ./installer --install-dir /opt/backend-service && systemctl start backend-service"
       only:
         - main # 或你的测试分支
     
     stop_test_service:
       stage: stop
       script:
         - eval $(ssh-agent -s)
         - echo "$SSH_PRIVATE_KEY" | tr -d '\r' | ssh-add -
         - ssh-keyscan $TEST_SERVER_IP >> ~/.ssh/known_hosts
         - ssh $TEST_SERVER_USER@$TEST_SERVER_IP "systemctl stop backend-service && systemctl disable backend-service"
       when: manual # 手动触发停止，适合测试完成后操作
     

  3. 提前在测试服务器上配置backend-service的systemd服务文件（/etc/systemd/system/backend-service.service），确保服务能后台稳定运行：

     [Unit]
     Description=Desktop GUI Backend Service
     After=network.target
     
     [Service]
     ExecStart=/opt/backend-service/your-binary
     Restart=on-failure
     User=test-user
     
     [Install]
     WantedBy=multi-user.target
     

方案2：将测试服务器注册为GitLab Runner #

把测试服务器直接作为GitLab Runner，让部署任务在目标机器本地执行，省去远程SSH的复杂度：

• 配置步骤：
  1. 在GitLab项目的「设置→CI/CD→Runners」中获取注册令牌，然后在测试服务器上安装GitLab Runner并完成注册，给runner打上专属标签（比如backend-test-runner）。
  2. 编写.gitlab-ci.yml，指定使用该runner执行部署：

     stages:
       - deploy
       - stop
     
     deploy_local:
       stage: deploy
       tags:
         - backend-test-runner
       script:
         # 拉取项目中的安装包（或从GitLab artifacts下载）
         - cp ./path/to/installer /tmp/
         - cd /tmp && ./installer --install-dir /opt/backend-service
         - systemctl start backend-service
       only:
         - test-branches
     
     stop_local_service:
       stage: stop
       tags:
         - backend-test-runner
       script:
         - systemctl stop backend-service && rm -rf /opt/backend-service
       when: manual
     

• 优势：无需处理SSH密钥，部署操作更直接，适合长期固定的测试服务器场景。

方案3：容器化部署（快速启停+环境隔离） #

如果你的后端服务支持容器化，用GitLab CI构建镜像并在测试服务器上部署容器，便于快速清理环境：

• 配置步骤：
  1. 编写Dockerfile打包后端服务：

     FROM ubuntu:22.04
     COPY your-binary /app/
     CMD ["/app/your-binary"]
     

  2. 在.gitlab-ci.yml中构建镜像并推送到GitLab容器注册表，然后远程触发测试服务器拉取启动：

     stages:
       - build
       - deploy
       - stop
     
     build_image:
       stage: build
       script:
         - docker build -t $CI_REGISTRY_IMAGE/backend-test:$CI_COMMIT_SHA .
         - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
         - docker push $CI_REGISTRY_IMAGE/backend-test:$CI_COMMIT_SHA
     
     deploy_container:
       stage: deploy
       script:
         - eval $(ssh-agent -s)
         - echo "$SSH_PRIVATE_KEY" | ssh-add -
         - ssh $TEST_SERVER_USER@$TEST_SERVER_IP "docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY"
         - ssh $TEST_SERVER_USER@$TEST_SERVER_IP "docker run -d --name backend-test $CI_REGISTRY_IMAGE/backend-test:$CI_COMMIT_SHA"
       only:
         - main
     
     stop_container:
       stage: stop
       script:
         - ssh $TEST_SERVER_USER@$TEST_SERVER_IP "docker stop backend-test && docker rm backend-test && docker rmi $CI_REGISTRY_IMAGE/backend-test:$CI_COMMIT_SHA"
       when: manual
     

• 优势：测试环境与宿主环境隔离，停止时只需删除容器即可彻底清理，适合多版本并行测试的场景。

方案4：GitLab环境管理+自定义生命周期脚本 #

利用GitLab的「环境（Environments）」功能管理测试服务的生命周期，即使是非Web应用也能适配：

• 配置步骤：
  1. 在.gitlab-ci.yml中部署job关联test环境：

     deploy_to_env:
       stage: deploy
       script:
         # 执行部署启动脚本（同方案1或2的部署逻辑）
         - ssh $TEST_SERVER_USER@$TEST_SERVER_IP "./deploy-script.sh start"
       environment:
         name: test
         url: "ssh://$TEST_SERVER_USER@$TEST_SERVER_IP" # 自定义环境链接，方便快速访问服务器
       only:
         - test-branches
     
     stop_env_service:
       stage: stop
       script:
         - ssh $TEST_SERVER_USER@$TEST_SERVER_IP "./deploy-script.sh stop"
       environment:
         name: test
         action: stop # 标记环境停止
       when: manual
     

  2. 编写deploy-script.sh脚本统一处理服务的启动、停止、卸载逻辑：

     #!/bin/bash
     ACTION=$1
     SERVICE_DIR="/opt/backend-service"
     
     case $ACTION in
       start)
         $SERVICE_DIR/your-binary &
         echo $! > /var/run/backend-service.pid
         ;;
       stop)
         kill $(cat /var/run/backend-service.pid)
         rm -f /var/run/backend-service.pid
         ;;
       *)
         echo "Usage: $0 {start|stop}"
         exit 1
         ;;
     esac
     

• 优势：可以在GitLab的「环境」页面直观查看测试环境状态，一键触发停止操作，便于团队协作管理。

内容的提问来源于stack exchange，提问作者Jewgioh