Snelstart

Deze gids leidt u door het implementeren van een zelf gehoste rtCloud-instantie op een Linux-server vanaf nul. Aan het einde heeft u een actieve rtCloud die u in uw browser kunt openen.

Vereisten link

Zorg ervoor dat uw server aan de volgende vereisten voldoet voordat u begint:

Hardware link

Software link

Docker installeren op Ubuntu:

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

Verifieer de installatie:

  docker --version
docker compose version
  

Stap 1 — Haal de bestanden op link

Kloon de implementatierepository naar uw server:

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

Stap 2 — Configureer de omgeving link

Kopieer het voorbeeldconfiguratiebestand:

  cp .env.production.sample .env
  

Open .env in een teksteditor en vul de vereiste waarden in:

  # Unieke identificator voor deze implementatie (geen spaties, geen speciale tekens)
PROJECT_ID=mijnproject

# Domein of IP-adres waar gebruikers toegang krijgen tot de app
# Voorbeeld: rtcloud.example.com  of  192.168.1.100
PROJECT_URL=rtcloud.example.com

# Protocol: gebruik "https" als u een domein met SSL heeft, anders "http"
HTTP_PROTOCOL=https

# Sterke, unieke wachtwoorden — verander alle drie voordat u start
MYSQL_PASSWORD=wijzig_mij_sterk_wachtwoord
MYSQL_ROOT_PASSWORD=wijzig_mij_rootwachtwoord
ADMIN_PASSWORD=wijzig_mij_beheerderswachtwoord
  

Belangrijk: Alleen .env wordt automatisch gelezen door Docker Compose. Maak geen bestand met de naam .env.production, want dat zou verwarring veroorzaken. Het ADMIN_PASSWORD wordt alleen toegepast bij de eerste start van een verse database.

Stap 3 — Start de containers link

Start alle services op de achtergrond:

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

De eerste start duurt 3–5 minuten terwijl Docker:

1. De rtCloud-applicatie-image ophaalt (~1 GB download)
2. De MySQL-database initialiseert
3. Het basisschema laadt
4. Alle openstaande databasemigraties uitvoert

Monitor de startvoortgang in realtime:

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

Wacht totdat u uitvoer ziet die aangeeft dat de applicatie gereed is. U kunt ook de gezondheidssstatus van de container bekijken:

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

Stap 4 — Toegang tot de applicatie link

Zodra beide containers Up (healthy) tonen, opent u uw browser:

  http://<PROJECT_URL>:8080
  

Log in met het beheerdersaccount:

Wijzig het beheerderwachtwoord onmiddellijk na uw eerste login via de pagina met accountinstellingen.

Stap 5 — Verifieer alle services link

Controleer of alle containers actief en gezond zijn:

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

Verwachte uitvoer:

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

Als een container Up (starting) of Up (unhealthy) toont, wacht dan nog 30–60 seconden en controleer opnieuw. MySQL kan tot een minuut nodig hebben om volledig te initialiseren bij de eerste start.

Poortreferentie link

MySQL (poort 3306) en optionele services (Keycloak) zijn alleen intern en worden niet standaard blootgesteld aan de host.

Volgende stappen link

Uw rtCloud-instantie is nu actief. Overweeg deze vervolgacties:

• HTTPS inschakelen — Wijs een domein aan uw server toe en configureer SSL met Let’s Encrypt. Zie Cloudimplementatie voor geautomatiseerde HTTPS-instelling.
• Alle instellingen bekijken — Blader door de Configuratiereferentie om uw implementatie te optimaliseren voor productie.
• SSO instellen — Verbind een identiteitsprovider voor gecentraliseerde gebruikersauthenticatie. Zie SSO-authenticatie.
• Plan uw back-ups — Bekijk de pagina Onderhoud voor back-up- en upgradeprocedures.