###### tags: `安裝部署`
# III DevOps 安裝部署常見問題
請先參考[**標準安裝程序說明**](https://github.com/iii-org/deploy-devops/blob/master/README.zh_TW.md)處理

## 安裝前需要準備事項
請先下載 [**III DevOps 安裝環境資訊表**](https://docs.google.com/spreadsheets/d/1nKhCtMyHwmApcKcE9MIgFCkl5QbzHqV75fP5A_nTt40/edit#gid=0) 確認與填寫 (可能需要請網管同仁一起幫忙)

## 安裝的模式說明
### IP 模式(最簡單)
如果不需要給這服務 Domain Name 也可以單純以 IP 模式安裝, 安裝之後的網址會類似以下的樣式:
* Rancher - https://10.20.0.71:31443/
* GitLab - http://10.20.0.71:32080/
* Redmine - http://10.20.0.71:32748/
* Harbor - https://10.20.0.71:32443/
* Sonarqube - http://10.20.0.71:31910/
* III-DevOps - http://10.20.0.71:30775

### DNS 模式(會和網路有關)
需要有自己的 Domain Name Server 可以指定網址, 就可以使用 DNS 模式安裝, 安裝之後的網址會類似以下的樣式:
* Rancher - https://rancher-devops.iiidevops.org
* GitLab - http://gitlab-devops.iiidevops.org
* Redmine - http://redmine-devops.iiidevops.org
* Harbor - https://harbor-devops.iiidevops.org
* Sonarqube - http://sonarqube-devops.iiidevops.org
* III-DevOps - http://devops.iiidevops.org

### DNS + SSL 憑證模式(比較複雜)
除有自己的 Domain Name Server 外, 也能產生出這 Domain Name 的合法 SSL 憑證, 這樣就可以所有網址都能提供 https 加密服務
SSL 憑證需要包含 fullchain.pem 與 privkey.pem 兩個檔案

* Rancher - https://rancher-devops.iiidevops.org
* GitLab - https://gitlab-devops.iiidevops.org
* Redmine - https://redmine-devops.iiidevops.org
* Harbor - https://harbor-devops.iiidevops.org
* Sonarqube - https://sonarqube-devops.iiidevops.org
* III-DevOps - https://devops.iiidevops.org

# 進階技術處理資訊
> **修改錯誤可能會造成整體系統異常無法簡單修復, 請務必小心執行**
## 手動更新 deploy-devops
讓部署安裝的 perl script 可以保持最新版本

 ~/deploy-devops/bin/update-perl.pl

如果更新正確會出現類似以下的訊息

:
  inflating: deploy-devops-master/sonarqube/sonarqube/sonar-server-ingress.yaml.tmpl
  inflating: deploy-devops-master/sonarqube/sonarqube/sonar-server-service.yaml
env.pl file link is automatically created ..OK!
env.pl.ans file link is automatically created ..OK!
==process complete==

## 手動修改 env 設定參數後的程序
**參數設定錯誤很可能造成系統無法正確運作, 除非你了解修改後會對哪些 script 進行影響, 否則強烈建議不要自行修改**

vi ~/deploy-devops/env.pl.ans

修改後可以透過 convert 進行轉換成 env.pl 內容

~/deploy-devops/bin/generate_env.pl convert

原有的 env.pl 會備份為 env.pl.bak 並呈現修改差異處

## ISO 光碟安裝後系統升級處理程序
**這過程會進行一些之前 ISO 光碟內所安裝部署版本的系統功能升級或修復，系統服務會在升級過程進行重新啟動，升級前強烈建議要先進行整理系統快照或備份作業，並在離峰時間執行。**

~/deploy-devops/bin/upgrade-iiidevops.pl