Provision
—— XP

Миссия: приложение под присмотром агента

практика~45 минут+675 XP

Это финал раздела. Ты поставишь в кластер агент GitOps, отдашь ему приложение и убедишься, что руками его больше не сломать: всё, что ты поменяешь мимо Git, агент вернёт. А потом посмотришь на это приложение глазами дежурного и составишь паспорт: что из раздела в нём сделано, а чего не хватает.

Приложение берём готовое — guestbook из официального репозитория примеров Argo CD. Свой репозиторий и свой чарт подключаются точно так же, меняется только адрес.

Требования

Миссия засчитывается, когда выполнено всё из списка ниже — его же проверит команда сдачи.

  • Argo CD работает в пространстве имён argocd.
  • Приложение guestbook создано объектом Application, синхронизировано и здорово.
  • Автосинхронизация с prune и selfHeal включена; ручная правка числа реплик откачена агентом.
  • В ~/lab/passport.txt — все восемь пунктов чек-листа из шага 9, каждый строкой «пункт: ответ».

Шаг 1. Освободить память

Argo CD займёт около гигабайта. Посмотри, сколько свободно: free -h, колонка available. Если меньше полутора гигабайт, убери мониторинг из практики 14 — он своё отработал.

ubuntu@stand:~$
helm -n mon uninstall mon
ubuntu@stand:~$
release "mon" uninstalled

Шаг 2. Поставить агента

Подключи репозиторий чартов Argo под коротким именем.

ubuntu@stand:~$
helm repo add argo https://argoproj.github.io/argo-helm
ubuntu@stand:~$
"argo" has been added to your repositories

Создай пространство имён и поставь чарт argo-cd с закреплённой версией — свежую покажет helm search repo argo/argo-cd.

ubuntu@stand:~$
kubectl create namespace argocd
ubuntu@stand:~$
helm install argocd argo/argo-cd -n argocd --version 10.9.6
ubuntu@stand:~$
NAME: argocd
NAMESPACE: argocd
STATUS: deployed
REVISION: 1
DESCRIPTION: Install complete

Дождись, пока все поды в argocd перейдут в Running: kubectl -n argocd get pods. Их будет семь — сервер, контроллер, репозиторный сервер, Redis и ещё три помощника. Если какой-то висит в ImagePullBackOff, спроси, откуда он берёт образ:

ubuntu@stand:~$
kubectl -n argocd get deploy -o wide | grep redis
ubuntu@stand:~$
argocd-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 — положи его в маленький файл значений рядом с приложением:

nano ~/lab/v.yaml
redis:
  image:
    repository: redis

helm upgrade применяет значения к уже установленному релизу, флаг -f указывает файл. Имя и версию чарта сохраним в переменных C и V, чтобы команда осталась короткой.

ubuntu@stand:~$
C=argo/argo-cd
ubuntu@stand:~$
V=10.9.6
ubuntu@stand:~$
cd ~/lab
ubuntu@stand:~$
helm upgrade argocd $C -n argocd --version $V -f v.yaml

Через минуту все семь подов Running.

Шаг 3. Войти

Первый пароль администратора лежит в секрете с длинным именем. Положи имя в переменную и достань пароль, как делал с Grafana; раскодируй его через base64 -d.

ubuntu@stand:~$
S=argocd-initial-admin-secret
ubuntu@stand:~$
kubectl -n argocd get secret $S -o yaml | grep pass
ubuntu@stand:~$
  password: c3VwZXJzZWNyZXQxMjM0NQ==

Во втором терминале пробрось интерфейс и открой https://localhost:8080. Браузер предупредит о самоподписанном сертификате — для стенда это нормально. Логин admin.

ubuntu@stand:~$
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. Первая половина — что и откуда брать:

~/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

Вторая половина в том же файле — куда применять:

~/lab/app.yaml, продолжение
  destination:
    server: https://kubernetes.default.svc
    namespace: guestbook

server — адрес API кластера изнутри самого кластера: Argo CD выкатывает туда же, где живёт. Как синхронизировать, пока не пишем.

Шаг 5. Отдать агенту

Объект Application создают в пространстве имён самого Argo CD. Флаг -f указывает файл.

ubuntu@stand:~$
kubectl apply -f ~/lab/app.yaml
ubuntu@stand:~$
kubectl -n argocd get applications
ubuntu@stand:~$
NAME        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:

~/lab/app.yaml, в конец
  syncPolicy:
    syncOptions: ["CreateNamespace=true"]

Примени файл той же командой и снова нажми Sync. Плитка станет Synced и Healthy. Нажми на неё — увидишь дерево объектов: Deployment, ReplicaSet, под, Service.

Шаг 7. Посмотреть, что выкачено

Приложение выкатил не ты, а агент. Убедись, что оно настоящее:

ubuntu@stand:~$
kubectl -n guestbook get deploy,svc
ubuntu@stand:~$
NAME                           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 задаёт новое число.

ubuntu@stand:~$
kubectl -n guestbook scale deploy guestbook-ui --replicas=3

Приложение станет OutOfSync, а реплик останется три: агент заметил расхождение, но синхронизировать без кнопки ему не разрешено. Включим автосинхронизацию — допиши в syncPolicy строку над syncOptions:

~/lab/app.yaml, в syncPolicy
    automated: {}

Примени и подожди минуту — реплик по-прежнему три, приложение OutOfSync. automated выкатывает новые коммиты сам, без кнопки, но ручные правки в кластере не трогает. За них отвечает отдельный ключ — selfHeal, «самолечение». Замени строку:

~/lab/app.yaml, в syncPolicy
    automated: { selfHeal: true }

Через полминуты:

ubuntu@stand:~$
kubectl -n guestbook get deploy guestbook-ui
ubuntu@stand:~$
NAME           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:

~/lab/app.yaml, в syncPolicy
    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 будут искать объекты не там.

ubuntu@stand:~$
kubectl config set-context --current --namespace=provision
ubuntu@stand:~$
Context "k3d-stand" modified.

Что спросят на собеседовании

  • Что проверишь у приложения перед выкатом в прод?
    Запросы и лимиты, пробы, бюджет отказов, свою учётную запись без лишних прав, сетевые политики, бэкап данных, образ с точной версией без критических уязвимостей и видимость в мониторинге.
  • Коллега поправил кластер руками, а через минуту всё вернулось. Что произошло?
    Приложением управляет агент GitOps с selfHeal: ручная правка считается дрейфом и откатывается к Git. Править надо коммитом.

Что дальше

Раздел закончен. Остался обзорный урок с инструментами эксплуатации, быстрой отладкой кластера и шпаргалкой раздела.

Практика 07+675 XP

Отдавать выкат агенту GitOps и проверять приложение по чек-листу прода: ресурсы, выкат, права, сеть, данные, образы, мониторинг.

  • Агент работает
  • Кластер совпадает с Git
  • Приложение здорово
  • Самолечение включено
  • Ручная правка откачена
  • Паспорт составлен
Команда сдачи — выполни на своей машине
команда
kubectl -n argocd get pods --no-headers | grep -c Running; kubectl -n argocd get app guestbook; kubectl -n argocd get app guestbook -o yaml | grep selfHeal; kubectl -n guestbook get deploy guestbook-ui; cat ~/lab/passport.txt

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.