Това ръководство ви провежда през разгръщането на самостоятелно хостван инстанс на rtCloud на Linux сървър от нулата. В края ще имате работещ rtCloud, достъпен в браузъра ви.

Предварителни изисквания

Уверете се, че сървърът ви отговаря на следните изисквания преди да започнете:

Хардуер

РесурсМинимумПрепоръчително
RAM2 GB4 GB
Диск10 GB40 GB
CPU1 vCPU2 vCPU

Софтуер

СофтуерВерсия
ОСUbuntu 20.04 LTS или по-нова (или всяка Linux с поддръжка на Docker)
Docker20.10 или по-нова
Docker Composev2.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

Важно: Само .env се чете автоматично от Docker Compose. Не създавайте файл с имe .env.production, тъй като това би причинило объркване. ADMIN_PASSWORD се прилага само при първото стартиране на нова база данни.

Стъпка 3 — Стартирайте контейнерите

Стартирайте всички услуги на заден план:

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

Първото стартиране отнема 3–5 минути, докато Docker:

  1. Изтегля образа на приложението rtCloud (~1 GB изтегляне)
  2. Инициализира базата данни MySQL
  3. Зарежда базовата схема
  4. Изпълнява всички чакащи миграции на базата данни

Следете напредъка на стартиране в реално време:

  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_PORT)
3838Shiny сървърАнализи и визуализации базирани на R (конфигурируеми чрез SHINY_PORT)

MySQL (порт 3306) и всички незадължителни услуги (Keycloak) са само за вътрешна употреба и по подразбиране не са изложени към хоста.

Следващи стъпки

Вашият инстанс на rtCloud вече работи. Помислете за тези последващи задачи:

  • Активиране на HTTPS — Насочете домейн към сървъра си и конфигурирайте SSL с Let’s Encrypt. Вижте Разгръщане в облак за автоматизирана настройка на HTTPS.
  • Преглед на всички настройки — Разгледайте Справочника за конфигурация, за да настроите разгръщането за производствена употреба.
  • Настройка на SSO — Свържете доставчик на самоличност за централизирано удостоверяване на потребители. Вижте SSO удостоверяване.
  • Планиране на архивиране — Прегледайте страницата Поддръжка за процедури за архивиране и надграждане.
Беше ли полезна тази страница?