使用 Argo CD 探索 GitOps,你學(xué)會了嗎?
Argo CD 是一個用于 Kubernetes 的聲明式 GitOps 持續(xù)交付工具。
管理 Kubernetes 集群的復(fù)雜性可能是一項艱巨的任務(wù),尤其是在跨多個環(huán)境部署和同步應(yīng)用程序時。為了研究如何更好地應(yīng)對此類挑戰(zhàn),我決定研究流行的 GitOps 持續(xù)交付工具 Argo CD。Argo CD 是一款開源 GitOps 持續(xù)交付工具,可為 Kubernetes 集群管理帶來便利性和自動化。借助此工具,工程師可以利用 GitOps 的強大功能,以聲明方式定義 Git 存儲庫中 Kubernetes 集群的所需狀態(tài),從而實現(xiàn)高效、自動化的應(yīng)用程序部署。
讓我們通過回顧 Argo CD 在自己的項目文檔中的解釋來開始這篇文章。
https://argoproj.github.io/
Argo CD 被實現(xiàn)為 Kubernetes 控制器,它持續(xù)監(jiān)控正在運行的應(yīng)用程序并將當(dāng)前的實時狀態(tài)與所需的目標(biāo)狀態(tài)進行比較。Argo CD 報告并可視化差異,同時提供自動或手動將實時狀態(tài)同步回所需目標(biāo)狀態(tài)的方法。對 Git 存儲庫中所需目標(biāo)狀態(tài)所做的任何修改都可以自動應(yīng)用并反映在指定的目標(biāo)環(huán)境中。
換句話說,Argo CD 是 Kubernetes 的聲明式 GitOps 持續(xù)交付工具。讓我們更深入地了解這實際上意味著什么。
GitOps 是一種軟件開發(fā)和交付流程,強調(diào)使用 Git 存儲庫作為定義系統(tǒng)所需狀態(tài)(例如云基礎(chǔ)設(shè)施或軟件應(yīng)用程序)的事實來源。在這個持續(xù)交付過程中,整個交付流程(從代碼提交到部署)都是使用 Git 實現(xiàn)自動化和版本控制的。系統(tǒng)的所需狀態(tài)(包括基礎(chǔ)設(shè)施、配置和/或應(yīng)用程序源)被定義為代碼并捕獲為存儲庫中的提交。一旦提交,聲明的系統(tǒng)狀態(tài)可以使用 GitOps 部署工具與系統(tǒng)實時持續(xù)同步。其結(jié)果是一個可靠的持續(xù)交付流程,使 DevOps 團隊能夠以自動化和可審核的方式快速、自信地部署代碼更改。
Argo CD 是一個基于 GitOps 的持續(xù)交付工具,在同步系統(tǒng)狀態(tài)時采用“pull”模式?!皃ull”模式是目標(biāo)環(huán)境從源代碼控制存儲庫“pull”最新提交并根據(jù)聲明的系統(tǒng)狀態(tài)自動更新自身。這與“push”模式相反,“push”模式將更改從開發(fā)環(huán)境推送到目標(biāo)環(huán)境。
持續(xù)交付的“pull”模型如下所示:
圖片
這里的意義在于,“push”模式要求交付機制提供對目標(biāo)環(huán)境的入站網(wǎng)絡(luò)訪問,而“pull”模式僅需要出站網(wǎng)絡(luò)訪問。出站連接被認(rèn)為風(fēng)險較小,因為內(nèi)部網(wǎng)絡(luò)通常通過對發(fā)起網(wǎng)絡(luò)通信的受信任實體授予最小權(quán)限的訪問控制來保護自身。入站連接會帶來更大的安全風(fēng)險,因為它們源自外部、不受信任的網(wǎng)絡(luò),并且可能包含惡意流量。
在更高層面上,Argo CD 部署過程按以下方式工作:
- 開發(fā)人員向受監(jiān)控的 Git 存儲庫進行提交。
- Argo CD 識別提交,克隆存儲庫,將當(dāng)前系統(tǒng)狀態(tài)與提交中聲明的系統(tǒng)狀態(tài)進行比較,然后將所需的更改應(yīng)用于集群的配置。
- Kubernetes 會將應(yīng)用清單中包含的配置與當(dāng)前資源進行協(xié)調(diào),并進行所需的更改以實現(xiàn)所需的集群狀態(tài)。
- Argo CD 將持續(xù)監(jiān)控當(dāng)前狀態(tài)與受監(jiān)控存儲庫中聲明的狀態(tài)的同步狀態(tài)。
請注意,此工作流程總結(jié)遺漏了通常執(zhí)行持續(xù)集成的重要步驟。持續(xù)集成流程用于自動構(gòu)建和測試應(yīng)用程序代碼,以確保在生產(chǎn)部署之前滿足要求和標(biāo)準(zhǔn)。除了這個簡單的定義之外,我將在另一個時間點對此主題進行更深入的討論。
讓我們繼續(xù)快速瀏覽一下構(gòu)成 Argo CD 架構(gòu)的三個主要組件。
API 和Web服務(wù)器
API 服務(wù)器是一個 gRPC/REST 服務(wù)器,它公開 Web UI、CLI 和 CI/CD 系統(tǒng)使用的 API。
存儲庫服務(wù)器
存儲庫服務(wù)器是一項內(nèi)部服務(wù),用于維護保存應(yīng)用程序清單的 Git 存儲庫的本地緩存。它負(fù)責(zé)生成和返回 Kubernetes 清單。
應(yīng)用控制器
應(yīng)用控制器是一個 Kubernetes 控制器,它持續(xù)監(jiān)視正在運行的應(yīng)用程序,并將當(dāng)前的實時狀態(tài)與所需的目標(biāo)狀態(tài)(如存儲庫中指定的)進行比較。它檢測偏離聲明配置的應(yīng)用程序狀態(tài),并可以選擇采取糾正措施。它負(fù)責(zé)為生命周期事件(PreSync、Sync、PostSync)調(diào)用任何用戶定義的鉤子。
圖片
Argo CD 支持以下聲明格式:
- Helm Charts
- Jsonnet Documents
- Kubernetes Manifests
- Kustomize Templates
我們將在本文中使用標(biāo)準(zhǔn) Kubernetes Manifests。你將看到 Argo CD 文檔將這些源作為“字典”。
現(xiàn)在我們已經(jīng)了解了 Argo CD 是什么、它提供的價值以及它的構(gòu)建方式,讓我們開始安裝它,以便更好地了解它如何用于管理 Kubernetes 工作負(fù)載。
本演練的先決條件如下:
- 對 Kubernetes 的集群提升訪問權(quán)限
- Git 存儲庫
- kubectl 命令行工具
我們將從安裝“argocd”命令行工具開始。執(zhí)行以下 CLI 命令來完成此操作
curl -L 'https://github.com/argoproj/argo-cd/releases/download/v2.5.8/argocd-linux-amd64' > /usr/local/sbin/argocd
chmod 0755 /usr/local/sbin/argocd
我們現(xiàn)在需要創(chuàng)建一個命名空間供 Argo CD 在其中運行。執(zhí)行以下 CLI 命令來完成此操作。
kubectl create namespace argocd
接下來,我們將下載安裝manifests并將其應(yīng)用到我們的 Kubernetes 集群。
curl -L 'https://raw.githubusercontent.com/argoproj/argo-cd/v2.6.0/manifests/ha/install.yaml' > argocd-ha-install.yaml
kubectl apply -n argocd -f argocd-ha-install.yaml
請注意,這是高可用安裝類型。如果你的系統(tǒng)資源不足,你可以使用非 HA 版本。只需使用以下一組 CLI 命令即可。
curl -L 'https://raw.githubusercontent.com/argoproj/argo-cd/v2.6.0/manifests/install.yaml' > argocd-install.yaml
kubectl apply -n argocd -f argocd-install.yaml
安裝過程完成后,你需要獲取管理員密碼。執(zhí)行以下 CLI 命令來完成此操作。
kubectl get secrets argocd-initial-admin-secret -n argocd -o json | jq -rM '.data.password' | base64 -d
這是一個高度敏感的信息。將此信息存儲在安全的地方。尤其是在生產(chǎn)系統(tǒng)中工作時。
有了這些信息,我們現(xiàn)在可以使用 Web 瀏覽器連接到 UI。但首先,讓我們將內(nèi)部 Argo CD 服務(wù)端口轉(zhuǎn)發(fā)到外部地址。執(zhí)行以下 CLI 命令來完成此操作。
kubectl port-forward svc/argocd-server -n argocd 8443:443 --address='0.0.0.0'
這里需要注意的一個重要警告是,我在我的家庭實驗室網(wǎng)絡(luò)中運行的裸機 Kubernetes 集群中工作,并且不擔(dān)心有威脅的訪問者訪問這個開放端口。如果你的集群暴露在互聯(lián)網(wǎng)上,我強烈建議你采取必要的預(yù)防措施。此配置超出了本文章的范圍,因此,你將承擔(dān)保護集群訪問的責(zé)任。
我運行此命令的服務(wù)器的 IP 地址恰好是 192.168.0.161。這讓我訪問以下 URL 來訪問 Argo CD Web 界面:
https://192.168.0.161:8443
使用“admin”作為用戶名和我們之前檢索到的密碼登錄后,你應(yīng)該看到類似以下內(nèi)容:
圖片
現(xiàn)在讓我們使用 Argo CD 命令行工具登錄。執(zhí)行以下命令來完成此操作:
argocd login 192.168.0.161:8443
同樣,192.168.0.161 是我的網(wǎng)絡(luò)中的 IP 地址。這會和你的不一樣。
你可以使用以下 CLI 命令更改管理員密碼。如果在生產(chǎn)環(huán)境中工作,這樣做可能是個好主意。
argocd account update-password
在這里,我們在與Argo CD 和 Kubernetes 集群交互時將主要使用 CLI。讓我們繼續(xù)創(chuàng)建我們的第一個 Argo CD 應(yīng)用程序。我們將通過執(zhí)行以下 CLI 命令來完成此操作。
argocd app create foo-app --repo https://github.com/trek10inc/exploring-gitops-with-argo --path part1/app1 --dest-server https://kubernetes.default.svc --dest-namespace default
請注意,此命令使用公共存儲庫創(chuàng)建應(yīng)用程序。使用私有存儲庫創(chuàng)建應(yīng)用程序超出了本文章的范圍。你可以通過以下鏈接閱讀有關(guān)如何完成此操作的更多信息:
https://argo-cd.readthedocs.io/en/stable/user-guide/private-repositories/
此外,還要注意 CLI 命令中提供的“路徑”屬性。這就是告訴 Argo CD 在哪里尋找 Kubernetes 清單的信息。此屬性允許你在單個存儲庫中存儲多個應(yīng)用程序。
命令執(zhí)行完成后,我們將使用以下 CLI 命令列出新創(chuàng)建的 Argo CD 應(yīng)用程序:
argocd app get foo-app
你應(yīng)該看到類似以下內(nèi)容:
Name: argocd/foo-app
Project: default
Server: https://kubernetes.default.svc
Namespace: default
URL: https://192.168.0.161:8443/applications/foo-app
Repo: https://github.com/trek10inc/exploring-gitops-with-argo
Target:
Path: part1/app1
SyncWindow: Sync Allowed
Sync Policy: <none>
Sync Status: OutOfSync from (37b85c8)
Health Status: Missing
GROUP KIND NAMESPACE NAME STATUS HEALTH HOOK MESSAGE
Service default foo-svc OutOfSync Missing
apps Deployment default foo-app OutOfSync Missing
記下“Service”和“Deployment”資源的“OutOfSync”狀態(tài)。應(yīng)用程序狀態(tài)最初處于“OutOfSync”狀態(tài),因為應(yīng)用程序尚未部署,這意味著尚未創(chuàng)建 Kubernetes 資源。
要同步(部署)應(yīng)用程序,請執(zhí)行以下 CLI 命令:
argocd app sync foo-app
使用此命令,Argo CD 將從受監(jiān)控的存儲庫檢索最新提交,并使用其包含的清單執(zhí)行“kubectl apply”。
“foo-app”應(yīng)用程序現(xiàn)在應(yīng)該正在運行中。你可以查看其資源組件、日志、歷史記錄和評估的健康狀態(tài)。
argocd app get foo-app
Name: argocd/foo-app
Project: default
Server: https://kubernetes.default.svc
Namespace: default
URL: https://192.168.0.161:8443/applications/foo-app
Repo: https://github.com/trek10inc/exploring-gitops-with-argo
Target:
Path: part1/app1
SyncWindow: Sync Allowed
Sync Policy: <none>
Sync Status: Synced to (37b85c8)
Health Status: Healthy
GROUP KIND NAMESPACE NAME STATUS HEALTH HOOK MESSAGE
Service default foo-svc Synced Healthy service/foo-svc created
apps Deployment default foo-app Synced Healthy deployment.apps/foo-app created
—------
argocd app logs foo-app
waiting 0
Starting application server
Web server is running on port 80
waiting 0
Starting application server
Web server is running on port 80
waiting 0
Starting application server
Web server is running on port 80
—--
argocd app history foo-app
ID DATE REVISION
0 2023-02-08 15:15:33 -0700 MST (37b85c8)
請注意,Argo CD 不會自動部署我們應(yīng)用程序的最新提交版本。我們必須手動將本地系統(tǒng)狀態(tài)與存儲在存儲庫中的遠(yuǎn)程聲明同步。由于利用 Argo CD 的全部目的是自動化部署過程,因此我們希望啟用 Argo CD 所謂的“自動同步策略”。
當(dāng) Argo CD 檢測到 Git 中所需的清單與集群中的實時狀態(tài)之間的差異時,它能夠自動同步應(yīng)用程序。
使用以下 CLI 命令啟用我們的應(yīng)用程序的自動同步:
argocd app set foo-app --sync-policy automated
你可以通過以下 URL 了解有關(guān)同步策略可以利用的附加功能的更多信息。
https://argocd.readthedocs.io/en/stable/user-guide/auto\_sync/
https://argocd.readthedocs.io/en/stable/user-guide/sync-options/
現(xiàn)在讓我們訪問我們通過部署“foo-app”應(yīng)用程序創(chuàng)建的 NodePort 服務(wù)上運行的 Web 服務(wù)器。我們首先需要找到集群節(jié)點的 IP 地址以及“foo-svc”服務(wù)正在偵聽的端口。
你可以通過以下 CLI 命令獲取集群節(jié)點的 IP 地址:
kubectl get nodes -o json | jq -rM '.items[].status.addresses[] | select(.type == "InternalIP") | .address' | tee /tmp/nodes.txt
你可以通過以下 CLI 命令獲取“foo-svc”服務(wù)正在偵聽的端口:
kubectl get svc foo-svc -o json | jq -rM '.spec.ports[].nodePort' | tee /tmp/port.txt
有了這些信息,我們將向每個集群節(jié)點上的服務(wù)的頂端路由發(fā)出請求,以驗證我們的應(yīng)用程序是否正常運行。執(zhí)行以下 CLI 命令來完成此操作。
PORT=$(cat /tmp/port.txt)
cat /tmp/nodes.txt | while read IP; do curl http://${IP}:${PORT}; done
你應(yīng)該看到以下輸出:
{ "version": "1.0.0" }
{ "version": "1.0.0" }
{ "version": "1.0.0" }
{ "version": "1.0.0" }
現(xiàn)在,我們將更改存儲庫中的清單之一,通過對“part1/app1/deployment.yaml”進行輕微編輯來強制更改系統(tǒng)狀態(tài)。這是通過編輯“CONTENT”環(huán)境變量使其讀取“1.0.1”然后提交更改來完成的。
name: foo-app
env:
- name: CONTENT
value: '{ "version": "1.0.1" }'
短暫等待后,我們將看到我們的應(yīng)用程序已自動更新。請注意,默認(rèn)同步間隔設(shè)置為 3 分鐘。
使用以下 CLI 命令查看“foo-app”應(yīng)用程序的運行狀況和同步狀態(tài)。
argocd app get foo-app | grep Status
你應(yīng)該看到類似以下內(nèi)容:
Sync Status: Synced to (5c8fe96)
Health Status: Healthy
使用以下 CLI 命令查看“foo-app”應(yīng)用程序的歷史記錄。
argocd app history foo-app
這應(yīng)該會產(chǎn)生如下所示的結(jié)果。提交 ID 將不同。
ID DATE REVISION
0 2023-02-08 15:15:33 -0700 MST (37b85c8)
1 2023-02-08 15:19:25 -0700 MST (5c8fe96)
我們還可以在 Web UI 中查看“foo-app”應(yīng)用程序的漂亮的圖形展示。請注意健康同步狀態(tài)、修訂號和副本集。
圖片
知道應(yīng)用程序已成功同步后,讓我們再次向每個集群節(jié)點上的“foo-svc”服務(wù)發(fā)出請求。我們將重用之前的命令。
PORT=$(cat /tmp/port.txt)
cat /tmp/nodes.txt | while read IP; do curl http://${IP}:${PORT}; done
這次我們應(yīng)該看到以下內(nèi)容。
{ "version": "1.0.1" }
{ "version": "1.0.1" }
{ "version": "1.0.1" }
{ "version": "1.0.1" }
至此,我們使用稱之為 Argo CD 的持續(xù)交付工具成功且安全地自動化了應(yīng)用程序的部署!恭喜!
你可以通過執(zhí)行以下 CLI 命令來刪除 Argo CD 應(yīng)用程序及其生成的所有資源。
argocd app delete foo-app
Argo CD 是一個強大的持續(xù)交付解決方案,其功能遠(yuǎn)遠(yuǎn)超出了本文章中強調(diào)的功能。如果你覺得這篇文章很有趣并且打算在生產(chǎn)環(huán)境中使用 Argo CD,我強烈建議你訪問以下鏈接以了解有關(guān)該工具豐富功能集的更多信息。
https://argocd.readthedocs.io/en/stable/
當(dāng)你這樣做時,查看他們的安全文檔會對你更有幫助!
https://github.com/argoproj/argo-cd/blob/master/docs/operator-manual/security.md
如有相關(guān)問題,請在文章后面給小編留言,小編安排作者第一時間和您聯(lián)系,為您答疑解惑。
原文鏈接:
https://www.trek10.com/blog/exploring-gitops-with-argo-cd