karser/gitbitlabhub

GitBitLabHub：使用简单Webhook在Bitbucket/Gitlab/Github之间镜像仓库

!https://img.shields.io/docker/pulls/karser/gitbitlabhub

• 纯bash编写的简单shell脚本（包括Web服务器部分）
• 基于Alpine的Docker镜像，大小约10MB
• 单个容器镜像单个仓库
• 单线程处理，处理前一个Webhook时会忽略下一个，自带DDoS保护

为什么需要镜像仓库？

• 可串联多个服务，例如将Bitbucket私有仓库作为主存储，自建Gitlab实例仅用作CI/CD工具
• 有备无患，镜像仓库是SaaS服务的唯一备份方案

如何使用

使用docker运行

docker run -it \
    -e SRC_REPO=git@bitbucket.org:vendor/src_repo.git \
    -e DEST_REPO=git@gitlab.example.com:2222/vendor/dest_repo.git \
    -e SRC_DEPLOY_KEY=base64_encoded_key \
    -e DEST_DEPLOY_KEY=base64_encoded_key \
    -p 8181:8080/tcp \
    docker.xuanyuan.run/karser/gitbitlabhub

其中SRC_DEPLOY_KEY和DEST_DEPLOY_KEY可通过以下命令获取：

base64 -w 0 < ~/.ssh/project_src_id_rsa
base64 -w 0 < ~/.ssh/project_dest_id_rsa

访问URL为：http://localhost:8181

使用docker-compose和traefik运行

yaml
version: '3.3'

services:
  gitbitlabhub_repo1:
    image: docker.xuanyuan.run/karser/gitbitlabhub
    restart: always
    networks:
      - webproxy
    environment:
      SRC_REPO: 'git@bitbucket.org:vendor/src_repo.git'
      DEST_REPO: 'git@gitlab.example.com:2222/vendor/dest_repo.git'
      SRC_DEPLOY_KEY: 'base64_encoded_key'
      DEST_DEPLOY_KEY: 'base64_encoded_key'
    labels:
      - "traefik.enable=true"
      - "traefik.backend=gitbitlabhub_repo1"
      - "traefik.frontend.rule=Host:gitbitlabhub.example.com;PathPrefixStrip:/vendor/src_repo"
      - "traefik.port=8080"
      - "traefik.docker.network=webproxy"
    volumes:
      - ./gitbitlabhub:/storage

networks:
  webproxy:
    external: true

访问URL为：[***]

如何设置镜像

1. 为源仓库和目标仓库生成2个部署密钥：

bash
ssh-keygen -t rsa -f ~/.ssh/project_src_id_rsa
ssh-keygen -t rsa -f ~/.ssh/project_dest_id_rsa

将这些密钥分别添加到源仓库和目标仓库的设置中：

bash
cat ~/.ssh/project_src_id_rsa.pub
cat ~/.ssh/project_dest_id_rsa.pub

源仓库的部署密钥可设为只读。根据平台不同，它可能被称为"部署令牌"或"访问密钥"。参考如何添加部署/访问密钥：https://confluence.atlassian.com/bitbucket/deployment-keys-776639781.html%E3%80%81https://confluence.atlassian.com/bitbucketserver/ssh-access-keys-for-system-use-776639781.html%E3%80%81https://docs.gitlab.com/ce/ssh/%E3%80%81https://developer.github.com/v3/guides/managing-deploy-keys/%E3%80%82

2. 运行容器并正确配置所有环境变量（参见如何使用部分）。

3. 在源仓库中创建Webhook。参考如何创建Webhook：https://confluence.atlassian.com/bitbucket/manage-webhooks-735643732.html%E3%80%81https://docs.gitlab.com/ce/user/project/integrations/webhooks.html%E3%80%81https://developer.github.com/webhooks/creating/%E3%80%82

如何构建镜像

bash
docker build --tag karser/gitbitlabhub:latest .
docker push karser/gitbitlabhub:latest