Ketik setidaknya dua huruf untuk mencari di setiap halaman dokumentasi.

↑ ↓ untuk bernavigasi ↵ untuk membuka esc untuk menutup

Menggunakan rdev

Layanan

Basis data, cache, pencarian, dan penyimpanan berkas berjalan di dalam lingkungan Anda, di samping situs Anda. rdev memasang setiap layanan saat pertama kali dibutuhkan proyek, dalam versi pilihan Anda, menjaganya tetap berjalan, dan menulis pengaturan koneksi ke .env proyek.

Apa yang tersedia

Layanan Kegunaan Versi Port default
MySQL Basis data relasional 8.0, 8.4, 9.7 3306
MariaDB Basis data relasional 10.11, 11.4, 11.8, 12.3 3307
PostgreSQL Basis data relasional; build -full menambahkan pgvector, PostGIS, pgRouting, dan (mulai 16) TimescaleDB 14, 15, 16, 17, 18 5432
MongoDB Basis data dokumen 7.0, 8.0, 9.0 27017
Redis Cache, antrean, dan sesi 9.1 6379
Meilisearch Pencarian teks lengkap, untuk Laravel Scout 1 7700
Typesense Pencarian teks lengkap, untuk Laravel Scout 29, 30 8108
RustFS Penyimpanan berkas kompatibel S3, dengan konsol web di port berikutnya 1 9000
Elasticsearch Pencarian dan analitik, untuk driver Scout dan klien Elastic (berjalan tanpa machine learning) 8.19, 9 9200
Qdrant Pencarian vektor untuk fitur AI seperti pencarian semantik 1 6333
Penangkap email Menangkap email keluar agar tidak ada yang sampai ke kotak masuk sungguhan; SMTP 127.0.0.1:2525, buka di browser pada https://rdev-mail.dev.test bawaan
Server dump Mengumpulkan dump debug dari kode Anda; 127.0.0.1:2304, buka di browser pada https://rdev-dumps.dev.test bawaan

Redis menggunakan protokol Redis standar: driver redis Laravel dan phpredis berfungsi tanpa perubahan. Setiap layanan hanya mendengarkan di dalam lingkungan Anda, di 127.0.0.1; jangkau konsol web seperti milik RustFS melalui koneksi laptop Anda.

Email dan dump yang tertangkap di browser Anda

Buka https://rdev-mail.dev.test di browser mana pun di tailnet Anda untuk membaca email yang dikirim aplikasi Anda. Anda melihat daftar (terbaru lebih dulu), header setiap pesan, versi teks biasa dan HTML-nya, serta lampirannya. Anda dapat menghapus satu pesan atau semuanya, dan email baru muncul dengan sendirinya. Email HTML ditampilkan dengan skrip dan gambar jarak jauh diblokir.

https://rdev-dumps.dev.test menampilkan panggilan dump() dan peristiwa tertangkap lainnya, terbaru lebih dulu, beserta file dan baris asalnya. Kosongkan daftar dengan Clear.

Kedua halaman berjalan di server Anda dan hanya dapat dijangkau melalui tailnet Anda, seperti proyek Anda. Data tidak pernah meninggalkan server Anda, dan pratinjau tidak akan pernah bisa membukanya untuk publik. rdev mail list mencetak kedua alamat, dan aplikasi laptop membukanya dari Mail dan Dumps di tab Sites. Nama rdev-mail dan rdev-dumps dicadangkan, jadi proyek tidak dapat menggunakannya.

Basis data di browser Anda

https://rdev-adminer.dev.test membuka Adminer, pengelola basis data, di server Anda. Pilih MySQL atau PostgreSQL, server 127.0.0.1, pengguna root (MySQL) atau postgres (PostgreSQL), dan kosongkan kata sandi; untuk SQLite, masukkan path file basis datanya. Seperti halaman di atas, ini hanya bisa dibuka lewat tailnet Anda, dan nama rdev-adminer dicadangkan. Tersedia sejak rdev 1.2.0; di server yang dipasang lebih awal, jalankan dulu sudo rdev host update.

Beri proyek sebuah layanan

Di server, sebutkan proyek dan layanannya:

rdev project service shop postgres

rdev memasang dan menjalankan layanan jika belum berjalan, membuat basis data (MySQL, MariaDB, PostgreSQL) atau bucket (RustFS) dengan nama sesuai proyek, dan menulis pengaturan koneksi ke .env proyek. Proyek tanpa .env mendapat pengaturan yang dicetak sebagai gantinya. MongoDB membuat basis data saat pertama kali kode Anda menulis ke dalamnya; untuk proyek PHP, rdev juga memasang ekstensi PHP mongodb untuk versi PHP yang digunakan situs (lihat Ekstensi PHP).

Saat proyek Laravel mendapat basis data MySQL, MariaDB, atau PostgreSQL baru, rdev juga menjalankan php artisan migrate --force, sehingga tabel tempat aplikasi baru menyimpan sesi, cache, dan antreannya tersedia dan situs tetap berfungsi. Ini hanya dilakukan untuk basis data yang baru dibuat, yang masih kosong; basis data yang sudah ada dibiarkan apa adanya. Jika migrasi gagal, layanan tetap di tempatnya dan pesan memberi tahu alasannya, sehingga Anda dapat menjalankan php artisan migrate sendiri.

Di panel, buka server dari Server di bilah sisi dan pilih Tambah layanan di kartu Layanan-nya, baik di bagian atas maupun di samping proyek (dasbor memiliki tombol yang sama), pilih layanan dan, untuk layanan dengan beberapa versi, Versi. Baris proyek menunjukkan di mana posisi server: memasang dan menjalankan layanan, membuat basis data, menulis .env, menjalankan migrasi. Notifikasi memberi tahu saat siap. Memasang layanan untuk pertama kali bisa memakan waktu beberapa menit. Agen AI Anda dapat melakukan hal yang sama melalui akses MCP-nya; minta "basis data PostgreSQL untuk shop".

Proyek baru bisa mendapat layanannya dalam perintah yang sama:

rdev project add shop --git [email protected]:you/shop.git --service mysql --service redis

Apa yang masuk ke .env

Layanan Pengaturan
MySQL, MariaDB, PostgreSQL DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME (tanpa kata sandi: hanya lingkungan Anda yang dapat menjangkaunya)
MongoDB MONGODB_URI, MONGODB_DATABASE, untuk paket 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) dan ELASTIC_HOST (127.0.0.1:9200); tanpa SCOUT_DRIVER, karena Laravel tidak memiliki driver Elasticsearch bawaan: atur untuk paket yang Anda gunakan
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

Nilai yang sudah ada di .env untuk kunci-kunci ini diganti; baris lain tetap seperti semula.

Membuka database di aplikasi desktop

Anda dapat melihat dan mengedit database dengan aplikasi database apa pun di laptop, misalnya TablePlus, TablePro, DBeaver, DataGrip, Beekeeper Studio, DBX, pgAdmin, MySQL Workbench, MongoDB Compass, Redis Insight. Layanan hanya mendengarkan di dalam lingkungan Anda, jadi pilih opsi SSH (tunnel SSH) di aplikasi: host SSH adalah alamat Tailscale server Anda (HostName pada entri rdev di ~/.ssh/config), pengguna dev, port 22, dan kunci SSH yang dipakai laptop Anda untuk masuk. Lalu sambungkan ke database di 127.0.0.1 dengan port dan kredensial dari tabel di atas. Ini memerlukan laptop yang terhubung; data lewat tailnet Anda dan tidak pernah melewati rdev.cloud.

Tidak ada aplikasi, atau sedang di ponsel atau tablet? https://rdev-adminer.dev.test membuka Adminer di browser Anda (lihat bagian Adminer di atas).

Pengaturan bawaan

Setiap layanan hanya mendengarkan di 127.0.0.1 di dalam lingkungan Anda, sehingga tidak ada yang dari luar dapat menjangkaunya, dan semuanya sudah disiapkan untuk pengembangan:

Layanan Kredensial Perlu diketahui
MySQL, MariaDB Pengguna root, tanpa kata sandi Setiap proyek mendapat basis data dengan namanya sendiri (my-shop menjadi my_shop).
PostgreSQL Pengguna postgres, tanpa kata sandi (autentikasi trust) Tanpa soket Unix: hubungkan ke 127.0.0.1. Satu basis data per proyek, seperti di atas.
MongoDB Tanpa autentikasi Basis data muncul saat kode Anda pertama kali menulis ke dalamnya.
Redis Tanpa kata sandi Hanya disimpan di memori: memulai ulang layanan mengosongkan cache, antrean, dan sesi.
Meilisearch Tanpa master key Mode pengembangan, analitik mati.
Typesense Kunci API rdev-typesense CORS aktif, sehingga halaman di laptop Anda dapat langsung mengkuerinya.
Elasticsearch Tanpa pengguna atau kata sandi (keamanan mati) Satu node dengan memori 512 MB; machine learning tidak disertakan.
Qdrant Tanpa kunci API gRPC di port setelah port HTTP (6334); telemetri mati.
RustFS Access key rdev, secret key rdev-secret Satu bucket per proyek; konsol web ada di port berikutnya (9001).

Di panel, Konfigurasi di menu ⋯ sebuah layanan menampilkan hal yang sama untuk versi dan port yang dijalankan server Anda, beserta baris .env untuk proyek pertamanya, siap disalin. Untuk mengubah opsi, gunakan rdev service set (lihat di bawah; MySQL, MariaDB, PostgreSQL, dan Redis), misalnya rdev service set redis appendonly yes agar data Redis tetap ada setelah dimulai ulang.

Memilih versi

Tambahkan @ dan versi atau jalur rilis ke layanan:

rdev project service shop [email protected]

Ini memasang MySQL 8.0 terbaru dan beralih ke sana. Tanpa versi, Anda mendapat yang sudah terpasang, atau yang terbaru. Untuk melihat setiap versi yang dapat dipasang:

rdev service available

Satu versi dari setiap layanan berjalan dalam satu waktu:

  • MySQL dan MariaDB menyimpan data terpisah untuk setiap jalur rilis (8.0, 8.4, 9.7…). Pindah ke jalur yang lebih baru dimulai dari salinan data jalur yang lebih lama, yang ditingkatkan oleh server yang lebih baru; data jalur yang lebih lama tetap seperti semula, sehingga Anda dapat kembali. Pindah ke jalur yang lebih lama dimulai dengan data kosong, karena server yang lebih lama tidak dapat membaca data yang lebih baru.
  • PostgreSQL dan MongoDB menyimpan data terpisah untuk setiap versi mayor (PostgreSQL 14, 15…; MongoDB 7, 8, 9). Versi mayor baru dimulai kosong; pindahkan data Anda dengan pg_dump atau mongodump.
  • Meilisearch dan Typesense membangun ulang indeksnya dari aplikasi Anda (php artisan scout:import) setelah perubahan versi.

MySQL menggunakan port 3306 dan MariaDB 3307, sehingga keduanya dapat dipasang dan dijalankan bersamaan; proyek mendapat port yang tepat di .env-nya. MariaDB menggunakan 3306 sebelum rdev 0.2.0-beta.37; setelah pembaruan itu, atur DB_PORT=3307 di .env proyek yang menggunakannya, atau pertahankan port lama dengan rdev service set-port mariadb 3306. Memilih versi memerlukan rdev 0.2.0-beta.18 atau yang lebih baru.

Ekstensi PostgreSQL

Build -full PostgreSQL menyertakan pgvector (pencarian vektor untuk fitur AI), PostGIS dan pgRouting (peta dan rute), dan, mulai versi 16, TimescaleDB (deret waktu). Pilih satu berdasarkan versi lengkapnya, seperti yang dicantumkan rdev service available:

rdev project service shop [email protected]

Lalu aktifkan ekstensi di basis data Anda, misalnya dalam migrasi:

CREATE EXTENSION IF NOT EXISTS vector;

Hal yang sama berlaku untuk postgis, pgrouting, dan timescaledb. rdev memuat TimescaleDB lebih dulu secara otomatis saat build menyertakannya.

Mengelola layanan

Kartu Layanan di halaman server Anda mencantumkan setiap layanan yang terpasang beserta versinya, apakah berjalan, portnya, dan proyek yang Anda beri layanan dari panel. Menu ⋯ pada baris memulai, menghentikan, atau memulai ulang layanan, memasang ulang versi yang sama (data dipertahankan), atau menghapus instalasinya, mempertahankan datanya untuk instalasi nanti atau menghapusnya juga. Baris yang penyiapannya gagal menunjukkan alasannya di menu yang sama dan dapat dicoba lagi atau dihapus dari daftar. Server menjalankan setiap tindakan dalam hitungan detik dan tabel mengikuti; ini memerlukan rdev 0.2.0-beta.24 atau yang lebih baru di server.

Di server itu sendiri:

Perintah Fungsinya
rdev service available Mencantumkan versi yang dapat dipasang
rdev service start mysql / stop / restart Memulai, menghentikan, atau memulai ulang layanan
rdev service logs mysql Menampilkan baris terakhir lognya
rdev service set-port mysql 3307 Memindahkannya ke port lain (pada restart berikutnya)
rdev service set mysql max_connections 300 Mengatur opsi konfigurasi (pada restart berikutnya; MySQL, MariaDB, PostgreSQL, dan Redis)
rdev service change-version mysql 9.7.4 Beralih ke versi lain
rdev service uninstall mysql 9.7.4 Menghapus satu versi; tambahkan --purge untuk menghapus datanya juga

Layanan dimulai bersama lingkungan Anda. Menghapus proyek tidak pernah menghapus basis datanya; hapus sendiri saat tidak lagi dibutuhkan.

Tim dan cadangan

Pada paket Team, setiap lingkungan anggota menjangkau layanan pemilik pada nama rdev-team, di samping layanan privatnya sendiri (Tim).

Cadangan data malam hari pada Pro dan Team mencakup setiap basis data MySQL, MariaDB, PostgreSQL, dan MongoDB serta folder ~/Code Anda, dan memulihkannya dari panel (Pencadangan). MySQL dan MariaDB masing-masing dicadangkan pada port mereka sendiri; MongoDB sebagai satu arsip dari semua basis datanya. Indeks pencarian dan bucket RustFS dibangun ulang dari aplikasi dan salinan Anda sendiri.

Layanan yang tidak ada dalam daftar

Anda tidak perlu menunggu kami untuk menjalankan hal lain:

  • Layanan yang ditulis dalam Node.js, Python, Ruby, atau Go berjalan sebagai proyek. rdev memasang runtime-nya, menjalankan perintahnya, memberinya port, dan memulai ulang jika berhenti:

    rdev project add realtime --lang node --command "npx soketi start --port={port}"
    
  • Perangkat lunak lain ditempatkan di folder home Anda, misalnya binary yang diunduh di ~/.local/bin, dan dimulai dari perintah proyek dengan cara yang sama. Folder home Anda adalah bagian lingkungan yang dipertahankan oleh rdev host update; apa pun yang dipasang di tempat lain dengan sudo apt hilang setelah pembaruan lingkungan berikutnya.

  • Ingin didukung seperti layanan di atas, dengan versi, panel, pengaturan .env, dan pencadangan? Tulis kepada kami dengan layanan dan kegunaannya bagi Anda. Kami menambahkan layanan yang dibutuhkan beberapa pelanggan, dan memberi tahu Anda sampai di mana prosesnya.

Agen AI Anda dapat menyiapkan dua yang pertama untuk Anda; minta "jalankan Elasticsearch untuk proyek shop".