Hurtigstart

Denne guide gennemgår implementering af en selvhostet rtCloud-instans på en Linux-server fra bunden. Når du er færdig, vil du have en kørende rtCloud tilgængelig i din browser.

Forudsætninger link

Sørg for, at din server opfylder følgende krav, inden du begynder:

Hardware link

Software link

Installer Docker på Ubuntu:

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

Bekræft installationen:

  docker --version
docker compose version
  

Trin 1 — Hent filerne link

Klon implementeringslageret til din server:

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

Trin 2 — Konfigurer miljøet link

Kopiér eksempelkonfigurationsfilen:

  cp .env.production.sample .env
  

Åbn .env i en teksteditor og udfyld de påkrævede værdier:

  # Unik identifikator for denne implementering (ingen mellemrum, ingen specialtegn)
PROJECT_ID=mitprojekt

# Domæne eller IP-adresse, hvor brugere vil tilgå appen
# Eksempel: rtcloud.example.com  eller  192.168.1.100
PROJECT_URL=rtcloud.example.com

# Protokol: brug "https", hvis du har et domæne med SSL, ellers "http"
HTTP_PROTOCOL=https

# Stærke, unikke adgangskoder – skift alle tre, inden du starter
MYSQL_PASSWORD=skift_mig_stærk_adgangskode
MYSQL_ROOT_PASSWORD=skift_mig_root_adgangskode
ADMIN_PASSWORD=skift_mig_admin_adgangskode
  

Vigtigt: Kun .env læses automatisk af Docker Compose. Opret ikke en fil med navnet .env.production, da det vil skabe forvirring. ADMIN_PASSWORD anvendes kun ved første opstart af en ny database.

Trin 3 — Start containerne link

Start alle tjenester i baggrunden:

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

Den første opstart tager 3–5 minutter, mens Docker:

1. Trækker rtCloud-applikationsimaget (~1 GB download)
2. Initialiserer MySQL-databasen
3. Indlæser basisskemaet
4. Kører alle ventende databasemigreringer

Overvåg opstartsforløbet i realtid:

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

Vent, til du ser output, der angiver, at applikationen er klar. Du kan også overvåge containerens sundhedsstatus:

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

Trin 4 — Få adgang til applikationen link

Når begge containere viser Up (healthy), åbn din browser:

  http://<PROJECT_URL>:8080
  

Log ind med administratorkontoen:

Skift admin-adgangskoden umiddelbart efter din første login fra kontoindstillingssiden.

Trin 5 — Bekræft alle tjenester link

Kontrollér, at alle containere kører og er sunde:

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

Forventet output:

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

Hvis en container viser Up (starting) eller Up (unhealthy), vent 30–60 sekunder mere og kontrollér igen. MySQL kan tage op til et minut at initialisere fuldt ud ved første opstart.

Portreference link

MySQL (port 3306) og eventuelle valgfrie tjenester (Keycloak) er kun interne og eksponeres ikke til hosten som standard.

Næste trin link

Din rtCloud-instans kører nu. Overvej disse opfølgende opgaver:

• Aktiver HTTPS – Peg et domæne mod din server og konfigurer SSL med Let’s Encrypt. Se Cloud-implementering for automatiseret HTTPS-opsætning.
• Gennemgå alle indstillinger – Gennemse Konfigurationsreferencen for at optimere din implementering til produktion.
• Opsæt SSO – Forbind en identitetsudbyder til centraliseret brugergodkendelse. Se SSO-godkendelse.
• Planlæg dine sikkerhedskopier – Gennemse siden Vedligeholdelse for sikkerhedskopiering og opgraderingsprocedurer.