Hızlı Başlangıç

Bu kılavuz, sıfırdan bir Linux sunucusuna kendi barındırdığınız rtCloud örneğini dağıtma sürecinde size yol gösterir. Sonunda tarayıcınızdan erişilebilen çalışan bir rtCloud’a sahip olacaksınız.

Ön Koşullar link

Başlamadan önce sunucunuzun aşağıdaki gereksinimleri karşıladığından emin olun:

Donanım link

Yazılım link

Ubuntu’ya Docker Kurulumu:

  curl -fsSL https://get.docker.com | sh
  

Kurulumu doğrulayın:

  docker --version
docker compose version
  

Adım 1 — Dosyaları Edinin link

Dağıtım deposunu sunucunuza klonlayın:

  git clone ssh://git@rtgit.rta.vn:2224/rtlab/rtwebteam/rta-smart-survey-docker.git rtcloud
cd rtcloud
  

Adım 2 — Ortamı Yapılandırın link

Örnek yapılandırma dosyasını kopyalayın:

  cp .env.production.sample .env
  

.env dosyasını bir metin düzenleyicide açın ve gerekli değerleri doldurun:

  # Bu dağıtım için benzersiz tanımlayıcı (boşluk yok, özel karakter yok)
PROJECT_ID=myproject

# Kullanıcıların uygulamaya erişeceği alan adı veya IP adresi
# Örnek: rtcloud.example.com  veya  192.168.1.100
PROJECT_URL=rtcloud.example.com

# Protokol: SSL'li bir alan adınız varsa "https", aksi takdirde "http" kullanın
HTTP_PROTOCOL=https

# Güçlü, benzersiz şifreler — başlamadan önce üçünü de değiştirin
MYSQL_PASSWORD=change_me_strong_password
MYSQL_ROOT_PASSWORD=change_me_root_password
ADMIN_PASSWORD=change_me_admin_password
  

Önemli: Yalnızca .env Docker Compose tarafından otomatik olarak okunur. .env.production adında bir dosya oluşturmayın; bu karışıklığa neden olur. ADMIN_PASSWORD yalnızca yeni bir veritabanının ilk açılışında uygulanır.

Adım 3 — Konteynerleri Başlatın link

Tüm hizmetleri arka planda başlatın:

  docker compose -f docker-compose.production.yml up -d
  

İlk başlatma Docker’ın şunları yapması sırasında 3–5 dakika sürer:

1. rtCloud uygulama görüntüsünü çeker (~1 GB indirme)
2. MySQL veritabanını başlatır
3. Temel şemayı yükler
4. Bekleyen tüm veritabanı geçişlerini çalıştırır

Başlatma ilerlemesini gerçek zamanlı olarak izleyin:

  docker compose -f docker-compose.production.yml logs -f rtcloud
  

Uygulamanın hazır olduğunu gösteren çıktıyı görene kadar bekleyin. Konteyner sağlık durumunu da izleyebilirsiniz:

  watch docker compose -f docker-compose.production.yml ps
  

Adım 4 — Uygulamaya Erişin link

Her iki konteyner de Up (healthy) gösterdiğinde tarayıcınızı açın:

  http://<PROJECT_URL>:8080
  

Yönetici hesabıyla giriş yapın:

İlk girişinizin hemen ardından hesap ayarları sayfasından yönetici şifresini değiştirin.

Adım 5 — Tüm Hizmetleri Doğrulayın link

Tüm konteynerlerin çalışır ve sağlıklı olduğunu kontrol edin:

  docker compose -f docker-compose.production.yml ps
  

Beklenen çıktı:

  NAME                    IMAGE                                   STATUS
rtcloud-app             rtawebteam/rta-smartsurvey:...          Up (healthy)
rtcloud-mysql           mysql:8.0                               Up (healthy)
  

Bir konteyner Up (starting) veya Up (unhealthy) gösteriyorsa 30–60 saniye daha bekleyip tekrar kontrol edin. MySQL ilk açılışta tam olarak başlatılması bir dakikaya kadar sürebilir.

Port Referansı link

MySQL (port 3306) ve isteğe bağlı hizmetler (Keycloak) yalnızca dahili olup varsayılan olarak ana bilgisayara açık değildir.

Sonraki Adımlar link

rtCloud örneğiniz artık çalışıyor. Şu takip görevlerini göz önünde bulundurun:

• HTTPS’yi Etkinleştirin — Bir alan adını sunucunuza yönlendirin ve Let’s Encrypt ile SSL yapılandırın. Otomatik HTTPS kurulumu için Bulut Dağıtımı sayfasına bakın.
• Tüm ayarları gözden geçirin — Dağıtımınızı üretim için ayarlamak üzere Yapılandırma Referansı’na göz atın.
• SSO’yu kurun — Merkezi kullanıcı kimlik doğrulaması için bir kimlik sağlayıcısı bağlayın. SSO Kimlik Doğrulama sayfasına bakın.
• Yedeklemelerinizi planlayın — Yedekleme ve yükseltme prosedürleri için Bakım sayfasını inceleyin.