Gõ ít nhất hai chữ cái để tìm trong mọi trang tài liệu.

↑ ↓ để di chuyển ↵ để mở esc để đóng

Sử dụng rdev

Nhóm

Quản lý ai làm việc trên các máy chủ gói Team của bạn: mời lập trình viên, cấp cho họ một vai trò và một môi trường riêng.

Mời mọi người

Mở Nhóm của bạn trong bảng điều khiển. Nhập địa chỉ email của một lập trình viên, chọn một vai trò và gửi lời mời. Họ nhận một email có liên kết hiệu lực trong 7 ngày; họ chấp nhận bằng cách đăng nhập, hoặc tạo tài khoản, với chính địa chỉ đó.

Mỗi thành viên và mỗi lời mời đang chờ chiếm một chỗ. Khi tất cả chỗ đã được dùng, hãy thêm chỗ bằng cách đổi gói trên bảng điều khiển trước. Thu hồi một lời mời đang chờ giải phóng chỗ của nó ngay lập tức.

Vai trò

Vai trò Có thể
Chủ sở hữu Mọi thứ: trả tiền cho giấy phép và không thể bị xóa
Quản trị viên Mời, gửi lại và thu hồi lời mời, đổi vai trò, xóa thành viên
Thành viên Dùng các máy chủ của nhóm; có thể rời nhóm

Một môi trường cho mỗi thành viên

Mỗi thành viên lưu các khóa công khai SSH của mình trên trang Nhóm của bạn, mỗi dòng một khóa: một khóa cho mỗi máy tính họ làm việc (ví dụ nội dung của ~/.ssh/id_ed25519.pub). Trang hiển thị tên môi trường của họ, như rdev-alice; các thành viên chưa có khóa được đánh dấu. Thẻ SSH keys của máy chủ liệt kê các khóa nhóm này trong một thẻ riêng, phía trên các khóa của chính máy chủ.

Trên máy chủ của nhóm, hãy chạy lệnh này một lần bằng root, với một auth key có thể tái sử dụng từ tài khoản Tailscale của bạn:

sudo rdev host member sync --tailscale-key tskey-auth-…

Nó tạo một môi trường cho mọi thành viên đã lưu khóa, và từ đó tự lặp lại mỗi 15 phút: thành viên mới nhận môi trường của họ, khóa thay đổi được cập nhật và môi trường của những người đã rời nhóm bị xóa. Dữ liệu của họ vẫn nằm trên máy chủ; hãy xóa nó bằng sudo rdev host member remove <name> --delete-data.

Mỗi thành viên nhận một container riêng với mã nguồn, cơ sở dữ liệu, dịch vụ và shell riêng; các thành viên không thấy công việc của nhau. Nó tham gia tailnet của bạn với tên <server name>-<name>, và thành viên kết nối bằng ssh dev@<server name>-<name> hoặc ứng dụng laptop rdev. Chủ sở hữu tiếp tục dùng môi trường chính của máy chủ.

  • sudo rdev host status liệt kê các thành viên và việc môi trường của họ có đang chạy hay không.
  • sudo rdev host update cập nhật mọi môi trường trên máy chủ cùng lúc.
  • sudo rdev host member add <name> --ssh-key "…" thêm một môi trường thủ công, nhưng lần đồng bộ tiếp theo sẽ xóa nó nếu người đó không thuộc nhóm.

Mỗi môi trường có cài đặt đồng bộ và env riêng. Thành viên tìm thấy của mình trên trang Nhóm của bạn trong Các môi trường của bạn: bật hoặc tắt đồng bộ tệp, dự án nào đến laptop của họ, các mục loại trừ, và các biến env của dự án. Chỉ thành viên mới đổi môi trường của chính mình; chủ sở hữu và quản trị viên đổi môi trường chính. Điều tương tự áp dụng trong ứng dụng laptop rdev.

PHP trong môi trường thành viên mới. Khi Thành viên mới bắt đầu với PHP của môi trường chính được bật (mặc định, trên trang Nhóm của bạn), môi trường của thành viên mới nhận các phiên bản PHP của môi trường chính, phiên bản mặc định của nó và các phần mở rộng trong danh mục của từng phiên bản khi nó được tạo, để các dự án của nhóm chạy ngay. Các môi trường hiện có không bị thay đổi, và mỗi thành viên có thể tự đổi PHP của mình sau. Điều này cần rdev 0.2.0-beta.36 trở lên trên máy chủ của nhóm; khi nó tắt, các môi trường mới bắt đầu với PHP mặc định.

Nhiều server cho nhóm. Nhóm lớn có thể chia môi trường ra nhiều server: cài rdev với giấy phép Team trên từng server và chạy rdev host member sync trên từng server. Khi nhóm có hơn một server, bảng Members ở trang Your team có thêm cột Server để chủ sở hữu và quản trị viên xếp từng thành viên; thành viên chưa được xếp làm việc trên server đầu tiên của nhóm. Ở lần đồng bộ kế tiếp, trong vòng 15 phút, mỗi server tạo môi trường cho các thành viên được xếp vào nó và gỡ container của người khác; tệp vẫn ở server cũ cho đến khi bạn xóa bằng sudo rdev host member remove <tên> --delete-data, nên hãy commit và push trước khi chuyển ai đó. Cần rdev 1.1.10 trở lên trên mọi server của nhóm.

Sao chép dự án cho thành viên

Chủ sở hữu và quản trị viên có thể giao dự án cho một thành viên mà không cần đi qua git trước. Trên trang của máy chủ, mở Dự án, chọn Sao chép cho thành viên nhóm trong menu của dự án, chọn thành viên và những gì đi kèm:

  • Sao chép cả cơ sở dữ liệu (mặc định bật): cơ sở dữ liệu MySQL, MariaDB hoặc PostgreSQL mang tên dự án.
  • Sao chép cả .env (mặc định tắt): mật khẩu và khóa API trong đó cũng được gửi đi và không thể lấy lại. Hãy để tắt để thành viên dùng giá trị của riêng họ.

Máy chủ nhóm sao chép dự án vào môi trường của thành viên ở lần đồng bộ tiếp theo, trong vòng 15 phút; Bản sao gửi thành viên nhóm bên dưới danh sách dự án cho biết khi nào mỗi bản sao hoàn tất, hoặc vì sao thất bại. Sau đó thành viên làm việc trên bản sao của mình, và thay đổi quay về qua git. Kết quả build (target, .next, .nuxt, .svelte-kit, .turbo, .dart_tool, .gradle, __pycache__) không được sao chép, nên lần build đầu tiên trong bản sao bắt đầu từ đầu; vendor và node_modules được sao chép. Nếu thành viên đã có một dự án cùng tên, việc sao chép sẽ thất bại cho đến khi họ xóa hoặc đổi tên dự án đó.

Sao chép hoạt động giữa các môi trường trên cùng một máy chủ, và máy chủ đó phải chạy rdev host member sync (xem ở trên); trước đó, hộp thoại sao chép và trang Nhóm của bạn sẽ cảnh báo rằng các bản sao đang chờ. Cần rdev 1.4.6 trở lên trên máy chủ nhóm.

Cơ sở dữ liệu dùng chung

Môi trường của chủ sở hữu đồng thời là máy chủ cơ sở dữ liệu dùng chung của nhóm. Mọi môi trường thành viên truy cập cơ sở dữ liệu và dịch vụ của nó (MySQL, MariaDB, PostgreSQL, MongoDB, Redis và các dịch vụ khác) bằng tên rdev-team (ví dụ DB_HOST=rdev-team và cổng 3306 trong .env của Laravel), bên cạnh các dịch vụ riêng của chính họ. Hãy dùng nó cho dữ liệu mà cả nhóm cùng làm việc, như một bản staging dùng chung; hãy giữ các thử nghiệm cá nhân trong cơ sở dữ liệu của môi trường của riêng bạn.

Biến dùng chung

Chủ sở hữu và quản trị viên có thể chia sẻ các biến như API key với cả nhóm trong Biến dùng chung trên trang Nhóm của bạn. Chọn Thêm biến, đặt tên (ví dụ STRIPE_SECRET), dự án mà nó dành cho hoặc Tất cả dự án, và giá trị của nó. Mọi môi trường của nhóm ghi nó vào .env của các dự án đó trong vài giây, và cả vào các dự án được tạo sau; một thành viên tham gia sau nhận nó từ một môi trường đã có. Một biến cho một dự án được ưu tiên hơn một biến cùng tên cho tất cả dự án. Các biến cho tất cả dự án chỉ đi vào những thư mục có .env, nên các thư mục không phải ứng dụng được giữ nguyên.

Đổi một giá trị bằng biểu tượng bút chì, hoặc xóa biến để gỡ nó khỏi mọi .env. Bảng hiển thị có bao nhiêu môi trường có mỗi biến; rê chuột lên con số để xem môi trường nào chưa có.

Trình duyệt của bạn mã hóa giá trị riêng cho từng môi trường trước khi nó rời trang, nên bảng điều khiển của rdev chỉ giữ tên, không bao giờ giữ giá trị. Bên trong một môi trường, giá trị là một dòng .env thông thường, nên ai dùng môi trường đó đều đọc được, như với mọi .env. Một biến dùng chung ghi đè dòng tương ứng trong .env của dự án ở mỗi lần đồng bộ, nên hãy đổi nó ở đây, không phải trong tệp. Nó cần rdev 0.2.0-beta.34 trở lên trong mỗi môi trường.

Kho sao lưu của nhóm

Chủ sở hữu và quản trị viên có thể thiết lập một bucket sao lưu cho mọi thành viên ở mục Kho sao lưu của nhóm trên trang Nhóm của bạn. Mỗi môi trường sao lưu vào thư mục riêng trong đó, và mỗi thành viên vẫn có thể chọn bucket riêng ở trang máy chủ. Xem Sao lưu và cài đặt.

Khởi động nhóm

Với gói Team, chủ sở hữu thấy hộp Thiết lập nhóm của bạn trên bảng điều khiển với các bước đầu theo thứ tự: cài rdev lên máy chủ đầu tiên của nhóm, mời nhóm, thành viên cài môi trường của họ, kết nối laptop và thêm dự án đầu tiên. Mỗi bước dẫn đến trang hoặc hướng dẫn cần thiết và được đánh dấu khi xong. Đặt cuộc gọi hướng dẫn mở một yêu cầu hỗ trợ để bạn gửi vài khung giờ phù hợp, và chúng tôi sắp xếp cuộc gọi với nhóm của bạn. Tôi không cần ẩn hộp đó vĩnh viễn.

Kênh nhóm

Chủ sở hữu và quản trị viên có thể thêm một incoming webhook của Slack hoặc Discord làm Kênh nhóm trên trang Nhóm của bạn. Ở lần đồng bộ tiếp theo, mọi môi trường trên các máy chủ của nhóm, kể cả của chủ sở hữu, cũng gửi thông báo agent của nó (hoàn thành, chờ phê duyệt, lỗi) tới đó, bên cạnh các kênh mà mỗi thành viên đã thiết lập bằng rdev notify. Xóa trường này để dừng.

Quy tắc nhóm cho AI agent

Chủ sở hữu và quản trị viên có thể viết Quy tắc nhóm cho AI agent trên trang Nhóm của bạn, như quy ước lập trình của bạn hoặc cơ sở dữ liệu nào được dùng cho dự án mới. Ở lần đồng bộ tiếp theo, mọi môi trường trên các máy chủ của nhóm thêm chúng vào hồ sơ agent của nó, để Claude Code và Codex tuân theo chúng trong mọi dự án. Các thành viên thấy các quy tắc trên cùng trang.

Nếu giấy phép dừng hoạt động

Khi giấy phép Team không còn hoạt động, không ai mới có thể tham gia nhóm và mọi môi trường trên máy chủ chuyển sang chỉ đọc đối với dự án mới, giống như một máy chủ đơn lẻ.