# Bắt đầu nhanh

> Chạy job GitHub Actions đầu tiên trên Skipbox: đăng nhập, cài ứng dụng, đổi một dòng runs-on, rồi push.

Bạn cần một repository trên tổ chức GitHub hoặc tài khoản cá nhân, công khai hay riêng tư đều được, có ít nhất một workflow trong `.github/workflows`. Các bước chỉ mất vài phút, và dùng thử miễn phí không cần thẻ.

## 1. Đăng nhập bằng GitHub

Mở [skipbox.dev](https://skipbox.dev/?lang=vi) và đăng nhập bằng GitHub. Đăng nhập không tốn gì.

## 2. Cài ứng dụng Skipbox

Skipbox hiển thị hai nút cài. Chọn nút dành cho tài khoản có các job bạn muốn chạy:

- **Tổ chức:** cài ứng dụng **Skipbox CI**. Owner của tổ chức là người cài. Nếu bạn không phải owner, GitHub gửi yêu cầu của bạn cho họ, và owner nào cài thì đăng nhập Skipbox một lần.
- **Tài khoản cá nhân của bạn:** cài ứng dụng **Skipbox (personal)**.

Sau đó GitHub hỏi ứng dụng được dùng mọi repository hay chỉ một số. Skipbox chạy job từ repository công khai lẫn riêng tư; với tổ chức có repository công khai, hãy cho phép Skipbox trên repository công khai một lần (nút trên trang repository của bạn), vì GitHub không cho self-hosted runner chạy chúng cho đến khi owner cho phép. Xem [Tổ chức và tài khoản cá nhân](https://docs.skipbox.dev/vi/accounts) và [Quyền của ứng dụng GitHub](https://docs.skipbox.dev/vi/permissions).

## 3. Đổi runs-on của một job

Mở một file workflow và đặt `runs-on` của một job thành `skipbox`:

```yaml
jobs:
  test:
    runs-on: skipbox
    steps:
      - uses: actions/checkout@v4
      - run: make test
```

Bảng điều khiển liệt kê các repository của bạn, mỗi workflow có một đường liên kết **Sửa trên GitHub**, để bạn sửa trong trình soạn thảo của GitHub. Hoặc nhấn **Mở pull request** bên cạnh một repository: Skipbox mở một pull request đổi các dòng `runs-on` thay bạn, sau khi GitHub yêu cầu bạn cài ứng dụng Skipbox Migrate trên repository đó ([Quyền của ứng dụng GitHub](https://docs.skipbox.dev/vi/permissions)). Merge nó, và bỏ qua bước 4.

## 4. Commit và push

Commit thay đổi. Lần chạy tiếp theo của job đó chạy trên Skipbox và hiện trên bảng điều khiển. Dùng thử miễn phí bắt đầu từ job đầu tiên này: 7 ngày hoặc 3.000 phút chạy job, tùy điều kiện nào đến trước. Xem [Dùng thử miễn phí](https://docs.skipbox.dev/vi/trial).

## Quay về runner của GitHub

Đặt `runs-on` về như cũ, chẳng hạn `ubuntu-latest`, rồi commit. Skipbox không thay đổi gì khác trong repository của bạn.

## Đọc tiếp

- Để AI coding agent chuyển các job còn lại: [Thiết lập bằng AI coding agent](https://docs.skipbox.dev/vi/ai-agents).
- VM lớn hơn: [Nhãn và kích thước](https://docs.skipbox.dev/vi/labels).
- VM đã cài sẵn những gì: [Image của runner](https://docs.skipbox.dev/vi/runner-image).
- Job không khởi chạy: [Job nằm mãi trong hàng đợi](https://docs.skipbox.dev/vi/job-queued).

Cập nhật ngày 2026-11-12 · https://docs.skipbox.dev/vi/quickstart
