安裝 Docker EE UCP v2.x

這裡說明 Internet 是可用的情況進行 Docker EE UCP v2.x 安裝, 若是可以使用 proxy 連接，請先做作業系統關於proxy的設定。

Docker引擎版本：17.06
UCP版本：2.2.4

請先確認合適的Docker引擎已經安裝在主機上。

下載 UCP

$ docker pull docker/ucp:2.2.4

確認 UCP 已經在本地主機上

$ docker image ls | grep ucp

運行如下命令開始安裝：

$ docker container run --rm -it --name ucp \
   -v /var/run/docker.sock:/var/run/docker.sock \
   docker/ucp:2.2.4 install \
     --host-address  --interactive

在這裡：

<host-ip-addr> 是安裝有 Docker 引擎的主機的 IP 地址
--interactive     以互動模式來進行UCP安裝

輸入上述命令之後，會開始下載UCP其他必要的元件，並且以互動模式來進行UCP安裝，過程中會要求輸入 SAN，以及UCP所需的username 以及 password.

安裝好後，開啟瀏覽器（建議用Firefox或Google Chrome）打開網址

https://<host-ip-addr>

之後登入安裝時所設定的 username 以及 password.

載入 license，即可看到UCP dashboard畫面


下面略述在安裝過程中可能遇到的幾個常見問題以及其可能的解決方法：

(1) 如果看到如下 Error 訊息：

FATA[0040] the following required ports are blocked on your host: 12380, 12376, 12384, 12387, 12381, 12382, 12383, 12379, 443, 2376, 12385, 12386. Check your firewall settings

可能原因與解決方法：主要可能是防火牆設定不正確，建議先檢查作業系統防火牆設定

(2) 如果看到如下 Error 訊息：

docker rtp FATA[0005] failed to get new conv client: failed to create ucp client from ucp opts: Couldn't login: Failed to authenticate. Status code: 401

可能原因與解決方法：不正確的 username 或 password

(3) 如果看到如下 Error 訊息：

FATA[0010] failed to choose ucp node: The UCP cluster does not have any available nodes without conflicting with ports '[80, 443]'

可能原因與解決方法：所使用的 controller port 跟系統上別的程式衝突



【參考資料】
https://docs.docker.com/ee/ucp/admin/install/