Ovaj vodič vas provodi kroz primenu sopstveno hostovane rtCloud instance na Linux serveru od nule. Na kraju ćete imati pokrenuti rtCloud dostupan u pregledaču.

Preduslovi

Proverite da vaš server ispunjava sledeće zahteve pre početka:

Hardver

ResursMinimumPreporučeno
RAM2 GB4 GB
Disk10 GB40 GB
CPU1 vCPU2 vCPU

Softver

SoftverVerzija
OSUbuntu 20.04 LTS ili noviji (ili bilo koji Linux sa Docker podrškom)
Docker20.10 ili noviji
Docker Composev2.x (docker compose) ili v1.x (docker-compose)

Instalirajte Docker na Ubuntu:

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

Proverite instalaciju:

  docker --version
docker compose version
  

Korak 1 — Preuzmite datoteke

Klonirajte repozitorijum za primenu na server:

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

Korak 2 — Podesite okruženje

Kopirajte primer konfiguracione datoteke:

  cp .env.production.sample .env
  

Otvorite .env u uređivaču teksta i popunite potrebne vrednosti:

  # Jedinstveni identifikator za ovu primenu (bez razmaka, bez specijalnih znakova)
PROJECT_ID=myproject

# Domen ili IP adresa gde će korisnici pristupati aplikaciji
# Primer: rtcloud.example.com  ili  192.168.1.100
PROJECT_URL=rtcloud.example.com

# Protokol: koristite "https" ako imate domen sa SSL-om, inače "http"
HTTP_PROTOCOL=https

# Snažne, jedinstvene lozinke — promenite sve tri pre pokretanja
MYSQL_PASSWORD=change_me_strong_password
MYSQL_ROOT_PASSWORD=change_me_root_password
ADMIN_PASSWORD=change_me_admin_password
  

Važno: Samo .env čita Docker Compose automatski. Ne kreirajte datoteku pod imenom .env.production, jer bi to izazvalo zabunu. ADMIN_PASSWORD se primenjuje samo pri prvom pokretanju nove baze podataka.


Korak 3 — Pokrenite kontejnere

Pokrenite sve servise u pozadini:

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

Prvo pokretanje traje 3–5 minuta dok Docker:

  1. Preuzima sliku rtCloud aplikacije (~1 GB preuzimanja)
  2. Inicijalizuje MySQL bazu podataka
  3. Učitava osnovnu šemu
  4. Izvršava sve čekajuće migracije baze podataka

Pratite napredak pokretanja u realnom vremenu:

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

Sačekajte dok ne vidite izlaz koji ukazuje da je aplikacija spremna. Takođe možete pratiti status zdravlja kontejnera:

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

Korak 4 — Pristupite aplikaciji

Kada oba kontejnera pokažu Up (healthy), otvorite pregledač:

  http://<PROJECT_URL>:8080
  

Prijavite se koristeći administratorski nalog:

PoljeVrednost
Korisničko imeadmin
LozinkaVrednost koju ste postavili za ADMIN_PASSWORD u .env

Promenite administratorsku lozinku odmah nakon prve prijave sa stranice za podešavanja naloga.


Korak 5 — Proverite sve servise

Proverite da svi kontejneri rade i da su zdravi:

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

Očekivani izlaz:

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

Ako kontejner pokazuje Up (starting) ili Up (unhealthy), sačekajte još 30–60 sekundi i proverite ponovo. MySQL može da treba i do minut da se potpuno inicijalizuje pri prvom pokretanju.


Referenca portova

PortServisOpis
8080rtCloud aplikacijaGlavni veb UI (podesivo putem APP_PORT)
3838Shiny ServerAnalitika i vizualizacije zasnovane na R-u (podesivo putem SHINY_PORT)

MySQL (port 3306) i svi opcioni servisi (Keycloak) su samo interni i podrazumevano nisu izloženi hostu.


Sledeći koraci

Vaša rtCloud instanca sada radi. Razmotrite ove naknadne zadatke:

  • Aktivirajte HTTPS — Usmerite domen na vaš server i konfigurišite SSL sa Let’s Encrypt. Pogledajte Primenu u oblaku za automatizovano HTTPS podešavanje.
  • Pregledajte sva podešavanja — Pregledajte Referencu konfiguracije da prilagodite vašu primenu za produkciju.
  • Podesite SSO — Povežite pružaoca identiteta za centralizovanu autentifikaciju korisnika. Pogledajte SSO autentifikaciju.
  • Planirajte rezervne kopije — Pregledajte stranicu Održavanje za procedure pravljenja rezervnih kopija i nadogradnje.
Da li je ova stranica bila korisna?