ASUSTOR - Website Management

Date:

Topic_id:

Subject:

Description:

content:

<h4>課程目的</h4>
完成此課程後您將能夠：
<ol>
<li>使用 Portainer 來下載所需的 Docker 映像檔。</li>
<li>使用 Portainer 將下載的映像檔部署容器執行。</li>
</ol>
 
<h4>必修項目</h4>
課程必修項目：
無
學生須先具備以下知識：
Docker / 映像檔 (Image) / 容器 (Container)
 
<h4>大綱</h4>
<a href="#dpt1">1. Portainer 簡介</a>
<a href="#dpt11">1.1 安裝 Portainer</a>
<a href="#dpt2">2. 設定本機 Docker</a>
<a href="#dpt3">3. 下載 Docker 映像檔 (Pull Images)</a>
<a href="#dpt31">3.1 在 Docker Hub 上搜尋</a>
<a href="#dpt32">3.2 下載映像檔</a>
<a href="#dpt4">4. 部署 Docker 容器 (Deploy Container)</a>
<a href="#dpt5">5. 遠端連線 NAS 部署的 Container</a>
<a href="#dpt6">6. 升級映像檔並更新 Container</a>
 <hr /> 
<h4><a name="dpt1"></a>1. Portainer 簡介</h4>
Docker 並沒有官方 GUI 介面支援，要使用 Docker 需對 Docker 的指令有一定程度的了解，或參考文件依步驟下載映像檔及完成部署。Portainer 是一個易用且輕量化的 Docker 管理介面，透過 Web 界面的操作，更方便對於 Docker 指令不熟悉的使用者更快進入 Docker 的世界。 Docker Hub 中數千種來自才華洋溢開發者的映象檔，透過 Portainer 即可進行輕鬆佈署，Portainer 擁有人性化界面，不須下指令，僅需下載映像檔即可立刻加入完成佈署，創造 ADM 更多可能性。基於 Docker 的特性，於 Portainer 中可以直接更新映像檔的版本，使用相同的設定，重新佈署並取代原來的 Container 即可完成升級，使用最新版本的功能。
 
<a name="dpt11"></a>1.1 安裝 Portainer
適用機種：AS31、32、40、50、51、52、53、54、61、62、63、64、70、Drivestor (AS11)、Drivestor Pro (AS33)、Drivestor Lite (AS11TL)、Drivestor Gen2 (AS12)、Drivestor Pro Gen2 (AS33 v2)、Lockerstor (AS65/66)、Lockerstor Gen2 (AS67) 、Lockerstor Gen2+ (AS67 v2)、Lockerstor Gen3 (AS68)、Lockerstor Pro (AS71)、Lockerstor Pro Gen2 (AS72)、Flashstor (FS67)、Flashstor Gen2 (FS68)。
 
步驟 1
<ul>
<li>使用網頁瀏覽器並以 Administrators 群組的帳號登入 ADM。</li>
<li>在 ADM 畫面上選擇 [App Central] 。</li>
<li>在 [ASUSTOR Apps] 選擇 [Portainer CE] 後，按下 [安裝]。</li>
</ul>
<img src="https://www.asustor.com/images/kindeditor/image/20210824/20210824014605_56317.png" alt="" width="860" height="497" title="" align="" />
 
步驟 2
<ul>
<li>若 Docker Engine 還未安裝，App Central 會先安裝 Docker Engine，然後再安裝 Portainer CE。</li>
<li>安裝完 Portainer CE 後，在 ADM 畫面上選擇 [Portainer CE] 。</li>
<li>請建立 admin 帳號及密碼。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230320161728_Portainer_init_create_user.png" alt="" width="800" height="594" title="" align="" />
 
<h4><a name="dpt2"></a>2. 設定本機 Docker</h4>
初次執行 Portainer，先設定本機 Docker 環境，即可在 NAS 上使用 Portainer 基本功能。
 
<ul>
<li>於初始畫面中，點選 [Get Started]。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230320161747_Portainer_init_connect_local.png" alt="" width="900" height="624" title="" align="" />
 
<ul>
<li>於左側框架點選 [Environments] 後，選擇 [local]。</li>
<li>於 [Environment details] 頁面中輸入 NAS Public IP，這是 Docker 部署 Container 的 Default IP，點擊 [Update environment]。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230320161825_Portainer_setup_local_env_IP.png" alt="" width="900" height="558" title="" align="" />
 
<h4><a name="dpt3"></a>3. 下載 Docker 映像檔 (Pull Images)</h4>
<a name="dpt31"></a>3.1 在 Docker Hub 上搜尋
Portainer 會使用 Docker Hub 來下載映像檔，因此，需先在 Docker Hub 上搜尋所需映像檔的正確路徑及名稱。相同功能或名稱的映像檔可能會有不同開發者上傳不同版本，輸入正確的路徑及名稱才能下載正確的版本。 範例： [<a target="_blank" href="https://hub.docker.com/" rel="noopener">Docker Hub</a>] 
 
<ul>
<li>於 Docker Hub 搜尋 [wordpress]，較熱門的版本會排在前面，點選所需的項目，進入該 Container 的頁面。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/20211215075234_DockerHub_search_wordpress.png" alt="" width="900" height="513" title="" align="" />
 
<ul>
<li>於 wordpress 頁面，右側會顯示此映像檔的下載指令。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/20211215075307_DockerHub_wordpress_image_path.png" alt="" width="900" height="390" title="" align="" />
 
<a name="dpt32"></a>3.2 下載映像檔
 
<ul>
<li>登入 Portainer 後，點選一個 Environment。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230320162113_Portainer_select_local_env.png" alt="" width="900" height="506" title="" align="" />
 
<ul>
<li>選擇 [Images]。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230320161955_Portainer_home_select_image_page.png" alt="" width="900" height="506" title="" align="" />
 
<ul>
<li>在 [Pull image] 頁面，輸入於 Docker Hub 中的映像檔下載路徑，點選 [Pull the Image]。</li>
<li>Portainer 預設會下載 [latest] 版本的映像檔，使用者可以依 Docker Hub 裡的說明，下載其他 tag 的版本。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230320162145_Portainer_pull_image_s1.png" alt="" width="900" height="506" title="" align="" />
 
 使用者可略過前面在 Docker Hub 中搜尋映像檔的步驟，只需在此頁面輸入映像檔名稱，點擊右側 "search" 鍵，即可在網頁瀏覽器開啟新分頁，顯示 Docker Hub 上的搜尋結果。
<img src="https://www.asustor.com/images/tinymce/upload_img_20231018164139_portainer_pull_image_search.png" alt="" width="900" height="230" title="" align="" />
 
<ul>
<li>下載映像檔所需時間依所需的檔案大小會不同，下載時，此頁面會顯示下載中的狀態。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230320162207_Portainer_pull_image_s2.png" alt="" width="800" height="326" title="" align="" />
 
<ul>
<li>下載完成後，映像檔列表中將會看到該映像檔，還沒有完成部署的映像檔，會標示為 [Unused]。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230320162233_Portainer_pull_image_s3.png" alt="" width="880" height="581" title="" align="" />
 
<h4><a name="dpt4"></a>4. 部署 Docker 容器 (Deploy Container)</h4>
Docker 映像檔下載完成後，即可為該映像檔部署 Docker 容器，容器部署成功後即可使用。
 
<ul>
<li>於 Portainer 左側框架中選擇 [Containers]。</li>
<li>在 [Container list] 頁面，點選 [Add container]。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230320164206_Portainer_deploy_container_s1.png" alt="" width="900" height="506" title="" align="" />
 
<ul>
<li>在 [Create container] 功能頁面，輸入自定義的容器名稱，及所需的映像檔版本。</li>
<li>點選 [Always pull the image]，將會下載指定的版本或最新版本的映像檔。啟用此選項，可略過前面章節下載映像檔的步驟，在此頁輸入映像檔名稱，為了確保映像檔名稱的正確性，請點擊 "Search" 鍵，在 Docker Hub 上搜尋 Docker 映像檔。若沒指定映像檔版本 (tag)，預設將使用 latest 版本。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20231018165533_portainer_add_container_search.png" alt="" width="900" height="409" title="" align="" />
 
若需要在 Docker 容器中設定 Volume，可選擇將 Volume 綁定至 NAS 共用資料夾的子資料夾中，這樣容器的的資料即可保存在 NAS 上，並可從 ADM 的檔案總管存取容器的資料。
<ul>
<li>點擊 [Advanced container settings] [Volumes] [+ map additional volume]。</li>
<li>於 [container] 中，輸入此容器設定的 Volume 完整路徑，選擇 [Bind]。 例如：Wordpress 的主要資料夾 "/var/www/html"</li>
<li>於 [host] 中，輸入 NAS 的資料夾完整路徑，選擇 [Writable] 或 [Read-only]。 例如：NAS 的資料夾 "/volume1/Docker/WordpressDK/data"</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20231018165617_portainer_add_container_bind_volume.png" alt="" width="900" height="464" title="" align="" />
 
 Docker 會將 WordPress 容器中 "/var/www/html" 資料夾中的所有資料綁定至 NAS 的 "/volume1/Docker/WordpressDK/data" 中，即使容器被移除，這些資料仍保存在 NAS 上。
<img src="https://www.asustor.com/images/tinymce/upload_img_20231018165633_wordpress_container_mapped folder_on_NAS.png" alt="" width="900" height="475" title="" align="" />
 
<ul>
<li>建議開啟 [Publish all exposed network ports to random host ports]。</li>
<li>點選 [Deploy the container]。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230320162322_Portainer_deploy_container_s2.png" alt="" width="900" height="591" title="" align="" />
 
<ul>
<li>容器部署成功後，此容器會直接啟動，容器列表 (Container list) 裡會列出此 Docker 環境中所有已部署的容器，使用者可以在此列表中操作不同的容器。</li>
<li>Docker 容器完成部署後，可於容器列表中，點選部署時設定的 Ports，該容器將於瀏覽器新分頁中開啟。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230320162338_Portainer_deploy_container_s3.png" alt="" width="880" height="593" title="" align="" />
 
 以 Wordpress 為例，點選右側的 [Published Ports]，Portainer 將會於瀏覽器新分頁中開啟 Wordpress。 註：如果 IP 為 0.0.0.0，請參考 [ <a href="#dpt2">2. 設定本機 Docker</a> ] 以設定 Public IP。
 
<img src="https://www.asustor.com/images/tinymce/upload_img_20230320162357_Portainer_launch_wordpress.png" alt="" width="800" height="540" title="" align="" />
 
<h4><a name="dpt5"></a>5. 遠端連線 NAS 部署的 Container</h4>
若想遠端連線使用在 ASUSTOR NAS 中部署的 Container，首先您的 ASUSTOR NAS 需先設定可以允許遠端連線，設定方式請參照 [ <a href="https://www.asustor.com/online/College_topic?topic=221" target="_blank" rel="noopener">NAS 221：遠端存取 - EZ-Connect</a> ] 及 [ <a href="https://www.asustor.com/online/College_topic?topic=224" target="_blank" rel="noopener">NAS 224：遠端存取 - 手動連線</a> ]。
 因現行的瀏覽器提高安全連線等級，只允許使用 HTTPS 遠端連線 DDNS 網址的網頁，若自行部署的 Container 暫時沒有支援 HTTPS 連線，或無法匯入使用 ADM 的 HTTPS 憑證，將無法使用 HTTPS 遠端連線此 Container。可以參考 [ <a href="https://www.asustor.com/online/College_topic?topic=325" target="_blank" rel="noopener">NAS 325：設定反向代理伺服器</a> ] 嘗試使用 ADM 反向代理伺服器來設定 Container 的遠端安全連線。
 註：Portainer CE 2.9.2 之後的版本預設使用 HTTPS 連線，並會自動匯入使用 ADM 的憑證。ADM 憑證更新後，若使用 HTTPS 連線 Portainer CE 時會顯示憑證無效或已過期的訊息，請於 App Central 中停用 Portainer CE，再重新啟用即可重新匯入 ADM 憑證。
<img src="https://www.asustor.com/images/tinymce/20211215082051_App_Central_re-enable_portainer.png" alt="" width="800" height="466" title="" align="" />
 
<h4><a name="dpt6"></a>6. 升級映像檔並更新 Container</h4>
當 Docker 映像檔在 Docker Hub 更新版本後，latest 版本也會同時被更新。使用 latest 版本映像檔所部署的 Container，可以使用 Portainer，依下列步驟升級為最新版本的映像檔。
 
<ul>
<li>以 Nextcloud 為例，於左側框架點選 [Containers] 後，選擇 [Nextcloud]。</li>
<li>點選 [Stop] 停止執行中的 Nextcloud。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230320162436_Portainer_update_container_s1.png" alt="" width="900" height="506" title="" align="" />
 
<ul>
<li>點選 Nextcloud 進入 Container details 頁面。</li>
<li>點擊 [Recreate]。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230320162502_Portainer_update_container_s2.png" alt="" width="900" height="497" title="" align="" />
 
<ul>
<li>啟用 [Pull latest image]，點擊 [Recreate]。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230320162520_Portainer_update_container_s3.png" alt="" width="750" height="431" title="" align="" />
 
<ul>
<li>下載映像檔及重新建立 Container 所需時間都不同，更新時，此頁面會顯示如下的狀態。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230320162545_Portainer_update_container_s4.png" alt="" width="800" height="514" title="" align="" />
 
<ul>
<li>部署完成後，於 Container list 頁面中可以看到 Nextcloud 已經使用更新的映像檔重新建立。</li>
<li>點擊 [Start] 以啟動 Container。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230320162617_Portainer_update_container_s5.png" alt="" width="900" height="506" title="" align="" />
 
<ul>
<li>不同 Container 啟動完成所需時間各有不同，請稍候片刻，或點選 [Log] 確認 Container 是否已經更新並成功啟動。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230320162636_Portainer_update_container_log.png" alt="" width="900" height="506" title="" align="" />
 
<ul>
<li>於 [Images] 頁面中，選擇 <img src="https://www.asustor.com/images/tinymce/upload_img_20230320162650_nextcoud_none_image_tag.png" alt="" width="120" height="24" title="" align="" /> 此映像檔，點擊 [Remove] 移除。</li>
</ul>
 註：若無標示為 [none] 的映像檔，表示此映像檔已經是最新版本，無需更新。
<img src="https://www.asustor.com/images/tinymce/upload_img_20230320162722_Portainer_remove_image.png" alt="" width="900" height="506" title="" align="" />

Publish: