అన్ని కాన్ఫిగరేషన్ మీ డిప్లాయ్‌మెంట్ డైరెక్టరీ రూట్‌లోని .env ఫైల్‌లో పర్యావరణ వేరియబుల్‌ల ద్వారా చేయబడుతుంది. Docker Compose ఈ ఫైల్‌ను స్వయంచాలకంగా చదువుతుంది — --env-file ఫ్లాగ్ అవసరం లేదు.

అవసరమైన వేరియబుల్‌లను కంటైనర్‌లు ప్రారంభించే ముందు సెట్ చేయాలి. మిగిలిన వాటికి డిఫాల్ట్‌లు ఉన్నాయి మరియు అవి ఐచ్ఛికం.


ప్రాజెక్ట్

ఈ వేరియబుల్‌లు మీ rtCloud ఇన్‌స్టాన్స్ యొక్క గుర్తింపు మరియు యాక్సెస్ పాయింట్ నిర్వచిస్తాయి.

వేరియబుల్డిఫాల్ట్అవసరంవివరణ
PROJECT_IDఅవునుఈ డిప్లాయ్‌మెంట్ కోసం ప్రత్యేక గుర్తింపు. ఖాళీలు లేదా ప్రత్యేక అక్షరాలు లేవు. అంతర్గత నామకరణ కోసం ఉపసర్గగా ఉపయోగించబడుతుంది.
PROJECT_URLఅవునువినియోగదారులు యాప్ యాక్సెస్ చేసే డొమైన్ పేరు లేదా IP చిరునామా (ఉదా., rtcloud.example.com లేదా 192.168.1.100).
PROJECT_TYPErtsurveyలేదుయాక్టివేట్ చేయవలసిన వేదిక వేరియంట్. ఎంపికలు: rtwork, rtsurvey, rthome.
PROJECT_PORT80లేదుకంటైనర్ లోపల అప్లికేషన్ వినే పోర్ట్. మీకు ఏమి చేస్తున్నారో తెలియకుండా మార్చవద్దు.
HTTP_PROTOCOLhttpsలేదుఅంతర్గత URLs నిర్మించడానికి ఉపయోగించే ప్రోటోకాల్. SSL ఉపయోగించకపోతే http కి సెట్ చేయండి.

డేటాబేస్

MySQL కనెక్షన్ ఆధారపత్రాలు. డేటాబేస్ MySQL కంటైనర్ ద్వారా స్వయంచాలకంగా నిర్వహించబడుతుంది — మీరు బలమైన పాస్‌వర్డ్‌లు మాత్రమే సెట్ చేయాలి.

వేరియబుల్డిఫాల్ట్అవసరంవివరణ
MYSQL_DATABASEsmartsurveyలేదుఅప్లికేషన్ డేటాబేస్ పేరు.
MYSQL_USERsmartsurveyలేదుఅప్లికేషన్ కోసం MySQL వినియోగదారు.
MYSQL_PASSWORDఅవునుMYSQL_USER కోసం పాస్‌వర్డ్. బలమైన, ప్రత్యేక విలువ ఉపయోగించండి.
MYSQL_ROOT_PASSWORDఅవునుMySQL రూట్ పాస్‌వర్డ్. డేటాబేస్ ఇనిషియలైజేషన్ మరియు అడ్మిన్ ఆపరేషన్‌లకు అవసరం.
MYSQL_HOSTmysqlలేదుMySQL హోస్ట్‌నేమ్. బాహ్య డేటాబేస్‌కు కనెక్ట్ చేస్తున్నప్పుడు తప్ప డిఫాల్ట్ ఉపయోగించండి.
MYSQL_PORT3306లేదుMySQL పోర్ట్.

అడ్మిన్ ఖాతా

తాజా డేటాబేస్ మొదటి బూట్‌లో అడ్మిన్ ఖాతా స్వయంచాలకంగా సృష్టించబడుతుంది.

వేరియబుల్డిఫాల్ట్అవసరంవివరణ
ADMIN_PASSWORDadminఅవునుఅంతర్నిర్మిత admin వినియోగదారుకు పాస్‌వర్డ్. మొదటి బూట్‌కు ముందు సెట్ చేయండి. డేటాబేస్ ఇప్పటికే ఉంటే ప్రభావం లేదు.

మొదటి లాగిన్ తర్వాత వెబ్ UI లో Account Settings పేజీ నుండి అడ్మిన్ పాస్‌వర్డ్ మార్చండి.


పోర్ట్‌లు

అప్లికేషన్ ఏ హోస్ట్ పోర్ట్‌లకు బైండ్ అవుతుందో నియంత్రించండి.

వేరియబుల్డిఫాల్ట్వివరణ
APP_PORT8080ప్రధాన వెబ్ UI కోసం హోస్ట్ పోర్ట్. మీ సర్వర్‌లో పోర్ట్ 8080 ఇప్పటికే ఉపయోగంలో ఉంటే దీన్ని మార్చండి.
SHINY_PORT3838Shiny విశ్లేషణ సర్వర్ కోసం హోస్ట్ పోర్ట్.

రన్‌టైమ్

వేరియబుల్డిఫాల్ట్వివరణ
RUN_ENVprodరన్‌టైమ్ పర్యావరణం. ప్రొడక్షన్ డిప్లాయ్‌మెంట్‌లకు prod, స్థానిక అభివృద్ధికి dev ఉపయోగించండి.
RUN_MODEadminకంటైనర్ పాత్ర. admin పూర్తి స్టాక్ (వెబ్ + క్యూ + cron) నడిపిస్తుంది. worker బ్యాక్‌గ్రౌండ్ ప్రాసెసింగ్ మాత్రమే నడిపిస్తుంది (హారిజాంటల్ స్కేలింగ్ కోసం).
TZAsia/Ho_Chi_Minhసర్వర్ టైమ్‌జోన్. లాగ్ టైమ్‌స్టాంప్‌లు, cron షెడ్యూల్‌లు మరియు తేదీ ప్రదర్శనను ప్రభావితం చేస్తుంది. TZ database name ఉపయోగించండి (ఉదా., UTC, America/New_York, Europe/London).
LOG_LEVELinfoఅప్లికేషన్ లాగ్ వెర్బోసిటీ. ఎంపికలు: debug, info, warning, error.
COMPOSE_PROJECT_NAMErtcloudఅన్ని Docker కంటైనర్ మరియు వాల్యూమ్ పేర్లకు వర్తించే ఉపసర్గ. ఒకే హోస్ట్‌లో బహుళ rtCloud ఇన్‌స్టాన్స్‌లు నడిపేటప్పుడు దీన్ని మార్చండి.
RESTART_POLICYunless-stoppedDocker కంటైనర్ పునఃప్రారంభ ప్రవర్తన. ఎంపికలు: no, always, on-failure, unless-stopped.
RTCLOUD_IMAGErtawebteam/rta-smartsurvey:survey-dockerizeఉపయోగించవలసిన Docker ఇమేజ్. నిర్దిష్ట వెర్షన్ పిన్ చేయడానికి ట్యాగ్ మార్చండి.
REQUIRE_LICENSEfalseస్టార్టప్‌లో లైసెన్స్ కీ ధృవీకరణ ప్రారంభించండి. లైసెన్స్ సమాచారం కోసం RTA సంప్రదించండి.

భద్రత

వేరియబుల్డిఫాల్ట్వివరణ
CSRF_VALIDATION_ENABLEDtrueCSRF టోకెన్ ధృవీకరణ ప్రారంభించండి. ప్రొడక్షన్‌లో దీన్ని true గా ఉంచండి. 400 CSRF token could not be verified లోపాలు ఎదుర్కొంటే స్థానిక అభివృద్ధిలో మాత్రమే false కి సెట్ చేయండి.
GII_ENABLEDfalseYii ఫ్రేమ్‌వర్క్ కోడ్ జనరేటర్ సాధనాన్ని ప్రారంభించండి. ప్రొడక్షన్‌లో ఎప్పుడూ ప్రారంభించవద్దు.

SSO — ఎంబెడెడ్ Keycloak

పూర్తి-ఫీచర్ ఎంటర్‌ప్రైజ్ SSO కోసం బండిల్ చేయబడిన Keycloak కంటైనర్ ప్రారంభించండి. HTTPS తో డొమైన్ అవసరం.

వేరియబుల్డిఫాల్ట్వివరణ
EMBED_KEYCLOAKfalseఎంబెడెడ్ Keycloak కంటైనర్ ప్రారంభించడానికి true కి సెట్ చేయండి. embed-keycloak Docker Compose ప్రొఫైల్ యాక్టివేట్ చేస్తుంది.
KEYCLOAK_URLKeycloak సర్వర్ పూర్తి URL (ఉదా., https://rtcloud.example.com/auth).
KEYCLOAK_REALMKeycloak realm పేరు (ఉదా., rtsurvey).
KEYCLOAK_CLIENT_IDrtCloud అప్లికేషన్ కోసం Keycloak క్లైంట్ ID.
KEYCLOAK_CLIENT_SECRETKeycloak క్లైంట్ సీక్రెట్. Keycloak అడ్మిన్ కన్సోల్ నుండి జనరేట్ చేయండి.
KEYCLOAK_ADMIN_USERadminKeycloak అడ్మినిస్ట్రేటర్ వినియోగదారు పేరు.
KEYCLOAK_ADMIN_PASSWORDKeycloak అడ్మినిస్ట్రేటర్ పాస్‌వర్డ్.
KEYCLOAK_DBkeycloakKeycloak కోసం డేటాబేస్ పేరు. మొదటి బూట్‌లో స్వయంచాలకంగా సృష్టించబడుతుంది.
KEYCLOAK_DB_USERkeycloakKeycloak కోసం డేటాబేస్ వినియోగదారు.
KEYCLOAK_DB_PASSWORDKeycloak వినియోగదారు కోసం డేటాబేస్ పాస్‌వర్డ్.
KC_HOSTNAMEKeycloak ఫ్రంటెండ్ URL (ఉదా., https://rtcloud.example.com/auth).
KC_HOSTNAME_STRICTfalseకఠోర హోస్ట్‌నేమ్ మ్యాచింగ్ అమలు చేయండి. స్థిర డొమైన్ తో ప్రొడక్షన్‌లో true కి సెట్ చేయండి.

పూర్తి సెటప్ గైడ్ కోసం SSO Authentication చూడండి.


SSO — బాహ్య OIDC ప్రొవైడర్

ఇప్పటికే ఉన్న OIDC-అనుకూల గుర్తింపు ప్రదాత (Supabase, Auth0, Authentik, Okta, మొదలైనవి) కనెక్ట్ చేయండి.

వేరియబుల్డిఫాల్ట్వివరణ
OIDC_ISSUER_URLOIDC issuer discovery URL (ఉదా., https://accounts.google.com).
OIDC_CLIENT_IDమీ గుర్తింపు ప్రదాతలో నమోదు చేయబడిన క్లైంట్ ID.
OIDC_CLIENT_SECRETమీ గుర్తింపు ప్రదాత నుండి క్లైంట్ సీక్రెట్.
OIDC_SCOPEopenid profile emailఅభ్యర్థించవలసిన OIDC స్కోప్‌ల ఖాళీ-వేరు చేయబడిన జాబితా.
OIDC_REDIRECT_URIవెబ్ యాప్ కోసం కాల్‌బ్యాక్ URL (ఉదా., https://rtcloud.example.com/auth/callback).
OIDC_MOBILE_CLIENT_IDrtSurvey మొబైల్ యాప్ కోసం వేర్వేరు క్లైంట్ ID.
OIDC_MOBILE_REDIRECT_URIమొబైల్ యాప్ కాల్‌బ్యాక్ URI (ఉదా., vn.rta.rtsurvey.auth://callback).
OPEN_REGISTRATIONfalseOIDC ద్వారా మొదటిసారి సైన్ ఇన్ చేసే వినియోగదారులకు rtCloud ఖాతాలు స్వయంచాలకంగా సృష్టించడం.
OIDC_AUTHORIZATION_ENDPOINTఅధికార ఎండ్‌పాయింట్ URL ఓవర్‌రైడ్ చేయండి (discovery ఉపయోగించాలంటే ఖాళీగా వదిలండి).
OIDC_TOKEN_ENDPOINTటోకెన్ ఎండ్‌పాయింట్ URL ఓవర్‌రైడ్ చేయండి (discovery ఉపయోగించాలంటే ఖాళీగా వదిలండి).
OIDC_USERINFO_ENDPOINTuserinfo ఎండ్‌పాయింట్ URL ఓవర్‌రైడ్ చేయండి (discovery ఉపయోగించాలంటే ఖాళీగా వదిలండి).

SSO — Azure Active Directory

వేరియబుల్వివరణ
AZURE_CLIENT_IDAzure AD అప్లికేషన్ (క్లైంట్) ID.
AZURE_TENANT_IDAzure AD డైరెక్టరీ (టెనెంట్) ID.

ఐచ్ఛిక అనుసంధానాలు

Stata

వేరియబుల్డిఫాల్ట్వివరణ
STATA_ENABLEDfalseడేటా విశ్లేషణ కోసం Stata స్టాటిస్టికల్ సాఫ్ట్‌వేర్ అనుసంధానం ప్రారంభించండి.
STATA_BIN_PATH/usr/bin/stataకంటైనర్ లోపల Stata బైనరీ యొక్క నిరపేక్ష మార్గం.

Elasticsearch

వేరియబుల్వివరణ
ES_HOSTElasticsearch హోస్ట్ (ఉదా., http://elasticsearch:9200).
ES_PORTElasticsearch పోర్ట్.

Matomo Analytics

వేరియబుల్వివరణ
PIWIK_URLMatomo (Piwik) సర్వర్ URL.
PIWIK_IDMatomo సైట్ ID.
PIWIK_SECRETMatomo ప్రమాణీకరణ టోకెన్.

OpenCPU (R Computation)

వేరియబుల్వివరణ
OCPU_HOSTR-ఆధారిత స్టాటిస్టికల్ కంప్యూటేషన్ కోసం OpenCPU సర్వర్ URL.

RtBox అనుసంధానం

వేరియబుల్వివరణ
RTBOX_HOSTRtBox సేవ హోస్ట్ URL.
RTBOX_USER_APIRtBox వినియోగదారు API కీ.
RTBOX_BASIC_AUTHRtBox కోసం Basic authentication ఆధారపత్రాలు.

Matrix Messaging

వేరియబుల్వివరణ
MATRIX_HOMESERVER_HOSTMatrix homeserver హోస్ట్.
MATRIX_HOMESERVER_PORTMatrix homeserver పోర్ట్.

డేటా వాల్యూమ్‌లు

అన్ని అప్లికేషన్ డేటా పేరు పెట్టబడిన Docker వాల్యూమ్‌లలో నిల్వ చేయబడుతుంది. వాల్యూమ్‌లు మొదటి స్టార్టప్‌లో స్వయంచాలకంగా సృష్టించబడతాయి మరియు కంటైనర్ పునఃప్రారంభాలు మరియు అప్‌డేట్‌ల అంతటా కొనసాగుతాయి.

వాల్యూమ్మౌంట్ పాయింట్కంటెంట్‌లు
rtcloud_mysql_data/var/lib/mysqlMySQL డేటాబేస్ ఫైల్‌లు
rtcloud_uploads…/uploadsసర్వే ప్రతిస్పందించే వారు అప్‌లోడ్ చేసిన ఫైల్‌లు
rtcloud_audios…/audiosఆడియో రికార్డింగులు
rtcloud_downloads…/downloadsజనరేట్ చేయబడిన ఎగుమతి ఫైల్‌లు
rtcloud_gallery…/galleryగ్యాలరీ చిత్రాలు
rtcloud_voicemail…/voicemailవాయిస్‌మెయిల్ రికార్డింగులు
rtcloud_analytics…/analyticsవిశ్లేషణ డేటా
rtcloud_aggregate…/aggregateసమీకృత సర్వే ఫలితాలు
rtcloud_converter…/converterడేటా మార్పిడి అవుట్‌పుట్‌లు
rtcloud_shiny_data/srv/shiny-server/smartsurveyShiny సర్వర్ R స్క్రిప్ట్‌లు
rtcloud_shiny_logs/var/log/shiny-serverShiny సర్వర్ లాగులు
rtcloud_assets…/assetsవెబ్ ఆస్తులు (CSS, JS)
rtcloud_runtime…/protected/runtimeఅప్లికేషన్ రన్‌టైమ్ కాష్
rtcloud_cache…/cacheఅప్లికేషన్ కాష్
rtcloud_tmp…/tmpతాత్కాలిక ఫైల్‌లు

వాల్యూమ్ పేర్లు COMPOSE_PROJECT_NAME విలువ (డిఫాల్ట్: rtcloud) ద్వారా ఉపసర్గ పెట్టబడతాయి.

మీ డిప్లాయ్‌మెంట్ కోసం అన్ని వాల్యూమ్‌లు జాబితా చేయండి:

  docker volume ls | grep rtcloud
  
ఈ పేజీ సహాయకరంగా ఉందా?