Ky udhëzues ju drejton nëpërmjet vendosjes së një instance rtCloud vetjake në një server Linux nga e para. Në fund, do të keni rtCloud të funksionojë dhe të aksesueshëm në shfletuesin tuaj.

Parakushtet

Sigurohuni që serveri juaj plotëson kërkesat e mëposhtme para fillimit:

Hardueri

BurimiMinimumiI Rekomanduar
RAM2 GB4 GB
Disku10 GB40 GB
CPU1 vCPU2 vCPU

Softueri

SoftueriVersioni
OSUbuntu 20.04 LTS ose më i ri (ose çdo Linux me mbështetje Docker)
Docker20.10 ose më i ri
Docker Composev2.x (docker compose) ose v1.x (docker-compose)

Instaloni Docker në Ubuntu:

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

Verifikoni instalimin:

  docker --version
docker compose version

Hapi 1 — Merrni Skedarët

Klononi depozitën e vendosjes në serverin tuaj:

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

Hapi 2 — Konfiguroni Mjedisin

Kopjoni skedarin e mostrës së konfigurimit:

  cp .env.production.sample .env

Hapni .env në një redaktues teksti dhe plotësoni vlerat e kërkuara:

  # Identifikues unik për këtë vendosje (pa hapësira, pa karaktere speciale)
PROJECT_ID=myprojekti

# Domeni ose adresa IP ku përdoruesit do të aksesojnë aplikacionin
# Shembull: rtcloud.example.com  ose  192.168.1.100
PROJECT_URL=rtcloud.example.com

# Protokolli: përdorni "https" nëse keni një domen me SSL, "http" ndryshe
HTTP_PROTOCOL=https

# Fjalëkalime të forta dhe unike — ndryshoni të tria para fillimit
MYSQL_PASSWORD=fjalëkalim_i_fortë_ndryshomëni
MYSQL_ROOT_PASSWORD=fjalëkalim_root_ndryshomëni
ADMIN_PASSWORD=fjalëkalim_admin_ndryshomëni

E rëndësishme: Vetëm .env lexohet automatikisht nga Docker Compose. Mos krijoni një skedar të quajtur .env.production, pasi do të shkaktojë konfuzion. ADMIN_PASSWORD aplikohet vetëm në nisjen e parë të një baze të dhënash të re.

Hapi 3 — Nisni Kontejnerët

Hapni të gjitha shërbimet në sfond:

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

Nisja e parë merr 3–5 minuta ndërkohë që Docker:

  1. Tërheq imazhin e aplikacionit rtCloud (~1 GB shkarkesë)
  2. Inicializon bazën e të dhënave MySQL
  3. Ngarkon skemën bazë
  4. Ekzekuton të gjitha migrimet e bazës së të dhënave në pritje

Monitoroni progresin e nisjes në kohë reale:

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

Prisni derisa të shihni dalje që tregon se aplikacioni është gati. Gjithashtu mund të shikoni statusin e shëndetit të kontejnerit:

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

Hapi 4 — Aksesoni Aplikacionin

Pasi të dy kontejnerët të tregojnë Up (healthy), hapni shfletuesin tuaj:

  http://<PROJECT_URL>:8080

Hyni duke përdorur llogarinë e administratorit:

FushaVlera
Emri i përdoruesitadmin
FjalëkalimiVlera që keni vendosur për ADMIN_PASSWORD në .env

Ndryshoni fjalëkalimin e administratorit menjëherë pas hyrjes suaj të parë nga faqja e cilësimeve të llogarisë.

Hapi 5 — Verifikoni të Gjitha Shërbimet

Kontrolloni që të gjithë kontejnerët po ekzekutohen dhe janë të shëndetshëm:

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

Dalja e pritur:

  EMRI                    IMAZHI                                   STATUSI
rtcloud-app             rtawebteam/rta-smartsurvey:...          Up (healthy)
rtcloud-mysql           mysql:8.0                               Up (healthy)

Nëse një kontejner tregon Up (starting) ose Up (unhealthy), prisni 30–60 sekonda më shumë dhe kontrolloni sërish. MySQL mund të marrë deri në një minutë për t’u inicializuar plotësisht gjatë nisjes së parë.

Referenca e Portave

PortaShërbimiPërshkrimi
8080Aplikacioni rtCloudUI-ja kryesore ueb (konfigurueshëm nëpërmjet APP_PORT)
3838Serveri ShinyAnalitika dhe vizualizimet e bazuara në R (konfigurueshëm nëpërmjet SHINY_PORT)

MySQL (porta 3306) dhe çdo shërbim opsional (Keycloak) janë vetëm të brendshme dhe nuk ekspozohen ndaj hostit si parazgjedhje.

Hapat e Mëtejshëm

Instanca juaj rtCloud tani po ekzekutohet. Konsideroni këto detyra pasardhëse:

  • Aktivizoni HTTPS — Drejtoni një domen në serverin tuaj dhe konfiguroni SSL me Let’s Encrypt. Shikoni Vendosja në Cloud për konfigurimin automatik të HTTPS.
  • Rishikoni të gjitha cilësimet — Shfletoni Referenca e Konfigurimit për të rregulluar vendosjen tuaj për prodhim.
  • Konfiguroni SSO — Lidhni një ofrues identiteti për autentifikim të centralizuar të përdoruesve. Shikoni Autentifikimi SSO.
  • Planifikoni rezervimet — Rishikoni faqen Mirëmbajtja për procedurat e rezervimit dhe përditësimit.
A ishte e dobishme kjo faqe?