Cơ sở dữ liệu, cache, tìm kiếm và lưu trữ tệp chạy bên trong môi trường của bạn, cạnh các site của bạn. rdev cài từng dịch vụ lần đầu tiên một dự án cần, ở phiên bản bạn chọn, giữ nó luôn chạy và ghi cài đặt kết nối vào .env của dự án.
Những gì có sẵn
| Dịch vụ | Dùng để làm gì | Phiên bản | Cổng mặc định |
|---|---|---|---|
| MySQL | Cơ sở dữ liệu quan hệ | 8.0, 8.4, 9.7 | 3306 |
| MariaDB | Cơ sở dữ liệu quan hệ | 10.11, 11.4, 11.8, 12.3 | 3307 |
| PostgreSQL | Cơ sở dữ liệu quan hệ; các bản build -full bổ sung pgvector, PostGIS, pgRouting và (từ 16) TimescaleDB |
14, 15, 16, 17, 18 | 5432 |
| MongoDB | Cơ sở dữ liệu tài liệu | 7.0, 8.0, 9.0 | 27017 |
| Redis | Cache, hàng đợi và phiên | 9.1 | 6379 |
| Meilisearch | Tìm kiếm toàn văn, cho Laravel Scout | 1 | 7700 |
| Typesense | Tìm kiếm toàn văn, cho Laravel Scout | 29, 30 | 8108 |
| RustFS | Lưu trữ tệp tương thích S3, với một bảng điều khiển web ở cổng kế tiếp | 1 | 9000 |
| Elasticsearch | Tìm kiếm và phân tích, cho driver Scout và client Elastic (chạy không có machine learning) | 8.19, 9 | 9200 |
| Qdrant | Tìm kiếm vector cho các tính năng AI như tìm kiếm ngữ nghĩa | 1 | 6333 |
| Bắt thư | Bắt email gửi đi để không có gì đến hộp thư thật; SMTP 127.0.0.1:2525, xem trong trình duyệt tại https://rdev-mail.dev.test |
tích hợp sẵn | |
| Máy chủ dump | Thu thập các bản dump gỡ lỗi từ mã của bạn; 127.0.0.1:2304, xem trong trình duyệt tại https://rdev-dumps.dev.test |
tích hợp sẵn |
Redis dùng giao thức Redis chuẩn: các driver redis của Laravel và phpredis hoạt động không đổi. Mọi dịch vụ chỉ lắng nghe bên trong môi trường của bạn, trên 127.0.0.1; hãy truy cập một bảng điều khiển web như của RustFS thông qua kết nối laptop của bạn.
Thư và dump đã bắt, xem trong trình duyệt
Mở https://rdev-mail.dev.test trong bất kỳ trình duyệt nào trên tailnet của bạn để đọc thư mà ứng dụng của bạn đã gửi. Bạn thấy danh sách (mới nhất trước), tiêu đề của từng thư, phiên bản văn bản thuần và HTML, cùng các tệp đính kèm. Bạn có thể xóa một thư hoặc tất cả, và thư mới tự xuất hiện. Thư HTML được hiển thị với script và hình ảnh từ xa bị chặn.
https://rdev-dumps.dev.test liệt kê các lệnh gọi dump() và các sự kiện khác đã bắt, mới nhất trước, kèm tệp và dòng mà chúng đến từ đó. Xóa danh sách bằng Clear.
Cả hai trang chạy trên máy chủ của bạn và chỉ truy cập được qua tailnet của bạn, giống như các dự án. Dữ liệu không bao giờ rời khỏi máy chủ, và bản xem trước không thể công khai chúng. rdev mail list in ra cả hai địa chỉ, và ứng dụng laptop mở chúng từ Mail và Dumps trên tab Sites. Tên rdev-mail và rdev-dumps được dành riêng, nên dự án không thể dùng chúng.
Cơ sở dữ liệu trong trình duyệt
https://rdev-adminer.dev.test mở Adminer, một trình quản lý cơ sở dữ liệu, trên máy chủ của bạn. Chọn MySQL hoặc PostgreSQL, máy chủ 127.0.0.1, người dùng root (MySQL) hoặc postgres (PostgreSQL) và để trống mật khẩu; với SQLite, nhập đường dẫn tệp cơ sở dữ liệu. Giống các trang ở trên, nó chỉ mở được qua tailnet của bạn, và tên rdev-adminer được dành riêng. Có từ rdev 1.2.0; trên máy chủ cài trước đó, hãy chạy sudo rdev host update trước.
Cấp cho dự án một dịch vụ
Trên máy chủ, hãy nêu tên dự án và dịch vụ:
rdev project service shop postgres
rdev cài đặt và khởi động dịch vụ nếu nó chưa chạy, tạo một cơ sở dữ liệu (MySQL, MariaDB, PostgreSQL) hoặc một bucket (RustFS) đặt theo tên dự án, và ghi cài đặt kết nối vào .env của dự án. Một dự án không có .env sẽ được in các cài đặt ra thay thế. MongoDB tạo cơ sở dữ liệu lần đầu tiên mã của bạn ghi vào nó; với một dự án PHP, rdev cũng cài phần mở rộng PHP mongodb cho phiên bản PHP mà site dùng (xem Phần mở rộng PHP).
Khi một dự án Laravel nhận một cơ sở dữ liệu MySQL, MariaDB hoặc PostgreSQL mới, rdev cũng chạy php artisan migrate --force, để các bảng mà một ứng dụng mới lưu phiên, cache và hàng đợi có sẵn và site tiếp tục hoạt động. Nó chỉ làm vậy với cơ sở dữ liệu vừa được tạo, vẫn còn trống; một cơ sở dữ liệu đã có được giữ nguyên. Nếu migration thất bại, dịch vụ vẫn ở nguyên chỗ và thông báo cho bạn biết lý do, để bạn tự chạy php artisan migrate.
Trong bảng điều khiển, mở máy chủ từ Máy chủ trên thanh bên và chọn Thêm dịch vụ trong thẻ Dịch vụ của nó, ở đầu thẻ hoặc cạnh một dự án (bảng điều khiển có cùng nút), chọn dịch vụ và, với các dịch vụ có nhiều phiên bản, chọn Phiên bản. Hàng của dự án cho biết máy chủ đang ở đâu: cài đặt và khởi động dịch vụ, tạo cơ sở dữ liệu, ghi .env, chạy migration. Một thông báo cho biết khi nào nó sẵn sàng. Lần cài đặt đầu tiên của một dịch vụ có thể mất vài phút. AI agent của bạn có thể làm tương tự thông qua quyền truy cập MCP của nó; hãy nhờ nó "một cơ sở dữ liệu PostgreSQL cho shop".
Một dự án mới có thể nhận các dịch vụ của nó ngay trong cùng một lệnh:
rdev project add shop --git [email protected]:you/shop.git --service mysql --service redis
Những gì đi vào .env
| Dịch vụ | Cài đặt |
|---|---|
| MySQL, MariaDB, PostgreSQL | DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME (không có mật khẩu: chỉ môi trường của bạn truy cập được) |
| MongoDB | MONGODB_URI, MONGODB_DATABASE, cho gói mongodb/laravel-mongodb |
| Redis | REDIS_HOST, REDIS_PORT |
| Meilisearch | SCOUT_DRIVER=meilisearch, MEILISEARCH_HOST |
| Typesense | SCOUT_DRIVER=typesense, TYPESENSE_HOST, TYPESENSE_PORT, TYPESENSE_PROTOCOL, TYPESENSE_API_KEY |
| Elasticsearch | ELASTICSEARCH_HOST (http://127.0.0.1:9200) và ELASTIC_HOST (127.0.0.1:9200); không có SCOUT_DRIVER, vì Laravel không có driver Elasticsearch tích hợp: hãy đặt nó cho gói bạn dùng |
| Qdrant | QDRANT_HOST, QDRANT_PORT, QDRANT_URL |
| RustFS | AWS_ACCESS_KEY_ID=rdev, AWS_SECRET_ACCESS_KEY=rdev-secret, AWS_DEFAULT_REGION, AWS_BUCKET, AWS_ENDPOINT, AWS_URL, AWS_USE_PATH_STYLE_ENDPOINT=true |
Các giá trị đã có trong .env cho những khóa này sẽ bị thay thế; các dòng khác được giữ nguyên.
Mở cơ sở dữ liệu trong ứng dụng desktop
Bạn có thể xem và chỉnh sửa cơ sở dữ liệu bằng bất kỳ ứng dụng cơ sở dữ liệu nào trên laptop, ví dụ TablePlus, TablePro, DBeaver, DataGrip, Beekeeper Studio, DBX, pgAdmin, MySQL Workbench, MongoDB Compass, Redis Insight. Các dịch vụ chỉ lắng nghe bên trong môi trường của bạn, nên hãy chọn tùy chọn SSH (đường hầm SSH) của ứng dụng: máy chủ SSH là địa chỉ Tailscale của server (HostName trong mục rdev của ~/.ssh/config), người dùng dev, cổng 22 và khóa SSH mà laptop dùng để đăng nhập. Sau đó kết nối tới cơ sở dữ liệu tại 127.0.0.1 với cổng và thông tin đăng nhập trong bảng trên. Việc này cần laptop đã kết nối; dữ liệu đi qua tailnet của bạn và không bao giờ qua rdev.cloud.
Không có ứng dụng, hoặc đang dùng điện thoại hay máy tính bảng? https://rdev-adminer.dev.test mở Adminer trong trình duyệt (xem phần Adminer ở trên).
Cài đặt mặc định
Mỗi dịch vụ chỉ lắng nghe trên 127.0.0.1 bên trong môi trường của bạn, nên không gì bên ngoài truy cập được, và chúng đều được thiết lập sẵn cho phát triển:
| Dịch vụ | Thông tin đăng nhập | Cần biết |
|---|---|---|
| MySQL, MariaDB | Người dùng root, không mật khẩu |
Mỗi dự án nhận một cơ sở dữ liệu mang tên của nó (my-shop thành my_shop). |
| PostgreSQL | Người dùng postgres, không mật khẩu (xác thực trust) |
Không có Unix socket: hãy kết nối tới 127.0.0.1. Mỗi dự án một cơ sở dữ liệu, như trên. |
| MongoDB | Không xác thực | Một cơ sở dữ liệu xuất hiện khi mã của bạn ghi vào lần đầu. |
| Redis | Không mật khẩu | Chỉ lưu trong bộ nhớ: khởi động lại dịch vụ sẽ làm trống bộ nhớ đệm, hàng đợi và phiên. |
| Meilisearch | Không có master key | Chế độ phát triển, tắt phân tích. |
| Typesense | API key rdev-typesense |
CORS đã bật, nên một trang trên laptop của bạn có thể truy vấn trực tiếp. |
| Elasticsearch | Không người dùng hay mật khẩu (tắt bảo mật) | Một node duy nhất với 512 MB bộ nhớ; không bao gồm học máy. |
| Qdrant | Không có API key | gRPC ở cổng ngay sau cổng HTTP (6334); tắt telemetry. |
| RustFS | Access key rdev, secret key rdev-secret |
Mỗi dự án một bucket; bảng điều khiển web ở cổng kế tiếp (9001). |
Trong bảng điều khiển, Cấu hình trong menu ⋯ của một dịch vụ hiển thị cùng nội dung này cho phiên bản và cổng mà máy chủ của bạn chạy, kèm các dòng .env cho dự án đầu tiên của nó, sẵn sàng để sao chép. Để đổi một tùy chọn, hãy dùng rdev service set (xem bên dưới; MySQL, MariaDB, PostgreSQL và Redis), ví dụ rdev service set redis appendonly yes để giữ dữ liệu Redis sau khi khởi động lại.
Chọn phiên bản
Thêm @ cùng một phiên bản hoặc dòng phát hành vào dịch vụ:
rdev project service shop [email protected]
Lệnh đó cài MySQL 8.0 mới nhất và chuyển sang nó. Nếu không có phiên bản, bạn nhận phiên bản đã cài, hoặc phiên bản mới nhất. Để xem mọi phiên bản bạn có thể cài:
rdev service available
Mỗi dịch vụ chỉ chạy một phiên bản tại một thời điểm:
- MySQL và MariaDB giữ dữ liệu riêng cho từng dòng phát hành (8.0, 8.4, 9.7…). Chuyển sang dòng mới hơn sẽ bắt đầu từ một bản sao dữ liệu của dòng cũ, mà máy chủ mới hơn nâng cấp; dữ liệu của dòng cũ vẫn giữ nguyên, nên bạn có thể quay lại. Chuyển sang dòng cũ hơn bắt đầu với dữ liệu trống, vì máy chủ cũ hơn không đọc được dữ liệu mới hơn.
- PostgreSQL và MongoDB giữ dữ liệu riêng cho từng phiên bản chính (PostgreSQL 14, 15…; MongoDB 7, 8, 9). Một phiên bản chính mới bắt đầu trống; hãy chuyển dữ liệu của bạn sang bằng
pg_dumphoặcmongodump. - Meilisearch và Typesense dựng lại chỉ mục từ ứng dụng của bạn (
php artisan scout:import) sau khi đổi phiên bản.
MySQL dùng cổng 3306 và MariaDB 3307, nên cả hai có thể được cài và chạy cùng lúc; các dự án nhận đúng cổng trong .env của chúng. MariaDB từng dùng 3306 trước rdev 0.2.0-beta.37; sau bản cập nhật đó, hãy đặt DB_PORT=3307 trong .env của dự án dùng nó, hoặc giữ cổng cũ bằng rdev service set-port mariadb 3306. Việc chọn phiên bản cần rdev 0.2.0-beta.18 trở lên.
Phần mở rộng PostgreSQL
Các bản build -full của PostgreSQL bao gồm pgvector (tìm kiếm vector cho các tính năng AI), PostGIS và pgRouting (bản đồ và tuyến đường) và, từ phiên bản 16, TimescaleDB (chuỗi thời gian). Hãy chọn một bản theo phiên bản đầy đủ của nó, như rdev service available liệt kê:
rdev project service shop [email protected]
Sau đó bật phần mở rộng trong cơ sở dữ liệu của bạn, ví dụ trong một migration:
CREATE EXTENSION IF NOT EXISTS vector;
Tương tự với postgis, pgrouting và timescaledb. rdev tự động nạp trước TimescaleDB khi bản build có nó.
Quản lý dịch vụ
Thẻ Dịch vụ trên trang máy chủ của bạn liệt kê mọi dịch vụ đã cài cùng phiên bản, trạng thái chạy, cổng và các dự án bạn đã cấp từ bảng điều khiển. Menu ⋯ trên một hàng khởi động, dừng hoặc khởi động lại nó, cài đặt lại cùng phiên bản (dữ liệu được giữ), hoặc gỡ cài đặt nó, giữ dữ liệu cho lần cài đặt sau hoặc xóa luôn cả dữ liệu. Một hàng có thiết lập thất bại sẽ hiển thị lý do trong cùng menu và có thể thử lại hoặc xóa khỏi danh sách. Máy chủ thực hiện từng hành động trong vài giây và bảng theo sau; điều này cần rdev 0.2.0-beta.24 trở lên trên máy chủ.
Trên chính máy chủ:
| Lệnh | Chức năng |
|---|---|
rdev service available |
Liệt kê các phiên bản bạn có thể cài |
rdev service start mysql / stop / restart |
Khởi động, dừng hoặc khởi động lại một dịch vụ |
rdev service logs mysql |
Hiển thị các dòng cuối của log |
rdev service set-port mysql 3307 |
Chuyển nó sang cổng khác (ở lần khởi động lại tiếp theo) |
rdev service set mysql max_connections 300 |
Đặt một tùy chọn cấu hình (ở lần khởi động lại tiếp theo; MySQL, MariaDB, PostgreSQL và Redis) |
rdev service change-version mysql 9.7.4 |
Chuyển sang phiên bản khác |
rdev service uninstall mysql 9.7.4 |
Xóa một phiên bản; thêm --purge để xóa luôn dữ liệu |
Các dịch vụ khởi động cùng môi trường của bạn. Xóa một dự án không bao giờ xóa cơ sở dữ liệu của nó; hãy tự xóa nó khi không cần nữa.
Nhóm và sao lưu
Ở gói Team, mọi môi trường thành viên truy cập các dịch vụ của chủ sở hữu bằng tên rdev-team, bên cạnh các dịch vụ riêng của chính họ (Nhóm).
Sao lưu dữ liệu hằng đêm ở Pro và Team bao gồm mọi cơ sở dữ liệu MySQL, MariaDB, PostgreSQL và MongoDB cùng thư mục ~/Code của bạn, và khôi phục chúng từ bảng điều khiển (Sao lưu). MySQL và MariaDB được sao lưu riêng theo cổng của mỗi cái; MongoDB là một kho lưu trữ duy nhất của mọi cơ sở dữ liệu của nó. Các chỉ mục tìm kiếm và bucket RustFS được dựng lại từ ứng dụng và các bản sao riêng của bạn.
Một dịch vụ không có trong danh sách
Bạn không cần chờ chúng tôi để chạy một thứ khác:
-
Một dịch vụ viết bằng Node.js, Python, Ruby hoặc Go chạy như một dự án. rdev cài runtime của nó, khởi động lệnh, cấp cho nó một cổng và khởi động lại nếu nó dừng:
rdev project add realtime --lang node --command "npx soketi start --port={port}" -
Phần mềm khác được đặt vào thư mục home của bạn, ví dụ một binary tải về trong
~/.local/bin, và khởi động từ lệnh của một dự án theo cách tương tự. Thư mục home của bạn là phần của môi trường màrdev host updategiữ lại; mọi thứ cài ở nơi khác bằngsudo aptsẽ mất sau lần cập nhật môi trường tiếp theo. -
Muốn nó được hỗ trợ như các dịch vụ ở trên, với phiên bản, bảng điều khiển, cài đặt
.envvà sao lưu? Hãy viết cho chúng tôi về dịch vụ và việc bạn dùng nó để làm gì. Chúng tôi thêm các dịch vụ mà nhiều khách hàng cần, và cho bạn biết tiến độ.
AI agent của bạn có thể thiết lập hai cách đầu tiên cho bạn; hãy nhờ nó "chạy Elasticsearch cho dự án shop".