데이터베이스, 캐시, 검색, 파일 스토리지는 사이트 옆의 환경 안에서 실행됩니다. rdev는 프로젝트에 처음 필요해질 때 원하는 버전으로 각 서비스를 설치하고, 계속 실행 상태로 유지하며, 연결 설정을 프로젝트의 .env에 기록합니다.
사용 가능한 서비스
| 서비스 | 용도 | 버전 | 기본 포트 |
|---|---|---|---|
| MySQL | 관계형 데이터베이스 | 8.0, 8.4, 9.7 | 3306 |
| MariaDB | 관계형 데이터베이스 | 10.11, 11.4, 11.8, 12.3 | 3307 |
| PostgreSQL | 관계형 데이터베이스. -full 빌드에는 pgvector, PostGIS, pgRouting, (16부터) TimescaleDB가 추가됩니다 |
14, 15, 16, 17, 18 | 5432 |
| MongoDB | 문서 데이터베이스 | 7.0, 8.0, 9.0 | 27017 |
| Redis | 캐시, 큐, 세션 | 9.1 | 6379 |
| Meilisearch | Laravel Scout용 전문 검색 | 1 | 7700 |
| Typesense | Laravel Scout용 전문 검색 | 29, 30 | 8108 |
| RustFS | S3 호환 파일 스토리지, 다음 포트에 웹 콘솔 제공 | 1 | 9000 |
| Elasticsearch | Scout 드라이버와 Elastic 클라이언트용 검색 및 분석 (머신 러닝 없이 실행) | 8.19, 9 | 9200 |
| Qdrant | 시맨틱 검색 같은 AI 기능을 위한 벡터 검색 | 1 | 6333 |
| 메일 캡처 | 발신 이메일을 가로채 실제 받은편지함에는 아무것도 도달하지 않게 함; SMTP 127.0.0.1:2525, 브라우저에서는 https://rdev-mail.dev.test |
기본 내장 | |
| 덤프 서버 | 코드의 디버그 덤프를 수집; 127.0.0.1:2304, 브라우저에서는 https://rdev-dumps.dev.test |
기본 내장 |
Redis는 표준 Redis 프로토콜을 사용합니다. Laravel의 redis 드라이버와 phpredis는 그대로 동작합니다. 모든 서비스는 환경 안의 127.0.0.1에서만 수신하며, RustFS 같은 웹 콘솔은 노트북 연결을 통해 접속합니다.
캡처된 메일과 덤프를 브라우저에서 보기
tailnet의 아무 브라우저에서나 https://rdev-mail.dev.test를 열면 앱이 보낸 메일을 읽을 수 있습니다. 목록(최신순), 각 메시지의 헤더, 일반 텍스트 및 HTML 버전, 첨부 파일이 표시됩니다. 메시지를 하나씩 또는 모두 삭제할 수 있고, 새 메일은 자동으로 나타납니다. HTML 메일은 스크립트와 원격 이미지가 차단된 상태로 표시됩니다.
https://rdev-dumps.dev.test에는 dump() 호출과 그 밖의 캡처된 이벤트가 최신순으로, 발생한 파일과 줄과 함께 표시됩니다. Clear로 목록을 비울 수 있습니다.
두 페이지 모두 서버에서 실행되며 프로젝트처럼 tailnet을 통해서만 접근할 수 있습니다. 데이터는 서버를 벗어나지 않고, 미리보기가 이를 공개할 수도 없습니다. rdev mail list는 두 주소를 모두 출력하며, 노트북 앱은 Sites 탭의 Mail과 Dumps에서 이를 엽니다. rdev-mail과 rdev-dumps 이름은 예약되어 있어 프로젝트에서 사용할 수 없습니다.
브라우저에서 데이터베이스 열기
https://rdev-adminer.dev.test는 서버에서 데이터베이스 관리 도구인 Adminer를 엽니다. MySQL 또는 PostgreSQL을 고르고 서버는 127.0.0.1, 사용자는 root(MySQL) 또는 postgres(PostgreSQL)로 하고 비밀번호는 비워 두세요. SQLite는 데이터베이스 파일 경로를 입력합니다. 위의 페이지처럼 tailnet에서만 열 수 있고 rdev-adminer 이름은 예약되어 있습니다. rdev 1.2.0부터 제공되며, 그 전에 설치한 서버에서는 먼저 sudo rdev host update를 실행하세요.
프로젝트에 서비스 추가
서버에서 프로젝트와 서비스 이름을 지정하세요.
rdev project service shop postgres
rdev는 서비스가 아직 실행 중이 아니면 설치하고 시작하며, 프로젝트 이름으로 된 데이터베이스(MySQL, MariaDB, PostgreSQL) 또는 버킷(RustFS)을 만들고, 연결 설정을 프로젝트의 .env에 기록합니다. .env가 없는 프로젝트에는 설정이 대신 출력됩니다. MongoDB는 코드가 처음 쓰기를 할 때 데이터베이스를 만들며, PHP 프로젝트의 경우 rdev가 사이트가 사용하는 PHP 버전용 PHP mongodb 확장도 설치합니다 (PHP 확장 참고).
Laravel 프로젝트가 새 MySQL, MariaDB, PostgreSQL 데이터베이스를 받으면 rdev는 php artisan migrate --force도 실행하므로, 새 앱이 세션, 캐시, 큐를 저장하는 테이블이 생겨 사이트가 계속 동작합니다. 이는 방금 만든 비어 있는 데이터베이스에만 수행되며, 기존 데이터베이스는 그대로 둡니다. 마이그레이션이 실패해도 서비스는 그대로 유지되고 메시지에 이유가 표시되므로 직접 php artisan migrate를 실행할 수 있습니다.
패널에서는 사이드바의 서버에서 서버를 열고 서비스 카드의 서비스 추가를 선택하세요(상단 또는 프로젝트 옆, 대시보드에도 같은 버튼이 있습니다). 서비스를 선택하고, 버전이 여러 개인 서비스는 버전도 선택합니다. 프로젝트 행에는 서버가 지금 어디까지 진행했는지 표시됩니다: 서비스 설치 및 시작, 데이터베이스 생성, .env 작성, 마이그레이션 실행. 준비되면 알림이 표시됩니다. 서비스를 처음 설치할 때는 몇 분 걸릴 수 있습니다. AI 에이전트도 MCP 접근을 통해 같은 작업을 할 수 있으며, "shop용 PostgreSQL 데이터베이스"처럼 요청하면 됩니다.
새 프로젝트는 같은 명령어에서 서비스도 함께 받을 수 있습니다.
rdev project add shop --git [email protected]:you/shop.git --service mysql --service redis
.env에 기록되는 내용
| 서비스 | 설정 |
|---|---|
| MySQL, MariaDB, PostgreSQL | DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME (비밀번호 없음: 사용자의 환경에서만 접근 가능) |
| MongoDB | mongodb/laravel-mongodb 패키지용 MONGODB_URI, MONGODB_DATABASE |
| 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)와 ELASTIC_HOST (127.0.0.1:9200). Laravel에는 기본 Elasticsearch 드라이버가 없으므로 SCOUT_DRIVER는 설정되지 않으며, 사용하는 패키지에 맞게 직접 설정하세요 |
| 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 |
.env에 이미 있는 이 키들의 값은 교체되며, 다른 줄은 그대로 유지됩니다.
데스크톱 앱에서 데이터베이스 열기
노트북의 어떤 데이터베이스 앱으로든 데이터베이스를 보고 편집할 수 있습니다. 예: TablePlus, TablePro, DBeaver, DataGrip, Beekeeper Studio, DBX, pgAdmin, MySQL Workbench, MongoDB Compass, Redis Insight. 서비스는 환경 내부에서만 수신하므로 앱의 SSH(SSH 터널) 옵션을 선택하세요. SSH 호스트는 서버의 Tailscale 주소(~/.ssh/config의 rdev 항목에 있는 HostName), 사용자는 dev, 포트는 22, 키는 노트북이 로그인할 때 쓰는 SSH 키입니다. 그런 다음 위 표의 포트와 자격 증명으로 127.0.0.1의 데이터베이스에 연결합니다. 노트북 연결이 필요하며, 데이터는 tailnet을 통해 오가고 rdev.cloud를 거치지 않습니다.
앱이 없거나 휴대폰이나 태블릿이라면 https://rdev-adminer.dev.test가 브라우저에서 Adminer를 엽니다(위의 Adminer 섹션 참고).
기본 설정
모든 서비스는 환경 내부의 127.0.0.1에서만 수신하므로 외부에서는 접근할 수 없으며, 개발용으로 설정되어 있습니다.
| 서비스 | 자격 증명 | 알아 둘 점 |
|---|---|---|
| MySQL, MariaDB | 사용자 root, 비밀번호 없음 |
각 프로젝트는 자신의 이름으로 된 데이터베이스를 받습니다(my-shop은 my_shop이 됩니다). |
| PostgreSQL | 사용자 postgres, 비밀번호 없음(trust 인증) |
Unix 소켓 없음: 127.0.0.1로 연결하세요. 위와 같이 프로젝트마다 데이터베이스 하나. |
| MongoDB | 인증 없음 | 데이터베이스는 코드가 처음 쓸 때 만들어집니다. |
| Redis | 비밀번호 없음 | 메모리에만 저장: 서비스를 다시 시작하면 캐시, 큐, 세션이 비워집니다. |
| Meilisearch | 마스터 키 없음 | 개발 모드, 분석 꺼짐. |
| Typesense | API 키 rdev-typesense |
CORS가 켜져 있어 노트북의 페이지에서 직접 조회할 수 있습니다. |
| Elasticsearch | 사용자와 비밀번호 없음(보안 꺼짐) | 메모리 512MB의 단일 노드이며 머신러닝은 포함되지 않습니다. |
| Qdrant | API 키 없음 | gRPC는 HTTP 포트 다음 포트(6334), 원격 측정 꺼짐. |
| RustFS | 액세스 키 rdev, 시크릿 키 rdev-secret |
프로젝트마다 버킷 하나. 웹 콘솔은 다음 포트(9001)에 있습니다. |
패널에서 서비스의 ⋯ 메뉴에 있는 구성은 서버가 실행 중인 버전과 포트에 대해 같은 내용을 보여 주며, 첫 번째 프로젝트의 .env 줄도 바로 복사할 수 있게 함께 표시합니다. 옵션을 바꾸려면 rdev service set을 사용하세요(아래 참고, MySQL, MariaDB, PostgreSQL, Redis 해당). 예를 들어 rdev service set redis appendonly yes로 다시 시작해도 Redis 데이터를 유지할 수 있습니다.
버전 선택
서비스 이름 뒤에 @와 버전 또는 릴리스 라인을 추가하세요.
rdev project service shop [email protected]
그러면 최신 MySQL 8.0을 설치하고 전환합니다. 버전을 지정하지 않으면 이미 설치된 버전, 또는 최신 버전이 사용됩니다. 설치할 수 있는 모든 버전을 보려면 다음을 실행하세요.
rdev service available
각 서비스는 한 번에 한 버전만 실행됩니다.
- MySQL과 MariaDB는 릴리스 라인(8.0, 8.4, 9.7…)마다 별도의 데이터를 유지합니다. 더 새로운 라인으로 옮기면 이전 라인 데이터의 사본에서 시작하며, 새 서버가 이를 업그레이드합니다. 이전 라인의 데이터는 그대로 남으므로 되돌릴 수 있습니다. 더 오래된 라인으로 옮기면 오래된 서버가 새 데이터를 읽을 수 없으므로 빈 데이터로 시작합니다.
- PostgreSQL과 MongoDB는 메이저 버전(PostgreSQL 14, 15…, MongoDB 7, 8, 9)마다 별도의 데이터를 유지합니다. 새 메이저 버전은 비어 있는 상태로 시작하며,
pg_dump나mongodump로 데이터를 옮기세요. - Meilisearch와 Typesense는 버전 변경 후 앱에서(
php artisan scout:import) 인덱스를 다시 만듭니다.
MySQL은 포트 3306, MariaDB는 3307을 사용하므로 둘을 동시에 설치하고 실행할 수 있으며, 프로젝트의 .env에는 올바른 포트가 기록됩니다. MariaDB는 rdev 0.2.0-beta.37 이전에는 3306을 사용했습니다. 해당 업데이트 이후에는 MariaDB를 사용하는 프로젝트의 .env에 DB_PORT=3307을 설정하거나, rdev service set-port mariadb 3306으로 이전 포트를 유지하세요. 버전 선택에는 rdev 0.2.0-beta.18 이상이 필요합니다.
PostgreSQL 확장
PostgreSQL의 -full 빌드에는 pgvector(AI 기능용 벡터 검색), PostGIS와 pgRouting(지도와 경로), 그리고 16 버전부터 TimescaleDB(시계열)가 포함됩니다. rdev service available에 표시된 전체 버전으로 선택하세요.
rdev project service shop [email protected]
그런 다음 마이그레이션 등에서 데이터베이스의 확장을 켜세요.
CREATE EXTENSION IF NOT EXISTS vector;
postgis, pgrouting, timescaledb도 마찬가지입니다. 빌드에 TimescaleDB가 포함되어 있으면 rdev가 자동으로 미리 로드합니다.
서비스 관리
서버 페이지의 서비스 카드에는 설치된 모든 서비스가 버전, 실행 여부, 포트, 패널에서 지정한 프로젝트와 함께 표시됩니다. 행의 ⋯ 메뉴에서 서비스를 시작, 중지, 재시작하거나, 같은 버전을 재설치(데이터 유지)하거나, 제거할 수 있으며, 제거할 때는 나중에 설치할 때를 위해 데이터를 유지하거나 데이터도 함께 삭제할 수 있습니다. 설정에 실패한 행은 같은 메뉴에 이유가 표시되며 다시 시도하거나 목록에서 제거할 수 있습니다. 서버는 각 작업을 몇 초 안에 수행하고 표가 따라 갱신됩니다. 이 기능에는 서버에서 rdev 0.2.0-beta.24 이상이 필요합니다.
서버에서는 다음을 사용합니다.
| 명령어 | 기능 |
|---|---|
rdev service available |
설치 가능한 버전을 나열합니다 |
rdev service start mysql / stop / restart |
서비스를 시작, 중지, 재시작합니다 |
rdev service logs mysql |
로그의 마지막 줄을 표시합니다 |
rdev service set-port mysql 3307 |
다른 포트로 옮깁니다 (다음 재시작 시) |
rdev service set mysql max_connections 300 |
구성 옵션을 설정합니다 (다음 재시작 시, MySQL, MariaDB, PostgreSQL, Redis) |
rdev service change-version mysql 9.7.4 |
다른 버전으로 전환합니다 |
rdev service uninstall mysql 9.7.4 |
버전을 제거합니다. 데이터도 삭제하려면 --purge를 추가하세요 |
서비스는 환경과 함께 시작됩니다. 프로젝트를 제거해도 데이터베이스는 제거되지 않으므로, 더 이상 필요 없으면 직접 삭제하세요.
팀과 백업
Team 요금제에서는 모든 멤버 환경이 자신의 비공개 서비스와 함께 소유자의 서비스에 rdev-team이라는 이름으로 접근합니다 (팀).
Pro와 Team의 야간 데이터 백업에는 모든 MySQL, MariaDB, PostgreSQL, MongoDB 데이터베이스와 ~/Code 폴더가 포함되며, 패널에서 복원할 수 있습니다 (백업). MySQL과 MariaDB는 각자의 포트에서 따로 백업되고, MongoDB는 모든 데이터베이스를 하나의 아카이브로 백업합니다. 검색 인덱스와 RustFS 버킷은 앱과 사용자가 가진 사본에서 다시 만듭니다.
목록에 없는 서비스
다른 것을 실행하기 위해 저희를 기다릴 필요는 없습니다.
-
Node.js, Python, Ruby, Go로 작성된 서비스는 프로젝트로 실행됩니다. rdev가 런타임을 설치하고, 명령어를 시작하고, 포트를 할당하고, 중지되면 다시 시작합니다.
rdev project add realtime --lang node --command "npx soketi start --port={port}" -
기타 소프트웨어는 홈 폴더에 넣습니다. 예를 들어
~/.local/bin에 다운로드한 바이너리를 두고 같은 방식으로 프로젝트의 명령어에서 시작합니다. 홈 폴더는rdev host update가 유지하는 환경의 일부이며,sudo apt로 다른 곳에 설치한 것은 다음 환경 업데이트 후 사라집니다. -
위의 서비스처럼 버전, 패널,
.env설정, 백업까지 지원되기를 원한다면 서비스 이름과 용도를 문의해 주세요. 여러 고객에게 필요한 서비스를 추가하며, 진행 상황도 알려드립니다.
AI 에이전트가 처음 두 가지를 설정해 줄 수 있으며, "shop 프로젝트용 Elasticsearch를 실행해 줘"라고 요청하면 됩니다.