Установка ArgoCD

Tue, 12 May 2026 08:05:35 +0500

Собираю единомышленников в телеграм канале - Присоединяйся

Установка ArgoCD с доступом в интернет на серверах до банальности проста.
Другое дело затащить все компоненты в закрытый контур.

Online установка ArgoCD

Вытаскиваем версию в переменную ARGO_VERSION

1

export ARGO_VERSION=$(curl --silent "https://api.github.com/repos/argoproj/argo-cd/releases/latest" | grep '"tag_name"' | sed -E 's/.*"([^"]+)".*/\1/')

Создаём окружение и применяем манифест:

1
2


kubectl create namespace argocd
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/$ARGO_VERSION/manifests/install.yaml

Готово, ArgoCD установлен.

Offline установка ArgoCD

Скачиваем компоненты

Перейдем к интересной инсталяции в закрытый контур. Подразумевается скачивание компонентов, а затем перенос архивов на закрытый от внешнего мира кластер Кубернетеса.

На машине (сервере) с инетом. Вытаскиваем версию в переменную ARGO_VERSION

1

export ARGO_VERSION=$(curl --silent "https://api.github.com/repos/argoproj/argo-cd/releases/latest" | grep '"tag_name"' | sed -E 's/.*"([^"]+)".*/\1/')

Скачиваем манифест

1

curl -LO https://raw.githubusercontent.com/argoproj/argo-cd/$ARGO_VERSION/manifests/install.yaml

Достаём версии image

1
2


DEX_VERSION=$(grep 'dex:' install.yaml | awk -F: '{print $NF}')
REDIS_VERSION=$(grep 'redis:' install.yaml | awk -F: '{print $NF}')

Качаем и упаковываем docker image:

1
2
3
4
5
6
7


docker pull quay.io/argoproj/argocd:$ARGO_VERSION
docker pull redis:$REDIS_VERSION
docker pull ghcr.io/dexidp/dex:$DEX_VERSION

docker save quay.io/argoproj/argocd:$ARGO_VERSION -o argocd.tar
docker save redis:$REDIS_VERSION -o redis.tar
docker save ghcr.io/dexidp/dex:$DEX_VERSION -o dex.tar

Теперь у тебя 4 файла:

argocd.tar
redis.tar
dex.tar
install.yaml
Переноси их в закрытую зону.

Загружаем образы в Harbor

Среда выполнения: Закрытый кластер Кубернетес
Загружаем образы локально:

1
2
3


docker load -i argocd.tar
docker load -i redis.tar
docker load -i dex.tar

Создать в Harbor новую диркторию project

Экспорт переменных окружения. Здесь в переменную ARGO_VERSION поместить скаченную версию ArgoCD, у меня v3.3.0.
Также указываете ваш репозиторий образов, у меня Harbor и проект (директория) внутри репозитория куда грузить образы.

1
2
3
4
5


export ARGO_VERSION=v3.3.0
export HARBOR=harbor.domain.local
export PROJECT=platform
DEX_VERSION=$(grep 'dex:' install.yaml | awk -F: '{print $NF}')
REDIS_VERSION=$(grep 'redis:' install.yaml | awk -F: '{print $NF}')

Тегаем и заливаем в репозиторий Harbor:

1
2
3
4
5
6


docker tag quay.io/argoproj/argocd:$ARGO_VERSION $HARBOR/platform/argocd:$ARGO_VERSION
docker push $HARBOR/platform/argocd:$ARGO_VERSION
docker tag redis:$REDIS_VERSION $HARBOR/platform/redis:$REDIS_VERSION
docker push $HARBOR/platform/redis:$REDIS_VERSION
docker tag ghcr.io/dexidp/dex:$DEX_VERSION $HARBOR/platform/dex:$DEX_VERSION
docker push $HARBOR/platform/dex:$DEX_VERSION

Заменяем репозиторий на приватный в install.yaml

1
2
3


sed -i "s#quay.io/argoproj/argocd:$ARGO_VERSION#$HARBOR/$PROJECT/argocd:$ARGO_VERSION#g" install.yaml
sed -i "s#public.ecr.aws/docker/library/redis:$REDIS_VERSION#$HARBOR/$PROJECT/redis:$REDIS_VERSION#g" install.yaml
sed -i "s#ghcr.io/dexidp/dex:$DEX_VERSION#$HARBOR/$PROJECT/dex:$DEX_VERSION#g" install.yaml

Секреты для доступа ArgoCD в Harbor

Чтобы взаимодействовать с образами внутри куба создадим токен доступа и секрет внутри Harbor.
Создай Robot Account в Harbor
Harbor UI → Project platform → Robot Accounts → New

Дай права минимум pull (read).
Получишь:
username вида: argocd-puller
token/secret (пароль)
Нажимаем созать получаем токен (такого вида B9N0yv5123123oNa)
Имя получилось robot$platform+argocd-puller

Создаём namespace:

1

kubectl create ns argocd

Создаём секрет в кубере:

1
2
3
4
5


kubectl -n argocd create secret docker-registry cred-harbor \
 --docker-server=harbor.domain.local \
 --docker-username='robot$platform+argocd-puller' \
 --docker-password='B9N0yv5123123oNa' \
 --docker-email='gdemoemilo@milo.tut'

Установка и патч с секретом

Далее создаём GitOps структуру, чтобы добавлять с помощью патчей этот секрет в ArgoCD.

1
2
3


mkdir -p ./argocd/base ./argocd/overlays
mv install.yaml ./argocd/base
nano ./argocd/overlays/kustomization.yaml

Вставляем:

1
2
3
4


apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
 - install.yaml

Далее создаём патч:

1

nano ./argocd/overlays/sa-patch.yaml

Где cred-harbor имя вашего секрета.

 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


apiVersion: apps/v1
kind: Deployment
metadata:
 name: argocd-server
spec:
 template:
 spec:
 imagePullSecrets:
 - name: cred-harbor
---
apiVersion: apps/v1
kind: Deployment
metadata:
 name: argocd-repo-server
spec:
 template:
 spec:
 imagePullSecrets:
 - name: cred-harbor
---
apiVersion: apps/v1
kind: Deployment
metadata:
 name: argocd-applicationset-controller
spec:
 template:
 spec:
 imagePullSecrets:
 - name: cred-harbor
---
apiVersion: apps/v1
kind: Deployment
metadata:
 name: argocd-dex-server
spec:
 template:
 spec:
 imagePullSecrets:
 - name: cred-harbor
---
apiVersion: apps/v1
kind: Deployment
metadata:
 name: argocd-redis
spec:
 template:
 spec:
 imagePullSecrets:
 - name: cred-harbor
---
apiVersion: apps/v1
kind: Deployment
metadata:
 name: argocd-notifications-controller
spec:
 template:
 spec:
 imagePullSecrets:
 - name: cred-harbor
---
apiVersion: apps/v1
kind: StatefulSet
metadata:
 name: argocd-application-controller
spec:
 template:
 spec:
 imagePullSecrets:
 - name: cred-harbor

Далее создаём kustomization в base:

1

nano ./argocd/base/kustomization.yaml

В котором описываем где патч:

1
2
3
4
5
6
7


apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
namespace: argocd
resources:
 - ../base
patchesStrategicMerge:
 - sa-patch.yaml

Получится такая структура:

1
2
3
4
5
6


├── base
│   ├── install.yaml
│   └── kustomization.yaml
└── overlays
 ├── kustomization.yaml
 └── sa-patch.yaml

Теперь мы применяем нашу кастомную конфигурацию. Она автоматически подтянет файл install.yaml, поэтому его не нужно запускать отдельно.

1

kubectl apply -k overlays/

ArgoCD по умолчанию работает в TLS режиме, поэтому пока мы настраиваем на 80 порт сделаем надстрийку --insecure.

1
2


kubectl -n argocd patch configmap argocd-cmd-params-cm \
 -p '{"data":{"server.insecure":"true"}}'

И рестартанём деплой:

1

kubectl -n argocd rollout restart deploy argocd-server

Вход в web-интерфейс ArgoCD

Создаём манифест с Ingress контроллером. Доменное имя в argocd.k8s.domain.local делайте своё.

1
2


mkdir ~/admin/manifests/
nano ~/admin/manifests/ingress-argo.yaml

Содержимое:

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


apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
 name: argocd
 namespace: argocd
 annotations:
 nginx.ingress.kubernetes.io/backend-protocol: "HTTP"
spec:
 ingressClassName: nginx
 rules:
 - host: argocd.k8s.domain.local
 http:
 paths:
 - path: /
 pathType: Prefix
 backend:
 service:
 name: argocd-server
 port:
 number: 80

Применяем:

1

kubectl apply -f ingress-argo.yaml

Логин: admin Пароль получить так:

1
2


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

Установка завершена.

GitOps on IT Notes