Rýchly štart

Táto príručka vás prevedie nasadením vlastnej inštancie rtCloud na linuxovom serveri od začiatku. Na konci budete mať bežiaci rtCloud prístupný v prehliadači.

Predpoklady link

Pred začatím sa uistite, že váš server spĺňa nasledujúce požiadavky:

Hardvér link

Softvér link

Inštalácia Dockeru na Ubuntu:

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

Overenie inštalácie:

  docker --version
docker compose version
  

Krok 1 — Získajte súbory link

Naklonujte repozitár nasadenia na váš server:

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

Krok 2 — Nakonfigurujte prostredie link

Skopírujte vzorový konfiguračný súbor:

  cp .env.production.sample .env
  

Otvorte .env v textovom editore a vyplňte požadované hodnoty:

  # Jedinečný identifikátor pre toto nasadenie (bez medzier, bez špeciálnych znakov)
PROJECT_ID=myproject

# Doména alebo IP adresa, kde budú používatelia pristupovať k aplikácii
# Príklad: rtcloud.example.com  alebo  192.168.1.100
PROJECT_URL=rtcloud.example.com

# Protokol: použite "https" ak máte doménu s SSL, inak "http"
HTTP_PROTOCOL=https

# Silné, jedinečné heslá — zmeňte všetky tri pred spustením
MYSQL_PASSWORD=change_me_strong_password
MYSQL_ROOT_PASSWORD=change_me_root_password
ADMIN_PASSWORD=change_me_admin_password
  

Dôležité: Docker Compose automaticky číta iba .env. Nevytvárajte súbor s názvom .env.production, pretože by to spôsobilo zmätok. ADMIN_PASSWORD sa použije iba pri prvom spustení čerstvej databázy.

Krok 3 — Spustite kontajnery link

Spustite všetky služby na pozadí:

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

Prvé spustenie trvá 3–5 minút, počas ktorých Docker:

1. Sťahuje image aplikácie rtCloud (~1 GB stiahnutie)
2. Inicializuje databázu MySQL
3. Načíta základnú schému
4. Spustí všetky čakajúce migrácie databázy

Monitorujte postup spustenia v reálnom čase:

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

Počkajte, kým neuvidíte výstup signalizujúci, že aplikácia je pripravená. Môžete tiež sledovať stav zdravia kontajnera:

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

Krok 4 — Prístup k aplikácii link

Keď oba kontajnery zobrazujú Up (healthy), otvorte prehliadač:

  http://<PROJECT_URL>:8080
  

Prihláste sa pomocou účtu správcu:

Po prvom prihlásení ihneď zmeňte heslo správcu na stránke nastavení účtu.

Krok 5 — Overte všetky služby link

Skontrolujte, či všetky kontajnery bežia a sú zdravé:

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

Očakávaný výstup:

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

Ak kontajner zobrazuje Up (starting) alebo Up (unhealthy), počkajte ďalších 30–60 sekúnd a skontrolujte znova. MySQL môže trvať až minútu, kým sa pri prvom spustení úplne inicializuje.

Referencia portov link

MySQL (port 3306) a akékoľvek voliteľné služby (Keycloak) sú iba interné a predvolene nie sú vystavené hostiteľovi.

Ďalšie kroky link

Vaša inštancia rtCloud teraz beží. Zvážte tieto nadväzujúce úlohy:

• Aktivujte HTTPS — Namierte doménu na váš server a nakonfigurujte SSL pomocou Let’s Encrypt. Pozrite si Cloudové nasadenie pre automatizovanú inštaláciu HTTPS.
• Skontrolujte všetky nastavenia — Prehliadnite Referenciu konfigurácie na naladenie nasadenia pre produkciu.
• Nastavte SSO — Pripojte poskytovateľa identity pre centralizovanú autentifikáciu používateľov. Pozrite si SSO autentifikácia.
• Plánujte zálohy — Prehliadnite stránku Údržba pre postupy zálohovania a aktualizácie.