oosVersion 2.1

新增 Container 範本

詳細說明如何在 OOS 設定 Container 範本、外接硬碟掛載、匯入範本、Container Registry 以及 Network Endpoint。

當 App Store 沒有您需要的容器範本時,可在此建立或匯入。Container(容器) 將程式與所需環境包裝在一起;本頁使用 Docker 容器。範本保存安裝設定,建立後還需到 App Store 安裝,才會建立可操作的應用程式。

開始前先確認

請向應用程式提供者取得映像檔名稱、版本標籤、資源需求,以及所需的環境變數、連接埠、儲存路徑與裝置設定。不需要的選用項目不必自行猜值。

  • Container Registry:存放容器映像檔的來源;映像檔是用來建立容器的程式與環境檔案。若所需來源尚未設定,先依下方「新增 Container Registry」操作。
  • Image Tag:用來指定映像檔版本的標籤,既有預設為 latest;請依應用程式需求確認要用的標籤。
  • Network Endpoint:容器使用的網路連線設定。先確認容器需要連到哪裡、允許誰連入,再選擇模式;各模式的限制見下方欄位說明。

新增 Container 範本

  1. 前往 Application > Template > Container 頁面。
  2. 點擊 Add Template 圖示。

Container 範本列表與新增按鈕

  1. 輸入 App Name(應用程式名稱)。
  2. 選擇 Container Registry。
  3. 輸入 Image Name(容器映像檔名稱)。
  4. 輸入 Image Tag(標籤,預設為 latest)。
  5. 選擇 Network Endpoint。
  6. 選擇 Resource Limitation(資源限制)。
  7. 依應用程式需求設定 Environment Variable(環境變數,即傳給程式的設定名稱與值)。
  8. 點擊 Upload App Icon 上傳應用程式圖示。
  9. 輸入 App Description(應用程式簡述)。
  10. (視需要)設定 Port Binding(連接埠對映):根據 Docker 需求新增單一連接埠或範圍,將設備對外的服務入口對應到容器內部的連接埠。
  11. (視需要)設定 Volumes(儲存區):依 Docker 需求新增用來保存容器資料的儲存路徑。
  12. (視需要)設定 Labels(識別標籤):依 Docker 需求新增名稱與值,供識別及管理。
  13. (視需要)設定 Commands(啟動指令):依 Docker 需求填入容器內要執行的指令。
  14. (視需要)設定 Devices(裝置對映):依 Docker 需求選擇容器要使用的硬體裝置。

新增 Container 範本詳細設定畫面

注意:「Device」會列出 /dev(系統的裝置路徑)下的所有裝置,包含 USB 與序列埠(serial ports)。請依應用程式需求選用要掛載的裝置。

附圖服務區塊另有 Service Name 欄位,用來識別該服務;請依要建立的服務填寫。

  1. 若需使用 Docker Compose(以一組設定管理多個容器服務的方式),可新增更多服務,並重複步驟 5 至 16 設定各服務。
  2. 點擊 Apply 按鈕。
  3. 到 Application > App Store 確認新範本已出現,再依安裝應用程式安裝。

容器改用外接 USB 硬碟

需要改用外接硬碟儲存時,先確認目標磁碟,再完成裝置對映與手動掛載。掛載是將磁碟接到容器內可存取的路徑;Console 是輸入文字指令的終端機。

  1. 選擇外接硬碟。
  2. 點擊 Apply。

外接 USB 磁碟對映與掛載設定

  1. 前往 Application > Information > Container > Action > Console,透過命令列手動掛載該磁碟。

本頁沒有提供適用所有磁碟的掛載指令。若不熟悉命令列,請先向管理員確認磁碟、目標路徑與指令,不要猜測執行。完成後,確認容器能在預定路徑存取該磁碟;只選取磁碟並套用,尚未完成上述手動掛載步驟。


匯入既有範本 (Import Template)

已有 App Template 檔案時,可使用匯入功能;請先準備範本檔案、名稱、描述與圖示。

  1. 前往 Application > Template > Container > Import Template。
  2. 輸入 App Name。
  3. 輸入 App Description。
  4. 選擇並瀏覽 App Template 檔案。
  5. 上傳 App Icon。
  6. 點擊 Apply 按鈕。

匯入 Container 範本頁面

匯入後,到 App Store 確認範本名稱與描述,再進行安裝。


新增 Container Registry

要使用尚未登錄的映像檔來源時,先準備 Registry 的伺服器位址;若該來源要求登入,也需取得帳號與密碼或 Token(存取憑證)。

  1. 前往 Application > Template > Container > Registry。
  2. 點擊 Add 按鈕新增 Container Registry。

新增 Container Registry 設定頁面

  1. 輸入 Registry Name。
  2. 輸入 Server Address(伺服器位址,必填)。Enable insecure HTTP access 是另外的選用開關;只有確認該來源需要使用未加密的 HTTP 存取時才開啟,不要將它當成填寫伺服器位址的必要步驟。
  3. (視需要)輸入 User Name 與 Password/Token。
  4. 點擊 Apply 按鈕。

Container Registry 伺服器資訊輸入

儲存後,回到範本設定,確認 Container Registry 可選到新增的來源,並在安裝時確認映像檔能取得。


新增網路端點 (Network Endpoint)

需要自訂容器網路設定時使用。Network Driver 是建立容器網路的方式;其選項請依網路規劃或管理員提供的設定填寫,不要自行猜測。

  1. 前往 Application > Template > Container > Network Endpoint。
  2. 點擊 Add 按鈕新增 Network Endpoint。
  3. 輸入 Network Name。
  4. 選擇 Network Driver。
  5. 新增 Network Driver 選項。
  6. 點擊 Apply 按鈕。

新增網路端點 Network Endpoint 設定

儲存後,回到範本的 Network Endpoint 確認可選到新項目;安裝後再測試實際需要的連線與限制。


範本設定欄位說明

項目 (Item)描述 (Description)
App Name定義應用程式名稱,名稱不可重複。
Container Registry存放各種 Docker 映像檔的倉庫,分為公開 (如 Docker Hub) 或私有 Registry。
Image Name要使用的 Docker 映像檔名稱;映像檔是建立容器所用的唯讀檔案。請依提供者的名稱填寫。
Image Tag協助開發與管理員組織容器映像檔,預設為 latest。
Network Endpoint選擇容器網路設定;各模式與存取選項見下表。
Resource Limitation容器可使用的 CPU(運算資源)與記憶體上限。規格:Low(0.2 CPU 核心 + 128 MB 記憶體);Medium(0.5 CPU 核心 + 512 MB 記憶體);High(2 CPU 核心 + 2 GB 記憶體)。說明:若選擇 Low 但 Docker 運作需要 High 資源,程式將無法運行,需調整資源限制設定。
Environment Variable以名稱與值傳入容器的設定,可包含應用程式或使用者參數;請依應用程式要求填寫。
Port Binding根據 Docker 需求,選擇 TCP/UDP 通訊協定並輸入對外 (Public) 與對內 (Private) 連接埠。對外連接埠設為 0 表示使用隨機連接埠。
Volumes掛載於 Docker 容器上的檔案系統,用於持久化保存容器運行時產生的資料。
LabelsKey/Value(名稱/值)形式的中繼資料,即附加的識別資訊,供分類與管理使用。
Commands在容器內部執行的指令,用於在容器運行時啟動應用程式或執行任務。
Upload App Icon上傳圖示圖片後,將顯示於 App Store 頁面上。
App Description簡要描述此應用程式的功能。

網路模式與存取選項

Bridge(橋接) 是此處預設的容器網路模式;Host(主機) 模式僅供下列指定容器使用。請保留應用程式所需的連線,同時核對允許的存取範圍。

模式或選項用途與限制
Host僅限 Wireshark 或 IPsec 容器;其餘預設為 Bridge,且無法切換為 Host。
Bridge預設網路模式。
Network-restriction(bridge)帶有存取規則的 Bridge 模式,依下列選項管理存取。
Allow Internet Access (Select Egress WAN)允許連線至網際網路,並選擇對外使用的 WAN(外部網路)出口。若容器有登入連接埠,其頁面存取受限,並透過 Port Mapping(連接埠對映)頁面管理。
Allow Controller Access允許 Controller 存取容器。
Allow LAN IP/24 Access限制僅允許指定 /24 網段內的 LAN(區域網路)裝置存取。
Allow WAN IP Access限制僅允許指定 WAN IP 位址存取。
None不套用任何網路限制;請先確認符合您的存取需求。