Швидкий старт
Запустіть rtCloud на власному сервері менш ніж за 10 хвилин за допомогою Docker Compose.
Цей посібник проведе вас через розгортання самостійного екземпляру rtCloud на сервері Linux з нуля. Після завершення у вас буде працюючий rtCloud, доступний у браузері.
Передумови
Переконайтеся, що ваш сервер відповідає наступним вимогам перед початком:
Апаратне забезпечення
| Ресурс | Мінімум | Рекомендовано |
|---|---|---|
| RAM | 2 ГБ | 4 ГБ |
| Диск | 10 ГБ | 40 ГБ |
| CPU | 1 vCPU | 2 vCPU |
Програмне забезпечення
| Програмне забезпечення | Версія |
|---|---|
| ОС | Ubuntu 20.04 LTS або новіша (або будь-який Linux з підтримкою Docker) |
| Docker | 20.10 або новіший |
| Docker Compose | v2.x (docker compose) або v1.x (docker-compose) |
Встановлення Docker на Ubuntu:
curl -fsSL https://get.docker.com | sh
Перевірте встановлення:
docker --version
docker compose version
Крок 1 — Отримайте файли
Клонуйте репозиторій розгортання на ваш сервер:
git clone ssh://git@rtgit.rta.vn:2224/rtlab/rtwebteam/rta-smart-survey-docker.git rtcloud
cd rtcloud
Крок 2 — Налаштуйте середовище
Скопіюйте зразковий файл конфігурації:
cp .env.production.sample .env
Відкрийте .env у текстовому редакторі та заповніть необхідні значення:
# Унікальний ідентифікатор для цього розгортання (без пробілів і спеціальних символів)
PROJECT_ID=myproject
# Домен або IP-адреса, за якою користувачі отримають доступ до застосунку
# Приклад: rtcloud.example.com або 192.168.1.100
PROJECT_URL=rtcloud.example.com
# Протокол: використовуйте "https" якщо маєте домен з SSL, "http" інакше
HTTP_PROTOCOL=https
# Надійні унікальні паролі — змініть усі три перед запуском
MYSQL_PASSWORD=change_me_strong_password
MYSQL_ROOT_PASSWORD=change_me_root_password
ADMIN_PASSWORD=change_me_admin_password
Важливо: Docker Compose автоматично зчитує тільки
.env. Не створюйте файл з назвою.env.production, оскільки це призведе до плутанини.ADMIN_PASSWORDзастосовується лише при першому завантаженні нової бази даних.
Крок 3 — Запустіть контейнери
Запустіть усі сервіси у фоновому режимі:
docker compose -f docker-compose.production.yml up -d
Перший запуск займає 3–5 хвилин, поки Docker:
- Завантажує образ застосунку rtCloud (~1 ГБ завантаження)
- Ініціалізує базу даних MySQL
- Завантажує базову схему
- Виконує всі очікуючі міграції бази даних
Відстежуйте прогрес запуску в реальному часі:
docker compose -f docker-compose.production.yml logs -f rtcloud
Зачекайте, доки у виводі не з’явиться повідомлення про готовність застосунку. Ви також можете спостерігати за статусом здоров’я контейнера:
watch docker compose -f docker-compose.production.yml ps
Крок 4 — Отримайте доступ до застосунку
Коли обидва контейнери показують Up (healthy), відкрийте браузер:
http://<PROJECT_URL>:8080
Увійдіть з обліковим записом адміністратора:
| Поле | Значення |
|---|---|
| Ім’я користувача | admin |
| Пароль | Значення, яке ви встановили для ADMIN_PASSWORD у .env |
Змініть пароль адміністратора одразу після першого входу на сторінці налаштувань облікового запису.
Крок 5 — Перевірте всі сервіси
Переконайтеся, що всі контейнери запущені та здорові:
docker compose -f docker-compose.production.yml ps
Очікуваний вивід:
NAME IMAGE STATUS
rtcloud-app rtawebteam/rta-smartsurvey:... Up (healthy)
rtcloud-mysql mysql:8.0 Up (healthy)
Якщо контейнер показує Up (starting) або Up (unhealthy), зачекайте ще 30–60 секунд і перевірте знову. MySQL може зайняти до хвилини для повної ініціалізації при першому завантаженні.
Довідник портів
| Порт | Сервіс | Опис |
|---|---|---|
8080 | rtCloud App | Основний веб-інтерфейс (налаштовується через APP_PORT) |
3838 | Shiny Server | Аналітика та візуалізації на основі R (налаштовується через SHINY_PORT) |
MySQL (порт 3306) та будь-які необов’язкові сервіси (Keycloak) є внутрішніми і не відкриті для хосту за замовчуванням.
Наступні кроки
Ваш екземпляр rtCloud тепер запущено. Розгляньте такі наступні завдання:
- Увімкніть HTTPS — Вкажіть домен на ваш сервер та налаштуйте SSL з Let’s Encrypt. Дивіться Хмарне розгортання для автоматичного налаштування HTTPS.
- Перегляньте всі налаштування — Перегляньте Довідник конфігурації для тонкого налаштування вашого розгортання для виробництва.
- Налаштуйте SSO — Підключіть постачальника ідентифікаційних даних для централізованої аутентифікації. Дивіться SSO-аутентифікація.
- Сплануйте резервне копіювання — Перегляньте сторінку Технічне обслуговування для процедур резервного копіювання та оновлення.