搭建 Bitbucket 二进制 Shell 模式 Runner 的通关教程

2026-06-19 约 286 字预计阅读 2 分钟

本文记录了** OpenVZ (LXC) 纯净小鸡（以 Ubuntu 24.04 为例）从零开始全手工搭建 Bitbucket 二进制 Shell 模式 Runner 的通关教程**。

**本教程完全脱离 Docker，纯粹利用小鸡的系统底座运行 [▲]。

我会按步骤分为 环境准备 → 下载解压 → 运行 → 守护。

1️⃣ 纯净系统环境补全（包含 curl、Java 25 和 Git）

刚开机的 OpenVZ 小鸡非常精简，必须先安装网络工具、高版本编译器和版本控制工具 [▲]。直接在小鸡终端依次运行：

# 1. 切换到绝对 root 权限
sudo su -

# 2. 更新系统软件源
apt-get update && apt-get upgrade -y

# 3. 安装基础网络下载工具 curl
apt-get install curl software-properties-common -y

# 4. 添加高版本 Java 的官方扩展库 PPA
add-apt-repository ppa:openjdk-r/ppa -y
apt-get update

# 5. 安装官方要求的最新 Java 25 运行环境与 Git 工具
apt-get install openjdk-25-jre-headless git -y

验证环境：输入 java -version 确保输出 version “25”；输入 git –version 确保 Git 已就绪 [▲]。

#debain12
apt-get update
apt-get install python3-launchpadlib -y
apt-get update && apt-get install default-jre-headless git -y
apt-get install openjdk-17-jre-headless git wget -y
java -version
useradd -m -s /bin/bash bitbucket-runner
su - bitbucket-runner

2️⃣ 解开 OpenVZ 宿主机的 1024 句柄与线程封印

OpenVZ 容器默认会对最大进程数和文件打开数做出严格限制 [▲]。为了防止 Java 25 并发通信时闪退，必须强行拉满系统资源限制：

3️⃣ 下载并解压 Bitbucket 官方 Shell 二进制包

我们直接在根目录下建立独立的运行沙箱 [▲]：

# 1. 回到根目录并下载官方最新的 6.x 官方二进制包
cd /
curl -L https://product-downloads.atlassian.com/software/bitbucket/pipelines/atlassian-bitbucket-pipelines-runner-6.0.4.tar.gz --output atlassian-bitbucket-pipelines-runner.tar.gz
#debian12
curl -L https://product-downloads.atlassian.com/software/bitbucket/pipelines/atlassian-bitbucket-pipelines-runner-5.9.0.tar.gz --output atlassian-bitbucket-pipelines-runner.tar.gz

# 2. 创建文件夹并将其完整解压进去
mkdir atlassian-bitbucket-pipelines-runner
tar -xzvf atlassian-bitbucket-pipelines-runner.tar.gz -C atlassian-bitbucket-pipelines-runner

# 3. 创建运行必不可少的临时缓存目录
mkdir /atlassian-bitbucket-pipelines-runner/temp

4️⃣ 从零生成属于你的 Bitbucket 认证密钥

打开浏览器登录 Bitbucket 网页端。

2.依次进入：左下角工作区设置 (Workspace settings) -> Pipelines 分组下的 Runners [▲]。

3.点击右上角蓝色按钮 Add runner [▲]。

4.核心选项：

Runner class：必须选择 Linux Shell（代表直接利用小鸡系统，不依赖 Docker） [▲]。
Runner name：起名叫 ovz-ubuntu。
Labels：填入 vps-build [▲]。

5.点击 Next，网页上会弹出一长串包含四个核心密钥的指导命令 [▲]。请把它们单独摘出来。

5️⃣ 终极守护进程启动（随缘关黑窗口，永不掉线）

**如果你直接运行 ./start.sh，一旦关闭 SSH 窗口，Runner 就会瞬间死掉 [▲]。

请进入解压好的 bin 目录，使用 nohup 加上末尾的 &，强行将它打入 Ubuntu 系统的底层后台常驻：

cd /atlassian-bitbucket-pipelines-runner/bin

# 复制下方命令，替换为你自己在第 4 步网页中生成的真实专属密钥，然后整行回车：
nohup ./start.sh \
  --accountUuid {你的ACCOUNT_UUID} \
  --runnerUuid {你的RUNNER_UUID} \
  --OAuthClientId 你的OAUTH_CLIENT_ID \
  --OAuthClientSecret 你的OAUTH_CLIENT_SECRET \
  --runtime linux-shell \
  --workingDirectory ../temp > /dev/null 2>&1 &

📅 日常运维与验收

检查是否成功在后台隐身运行：输入 ps -ef | grep java，只要能看到一行长长的带有 runner.jar 的高亮进程，说明它已经在后台安全托底运行了 [▲]。

2.看网页端效果：回到网页端刷新，你会看到这个 ovz-ubuntu 的状态会瞬间秒变绿色的 ONLINE 🟢 [▲]！