ilyasemenov/gitlab-ci-git-push

GitLab CI runner 推送至Git仓库镜像

镜像概述和主要用途

该GitLab CI runner镜像允许将GitLab项目部署到远程Git仓库，特别适用于Dokku、Heroku、Deis等依赖Git推送进行部署的平台。通过集成CI/CD流程，实现代码提交后的自动推送部署。

核心功能和特性

• 支持通过SSH密钥认证连接远程Git仓库
• 可指定推送目标分支，默认推送至master分支
• 兼容非标准SSH端口的Git服务
• 支持禁用默认的强制推送行为
• 与GitLab CI/CD流程无缝集成

使用场景和适用范围

适用于需要通过GitLab CI/CD pipeline将代码自动推送到远程Git仓库的部署场景，尤其适合以下平台：

• Dokku应用部署
• Heroku应用部署
• Deis应用部署
• 其他基于Git推送的部署系统

使用方法和配置说明

基本配置步骤

1. 创建.gitlab-ci.yml文件

在项目根目录创建CI配置文件：

yaml
image: ilyasemenov/gitlab-ci-git-push

stages:
  - deploy

deploy to production:
  stage: deploy
  environment: production
  only:
    - master
  script: git-push dokku@dokku.me:myapp

2. 配置SSH私钥

1. 进入GitLab项目页面
2. 导航至 设置 > CI/CD > 变量
3. 添加名为SSH_PRIVATE_KEY的变量，值为未加密的SSH私钥：

-----BEGIN RSA PRIVATE KEY-----
...
-----END RSA PRIVATE KEY-----

注意：私钥必须未加密。如果私钥顶部包含Proc-Type: 4,ENCRYPTED，表示已加密，需先解密：

console
openssl rsa -in 加密的私钥文件 -out 解密的私钥文件

高级使用场景

推送到非master分支

默认情况下，git-push会推送至远程仓库的master分支。如需指定其他分支，可在命令中添加分支名：

console
git-push user@git.host:repo 目标分支名

连接非标准SSH端口的Git服务

如需连接运行在非标准端口的Git服务，使用SSH URL格式指定端口：

console
git-push ssh://dokku@dokku.me:8022/myapp

禁用强制推送

默认启用强制推送（git push --force）。如需禁用，设置环境变量DISABLE_FORCE_PUSH为任意值：

yaml
deploy to production:
  stage: deploy
  environment: production
  only:
    - master
  variables:
    DISABLE_FORCE_PUSH: "true"
  script: git-push ***:myapp