On this page
settings
Referenca e Konfigurimit
Referencë e plotë për të gjitha variablat e mjedisit të përdorura për konfigurimin e një vendosjeje vetjake rtCloud.
E gjithë konfigurimi bëhet nëpërmjet variablave të mjedisit në skedarin .env në rrënjën e drejtorisë suaj të vendosjes. Docker Compose e lexon këtë skedar automatikisht — nuk nevojitet flamur --env-file.
Variablat e shënuara si të detyrueshme duhet të caktohen para nisjes së kontejnerëve. Të gjitha të tjerat kanë vlera të paracaktuara dhe janë opsionale.
Projekti
Këto variabla përkufizojnë identitetin dhe pikën e aksesit të instancës suaj rtCloud.
| Variabla | Parazgjedhja | E detyrueshme | Përshkrimi |
|---|---|---|---|
PROJECT_ID | — | Po | Identifikues unik për këtë vendosje. Pa hapësira ose karaktere speciale. Përdoret si prefiks për emërtimin e brendshëm. |
PROJECT_URL | — | Po | Emri i domenit ose adresa IP ku përdoruesit aksesojnë aplikacionin (p.sh., rtcloud.example.com ose 192.168.1.100). |
PROJECT_TYPE | rtsurvey | Jo | Varianti i platformës për aktivizim. Opsionet: rtwork, rtsurvey, rthome. |
PROJECT_PORT | 80 | Jo | Porta të cilën aplikacioni dëgjon brenda kontejnerit. Mos ndryshoni nëse nuk dini çfarë bëni. |
HTTP_PROTOCOL | https | Jo | Protokolli i përdorur për ndërtimin e URL-ve të brendshme. Caktoni në http nëse nuk po përdorni SSL. |
Baza e të Dhënave
Kredencialet e lidhjes MySQL. Baza e të dhënave menaxhohet automatikisht nga kontejneri MySQL — vetëm duhet të caktoni fjalëkalime të forta.
| Variabla | Parazgjedhja | E detyrueshme | Përshkrimi |
|---|---|---|---|
MYSQL_DATABASE | smartsurvey | Jo | Emri i bazës së të dhënave të aplikacionit. |
MYSQL_USER | smartsurvey | Jo | Përdoruesi MySQL për aplikacionin. |
MYSQL_PASSWORD | — | Po | Fjalëkalimi për MYSQL_USER. Përdorni një vlerë të fortë dhe unike. |
MYSQL_ROOT_PASSWORD | — | Po | Fjalëkalimi rrënjësor MySQL. Kërkohet për inicializimin e bazës së të dhënave dhe operacionet administrative. |
MYSQL_HOST | mysql | Jo | Emri i hostit MySQL. Përdorni parazgjedhjen nëse nuk po lidheni me një bazë të dhënash të jashtme. |
MYSQL_PORT | 3306 | Jo | Porta MySQL. |
Llogaria e Administratorit
Llogaria e administratorit krijohet automatikisht në nisjen e parë të një baze të dhënash të re.
| Variabla | Parazgjedhja | E detyrueshme | Përshkrimi |
|---|---|---|---|
ADMIN_PASSWORD | admin | Po | Fjalëkalimi për përdoruesin e integruar admin. Caktojeni para nisjes së parë. Nuk ka efekt nëse baza e të dhënave ekziston tashmë. |
Pas hyrjes së parë, ndryshoni fjalëkalimin e administratorit nga faqja Cilësimet e Llogarisë në UI-n ueb.
Portat
Kontrolloni cilat porta të hostit lidhet aplikacioni.
| Variabla | Parazgjedhja | Përshkrimi |
|---|---|---|
APP_PORT | 8080 | Porta e hostit për UI-n kryesore ueb. Ndryshojeni nëse porta 8080 është tashmë në përdorim në serverin tuaj. |
SHINY_PORT | 3838 | Porta e hostit për serverin e analitikës Shiny. |
Koha e Ekzekutimit
| Variabla | Parazgjedhja | Përshkrimi |
|---|---|---|
RUN_ENV | prod | Mjedisi i ekzekutimit. Përdorni prod për vendosjet e prodhimit, dev për zhvillimin lokal. |
RUN_MODE | admin | Roli i kontejnerit. admin ekzekuton suitën e plotë (ueb + radhë + cron). worker ekzekuton vetëm përpunimin në sfond (për shkallëzim horizontal). |
TZ | Asia/Ho_Chi_Minh | Zona kohore e serverit. Ndikon në markat kohore të regjistrit, oraret cron dhe shfaqjen e datës. Përdorni një emër zone kohore TZ database (p.sh., UTC, America/New_York, Europe/London). |
LOG_LEVEL | info | Detajimi i regjistrit të aplikacionit. Opsionet: debug, info, warning, error. |
COMPOSE_PROJECT_NAME | rtcloud | Prefiks i aplikuar ndaj të gjithë emrave të kontejnerëve dhe volumeve Docker. Ndryshojeni kur ekzekutoni instanca të shumta rtCloud në të njëjtin host. |
RESTART_POLICY | unless-stopped | Sjellja e rinisjes së kontejnerit Docker. Opsionet: no, always, on-failure, unless-stopped. |
RTCLOUD_IMAGE | rtawebteam/rta-smartsurvey:survey-dockerize | Imazhi Docker për të përdorur. Ndryshoni etiketa për të fiksuar një version specifik. |
REQUIRE_LICENSE | false | Aktivizoni validimin e çelësit të licencës në nisje. Kontaktoni RTA për informacione mbi licencën. |
Siguria
| Variabla | Parazgjedhja | Përshkrimi |
|---|---|---|
CSRF_VALIDATION_ENABLED | true | Aktivizoni validimin e shenjës CSRF. Mbajeni true në prodhim. Caktoni në false vetëm në zhvillim lokal nëse ndeshni gabime 400 Shenja CSRF nuk mund të verifikohej. |
GII_ENABLED | false | Aktivizoni mjetin gjenerues të kodit të kuadrit Yii. Kurrë mos aktivizoni në prodhim. |
SSO — Keycloak i Integruar
Aktivizoni kontejnerin e integruar Keycloak për SSO të plotë të ndërmarrjeve. Kërkon një domen me HTTPS.
| Variabla | Parazgjedhja | Përshkrimi |
|---|---|---|
EMBED_KEYCLOAK | false | Caktoni në true për të nisur kontejnerin e integruar Keycloak. Aktivizon profilin Docker Compose embed-keycloak. |
KEYCLOAK_URL | — | URL-ja e plotë e serverit Keycloak (p.sh., https://rtcloud.example.com/auth). |
KEYCLOAK_REALM | — | Emri i realmit Keycloak (p.sh., rtsurvey). |
KEYCLOAK_CLIENT_ID | — | ID-ja e klientit Keycloak për aplikacionin rtCloud. |
KEYCLOAK_CLIENT_SECRET | — | Sekreti i klientit Keycloak. Gjenerojeni nga konsollja administrative Keycloak. |
KEYCLOAK_ADMIN_USER | admin | Emri i përdoruesit administrator Keycloak. |
KEYCLOAK_ADMIN_PASSWORD | — | Fjalëkalimi i administratorit Keycloak. |
KEYCLOAK_DB | keycloak | Emri i bazës së të dhënave për Keycloak. Krijohet automatikisht në nisjen e parë. |
KEYCLOAK_DB_USER | keycloak | Përdoruesi i bazës së të dhënave për Keycloak. |
KEYCLOAK_DB_PASSWORD | — | Fjalëkalimi i bazës së të dhënave për përdoruesin Keycloak. |
KC_HOSTNAME | — | URL-ja e ballinës Keycloak (p.sh., https://rtcloud.example.com/auth). |
KC_HOSTNAME_STRICT | false | Zbatoni përputhjen strikte të emrit të hostit. Caktoni në true në prodhim me një domen fiks. |
Shikoni Autentifikimi SSO për udhëzuesin e plotë të konfigurimit.
SSO — Ofruesi i Jashtëm OIDC
Lidhuni me një ofrues identiteti ekzistues të përputhshëm me OIDC (Supabase, Auth0, Authentik, Okta, etj.).
| Variabla | Parazgjedhja | Përshkrimi |
|---|---|---|
OIDC_ISSUER_URL | — | URL-ja e zbulimit të lëshuesit OIDC (p.sh., https://accounts.google.com). |
OIDC_CLIENT_ID | — | ID-ja e klientit e regjistruar tek ofruesi juaj i identitetit. |
OIDC_CLIENT_SECRET | — | Sekreti i klientit nga ofruesi juaj i identitetit. |
OIDC_SCOPE | openid profile email | Lista e fushave OIDC të ndara me hapësira për t’u kërkuar. |
OIDC_REDIRECT_URI | — | URL-ja e thirrjes pas autentifikimit për aplikacionin ueb (p.sh., https://rtcloud.example.com/auth/callback). |
OIDC_MOBILE_CLIENT_ID | — | ID-ja e veçantë e klientit për aplikacionin celular rtSurvey. |
OIDC_MOBILE_REDIRECT_URI | — | URI-ja e thirrjes pas autentifikimit të aplikacionit celular (p.sh., vn.rta.rtsurvey.auth://callback). |
OPEN_REGISTRATION | false | Krijoni automatikisht llogari rtCloud për përdoruesit që autentifikohen nëpërmjet OIDC për herë të parë. |
OIDC_AUTHORIZATION_ENDPOINT | — | Anashkaloni URL-n e pikës fundore të autorizimit (lini bosh për të përdorur zbulimin). |
OIDC_TOKEN_ENDPOINT | — | Anashkaloni URL-n e pikës fundore të shenjës (lini bosh për të përdorur zbulimin). |
OIDC_USERINFO_ENDPOINT | — | Anashkaloni URL-n e pikës fundore të informacionit të përdoruesit (lini bosh për të përdorur zbulimin). |
SSO — Azure Active Directory
| Variabla | Përshkrimi |
|---|---|
AZURE_CLIENT_ID | ID-ja e aplikacionit Azure AD (klientit). |
AZURE_TENANT_ID | ID-ja e drejtorisë Azure AD (qiramarrësit). |
Integrime Opsionale
Stata
| Variabla | Parazgjedhja | Përshkrimi |
|---|---|---|
STATA_ENABLED | false | Aktivizoni integrimin e softuerit statistikor Stata për analizën e të dhënave. |
STATA_BIN_PATH | /usr/bin/stata | Rruga absolute ndaj binarit Stata brenda kontejnerit. |
Elasticsearch
| Variabla | Përshkrimi |
|---|---|
ES_HOST | Hosti Elasticsearch (p.sh., http://elasticsearch:9200). |
ES_PORT | Porta Elasticsearch. |
Analitika Matomo
| Variabla | Përshkrimi |
|---|---|
PIWIK_URL | URL-ja e serverit Matomo (Piwik). |
PIWIK_ID | ID-ja e faqes Matomo. |
PIWIK_SECRET | Shenja e autentifikimit Matomo. |
OpenCPU (Llogaritja R)
| Variabla | Përshkrimi |
|---|---|
OCPU_HOST | URL-ja e serverit OpenCPU për llogaritjen statistikore të bazuar në R. |
Integrimi RtBox
| Variabla | Përshkrimi |
|---|---|
RTBOX_HOST | URL-ja e hostit të shërbimit RtBox. |
RTBOX_USER_API | Çelësi API i përdoruesit RtBox. |
RTBOX_BASIC_AUTH | Kredencialet e autentifikimit bazë për RtBox. |
Mesazheria Matrix
| Variabla | Përshkrimi |
|---|---|
MATRIX_HOMESERVER_HOST | Hosti i serverit kryesor Matrix. |
MATRIX_HOMESERVER_PORT | Porta e serverit kryesor Matrix. |
Volumet e të Dhënave
Të gjitha të dhënat e aplikacionit ruhen në volume të emëruara Docker. Volumet krijohen automatikisht në nisjen e parë dhe ruhen nëpërmjet rinisjes dhe përditësimeve të kontejnerëve.
| Volumi | Pika e Montimit | Përmbajtja |
|---|---|---|
rtcloud_mysql_data | /var/lib/mysql | Skedarët e bazës së të dhënave MySQL |
rtcloud_uploads | …/uploads | Skedarët e ngarkuar nga të anketuarit |
rtcloud_audios | …/audios | Regjistrime audio |
rtcloud_downloads | …/downloads | Skedarët e eksportit të gjeneruar |
rtcloud_gallery | …/gallery | Imazhet e galerisë |
rtcloud_voicemail | …/voicemail | Regjistrime poste zanore |
rtcloud_analytics | …/analytics | Të dhënat e analitikës |
rtcloud_aggregate | …/aggregate | Rezultate të grumbulluara të sondazhit |
rtcloud_converter | …/converter | Dalja e konvertimit të të dhënave |
rtcloud_shiny_data | /srv/shiny-server/smartsurvey | Skriptet R të serverit Shiny |
rtcloud_shiny_logs | /var/log/shiny-server | Regjistrat e serverit Shiny |
rtcloud_assets | …/assets | Asete ueb (CSS, JS) |
rtcloud_runtime | …/protected/runtime | Cache i kohës së ekzekutimit të aplikacionit |
rtcloud_cache | …/cache | Cache i aplikacionit |
rtcloud_tmp | …/tmp | Skedarë të përkohshëm |
Emrat e volumeve prefiqsohen nga vlera e COMPOSE_PROJECT_NAME (parazgjedhja: rtcloud).
Listoni të gjitha volumet për vendosjen tuaj:
docker volume ls | grep rtcloud
A ishte e dobishme kjo faqe?