開發者模式

  • 最後修改時間:2025-08-07
  • 提示:
    「開發者模式」相關功能均有較高風險,如操作失誤可能直接導致專案出現不可挽回的問題!

    建議交握帆軟技術支援,在技術人員協助下操作。技術支援交握方式:帆軟官方服務渠道使用説明

    1. 概述

    1.1 版本

    維運平台版本
    功能變更
    V2.18.0-

    1.2 應用場景

    開發者模式為高風險操作提供介面化入口,支援專案、容器的卸載,環境變數修改,埠調整等操作。

    降低手動操作成本和誤操作風險,確定操作安全高效,提升維運效率。

    1.3 功能簡介

    1)管理者登入維運平台,點選專案,點選「維護>組件管理」,在組件管理介面下滑到最底部,點選「進入開發者模式」。

    2)提示「確定進入開發者模式?開發者模式相關功能均有較高風險,如操作失誤可能直接導致專案出現不可挽回的問題,請在技術人員協助下操作!」

    3)點選「確定」,即可進入開發者模式。

    2. 專案級功能

    2.1 變更存取路徑

    2.1.1 應用場景

    一般情況下,帆軟專案的存取地址為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

    2.1.2 操作前重要提示

    1)面向物件:本功能僅面向維運平台部署的帆軟專案,不支援非維運平台部署的專案

    2)系統影響:變更存取路徑將觸發專案容器自動重啟。建議選擇業務低峯期或非工作時間進行操作。

    3)存取變更:路徑調整後,專案存取地址將更新。請務必通知所有相關業務使用者,確定業務連續性。

    2.1.3 操作步驟

    1)進入開發者模式

    • 管理者登入維運平台,點選專案,點選「維護>組件管理」。

    • 在組件管理介面下滑到最底部,點選「進入開發者模式>確定」,即可進入開發者模式。

    2)變更存取路徑

    • 在開發者模式介面,點選「變更存取路徑」,輸入新的存取路徑。

    • 存取路徑僅支援輸入英文和數字,或直接置空。

    3)自動重啟容器

    • 點選「確定」,出現提示「確定更改並重啟容器?」。

    • 點選「確定」,維運平台會自動對該專案容器進行重啟。

    • 請耐心等待重啟成功,即可使用新存取路徑對應地址存取專案。

    2.2 卸載專案

    2.2.1 應用場景

    場景一:專案遷移

    專案已遷移至新的伺服器或環境,舊伺服器上的專案不再需要。

    管理者可以卸載舊伺服器上的專案,釋放伺服器資源,避免安全隱患。

    場景二:測試專案清理

    使用者前期安裝了測試專案進行上線測試,測試完成後不再需要該專案。

    管理者可以卸載測試專案,清理系統環境,避免資源浪費。

    2.2.2 操作前重要提示

    1)面向物件:

    • 本功能僅面向維運平台部署的帆軟專案,不支援非維運平台部署的專案。

    2)卸載須知:

    • 本操作將永久刪除伺服器上的專案及所有聯動資源(資料、配置、儲存等),刪除後所有內容不可恢復

    • 請務必在卸載專案前慎重評估相關影響,帆軟無法對已卸載的專案進行任何恢復操作。

    3)建議操作:

    • 在卸載專案前,強烈建議自行對專案涉及的所有伺服器進行快照備份。快照備份操作步驟請自行諮詢你的伺服器維運人員。

    • 透過快照恢復的專案僅可找回相關資料,不確定專案仍然可用。

    2.2.3 操作步驟

    1)進入開發者模式

    • 管理者登入維運平台,點選專案,點選「維護>組件管理」。

    • 在組件管理介面下滑到最底部,點選「進入開發者模式>確定」,即可進入開發者模式。

    2)卸載專案

    • 在開發者模式介面,點選「卸載專案」。

    • 彈出提示「本操作將永久刪除伺服器上的專案及所有聯動資源(資料、配置、儲存等),刪除後所有內容不可恢復!若您確認要執行物理級清除,請在此輸入專案全稱進行二次驗證:」

    • 手動輸入專案名稱後,點選「確定」,維運平台會自動對該專案所有容器和相關資源依次卸載。

    3)查看卸載進度

    使用者可在卸載介面查看卸載進度,等待卸載成功。

    也可跳出開發者模式,稍後在專案管理介面查看卸載進度和結果。

    3. 組件級功能

    3.1 host設定

    3.1.1 應用場景

    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 地址的映射關係,滿足不同場景下的網路和認證需求。

    3.1.2 操作前重要提示

    1)面向物件:本功能僅面向維運平台部署的帆軟專案,不支援非維運平台部署的專案

    2)系統影響

    在進行 Host 設定時,通常只需配置應用節點組件,配置完成後系統將自動重啟該組件的所有容器。為確定業務連續性,建議選擇業務低峯期或非工作時間執行此操作。

    3)host規則

    host 名稱僅允許使用字母(a-z, A-Z)、數字(0-9)、點(.)和連字元(-),且不為空

    4)特殊情況:

    對於 FineBI 6.1 專案,master 和 worker 組件有啟動順序要求。如對「 bi-engine-master 」組件進行 Host 設定,請在配置完成後額外進行以下步驟:

    1. 待系統自動重啟完成後,首先在組件管理中手動停止所有 master 和 worker 組件;

    2. 然後啟動 master 組件,等待其運作(running)持續三分鐘,以確定健康狀態(healthy);

    3. 最後啟動全部 worker 組件。

    3.1.3 操作步驟

    1)進入開發者模式

    • 管理者登入維運平台,點選專案,點選「維護>組件管理」。

    • 在組件管理介面下滑到最底部,點選「進入開發者模式>確定」,即可進入開發者模式。

    2)進行host設定

    • 找到需要配置的組件,點選「host設定」。

    • 點選「新增host」,輸入對應的 host 和 IP 。支援新增多個。

    • host 名稱僅允許使用字母(a-z, A-Z)、數字(0-9)、點(.)和連字元(-),且不為空

    3)自動重啟容器

    • 點選「確定」,出現提示「確定更改並重啟容器?」。

    • 點選「確定」,維運平台會自動對該組件的所有容器進行重啟。

    • 請耐心等待重啟成功,即可配置成功。

    3.2 自訂環境變數

    3.2.1 應用場景

    此處展示的環境變數為維運平台部署該專案容器時,docker run 命令中的低風險參數及其值。

    修改完成後,系統會自動將這些參數傳遞給啟動 Docker 容器的 docker run 命令。

    3.2.2 操作前重要提示

    1)面向物件:本功能僅面向維運平台部署的帆軟專案,不支援非維運平台部署的專案。

    2)容器重啟:變更環境變數將觸發專案容器自動重啟。為避免影響業務,建議選擇業務低峯期或非工作時間進行操作。

    3)回退機制:如果更改環境變數後,容器自動重啟失敗,系統將自動回退本次環境變數更改,並嘗試再次重啟。因此建議在操作完成後,再次查看並確認更改是否成功。

    3.2.3 操作步驟

    1)進入開發者模式

    • 管理者登入維運平台,點選專案,點選「維護>組件管理」。

    • 在組件管理介面下滑到最底部,點選「進入開發者模式>確定」,即可進入開發者模式。

    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

    3)自動重啟容器

    • 點選「確定」,出現提示「確定更改並重啟容器?」。

    • 點選「確定」,維運平台會自動對該組件的所有容器進行重啟。

    • 請耐心等待重啟成功,即可配置成功。

    3.3 新增掛載目錄

    3.3.1 應用場景

    維運平台部署專案時,會自動外掛一部分工程目錄,詳情請參見:準備FineBI專案掛載目錄

    如需上傳資源,建議優先上傳至外掛目錄的help資料夾中。

    如必須將產品預期外的目錄外掛,可透過該方法將webroot下的資料夾外掛出來。

    3.3.2 操作前重要提示

    1)面向物件:本功能僅面向維運平台部署的帆軟專案,不支援非維運平台部署的專案。

    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/reportlets_versions

    WEB-INF/resources

    WEB-INF/schedule

    WEB-INF/treasures
    安全考慮WEB-INF

    WEB-INF/lib

    WEB-INF/skywalking-java-agent

    WEB-INF/default-plugins

    3.2.3 操作步驟

    1)進入開發者模式

    • 管理者登入維運平台,點選專案,點選「維護>組件管理」。

    • 在組件管理介面下滑到最底部,點選「進入開發者模式>確定」,即可進入開發者模式。

    2)新增掛載目錄

    • 找到工程組件,點選「新增掛載目錄」。

    • 輸入需要掛載出來的webroot下的資料夾,例如temp/attach

    3)自動重啟容器

    • 點選「確定」,出現提示「確定更改並重啟容器?」。

    • 點選「確定」,維運平台會自動對該組件的所有容器進行重啟。

    • 請耐心等待重啟成功,即可外掛成功。例如本範例,維運平台會自動將該專案的WEB-INF/temp/attach資料夾,外掛到/工程掛載目錄/fanruanxxx/bi-web下

    4. 容器級功能

    4.1 變更掛載根目錄

    4.1.1 應用場景

    專案/維運平台掛載目錄,對磁碟空間有一定要求,且隨着專案使用和內容增加,可能會出現磁碟空間不足的情況。

    此時可參考本節方案,將專案/維運平台掛載根目錄,取代到其他大容量磁碟上。

    4.1.2 操作前重要提示

    1)面向專案:

    本功能僅面向維運平台部署的帆軟專案,不支援非維運平台部署的專案。

    配置完成後系統將自動重啟容器。為確定業務連續性,建議選擇業務低峯期或非工作時間執行此操作。

    2)面向組件:

    對於叢集專案,有多個主應用/組件伺服器,此操作不是僅修改該容器的掛載根目錄,也不是修改整個專案涉及的所有組件的掛載根目錄

    修改哪個容器的掛載根目錄配置,即代表修改該容器所在伺服器上,該專案所有組件的根目錄配置

    4.1.3 操作步驟

    本節範例:將專案掛載目錄由/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」

    • 點選「確定」,維運平台會自動對容器進行重啟。

    • 請耐心等待重啟成功,即可修改成功

    4.2 變更埠

    4.2.1 應用場景

    專案部署成功後,如需調整對外曝光埠和組件間通訊埠,可透過本節方案修改

    4.2.2 操作前重要提示

    1)面向專案:

    本功能僅面向維運平台部署的帆軟專案,不支援非維運平台部署的專案。

    配置完成後系統將自動重啟容器。為確定業務連續性,建議選擇業務低峯期或非工作時間執行此操作。

    2)面向組件:

    若專案/維運平台使用了自備的負載均衡,請自行檢查調整轉發策略。

    4.2.3 操作步驟

    1)確定埠可用性

    請確定所準備的埠是否已被使用,如已被使用,請安排好其他閒置埠。

    埠佔用檢查和防火牆放行方法請參考:埠占用檢查與防火牆配置

    2)進入開發者模式

    • 管理者登入維運平台,點選專案,點選「維護>組件管理」。

    • 在組件管理介面下滑到最底部,點選「進入開發者模式>確定」,即可進入開發者模式。

    3)變更埠

    • 找到需要調整的容器,點選「變更埠」。

    • 修改需要調整的主機埠。

    4)自動重啟容器

    點選「確定」,出現提示「確定更改並重啟容器?」

    點選「確定」,維運平台會自動對容器進行重啟。請耐心等待重啟成功,即可修改成功。

    維運平台會自動幫助使用者調整以下內容:

    • 專案的內網關轉發策略會直接跟隨變更

    • 叢集節點間通訊埠的變化會自動相容處理

    • 維運平台與專案之間的對接會自動相容處理

    • 自動重啟容器,新埠配置生效

    4.3 卸載容器

    4.3.1 應用場景

    專案中部分節點伺服器變更,需要對該節點進行清理,管理者可以卸載指定容器,釋放伺服器資源

    4.3.2 操作前重要提示

    1)面向物件:

    • 本功能僅面向維運平台部署的帆軟專案,不支援非維運平台部署的專案。

    • 本功能支援專案中除OPS Agent以外所有容器的單獨卸載。

    2)卸載須知:

    • 本操作將永久刪除伺服器上的該容器及所有聯動資源(資料、配置、儲存等),刪除後所有內容不可恢復

    • 請務必在卸載容器前慎重評估相關影響,帆軟無法對已卸載的容器進行任何恢復操作。

    3)建議操作:

    • 在卸載專案前,強烈建議自行對專案涉及的所有伺服器進行快照備份。快照備份操作步驟請自行諮詢你的伺服器維運人員。

    • 透過快照恢復的專案僅可找回相關資料,不確定專案及對應容器仍然可用。

    4.3.3 操作步驟

    1)進入開發者模式

    • 管理者登入維運平台,點選專案,點選「維護>組件管理」。

    • 在組件管理介面下滑到最底部,點選「進入開發者模式>確定」,即可進入開發者模式。

    2)卸載容器

    • 在開發者模式介面,找到對應容器,點選「卸載容器」。

    • 彈出提示「卸載後此容器和掛載目錄將全部被清理並無法恢復!如確定卸載,請輸入容器名稱:」

    • 手動輸入容器名稱後,點選「確定」,維運平台會自動對該容器和相關資源依次卸載。

    附件列表


    主題: 專案管理
    已經是第一篇
    已經是最後一篇
    • 有幫助
    • 沒幫助
    • 只是瀏覽