Gyors kezdés

Ez az útmutató végigvezeti Önt egy saját rtCloud-példány nulláról való telepítésén egy Linux-kiszolgálón. A végére egy böngészőben elérhető, működő rtCloud-ja lesz.

Előfeltételek link

A kezdés előtt győződjön meg arról, hogy a kiszolgáló megfelel a következő követelményeknek:

Hardver link

Szoftver link

A Docker telepítése Ubuntu-n:

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

A telepítés ellenőrzése:

  docker --version
docker compose version
  

1. lépés — A fájlok letöltése link

Klónozza a telepítési tárolót a kiszolgálóra:

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

2. lépés — A környezet konfigurálása link

Másolja a minta konfigurációs fájlt:

  cp .env.production.sample .env
  

Nyissa meg a .env fájlt egy szövegszerkesztőben, és töltse ki a szükséges értékeket:

  # Egyedi azonosító ehhez a telepítéshez (szóközök és különleges karakterek nélkül)
PROJECT_ID=myproject

# Domain vagy IP-cím, ahol a felhasználók elérik az alkalmazást
# Példa: rtcloud.example.com  vagy  192.168.1.100
PROJECT_URL=rtcloud.example.com

# Protokoll: használjon "https"-t, ha van SSL-lel rendelkező domainje, egyébként "http"-t
HTTP_PROTOCOL=https

# Erős, egyedi jelszavak — mindhárom megváltoztatása az indítás előtt
MYSQL_PASSWORD=change_me_strong_password
MYSQL_ROOT_PASSWORD=change_me_root_password
ADMIN_PASSWORD=change_me_admin_password
  

Fontos: A Docker Compose csak a .env fájlt olvassa be automatikusan. Ne hozzon létre .env.production nevű fájlt, mert az zavart okozna. Az ADMIN_PASSWORD csak egy friss adatbázis első indításakor kerül alkalmazásra.

3. lépés — A konténerek elindítása link

Indítsa el az összes szolgáltatást a háttérben:

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

Az első indítás 3–5 percet vesz igénybe, míg a Docker:

1. Letölti az rtCloud alkalmazás képfájlját (~1 GB letöltés)
2. Inicializálja a MySQL adatbázist
3. Betölti az alap sémát
4. Lefuttatja az összes függőben lévő adatbázis-migrációt

Az indítási folyamat valós idejű figyelése:

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

Várjon, amíg az alkalmazás készenlétét jelző kimenet meg nem jelenik. A konténer állapotát is figyelheti:

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

4. lépés — Az alkalmazás elérése link

Ha mindkét konténer Up (healthy) állapotot mutat, nyissa meg a böngészőt:

  http://<PROJECT_URL>:8080
  

Jelentkezzen be a rendszergazdai fiókkal:

Az első bejelentkezés után azonnal változtassa meg a rendszergazdai jelszót a fiókbeállítások oldalon.

5. lépés — Az összes szolgáltatás ellenőrzése link

Ellenőrizze, hogy az összes konténer fut és egészséges-e:

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

Várt kimenet:

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

Ha egy konténer Up (starting) vagy Up (unhealthy) állapotot mutat, várjon még 30–60 másodpercet, majd ellenőrizze újra. A MySQL akár egy percig is eltarthat, amíg az első indításkor teljesen inicializálódik.

Portok referenciája link

A MySQL (3306-os port) és az opcionális szolgáltatások (Keycloak) csak belsők, alapértelmezés szerint nem érhetők el a gazdagépről.

Következő lépések link

Az rtCloud-példány most fut. Fontolja meg a következő feladatokat:

• HTTPS engedélyezése — Irányítson egy domaint a kiszolgálójára, és konfigurálja az SSL-t a Let’s Encrypt segítségével. Tekintse meg a Felhőtelepítés oldalt az automatizált HTTPS-beállításhoz.
• Az összes beállítás áttekintése — Böngéssze a Konfigurációs referencia oldalt, hogy a telepítést éles környezethez hangolja.
• SSO beállítása — Csatlakoztasson identitásszolgáltatót a centralizált felhasználói hitelesítéshez. Tekintse meg az SSO-hitelesítés oldalt.
• Biztonsági mentések tervezése — Tekintse meg a Karbantartás oldalt a biztonsági mentési és frissítési eljárásokhoz.