Kendi sunucunuza kurun, kendi takviminizle güncelleyin.
Remyral’ın yönetim tarafı — konsol, API, veritabanı, kuyruk ve yedekler — tek bir Linux sunucuda çalışır. Ajanlar orada çalışmaz; sunucuya dışa doğru bağlanan kendi makinelerinizde çalışır.
Sistem gereksinimleri
| En az | Önerilen | |
|---|---|---|
| Sistem | Linux, x86_64 ya da aarch64 (Ubuntu 22.04+, Debian 12+, RHEL / Rocky / Alma 9+) | Ubuntu 24.04 LTS |
| İşlemci / bellek | 2 çekirdek, 4 GB | 4 çekirdek, 8 GB |
| Disk | 10 GB boş | 20 GB ve üzeri (yedekler veritabanıyla büyür) |
| Yazılım | Docker ≥ 24 ve compose eklentisi ≥ 2.24, OpenSSL ≥ 3, curl | — |
| Ağ | Konsol için bir alan adı; 80 ve 443 portları ya da kendi proxy’nizin arkasında bir HTTPS portu | Sürüm adresine ve imaj kaydına giden HTTPS |
Windows ve macOS yönetim sunucusu olarak desteklenmez (Docker Desktop dahil). İkisi de worker makinesi olarak tam desteklenir.
Kurulum
- 01
Alan adını yönlendirin
Konsol için seçtiğiniz alan adını (ör. ops.example.com) sunucuya yönlendirin.
- 02
Betiği indirip kontrol edin
Kurulum betiğini sürüm adresinden indirin; sürüm duyurusundaki anahtar kimliğini betikteki güvenilen anahtarla karşılaştırın.
- 03
Bir TLS biçimi seçip çalıştırın
Betiği root olarak, üç TLS biçiminden biriyle çalıştırın (aşağıda).
- 04
Sahip hesabını oluşturun
Betik sonunda tek kullanımlık bir kurulum anahtarı gösterir. /setup adresinde anahtarı girip sahip hesabını oluşturun; ilk girişte authenticator uygulamanızı bağlar ve 10 kurtarma kodu alırsınız.
- 05
Kurulum sihirbazını tamamlayın
Organizasyon adı, güvenlik ayarı, ilk makine, git bağlantısı, isteğe bağlı entegrasyonlar, ilk proje ve örnek bir iş. Her adım atlanabilir, sonra ana sayfadan devam edilir.
# betiği indirin ve güvenilen anahtarı kontrol edin
$ curl -fsSLO https://<release-url>/<version>/install.sh
$ grep -n "TRUSTED_KEYS=" install.sh
# A) Let’s Encrypt
$ sudo bash install.sh --domain ops.example.com \
--tls letsencrypt --email [email protected]
# B) Cloudflare
$ sudo bash install.sh --domain ops.example.com \
--tls cloudflare [--tls-cert origin.pem --tls-key origin.key]
# C) kendi ters proxy’niz
$ sudo bash install.sh --domain ops.example.com \
--tls proxy --https-port 8443 --http-port 8080 \
--bind 10.0.0.5 --trusted-proxy 10.0.0.2/32Üç TLS biçimi
- Let’s Encrypt
- Sunucu 80/443’te kendisi yanıt verir, sertifikayı Let’s Encrypt verir.
- Cloudflare
- Alan adı Cloudflare üzerinden; SSL “Full”, origin sertifikasıyla “Full (strict)”.
- Kendi proxy’niz
- TLS’i kendi ters proxy’niz bitirir; port, bağlanılacak adres ve güvenilen proxy belirtilir.
Betik ne yapar?
- Gereksinimleri kontrol eder.
- Sürümü indirir; imzasını ve her dosyasını doğrular. Doğrulama tutmazsa hiçbir şeye dokunmadan durur.
- Veri klasörünü kurar; parolaları ve anahtar dosyalarını bir kez üretir, ekrana asla yazmaz.
- Proxy ayarını yazar, imajları özetleriyle (digest) çeker, veritabanını taşır ve sistemi başlatır.
- Sağlık kontrolünü bekler ve tek kullanımlık kurulum anahtarını bir kez gösterir.
Sık kullanılan seçenekler
--dry-run- Her adımı kontrol eder ve gösterir, hiçbir şeyi değiştirmez.
--version- Belirli bir sürümü kurar (varsayılan: en yenisi).
--registry- Kendi imaj aynanızı kullanır; özetler korunur.
--bundle- Bir sürüm klasörünün çevrimdışı kopyasından kurar.
--backup-recipient- age açık anahtarınız: yedekler anahtar dosyalarını da şifreli taşır.
--data-dir- Veri klasörünün yeri.
Betiği yeniden çalıştırmak güvenlidir: ilk çalıştırmanın parolalarını ve seçimlerini korur. TLS biçimini ya da portları değiştirmek için yeni seçeneklerle yeniden çalıştırmanız yeterlidir.
Makineleri bağlama
Worker’lar Linux (x64, arm64 / Raspberry Pi 64-bit), macOS (Apple silicon ve Intel) ve Windows x64 üzerinde çalışır; Docker worker da desteklenir.
Panelde “Makine ekle”
Makineler → Makine ekle → işletim sistemini seçin.
İki satırı çalıştırın
İlk satır kurulum betiğini indirir; SHA-256 özeti paneldekiyle aynı değilse durur. İkinci satır kiti indirir, imzalı indeksle karşılaştırır ve servisi kurar.
Eşleştirin
Makinede görünen eşleştirme kodunu ve parmak izini panelde karşılaştırın, kodu girip doğrulama koduyla onaylayın.
Panelden yapılandırın
Projeler, runtime’lar, paralel iş sayısı ve sandbox profilleri panelden ayarlanır; makineye tekrar gitmeniz gerekmez.
- Makinede uygun Node.js sürümü yoksa, sabitlenmiş sürüm özet ve imza kontrolüyle yalnızca worker için ayrı bir klasöre kurulur; sistemdeki Node ve PATH’e dokunulmaz.
- İnternetten indirme istemiyorsanız kurulum paketini panelden indirip makineye kopyalayabilirsiniz.
- Paneldeki komutlarda gizli bilgi ya da token bulunmaz; onay verilmeden hiçbir makineye güvenilmez.
Güncelleme
Yeni imzalı bir sürüm çıktığında sahipler konsolda “Güncelleme mevcut” bandını görür: sürüm notları, uyumsuz değişiklikler ve komut. Güncelleme her zaman sunucuda, sizin başlattığınız bir komutla yapılır.
doğrula
çek
master’ı durdur
yedek al
taşı
başlat
sağlık kontrolü
Önce kontrol. Yeni sürüm olup olmadığını sorgulayabilir, adımları kuru çalıştırmayla (dry-run) önceden görebilirsiniz.
Zorunlu yedek. Güncelleme öncesi yedek alınamazsa hiçbir şey değişmez ve sistem eski haliyle yeniden başlar.
Uyumsuz değişikliklerde onay. Uyumsuz değişiklik içeren bir sürüm açıkça onay ister.
Geri dönüş. Sağlık kontrolü geçmezse ve veritabanı şeması değişmediyse eski sürüm kendiliğinden geri gelir. Şema ilerlediyse komut, güncelleme öncesi yedeği geri yükleyen geri dönüş komutunu yazar.
Makineler kendini günceller. Sürüm notları gereken en düşük worker sürümünü belirtir; worker sürümleri imzalıdır ve kademeli yayılır.
Yedek, tanılama ve kaldırma
Gece yedeği
Yedek servisi her gece veritabanını yedekler ve geri yükleme provası yapar; durum Ayarlar → Yedekler’de. İsterseniz elle de yedek alınır.
Anahtarları sunucu dışında saklayın
Ayar dosyasını ve anahtar klasörünü bir parola yöneticisinde tutun; authenticator anahtarı olmadan herkes uygulamasını yeniden bağlamak zorunda kalır.
Tanılama
Ayarlar → Tanılama, kontrol düzlemini ve bağlı makineleri tek tıkla denetler; bulgular öneri ve ilgili sayfanın bağlantısıyla gelir. Aynı kontroller sunucudan da çalıştırılabilir.
Destek raporu
Sorunu anlatın, bölümleri seçin, zip’in içindeki her dosyayı önizleyin; indirin ya da e-postayla gönderin. Parolalar, token’lar ve anahtarlar rapora girmez.
Portlar
Sunucuda dışarıya yalnızca ters proxy’nin portları (80/443 ya da sizin seçtikleriniz) açılır.
Kaldırma
Kaldırma kapsayıcıları siler, veri klasörünü bırakır. Veritabanını, yedekleri ve anahtarları da silmek ayrı ve geri alınamaz bir seçenektir.
Kurulumu pilotla birlikte yapalım.
Dört haftalık pilotun ilk haftası kurulumdur: kontrol düzlemi ve 2–3 worker makinesi.