建議交握帆軟技術支援,在技術人員協助下操作。技術支援交握方式:帆軟官方服務渠道使用説明 。
開發者模式為高風險操作提供介面化入口,支援專案、容器的卸載,環境變數修改,埠調整等操作。
降低手動操作成本和誤操作風險,確定操作安全高效,提升維運效率。
1)管理者登入維運平台,點選專案,點選「維護>組件管理」,在組件管理介面下滑到最底部,點選「進入開發者模式」。
2)提示「確定進入開發者模式?開發者模式相關功能均有較高風險,如操作失誤可能直接導致專案出現不可挽回的問題,請在技術人員協助下操作!」
3)點選「確定」,即可進入開發者模式。
一般情況下,帆軟專案的存取地址為http://IP:port/webroot/decision,其中的「webroot」即為預設存取路徑。
場景一:提升專案安全性
預設存取路徑容易被猜測和攻擊,管理者可以將存取路徑修改為更復雜、不易猜測的路徑,降低被攻擊的風險。
存取地址由http://IP:port/webroot/decision變為http://IP:port/myproject/decision
場景二:配置短域名存取
存取地址較長,不利於業務使用者記憶和傳播,管理者可以將存取路徑置空,結合SSL配置,直接使用IP/域名存取專案。
存取地址由http://IP:port/webroot/decision變為http://my.domain.name.com
1)面向物件:本功能僅面向維運平台部署的帆軟專案,不支援非維運平台部署的專案
2)系統影響:變更存取路徑將觸發專案容器自動重啟。建議選擇業務低峯期或非工作時間進行操作。
3)存取變更:路徑調整後,專案存取地址將更新。請務必通知所有相關業務使用者,確定業務連續性。
1)進入開發者模式
管理者登入維運平台,點選專案,點選「維護>組件管理」。
在組件管理介面下滑到最底部,點選「進入開發者模式>確定」,即可進入開發者模式。
2)變更存取路徑
在開發者模式介面,點選「變更存取路徑」,輸入新的存取路徑。
存取路徑僅支援輸入英文和數字,或直接置空。
3)自動重啟容器
點選「確定」,出現提示「確定更改並重啟容器?」。
點選「確定」,維運平台會自動對該專案容器進行重啟。
請耐心等待重啟成功,即可使用新存取路徑對應地址存取專案。
場景一:專案遷移
專案已遷移至新的伺服器或環境,舊伺服器上的專案不再需要。
管理者可以卸載舊伺服器上的專案,釋放伺服器資源,避免安全隱患。
場景二:測試專案清理
使用者前期安裝了測試專案進行上線測試,測試完成後不再需要該專案。
管理者可以卸載測試專案,清理系統環境,避免資源浪費。
1)面向物件:
本功能僅面向維運平台部署的帆軟專案,不支援非維運平台部署的專案。
2)卸載須知:
本操作將永久刪除伺服器上的專案及所有聯動資源(資料、配置、儲存等),刪除後所有內容不可恢復!
請務必在卸載專案前慎重評估相關影響,帆軟無法對已卸載的專案進行任何恢復操作。
3)建議操作:
在卸載專案前,強烈建議自行對專案涉及的所有伺服器進行快照備份。快照備份操作步驟請自行諮詢你的伺服器維運人員。
透過快照恢復的專案僅可找回相關資料,不確定專案仍然可用。
2)卸載專案
在開發者模式介面,點選「卸載專案」。
彈出提示「本操作將永久刪除伺服器上的專案及所有聯動資源(資料、配置、儲存等),刪除後所有內容不可恢復!若您確認要執行物理級清除,請在此輸入專案全稱進行二次驗證:」
手動輸入專案名稱後,點選「確定」,維運平台會自動對該專案所有容器和相關資源依次卸載。
3)查看卸載進度
使用者可在卸載介面查看卸載進度,等待卸載成功。
也可跳出開發者模式,稍後在專案管理介面查看卸載進度和結果。
Host 設定 是指管理者可以自訂主機名與 IP 地址之間的解析關係。
透過這種方式,可以將特定的主機名(如 example.com)映射到指定的 IP 地址(如 192.168.1.100)。
配置完成後,系統會自動將這些解析關係,以 --dd-host 參數的形式,傳遞給啟動 Docker 容器的 docker run 命令,確定 Docker 容器內部能夠正確解析你定義的主機名。
場景一:多網卡環境下的網路隔離
當伺服器配備多個網卡時,透過自訂 Host 設定,可以將服務的主機名解析到特定網卡的 IP 地址。
配置後,服務只能透過指定的網路存取,進而實現網路隔離和安全性控制。
場景二:Kerberos 認證的主機名綁定
在 Kerberos 認證場景中,主機名與 IP 地址的綁定至關重要。透過 Host 設定,將主機名解析到正確的 IP 地址,確定使用者端能夠準確找到 Kerberos 服務。這不僅保證了主機身分的唯一性,還提升了認證程式的可靠性。
透過 Host 設定,管理者可以靈活地管理主機名與 IP 地址的映射關係,滿足不同場景下的網路和認證需求。
2)系統影響:
在進行 Host 設定時,通常只需配置應用節點組件,配置完成後系統將自動重啟該組件的所有容器。為確定業務連續性,建議選擇業務低峯期或非工作時間執行此操作。
3)host規則
host 名稱僅允許使用字母(a-z, A-Z)、數字(0-9)、點(.)和連字元(-),且不為空
4)特殊情況:
對於 FineBI 6.1 專案,master 和 worker 組件有啟動順序要求。如對「 bi-engine-master 」組件進行 Host 設定,請在配置完成後額外進行以下步驟:
待系統自動重啟完成後,首先在組件管理中手動停止所有 master 和 worker 組件;
然後啟動 master 組件,等待其運作(running)持續三分鐘,以確定健康狀態(healthy);
最後啟動全部 worker 組件。
2)進行host設定
找到需要配置的組件,點選「host設定」。
點選「新增host」,輸入對應的 host 和 IP 。支援新增多個。
點選「確定」,維運平台會自動對該組件的所有容器進行重啟。
請耐心等待重啟成功,即可配置成功。
此處展示的環境變數為維運平台部署該專案容器時,docker run 命令中的低風險參數及其值。
修改完成後,系統會自動將這些參數傳遞給啟動 Docker 容器的 docker run 命令。
1)面向物件:本功能僅面向維運平台部署的帆軟專案,不支援非維運平台部署的專案。
2)容器重啟:變更環境變數將觸發專案容器自動重啟。為避免影響業務,建議選擇業務低峯期或非工作時間進行操作。
3)回退機制:如果更改環境變數後,容器自動重啟失敗,系統將自動回退本次環境變數更改,並嘗試再次重啟。因此建議在操作完成後,再次查看並確認更改是否成功。
2)自訂環境變數
找到需要配置的組件,點選「自訂環境變數」。
支援新增參數、修改參數值和刪除參數。
注:以下參數屬於高風險參數,不支援透過此功能修改。
APP_PATH, APP_URLS, APP_WEBSOCKET_URLS, BI_CLUSTER_CONTAINER, BI_CONF_RPC_PORT_EXPOSE, BI_GRPC_PORT_EXPOSE, BI_SERVER_PORT_EXPOSE, CATALINA_OPTS, CLI_JAVA_OPTS, CONTEXT_PATH, CORE_EXTERNAL_PORT, DB_CACHE_EXTERNAL_PORT, ELASTIC_PASSWORD_FILE, ENV_MASTER_HOST, ENV_MASTER_PORT, ES_JAVA_OPTS, EXTERNAL_HTTP_PORT, FBP_BI_MASTER_HOST, FBP_BI_MASTER_PORT, FBP_BI_SERVER_MODE, FDL_WORKER_EXTERNAL_IP, FILE_SYNC_EXTERNAL_PORT, GENERAL_CACHE_EXTERNAL_PORT, GROUP_ID, GRPC_URLS, HOST_IP, JAVA_OPTS, JAVA_OPT_EXT, JVM_XMS, JVM_XMX, KAFKA_CFG_ADVERTISED_LISTENERS, KAFKA_CFG_LISTENERS, KAFKA_HEAP_OPTS, KAFKA_INTER_BROKER_PASSWORD, KAFKA_INTER_BROKER_USER, MASTER_EXTRA_VM_OPTIONS, MEMBER_EXTERNAL_PORT, MINIO_ACCESSKEY, MINIO_BROWSER_REDIRECT_URL, MINIO_ENDPOINT, MINIO_ROOT_PASSWORD, MINIO_ROOT_USER, MINIO_SECRETKEY, MINIO_URL, MONITOR_EXTRA_VM_OPTIONS, MYSQL_ROOT_PASSWORD, MYSQL_SERVICE_HOST, MYSQL_SERVICE_PASSWORD, MYSQL_SERVICE_PORT, MYSQL_SERVICE_USER, NACOS_IP, NACOS_NAMING_NAMESPACE, NACOS_PASSWORD, NACOS_PORT, NACOS_USER, NAMESPACE, NAMESRV_ADDR, NGINX_SUBNET, NGINX_URL, OPS_URL, POLARS_HOST, POLARS_NAME, POLARS_PORT, PROXY_APP_WEBSOCKET, SKYWALKING_OAP_URL, SPIDER_GRPC_PORT_EXPOSE, SPIDER_SERVER_PORT_EXPOSE, USER_ID, WORKER_EXTRA_VM_OPTIONS, bootstrap.memory_lock, gpload.external_addr, gploadPort, independence, jgroups.external_addr, nacos.namespace, nacos.password, nacos.serverAddr, nacos.username, ops_sign_key
維運平台部署專案時,會自動外掛一部分工程目錄,詳情請參見:準備FineBI專案掛載目錄
如需上傳資源,建議優先上傳至外掛目錄的help資料夾中。
如必須將產品預期外的目錄外掛,可透過該方法將webroot下的資料夾外掛出來。
2)部分路徑不支援掛載
支援對專案的工程組件(bi-web、fr、fdl)的/usr/local/tomcat/webapps/webroot下的資料夾路徑新增掛載
由於以下資料夾已被外掛/安全考慮,因此不支援新增掛載,輸入後會提示「此路徑不支援掛載」
backup
bi-data
help
logs
WEB-INF/assets
WEB-INF/classes
WEB-INF/config
WEB-INF/customlib
WEB-INF/dashboards
WEB-INF/dpworks
WEB-INF/local
WEB-INF/plugins
WEB-INF/reportlets
WEB-INF/resources
WEB-INF/schedule
WEB-INF/lib
WEB-INF/skywalking-java-agent
2)新增掛載目錄
找到工程組件,點選「新增掛載目錄」。
輸入需要掛載出來的webroot下的資料夾,例如temp/attach
請耐心等待重啟成功,即可外掛成功。例如本範例,維運平台會自動將該專案的WEB-INF/temp/attach資料夾,外掛到/工程掛載目錄/fanruanxxx/bi-web下
專案/維運平台掛載目錄,對磁碟空間有一定要求,且隨着專案使用和內容增加,可能會出現磁碟空間不足的情況。
此時可參考本節方案,將專案/維運平台掛載根目錄,取代到其他大容量磁碟上。
1)面向專案:
配置完成後系統將自動重啟容器。為確定業務連續性,建議選擇業務低峯期或非工作時間執行此操作。
2)面向組件:
對於叢集專案,有多個主應用/組件伺服器,此操作不是僅修改該容器的掛載根目錄,也不是修改整個專案涉及的所有組件的掛載根目錄
修改哪個容器的掛載根目錄配置,即代表修改該容器所在伺服器上,該專案所有組件的根目錄配置
本節範例:將專案掛載目錄由/home/bi61/fanruanxxxx/調整到/dev/fanruan/fanruanxxxx/
1)準備新掛載目錄
請確定新掛載目錄/dev/fanruan實際存在
請確定部署專案所使用的伺服器使用者,是新掛載目錄的所有者,且有新掛載目錄的讀寫操作權限
目錄準備和權限配置可參考:準備FineBI專案掛載目錄
2)手動copy掛載目錄檔案到目標位置
請將/home/bi61下的fanruanxxxx資料夾,完整copy到/dev/fanruan資料夾下
請勿改動該資料夾的內部儲存內容
請務必手動提前完成該操作,否則可能導致掛載根目錄切換後專案啟動失敗!
3)進入開發者模式
4)修改掛載根目錄
找到需要調整的容器,點選「修改掛載根目錄」。
專案原掛載目錄為/home/bi61/fanruanxxxx/,支援調整的路徑為/home/bi61部分。輸入新的掛載路徑,即/dev/fanruan。
5)自動重啟容器
點選「確定」,出現提示「確定更改並重啟容器?更改後當前專案在節點上的所有掛載都將由xxx切換至xxx」
點選「確定」,維運平台會自動對容器進行重啟。
請耐心等待重啟成功,即可修改成功
專案部署成功後,如需調整對外曝光埠和組件間通訊埠,可透過本節方案修改
若專案/維運平台使用了自備的負載均衡,請自行檢查調整轉發策略。
1)確定埠可用性
請確定所準備的埠是否已被使用,如已被使用,請安排好其他閒置埠。
埠佔用檢查和防火牆放行方法請參考:埠占用檢查與防火牆配置
2)進入開發者模式
3)變更埠
找到需要調整的容器,點選「變更埠」。
修改需要調整的主機埠。
4)自動重啟容器
點選「確定」,出現提示「確定更改並重啟容器?」
點選「確定」,維運平台會自動對容器進行重啟。請耐心等待重啟成功,即可修改成功。
維運平台會自動幫助使用者調整以下內容:
專案的內網關轉發策略會直接跟隨變更
叢集節點間通訊埠的變化會自動相容處理
維運平台與專案之間的對接會自動相容處理
自動重啟容器,新埠配置生效
專案中部分節點伺服器變更,需要對該節點進行清理,管理者可以卸載指定容器,釋放伺服器資源
本功能支援專案中除OPS Agent以外所有容器的單獨卸載。
本操作將永久刪除伺服器上的該容器及所有聯動資源(資料、配置、儲存等),刪除後所有內容不可恢復!
請務必在卸載容器前慎重評估相關影響,帆軟無法對已卸載的容器進行任何恢復操作。
透過快照恢復的專案僅可找回相關資料,不確定專案及對應容器仍然可用。
2)卸載容器
在開發者模式介面,找到對應容器,點選「卸載容器」。
彈出提示「卸載後此容器和掛載目錄將全部被清理並無法恢復!如確定卸載,請輸入容器名稱:」
手動輸入容器名稱後,點選「確定」,維運平台會自動對該容器和相關資源依次卸載。