Szybki start

Ten przewodnik przeprowadza Cię przez wdrożenie własnej instancji rtCloud na serwerze Linux od podstaw. Po zakończeniu będziesz mieć działający rtCloud dostępny w przeglądarce.

Wymagania wstępne link

Przed rozpoczęciem upewnij się, że serwer spełnia następujące wymagania:

Sprzęt link

Oprogramowanie link

Instalacja Docker na Ubuntu:

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

Weryfikacja instalacji:

  docker --version
docker compose version
  

Krok 1 — Pobierz pliki link

Sklonuj repozytorium wdrożeniowe na serwer:

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

Krok 2 — Skonfiguruj środowisko link

Skopiuj przykładowy plik konfiguracyjny:

  cp .env.production.sample .env
  

Otwórz .env w edytorze tekstu i uzupełnij wymagane wartości:

  # Unikalny identyfikator tego wdrożenia (bez spacji, bez znaków specjalnych)
PROJECT_ID=myproject

# Domena lub adres IP, pod którym użytkownicy będą uzyskiwać dostęp do aplikacji
# Przykład: rtcloud.example.com  lub  192.168.1.100
PROJECT_URL=rtcloud.example.com

# Protokół: użyj "https" jeśli masz domenę z SSL, "http" w przeciwnym razie
HTTP_PROTOCOL=https

# Silne, unikalne hasła — zmień wszystkie trzy przed uruchomieniem
MYSQL_PASSWORD=change_me_strong_password
MYSQL_ROOT_PASSWORD=change_me_root_password
ADMIN_PASSWORD=change_me_admin_password
  

Ważne: Tylko .env jest automatycznie odczytywany przez Docker Compose. Nie twórz pliku o nazwie .env.production, ponieważ spowodowałoby to zamieszanie. ADMIN_PASSWORD jest stosowane tylko przy pierwszym uruchomieniu świeżej bazy danych.

Krok 3 — Uruchom kontenery link

Uruchom wszystkie usługi w tle:

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

Pierwsze uruchomienie trwa 3–5 minut, podczas gdy Docker:

1. Pobiera obraz aplikacji rtCloud (~1 GB do pobrania)
2. Inicjalizuje bazę danych MySQL
3. Ładuje bazowy schemat
4. Wykonuje wszystkie oczekujące migracje bazy danych

Monitoruj postęp uruchomienia w czasie rzeczywistym:

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

Poczekaj, aż zobaczysz komunikat wskazujący, że aplikacja jest gotowa. Możesz też obserwować status zdrowia kontenera:

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

Krok 4 — Dostęp do aplikacji link

Gdy oba kontenery pokażą Up (healthy), otwórz przeglądarkę:

  http://<PROJECT_URL>:8080
  

Zaloguj się przy użyciu konta administratora:

Zmień hasło administratora natychmiast po pierwszym logowaniu ze strony ustawień konta.

Krok 5 — Weryfikacja wszystkich usług link

Sprawdź, czy wszystkie kontenery działają i są zdrowe:

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

Oczekiwane wyjście:

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

Jeśli kontener pokazuje Up (starting) lub Up (unhealthy), poczekaj 30–60 sekund i sprawdź ponownie. MySQL może potrzebować do minuty na pełną inicjalizację przy pierwszym uruchomieniu.

Informacje o portach link

MySQL (port 3306) i wszelkie opcjonalne usługi (Keycloak) są tylko wewnętrzne i domyślnie nie są udostępniane hostowi.

Następne kroki link

Twoja instancja rtCloud jest teraz uruchomiona. Rozważ następujące zadania uzupełniające:

• Włącz HTTPS — Wskaż domenę na serwer i skonfiguruj SSL z Let’s Encrypt. Zobacz Wdrożenie w chmurze dla zautomatyzowanej konfiguracji HTTPS.
• Przejrzyj wszystkie ustawienia — Przeglądaj Dokumentację konfiguracji, aby dostosować wdrożenie do środowiska produkcyjnego.
• Skonfiguruj SSO — Połącz dostawcę tożsamości dla scentralizowanego uwierzytelniania użytkowników. Zobacz Uwierzytelnianie SSO.
• Zaplanuj kopie zapasowe — Przejrzyj stronę Konserwacja dla procedur tworzenia kopii zapasowych i aktualizacji.