1. 概述
2. 容器工具啟動失敗
2.1 finekey is already running
報錯語句：finekey is already running
原因分析：finekey工具正在運作，需要關閉工具佔用的進程，方可重啟。
解決方案：透過語句ps -ef|grep finekey，查看相關的進程號，kill -9 進程號 即可。
2.2 disk availlable capacity:xxx, less then 500G
報錯語句：ERROR: 2022/05/18 17:08:36 node 192.168.1.24 disk availlable capacity:3789952, less then 500G
原因分析：安裝時會自動檢查finekey.yaml檔案中配置的掛載卷目錄所在磁碟分割槽閒置空間要≥500G，預設~/data代表的目錄是/root/data。
解決方案：這是容器化部署的前提，必須滿足。請聯絡相關維運人員對伺服器進行擴容。
2.3 memory avillable capacity: xxx, less then 16G
報錯語句：ERROR: 2022/04/20 14:12:55 node 192.168.101.144 memory avillable capacity: 7302952, less then 16G
原因分析：伺服器記憶體容量不足
解決方案：這是容器化部署的前提，必須滿足。請聯絡相關維運人員對伺服器進行擴容。
2.4 connection refused
報錯語句：ERROR: 2022/05/18 17:33:07 finedb connect error:dial tcp 192.168.1.24:3306: connect: connection refused
原因分析：finekey.yaml檔案中配置的相關埠，沒有開放，無法連結。
解決方案：請檢查伺服器相關埠的防火牆、安全組等設定是否開放。
2.5 finedb connect error
報錯語句：
ERROR: 2022/06/23 16:51:52 finedb connect error:dial tcp 192.168.1.44:3306: connect: connection refused
ERROR: 2022/06/23 16:52:14 deployment fail, please check error log info and fix it! bye~
原因分析：
mysql容器啟動後，會嘗試連結，連續10次都沒連結上就會認為mysql有問題，開始回滾。
一般都是由於效能太差，導致MySQL啟動過慢。
解決方案：
請將伺服器環境升級滿足部署需求。伺服器部署環境請參考：容器化部署
3. finekey.yaml檔案配置錯誤
3.1 mapping values are not allowed in this context
報錯語句：ERROR: 2022/04/20 13:56:28 parse config file /Users/carly/finekey/conf/finekey.yaml error: yaml: line 14: mapping values are not allowed in this context
報錯原因：yaml 檔案對格式的要求非常高，出現該錯誤，大概率都是由於內容格式存在錯誤。
解決方案：根據報錯提示中的 line 號修改配置檔案格式。
3.2 address already in use
報錯語句：ERROR: 2022/05/18 17:15:23 192.168.1.24 :try bind port error:listen tcp :12100: bind: address already in use
原因分析：埠衝突，已有的組件佔用了預設埠。
解決方案：
1）埠確實衝突：開啟安裝目錄下 conf 資料夾裏的 finekey.yaml檔案，找到對應組件，修改portMapping中映射埠，儲存跳出後重新運作即可。
2）埠沒有衝突：仔細排查安裝目錄下 conf 資料夾裏的 finekey.yaml檔案，是否是finekey.yaml中各處字元格式不對，比如漏加空格或用了中文符號等。
3.3 can't use localhost
報錯語句：ERROR: 2022/04/20 13:58:14 can't use localhost，127.0.0.1 etc as node.ip in cluster mode.. must ensure ensure IP connectivity of all nodes
報錯原因：叢集下不能使用 localhost 等迴環地址作為 IP
解決方案：修改 IP 為其他節點都能存取的真實 IP
3.4 add user to docker group error
報錯語句：add user to docker group error：sudo：1次錯誤密碼嘗試
解決方案：
1）確定finekey.yaml檔案配置的ssh使用者和運作finekey的使用者保持一致
2）檢查finekey.yaml檔案中配置ssh帳號密碼是否正確
3）遠端連結工具問題，關閉重啟遠端工具並再次嘗試
3.5 ssh connect error
報錯語句：ERROR: 2022/04/20 13:58:14 node:192.168.101.144 ssh connect error:ssh: handshake failed: ssh: unable to authenticate, attempted methods
報錯原因：SSH 連結失敗，通常報錯明細中出現 unable to authenticate 則代表密碼有問題；出現 Connection refused 則代表網路不通等可能
解決方案：
1）確定finekey.yaml檔案配置的ssh使用者和運作finekey的使用者保持一致
2）檢查finekey.yaml檔案中配置ssh帳號密碼是否正確
3）遠端連結工具問題，關閉重啟遠端工具並再次嘗試
