Greitas paleidimas

Šis vadovas supažindins jus su savarankiškai valdomos rtCloud instancijos diegimu „Linux" serveryje nuo nulio. Pabaigoje turėsite veikiančią rtCloud, pasiekiamą naršyklėje.

Išankstinės sąlygos link

Prieš pradėdami įsitikinkite, kad jūsų serveris atitinka šiuos reikalavimus:

Aparatinė įranga link

Programinė įranga link

Docker diegimas Ubuntu:

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

Patikrinkite diegimą:

  docker --version
docker compose version
  

1 žingsnis — Gaukite failus link

Klonuokite diegimo saugyklą į savo serverį:

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

2 žingsnis — Konfigūruokite aplinką link

Nukopijuokite pavyzdinę konfigūracijos bylą:

  cp .env.production.sample .env
  

Atidarykite .env teksto redaktoriuje ir užpildykite reikiamas reikšmes:

  # Unikalus šio diegimo identifikatorius (be tarpų, be specialių simbolių)
PROJECT_ID=myproject

# Domenų vardas arba IP adresas, kuriuo naudotojai pasieks programą
# Pavyzdys: rtcloud.example.com  arba  192.168.1.100
PROJECT_URL=rtcloud.example.com

# Protokolas: naudokite "https", jei turite domeną su SSL, "http" kitu atveju
HTTP_PROTOCOL=https

# Stiprūs, unikalūs slaptažodžiai – pakeiskite visus tris prieš paleidžiant
MYSQL_PASSWORD=change_me_strong_password
MYSQL_ROOT_PASSWORD=change_me_root_password
ADMIN_PASSWORD=change_me_admin_password
  

Svarbu: tik .env automatiškai skaitoma „Docker Compose". Nekurkite failo pavadinimu .env.production, nes tai sukeltų painiavą. ADMIN_PASSWORD taikoma tik pirmojo paleidimo metu su nauja duomenų baze.

3 žingsnis — Paleiskite konteinerius link

Paleiskite visas paslaugas fone:

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

Pirmasis paleidimas užtrunka 3–5 minutes, kol Docker:

1. Atsisiunčia rtCloud programos vaizdą (~1 GB parsisiuntimas)
2. Inicializuoja MySQL duomenų bazę
3. Įkelia pagrindinę schemą
4. Paleidžia visas laukiančias duomenų bazės migracijas

Stebėkite paleidimo eigą realiuoju laiku:

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

Palaukite, kol pamatysite išvestį, nurodančią, kad programa pasiruošusi. Taip pat galite stebėti konteinerio sveikatos būseną:

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

4 žingsnis — Pasiekite programą link

Kai abu konteineriai rodo Up (healthy), atidarykite naršyklę:

  http://<PROJECT_URL>:8080
  

Prisijunkite naudodami administratoriaus paskyrą:

Pirmą kartą prisijungę, pakeiskite administratoriaus slaptažodį paskyros nustatymų puslapyje.

5 žingsnis — Patikrinkite visas paslaugas link

Patikrinkite, ar visi konteineriai veikia ir yra sveiki:

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

Tikėtina išvestis:

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

Jei konteineris rodo Up (starting) arba Up (unhealthy), palaukite dar 30–60 sekundžių ir patikrinkite dar kartą. MySQL pirmą kartą paleidžiant gali užtrukti iki minutės.

Prievadų nuoroda link

MySQL (prievadas 3306) ir bet kurios papildomos paslaugos (Keycloak) yra tik vidinės ir pagal numatytuosius nustatymus neatidarytos pagrindiniame kompiuteryje.

Kiti žingsniai link

Jūsų rtCloud instancija dabar veikia. Apsvarstykite šias tolimesnes užduotis:

• Įjunkite HTTPS – nukreipkite domeną į savo serverį ir konfigūruokite SSL su „Let’s Encrypt". Automatinio HTTPS nustatymo informaciją rasite Debesies diegime.
• Peržiūrėkite visus nustatymus – naršykite Konfigūracijos nuorodą, kad pritaikytumėte diegimą gamybai.
• Nustatykite SSO – prijunkite tapatybės teikėją centralizuotai naudotojų autentifikacijai. Žr. SSO autentifikavimą.
• Planuokite atsargines kopijas – peržiūrėkite Priežiūros puslapį, kad sužinotumėte apie atsarginių kopijų kūrimo ir atnaujinimo procedūras.