Это финал раздела. Ты поставишь в кластер агент GitOps, отдашь ему приложение и убедишься, что руками его больше не сломать: всё, что ты поменяешь мимо Git, агент вернёт. А потом посмотришь на это приложение глазами дежурного и составишь паспорт: что из раздела в нём сделано, а чего не хватает.
Приложение берём готовое — guestbook из официального репозитория примеров Argo CD. Свой репозиторий и свой чарт подключаются точно так же, меняется только адрес.
Требования
Миссия засчитывается, когда выполнено всё из списка ниже — его же проверит команда сдачи.
- Argo CD работает в пространстве имён
argocd. - Приложение
guestbookсоздано объектом Application, синхронизировано и здорово. - Автосинхронизация с
pruneиselfHealвключена; ручная правка числа реплик откачена агентом. - В
~/lab/passport.txt— все восемь пунктов чек-листа из шага 9, каждый строкой «пункт: ответ».
Шаг 1. Освободить память
Argo CD займёт около гигабайта. Посмотри, сколько свободно: free -h, колонка available. Если меньше полутора гигабайт, убери мониторинг из практики 14 — он своё отработал.
helm -n mon uninstall monrelease "mon" uninstalledШаг 2. Поставить агента
Подключи репозиторий чартов Argo под коротким именем.
helm repo add argo https://argoproj.github.io/argo-helm"argo" has been added to your repositoriesСоздай пространство имён и поставь чарт argo-cd с закреплённой версией — свежую покажет helm search repo argo/argo-cd.
kubectl create namespace argocdhelm install argocd argo/argo-cd -n argocd --version 10.9.6NAME: argocd NAMESPACE: argocd STATUS: deployed REVISION: 1 DESCRIPTION: Install complete
Дождись, пока все поды в argocd перейдут в Running: kubectl -n argocd get pods. Их будет семь — сервер, контроллер, репозиторный сервер, Redis и ещё три помощника. Если какой-то висит в ImagePullBackOff, спроси, откуда он берёт образ:
kubectl -n argocd get deploy -o wide | grep redisargocd-redis 0/1 1 0 5m37s redis ecr-public.aws.com/docker/library/redis:8.6.4-alpine app.kubernetes.io/name=argocd-redisФлаг -o wide добавляет колонки, среди них образ.
Чарт берёт Redis из публичного реестра Amazon, а из России он бывает недоступен — так было в прогоне для этого урока. Тот же образ лежит на Docker Hub. Источник образа задаёт значение чарта redis.image.repository — положи его в маленький файл значений рядом с приложением:
redis: image: repository: redis
helm upgrade применяет значения к уже установленному релизу, флаг -f указывает файл. Имя и версию чарта сохраним в переменных C и V, чтобы команда осталась короткой.
C=argo/argo-cdV=10.9.6cd ~/labhelm upgrade argocd $C -n argocd --version $V -f v.yamlЧерез минуту все семь подов Running.
Шаг 3. Войти
Первый пароль администратора лежит в секрете с длинным именем. Положи имя в переменную и достань пароль, как делал с Grafana; раскодируй его через base64 -d.
S=argocd-initial-admin-secretkubectl -n argocd get secret $S -o yaml | grep pass password: c3VwZXJzZWNyZXQxMjM0NQ==Во втором терминале пробрось интерфейс и открой https://localhost:8080. Браузер предупредит о самоподписанном сертификате — для стенда это нормально. Логин admin.
kubectl -n argocd port-forward svc/argocd-server 8080:443После первого входа смени пароль (User Info → Update Password) и удали секрет с первым паролем: kubectl -n argocd delete secret $S. Так советует и документация Argo CD — первый пароль лежит в кластере открытым текстом в base64, и читать его может любой, у кого есть доступ к секретам пространства.
Шаг 4. Описать приложение
Создай ~/lab/app.yaml. Первая половина — что и откуда брать:
apiVersion: argoproj.io/v1alpha1 kind: Application metadata: name: guestbook namespace: argocd spec: project: default source: repoURL: https://github.com/argoproj/argocd-example-apps targetRevision: HEAD path: guestbook
Вторая половина в том же файле — куда применять:
destination: server: https://kubernetes.default.svc namespace: guestbook
server — адрес API кластера изнутри самого кластера: Argo CD выкатывает туда же, где живёт. Как синхронизировать, пока не пишем.
Шаг 5. Отдать агенту
Объект Application создают в пространстве имён самого Argo CD. Флаг -f указывает файл.
kubectl apply -f ~/lab/app.yamlkubectl -n argocd get applicationsNAME SYNC STATUS HEALTH STATUS guestbook OutOfSync Missing
OutOfSync — в Git есть то, чего нет в кластере; Missing — объектов приложения в кластере нет вовсе. Агент прочитал репозиторий, сравнил и… ничего не сделал. Без syncPolicy Argo CD только показывает расхождение, а выкатывает по кнопке.
Шаг 6. Синхронизировать кнопкой
В интерфейсе нажми на плитку guestbook, затем Sync → Synchronize. Через несколько секунд — красное Sync failed, а в подробностях у каждого объекта:
one or more objects failed to apply, reason: namespaces "guestbook" not found Service SyncFailed namespaces "guestbook" not found Deployment SyncFailed namespaces "guestbook" not found
Пространства имён guestbook нет, а сам агент создавать его не станет, пока не разрешишь. Допиши в app.yaml:
syncPolicy: syncOptions: ["CreateNamespace=true"]
Примени файл той же командой и снова нажми Sync. Плитка станет Synced и Healthy. Нажми на неё — увидишь дерево объектов: Deployment, ReplicaSet, под, Service.
Шаг 7. Посмотреть, что выкачено
Приложение выкатил не ты, а агент. Убедись, что оно настоящее:
kubectl -n guestbook get deploy,svcNAME READY UP-TO-DATE AVAILABLE AGE deployment.apps/guestbook-ui 1/1 1 1 40s NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE service/guestbook-ui ClusterIP 10.43.169.206 <none> 80/TCP 40s
Одна реплика у guestbook-ui — так записано в Git.
Шаг 8. Сломать руками
Сделай то, что в проде делают «на минутку»: поменяй число реплик мимо Git. Флаг --replicas задаёт новое число.
kubectl -n guestbook scale deploy guestbook-ui --replicas=3Приложение станет OutOfSync, а реплик останется три: агент заметил расхождение, но синхронизировать без кнопки ему не разрешено. Включим автосинхронизацию — допиши в syncPolicy строку над syncOptions:
automated: {}Примени и подожди минуту — реплик по-прежнему три, приложение OutOfSync. automated выкатывает новые коммиты сам, без кнопки, но ручные правки в кластере не трогает. За них отвечает отдельный ключ — selfHeal, «самолечение». Замени строку:
automated: { selfHeal: true }Через полминуты:
kubectl -n guestbook get deploy guestbook-uiNAME READY UP-TO-DATE AVAILABLE AGE guestbook-ui 1/1 1 1 2m37s
Агент вернул одну реплику. Теперь удали сервис целиком — kubectl -n guestbook delete svc guestbook-ui — и через несколько секунд он появится снова, с новым адресом. Вот что значит «источник правды — Git»: поменять что-то надолго можно только коммитом.
Шаг 9. Лишнее в кластере
Остался обратный случай: объект убрали из Git, а в кластере он живёт. Argo CD покажет его как требующий удаления, но сам удалять не станет — в журнале контроллера будет строка Skipping auto-sync: need to prune extra resources only but automated prune is disabled. Удаление включает ключ prune:
automated: { selfHeal: true, prune: true }Не спеши проверять: Argo CD сверяет приложения с Git по расписанию, по умолчанию примерно раз в три минуты, и лишний объект пропадёт при следующей сверке. prune выключен по умолчанию не зря: одна ошибка в пути — и агент удалит из кластера всё, чего «нет в Git».
Шаг 10. Где видна история
Открой в интерфейсе приложение и кнопку History and rollback. Каждая синхронизация записана с номером коммита. Откат в GitOps — это git revert в репозитории, а не кнопка: кнопка отката в Argo CD при включённой автосинхронизации недоступна, и это правильно.
Шаг 11. Паспорт готовности к проду
Посмотри на guestbook-ui глазами дежурного. Описание целиком покажет команда kubectl -n guestbook get deploy guestbook-ui -o yaml; ищи в нём нужные поля через | grep.
Создай ~/lab/passport.txt и ответь по каждому пункту одной строкой «пункт: что есть / чего не хватает». Строка начинается со слова пункта и двоеточия, ровно как в списке, — по этим словам паспорт и проверяется. Пункты — ровно темы раздела:
- ресурсы: заданы ли requests и limits;
- масштабирование: есть ли HPA;
- выкат: есть ли проба готовности и бюджет отказов;
- права: своя ли учётная запись и смонтирован ли токен;
- сеть: закрыта ли политиками;
- данные: есть ли тома и как их бэкапить;
- образ: тег или дайджест, что говорит Trivy;
- мониторинг: виден ли под в дашборде из практики 14.
Для сравнения загляни и в стенд курса: Deployment provision-provision в пространстве имён provision, его поды помечены app.kubernetes.io/name: provision. Там часть пунктов уже закрыта чартом из раздела 17.
Подсказка: у учебного guestbook не хватает почти всего — это нормально и ожидаемо. Ценность паспорта в том, что ты видишь дыры и называешь их словами. Отправь команду сдачи.
Шаг 12. Вернуться к стенду
Весь раздел kubectl смотрел в пространство lab. Верни его к стенду, иначе в следующих разделах команды без -n будут искать объекты не там.
kubectl config set-context --current --namespace=provisionContext "k3d-stand" modified.Что спросят на собеседовании
- Что проверишь у приложения перед выкатом в прод?Запросы и лимиты, пробы, бюджет отказов, свою учётную запись без лишних прав, сетевые политики, бэкап данных, образ с точной версией без критических уязвимостей и видимость в мониторинге.
- Коллега поправил кластер руками, а через минуту всё вернулось. Что произошло?Приложением управляет агент GitOps с selfHeal: ручная правка считается дрейфом и откатывается к Git. Править надо коммитом.
Что дальше
Раздел закончен. Остался обзорный урок с инструментами эксплуатации, быстрой отладкой кластера и шпаргалкой раздела.