Tự Động Cài Đặt GitHub Actions Runner Bằng Bash Script – Nhanh, Gọn, Lẹ!

Nếu bạn đang cần thiết lập một GitHub Actions Runner trên Linux mà không muốn mất công cài đặt thủ công, thì Bash script dưới đây chính là giải pháp dành cho bạn. Chỉ cần chạy một lệnh duy nhất, bạn sẽ có ngay một runner sẵn sàng hoạt động.

Bash Script Cài Đặt GitHub Actions Runner

Dưới đây là toàn bộ script giúp bạn tải về, cài đặt và khởi động GitHub Actions Runner một cách tự động:

#!/bin/bash  

if [ "$#" -ne 3 ]; then  
    echo "Usage: $0 <directory_number> <token> <label>"  
    exit 1  
fi  

DIR_NUMBER=$1  
TOKEN=$2  
LABEL_SV=$3  

RUNNER_GROUP_DEFAULT="Default"  
RUNNER_NAME="hosted-runner-org-$LABEL_SV-$DIR_NUMBER"  
RUNNER_LABELS="$LABEL_SV,org-level,hosted"  
WORK_FOLDER="_work"  

DIR_NAME="actions-runner-$DIR_NUMBER"  
mkdir "$DIR_NAME" && cd "$DIR_NAME" || exit  

echo "Downloading GitHub Actions Runner..."  
curl -o actions-runner-linux-x64-2.319.1.tar.gz -L https://github.com/actions/runner/releases/download/v2.319.1/actions-runner-linux-x64-2.319.1.tar.gz  

echo "Checking checksum..."  
echo "3f6efb7488a183e291fc2c62876e14c9ee732864173734facc85a1bfb1744464  actions-runner-linux-x64-2.319.1.tar.gz" | shasum -a 256 -c  

echo "Extracting files..."  
tar xzf ./actions-runner-linux-x64-2.319.1.tar.gz  

echo "Configuring the runner..."  
./config.sh --url https://github.com/company \
    --token "$TOKEN" \
    --name "$RUNNER_NAME" \
    --runnergroup "$RUNNER_GROUP_DEFAULT" \
    --labels "$RUNNER_LABELS" \
    --work "$WORK_FOLDER"  

echo "Starting the runner..."  
nohup ./run.sh > runner.log 2>&1 &  

cd ..  

echo "GitHub Actions runner setup complete in $DIR_NAME."

Giải Thích Từng Bước Một

1. Nhận thông tin đầu vào

Script này yêu cầu 3 tham số:

• directory_number: Số thứ tự runner (dùng để đặt tên thư mục).
• token: Token để runner có thể kết nối với GitHub.
• label: Nhãn runner để dễ quản lý.

Nếu nhập thiếu, script sẽ báo lỗi và dừng lại ngay.

2. Tạo thư mục và tải về runner

Runner sẽ được tải về từ GitHub và lưu vào thư mục actions-runner-<directory_number>.

3. Kiểm tra checksum

Chắc chắn rằng file tải về không bị lỗi bằng cách kiểm tra mã hash SHA-256.

4. Giải nén và cấu hình runner

Runner sẽ được giải nén và kết nối với GitHub thông qua script config.sh. Nó sẽ:

• Gán tên runner.
• Gán runner vào nhóm Default.
• Thêm nhãn để dễ nhận diện.

5. Chạy runner ở chế độ nền

Runner sẽ khởi động và chạy ở chế độ nền để luôn sẵn sàng nhận job từ GitHub Actions.

Cách Sử Dụng

Mở terminal và chạy lệnh sau (thay giá trị <directory_number>, <token>, <label> bằng giá trị thực tế của bạn):

chmod +x setup_runner.sh  
./setup_runner.sh 1 your_token_here your_label_here  

Sau khi chạy xong, runner sẽ tự động hoạt động và bạn có thể sử dụng nó ngay lập tức. Script này giúp bạn tiết kiệm rất nhiều thời gian khi cài đặt GitHub Actions Runner. Thay vì phải làm từng bước thủ công, bạn chỉ cần một dòng lệnh là xong! Nếu bạn đang quản lý nhiều runner hoặc muốn triển khai nhanh chóng, thì đây là cách làm cực kỳ hiệu quả.