文章 標籤 分類 系列 作品 文件 關於

ArgoCD 安裝筆記

YuChia Wei   收錄於 ArgoCD
     約 2369 字  預計閱讀 5 分鐘 

Argo CD 安裝的紀錄

警告
新版安裝資料待整理，本文版本為 ver 2.2.1

ArgoCD Install Memo

信息
Kubernetes with Istio 的環境下建議參照 kustomization install 的方式進行安裝

  1. download install yaml (option)

    • 指定版本
      1

       curl -sSL https://raw.githubusercontent.com/argoproj/argo-cd/v2.2.1/manifests/install.yaml -o install-2.2.1.yaml
    • 最新版本
      1

       curl -sSL https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml -o install-latest.yaml

  2. 建立 namespace

    • 純建立
      1

      kubectl create namespace argocd
    • 含設定 istio 掛車
      1
2

      kubectl create namespace argocd
kubectl label namespace argocd istio-injection=enabled --overwrite

  3. Install to K8s

    • 使用下載版 (指定版本)
      1

      kubectl apply -n argocd -f install-2.2.1.yaml
    • 使用下載版 (最新版本)
      1

      kubectl apply -n argocd -f install-latest.yaml
    • 使用線上指定版
      1

      kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/v2.2.1/manifests/install.yaml
    • 使用線上最新版
      1

      kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml

  4. Install Argo Cli (option)

    1
2

    curl -sSL -o /usr/local/bin/argocd https://github.com/argoproj/argo-cd/releases/latest/download/argocd-linux-amd64
chmod +x /usr/local/bin/argocd

  5. Fix Https Problam

    Reference

    • 編輯發布設定
      1

      kubectl edit deploy argocd-server -n argocd
    • 找到 spec.containers.command 區段並加入以下內容
       1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

      spec:
  containers:
    - name: argocd-server
      command:
        - argocd-server
        # 加入以下五行，使用 http 連線
        - --staticassets
        - /shared/app
        - --repo-server
        - argocd-repo-server:8081
        - --insecure
    • 重新佈署
      1

      kubectl rollout restart deploy -n argocd

Official Argo CD Helm Readme

重要：安裝時設定 server.extraArgs={–insecure} 來避開 TLS 憑證，如果要使用 TLS 憑證的話要多一些憑證設定，這邊先略過

1
2
3
4
5

helm repo add argo https://argoproj.github.io/argo-helm
helm install argocd argo/argo-cd -n argocd
kubectl create namespace argocd
kubectl label namespace argocd istio-injection=enabled --overwrite
helm install argocd argo/argo-cd -n argocd --set server.extraArgs={--insecure}

  1. nginx Ingress

     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22

    apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: argocd-server-ingress
  namespace: argocd
  annotations:
    # kubernetes.io/ingress.class: nginx
    # nginx.ingress.kubernetes.io/force-ssl-redirect: "true"
    # nginx.ingress.kubernetes.io/ssl-passthrough: "true"
spec:
  ingressClassName: nginx
  rules:
  - host: argocd.<domain>
    http:
      paths:
      - pathType: Prefix
        path: /
        backend:
          service:
            name: argocd-server
            port:
              number: 80

  2. Istio Ingress

    Reference

    • Gateway yaml
       1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

      apiVersion: networking.istio.io/v1beta1
kind: Gateway
metadata:
  name: argocd-gateway
  namespace: argocd
spec:
  selector:
    istio: ingressgateway
  servers:
    - hosts:
        - argocd.<domain>
      port:
        name: http
        # port 要用 ingressgateway 中，port = 80 的那組設定的 TargetPort
        number: 8080
        protocol: HTTP
      # 如果要強轉 HTTPS
      # tls:
      #   httpsRedirect: true
    - hosts:
        # 這邊這樣設定只是想讓 istio 不會跳相同 host 的警告
        - argocd/argocd.<domain>
      port:
        name: https
        # port 要用 ingressgateway 中，port = 443 的那組設定的 TargetPort
        number: 8443
        protocol: HTTPS
      tls:
        mode: PASSTHROUGH
      # 另外的設定方法，待測試
      # tls:
      #   credentialName: argocd-server-tls # argocd server 會自動讀取這個名稱的 k8s secrets
      #   mode: SIMPLE
    • VirtualService yaml
      信息
          含有 https 導流的設定方式要研究一下

       1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

      apiVersion: networking.istio.io/v1beta1
kind: VirtualService
metadata:
  name: argocd-vs
  namespace: argocd
spec:
  hosts:
  - argocd.<domain>
  gateways:
  - argocd-gateway
  http:
  - route:
    - destination:
        host: argocd-server.argocd.svc.cluster.local
        port:
          number: 80
警告
暫時測不到 <domain>/argocd/ 這種相對路徑的 URL 設定

  1. nginx Ingress

    待補

  2. Istio Ingress

    • Gateway yaml
       1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

      apiVersion: networking.istio.io/v1beta1
kind: Gateway
metadata:
  name: argocd-gateway
  namespace: argocd
spec:
  selector:
    istio: ingressgateway
  servers:
    - hosts:
        - <domain>
      port:
        name: http
        # port 要用 ingressgateway 中，port = 80 的那組設定的 TargetPort
        number: 8080
        protocol: HTTP
      # 如果要強轉 HTTPS
      # tls:
      #   httpsRedirect: true
    - hosts:
        # 這邊這樣設定只是想讓 istio 不會跳相同 host 的警告
        - argocd/<domain>
      port:
        name: https
        # port 要用 ingressgateway 中，port = 443 的那組設定的 TargetPort
        number: 443
        protocol: HTTPS
      tls:
        mode: PASSTHROUGH
      # 另外的設定方法，待測試
      # tls:
      #   credentialName: argocd-server-tls # argocd server 會自動讀取這個名稱的 k8s secrets
      #   mode: SIMPLE
    • VirtualService yaml
      信息
          含有 https 導流的設定方式要研究一下

       1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

      apiVersion: networking.istio.io/v1beta1
kind: VirtualService
metadata:
  name: argocd-vs
  namespace: argocd
spec:
  hosts:
  - <domain>
  gateways:
  - argocd-gateway
  http:
  - route:
    - destination:
        host: argocd-server.argocd.svc.cluster.local
        port:
          number: 80

此方法主要參考以下三個連結

信息
這邊的 kustomization yaml 同時設定了 argoproj-lab 的擴充

  1. 預先準備

  2. 準備 kustomization yaml

     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

    apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
namespace: argocd
resources:
  - install-2.2.1.yaml
  - VirtualService.yaml
  - Gateway.yaml
patchesStrategicMerge:
  - istio_patches.yaml
components:
  # extensions controller component
  - https://github.com/argoproj-labs/argocd-extensions/manifests

  3. 準備 istio patch yaml

    信息
    這邊準備的 yaml 除了預先設定排除 https 之外，就是要設定每個部屬出去的組件的版本號與應用程式名稱，以便 Istio 可以正確追蹤；在使用 [Manual Command Install](#Manual-Command-Install) + [Ingress Install](#Ingress-Install) 的方式安裝時，Istio 會發出因為沒有版本號與應用程式的 Label 而無法追蹤的錯誤。
    警告
    此處提供的 yaml 內容須依據實際安裝的版本去修改版本號，例如在本文件中使用的 Argo CD 版本為 v2.2.1 版，就要將相關版本設定為 v2.2.1。而 Redis 與其他套件的部分，建議參考官方安裝文件中使用的版號進行設定，盡可能使 label 中的版號與實際使用的套件版本相符。

      1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163

    apiVersion: apps/v1
kind: Deployment
metadata:
  labels:
    app.kubernetes.io/component: server
    app.kubernetes.io/name: argocd-server
    app.kubernetes.io/part-of: argocd
    app: argocd-server
    version: v2.2.1
  name: argocd-server
spec:
  template:
    spec:
      containers:
      - name: argocd-server
        command:
        - argocd-server
        - --staticassets
        - /shared/app
        - --insecure
---
apiVersion: apps/v1
kind: Deployment
metadata:
  labels:
    app.kubernetes.io/component: repo-server
    app.kubernetes.io/name: argocd-repo-server
    app.kubernetes.io/part-of: argocd
    app: argocd-repo-server
    version: v2.2.1
  name: argocd-repo-server
spec:
  template:
    metadata:
      labels:
        app: argocd-repo-server
        version: v2.2.1
---
apiVersion: apps/v1
kind: Deployment
metadata:
  labels:
    app.kubernetes.io/component: redis
    app.kubernetes.io/name: argocd-redis
    app.kubernetes.io/part-of: argocd
    app: argocd-redis
    version: v6.2.4
  name: argocd-redis
spec:
  template:
    metadata:
      labels:
        app: argocd-redis
        version: v6.2.4
---
apiVersion: apps/v1
kind: Deployment
metadata:
  labels:
    app.kubernetes.io/component: dex-server
    app.kubernetes.io/name: argocd-dex-server
    app.kubernetes.io/part-of: argocd
    app: argocd-dex-server
    version: v2.30.0
  name: argocd-dex-server
spec:
  template:
    metadata:
      labels:
        app: argocd-dex-server
        version: v2.30.0
---
apiVersion: apps/v1
kind: StatefulSet
metadata:
  labels:
    app.kubernetes.io/component: application-controller
    app.kubernetes.io/name: argocd-application-controller
    app.kubernetes.io/part-of: argocd
    app: argocd-application-controller
    version: v2.2.1
  name: argocd-application-controller
spec:
  template:
    metadata:
      labels:
        app: argocd-application-controller
        version: v2.2.1
---
apiVersion: v1
kind: Service
metadata:
  name: argocd-dex-server
spec:
  # expose container ports to istio network
  ports:
  - name: http
    port: 5556
    protocol: TCP
    targetPort: 5556
  - name: http-grpc
    port: 5557
    protocol: TCP
    targetPort: 5557
  - name: http-metrics
    port: 5558
    protocol: TCP
    targetPort: 5558

---
apiVersion: v1
kind: Service
metadata:
  name: argocd-metrics
spec:
  # expose container ports to istio network
  ports:
  - name: http-metrics
    port: 8082
    protocol: TCP
    targetPort: 8082
---
apiVersion: v1
kind: Service
metadata:
  name: argocd-repo-server
spec:
  # expose container ports to istio network
  ports:
  - name: https-server
    port: 8081
    protocol: TCP
    targetPort: 8081
  - name: http-metrics
    port: 8084
    protocol: TCP
    targetPort: 8084
---
apiVersion: v1
kind: Service
metadata:
  name: argocd-server-metrics
spec:
  # expose container ports to istio network
  ports:
  - name: http-metrics
    port: 8083
    protocol: TCP
    targetPort: 8083
---
apiVersion: v1
kind: Service
metadata:
  name: argocd-server
spec:
  ports:
  - name: http-argocd-server
    port: 80
    protocol: TCP
    targetPort: 8080
  # delete https port
  - port: 443
    $patch: delete

  4. 安裝

    警告
    建議前述準備的 yaml 檔案統一放在專門的資料夾


    1

    kubectl apply -k ./

CLI Tool

官方文件

警告
CLI 不需要安裝在 ArgoCD 所在的叢集主機 (或 kubernetes master server)，但是有些 CLI 命令倚賴 kube config 來取得叢集資料，如果 CLI 裝在沒有 kube config 的環境時，有些命令會出錯

1 Install - Linux

  • Download Latest with curl (Linux)
1
2

curl -sSL -o /usr/local/bin/argocd https://github.com/argoproj/argo-cd/releases/latest/download/argocd-linux-amd64
chmod +x /usr/local/bin/argocd
  • Download Concrete Version with curl (Linux)
1
2

curl -sSL -o /usr/local/bin/argocd https://github.com/argoproj/argo-cd/releases/download/v2.2.1/argocd-linux-amd64
chmod +x /usr/local/bin/argocd

Manage

  1. 參考 Kubernetes Multi-Cluster 中的說明，調整 ArgoCD 所在的網路叢集的 Kubernetes config，加入外部叢集資訊
  2. 確認外部叢集的名稱以供後續 ArgoCD 加入外部叢集時使用
    1

    kubectl config get-contexts -o name
  3. 使用 ArgoCD CLI 登入 ArgoCD
    1

    argocd login <ARGOCD_SERVER>
  4. 加入外部叢集
    1

    argocd cluster add <remote-cluster name>
  5. 現在可以在 UI 中看到外部叢集了
  6. CLI 參考
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

    # List all known clusters in JSON format:
argocd cluster list -o json

# Add a target cluster configuration to ArgoCD. The context must exist in your kubectl config:
argocd cluster add <cluster name>

# Get specific details about a cluster in plain text (wide) format:
argocd cluster get <cluster name> -o wide

# Remove a target cluster context from ArgoCD
argocd cluster rm <cluster name>
  1. Get Default Admin Password
    1

    kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d; echo
警告
不完整

  1. 使用官方提供的命令取得管理員密碼，登入系統後應修改密碼

    1

    kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d

  2. 編輯 ConfigMap

    1

    kubectl edit cm argocd-cm -n argocd

  3. 找到 data 區段，加入使用者

    1
2
3
4

    data:
  accounts.<user>: apiKey,login # 加入這個
  application.instanceLabelKey: argocd.argoproj.io/instance
  url: <argocd server url> # 這個可以順便改一下

  4. 到 <argocd server url>/settings/accounts 建立登入的 Token (密碼的更新方式待測試)

Extension Install

官方擴充套件 建議使用 Kustomization 方式安裝，同時，安裝時會需要使用到 Git，請確認系統內已安裝 Git。

kustomization yaml (Base on kustomization Install With Istio)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
namespace: argocd
resources:
  - install-2.2.1.yaml
  - VirtualService.yaml
  - Gateway.yaml
patchesStrategicMerge:
  - istio_patches.yaml
components:
  # extensions controller component
  - https://github.com/argoproj-labs/argocd-extensions/manifests

Argo Rollout dashboard into the Argo CD Web UI.

  • download yaml
1

curl https://raw.githubusercontent.com/argoproj-labs/rollout-extension/v0.1.0/manifests/install.yaml -o argocd-rollout-extension.yaml
  • apply
1

kubectl apply -n argocd -f argocd-rollout-extension.yaml

Reference

Argo Cd Official Startup Argo Cd Official TLS Configuration Argo Cd Official Startup-Github Argo Cd Github Release Page

Kubernetes 環境準備 - ubuntu & containerd

Kubernetes 環境準備 - centos7 & containerd

Kubernetes 環境準備 - centos7 & docker

ArgoCD install use kustomizaion

Istio 附帶的 Plugin 安裝

更新於 2024-03-03  5b5126f
 Install
返回 | 主頁