Denne veiledningen tar deg gjennom distribusjon av en selvdriftet rtCloud-instans på en Linux-server fra bunnen av. Når du er ferdig, har du en kjørende rtCloud tilgjengelig i nettleseren.

Forutsetninger

Kontroller at serveren din oppfyller følgende krav før du starter:

Maskinvare

RessursMinimumAnbefalt
RAM2 GB4 GB
Disk10 GB40 GB
CPU1 vCPU2 vCPUer

Programvare

ProgramvareVersjon
OSUbuntu 20.04 LTS eller nyere (eller en hvilken som helst Linux med Docker-støtte)
Docker20.10 eller nyere
Docker Composev2.x (docker compose) eller v1.x (docker-compose)

Installer Docker på Ubuntu:

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

Kontroller installasjonen:

  docker --version
docker compose version

Trinn 1 — Hent filene

Klon distribusjonslageret til serveren:

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

Trinn 2 — Konfigurer miljøet

Kopier eksempelkonfigurasjonsfilen:

  cp .env.production.sample .env

Åpne .env i en tekstredigerer og fyll inn de påkrevde verdiene:

  # Unik identifikator for denne distribusjonen (ingen mellomrom, ingen spesialtegn)
PROJECT_ID=myproject

# Domene eller IP-adresse der brukere vil få tilgang til appen
# Eksempel: rtcloud.example.com  eller  192.168.1.100
PROJECT_URL=rtcloud.example.com

# Protokoll: bruk "https" hvis du har et domene med SSL, "http" ellers
HTTP_PROTOCOL=https

# Sterke, unike passord — endre alle tre før oppstart
MYSQL_PASSWORD=change_me_strong_password
MYSQL_ROOT_PASSWORD=change_me_root_password
ADMIN_PASSWORD=change_me_admin_password

Viktig: Bare .env leses automatisk av Docker Compose. Ikke opprett en fil kalt .env.production, da det vil skape forvirring. ADMIN_PASSWORD brukes kun ved første oppstart av en fersk database.

Trinn 3 — Start containerne

Start alle tjenester i bakgrunnen:

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

Den første oppstarten tar 3–5 minutter mens Docker:

  1. Laster ned rtCloud-applikasjonsbildet (~1 GB nedlasting)
  2. Initialiserer MySQL-databasen
  3. Laster inn basisskjemaet
  4. Kjører alle ventende databasemigrasjoner

Overvåk oppstartsfremgangen i sanntid:

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

Vent til du ser utdata som indikerer at applikasjonen er klar. Du kan også se på containerhelsestatusen:

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

Trinn 4 — Åpne applikasjonen

Når begge containerne viser Up (healthy), åpner du nettleseren:

  http://<PROJECT_URL>:8080

Logg inn med administratorkontoen:

FeltVerdi
Brukernavnadmin
PassordVerdien du angav for ADMIN_PASSWORD i .env

Endre adminpassordet umiddelbart etter første innlogging fra kontoinnstillingssiden.

Trinn 5 — Kontroller alle tjenester

Kontroller at alle containere kjører og er sunne:

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

Forventet utdata:

  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 til og sjekk på nytt. MySQL kan ta opptil ett minutt å initialisere fullt ved første oppstart.

Portreferanse

PortTjenesteBeskrivelse
8080rtCloud AppHoved-nettgrensesnitt (kan konfigureres via APP_PORT)
3838Shiny ServerAnalyse og R-baserte visualiseringer (kan konfigureres via SHINY_PORT)

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

Neste steg

rtCloud-instansen din kjører nå. Vurder disse oppfølgingsoppgavene:

  • Aktiver HTTPS — Pek et domene til serveren din og konfigurer SSL med Let’s Encrypt. Se Skydistribusjon for automatisert HTTPS-oppsett.
  • Gjennomgå alle innstillinger — Bla gjennom Konfigurasjonsreferansen for å finjustere distribusjonen for produksjon.
  • Sett opp SSO — Koble til en identitetsleverandør for sentralisert brukerautentisering. Se SSO-autentisering.
  • Planlegg sikkerhetskopiene — Gjennomgå Vedlikehold-siden for sikkerhetskopierings- og oppgraderingsprosedyrer.
Var denne siden nyttig?