Argo CD: первый manual sync и состояние приложения
Application уже связывает Git main, dev overlay и namespace ploshchadka-dev. Теперь читатель может выполнить первый manual sync. В этой главе разберём, что нужно увидеть до применения, как трактовать результат операции и почему Synced не заменяет проверку готовности и пользовательского пути. Результат — осмысленный первый выпуск собственного API/web в локальную лабораторию.
Автор не выполнял команды Argo CD, Kubernetes или HTTP. Все состояния ниже ожидаемые. Команды предназначены для reader после bootstrap из README: собственные образы загружены, Secret существует, Git bundle опубликован, компоненты argocd доступны через локальный port-forward. Если какая-то предпосылка отсутствует, сначала нужно устранить её, не объявляя ещё не созданное приложение исправным.
Сначала узнаём разрешённый источник
Get release-dev с refresh предлагает контроллеру обновить сведения и показывает source, destination, sync и health. Main является веткой, поэтому нужно прочитать фактическую Git revision, которую Argo CD разрешил. Reader должен связать её с commit своей рабочей копии и опубликованным bundle. Сохранённый YAML на диске, не вошедший в commit, в этой revision отсутствует.
Diff показывает отличие желаемых манифестов от live объектов. При первом выпуске большинство объектов ещё отсутствует: должны появиться два Deployment, два Service и сгенерированный ConfigMap. Secret и Namespace в этом наборе не создаются. Если diff неожиданно включает инфраструктуру Git или сам Argo CD, следует проверить path Application прежде, чем применять.
В Kustomize выводе имя ConfigMap содержит hash. Это ожидаемо: generator связывает содержание конфигурации с именем, а ссылки Deployment переписываются соответствующим образом. Не нужно вручную исправлять ссылку обратно на короткое api-config в построенном результате. Такой фикс уничтожил бы связь release конфигурации и шаблона процесса.
Применение требует отдельного действия
Следующие команды reader выполняет после входа в локальный Argo CD. Они показаны как последовательность будущих действий, а не вывод уже выполненной операции.
argocd app get release-dev --refresh
argocd app diff release-dev
argocd app sync release-dev
argocd app wait release-dev --sync --health --timeout 120
Sync берёт выбранное желаемое состояние и применяет его ресурсы. В Application нет automated, поэтому одного нового commit или refresh недостаточно для запуска. Эта граница позволяет обсуждать релиз до изменения live: reader видит image один, replicas один для dev, Service selectors и конфигурацию, затем принимает конкретный набор.
Wait с sync и health ожидает подходящие состояния, но ограничен timeout. Если время закончилось, это не означает автоматический rollback и не доказывает, что все действия провалились. Нужно прочитать текущие объекты: часть могла быть создана, Deployment мог ещё ждать образ или readiness. История операции и события Pod помогают понять, где закончилась выполненная часть намерения.
Повтор sync того же состояния не обязан создавать новый Pod. Если шаблон Deployment не изменился, Kubernetes сохраняет существующие копии. Это нормальное следствие декларативной модели. Команда sync не является универсальным «перезапустить процессы», поэтому reader не должен использовать её как магическое исправление неизвестной прикладной ошибки.
Sync и health отвечают на разные вопросы
Sync отражает согласование желаемого и live состояний. Health оценивает состояние ресурсов по применяемым правилам. Deployment может уже иметь правильный image и replicas в spec, но ещё не располагать готовой копией. Поэтому наблюдать оба показателя полезнее, чем смотреть только зелёную подпись операции.
API имеет startup, readiness и liveness. Во время заданной задержки запуска startup/readiness должны удерживать неподготовленный процесс вне обычного трафика. Service api получает только подходящие адресаты согласно Kubernetes механизму. Web readiness проверяет свой процесс, но не доказывает, что upstream API отдаёт правильный каталог. Разные уровни готовности не следует складывать в одно неразличимое понятие.
Ожидаемое успешное состояние dev — одна API копия и одна web копия, затем готовые Deployment и согласованные Service. В stage overlay API копий две, однако первый sync относится только к release-dev. Если обе среды внезапно изменились, нужно выяснить, какое Application применили и какие paths выбраны. Само имя команды должно обозначать конкретное окружение.
Отсутствующий образ и Secret дают разные признаки
Если reader не загрузил ploshchadka-api:1 в kind, imagePullPolicy Never не позволит скачать случайный образ. Pod останется без успешного старта контейнера. Это проверяется через описание Pod и события. Argo CD не строит Dockerfile, поэтому повтор sync не создаст недостающие слои image; нужно вернуться к подготовке собственного артефакта.
Если образ есть, но api-demo-secret отсутствует, проблема относится к конфигурационной зависимости. SecretRef обязателен, контейнер получает ошибку создания. Исправление — адресное создание учебного Secret в ploshchadka-dev, а не добавление действующего значения в Git только ради исчезновения ошибки. Ссылку и содержание мы уже разделили в предыдущем уроке.
Если контейнер работает, но readiness не проходит, читатель изучает путь, порт и журнал процесса. Ответ healthz не заменяет readyz; API может быть жив, но ещё не готов обслуживать сценарий. Такая последовательность наблюдений продолжает «Площадку» и не обещает, что Argo CD самостоятельно исправляет любой неверный HTTP обработчик.
Проверяем путь пользователя после ресурсов
Для будущего доступа reader создаёт port-forward web на 8082:8080 в namespace ploshchadka-dev. Браузер открывает http://localhost:8082, web проксирует /api к Service api. Frontend и API сохраняют один origin для браузера. Публичный домен, внешний ingress, TLS пользовательского сайта и DNS здесь не создаются.
Ожидаемый HTML показывает каталог, а /api/lessons возвращает версию один и два исходных элемента. Поле version читается из конфигурации процесса, поэтому его нельзя считать самостоятельным доказательством digest образа. Для настоящего выпуска нужно сопоставить declaration image, artifact происхождение и прикладной ответ. В этой подготовке HTTP вызовы не проводились, поэтому материал не содержит фактический JSON конкретного Pod.
Port-forward живёт в отдельном терминале и может потребовать повторного запуска при смене выбранного Pod. Его прекращение не означает, что Service исчез из кластера. Это локальный канал диагностики, не постоянный внешний вход. Понимание этой границы помогает не менять Application в ответ на закрытую временную команду.
Первый manual sync теперь связан с проверяемыми этапами: доступная revision, понятный diff, отдельное применение, состояние ресурсов и пользовательский маршрут. Официальный Getting Started задаёт базовую процедуру приложения; наш пример добавляет конкретные зависимости собственной «Площадки». Следующий урок покажет, как читать расхождение, если live состояние изменили уже после выпуска.