Synced, Healthy и ничего не изменилось: ключ values, который чарт не читает
Merge request одобрен, Argo CD зелёный, а поведение не поменялось. Helm молча игнорирует незнакомые ключи, поэтому рендер остался прежним, а diff был честно пустым.
Правка деплоя RabbitMQ прошла ревью и была смёржена. Argo CD показывал Synced и Healthy на новом коммите. Брокер вёл себя ровно так же, как раньше.
Я уже писал о том, как Argo CD показывает Synced, пока API-сервер выбрасывает незнакомое ему поле. Здесь — более тихий родственник того бага. Ничего не выброшено, ничего не отклонено. Argo CD вообще не врал.
На что на самом деле отвечает Synced
Synced отвечает на один вопрос: совпадает ли то, что я отрендерил, с тем, что лежит в кластере? Он не отвечает на «доехал ли мой коммит» и не отвечает на «изменилось ли поведение». Как минимум четыре разные причины дают один и тот же зелёный статус:
- Дочернее приложение всегда зелёное. Его статус ничего не говорит о том, подхватил ли родитель ваш коммит. Сверяйте
status.sync.revisionродителя с git. - Синк к старому коммиту.
reconciledAtможет быть свежим, аoperationState.finishedAt— недельной давности. Реконсиляция — это сравнение, а не применение: если diff пустой, операции не будет. - Рендер не изменился. Об этом пост.
- Объект изменился, процесс его не перечитал. ConfigMap обновлён, а приложение читает его только при старте.
Ключ не на своём месте
Правка добавила memoryHighWatermark на верхний уровень файла values. Чарт читает его как config.memoryHighWatermark. Helm не проверяет values ни против чего, если у чарта нет JSON-схемы, а у большинства её нет. Незнакомые ключи молча игнорируются.
В итоге рендер побайтно совпал с прежним, diff с кластером был пустым, и Argo CD правильно сообщил, что всё совпадает. Все проверки были зелёными, потому что с точки зрения любого инструмента ничего не изменилось. И это была правда.
Проверять рендер, а не статус
Быстрее всего это ловится рендером обеих версий и сравнением:
helm template <release> <chart> --version <ver> -f values-old.yaml > /tmp/old.yaml
helm template <release> <chart> --version <ver> -f values-new.yaml > /tmp/new.yaml
diff /tmp/old.yaml /tmp/new.yaml
Пустой diff при непустой правке значит, что ключ не тот. Тогда ищите настоящее имя в helm show values <chart> --version <ver> и следите за вложенностью. В values.yaml чартов часто заголовок секции стоит в комментарии, а сам ключ лежит на уровень глубже. Легко скопировать заголовок вместо пути.
Та же проверка хорошо работает в CI: рендерить чарт для merge request’а и падать или хотя бы предупреждать, если изменение values не дало изменений в манифестах.
Короткий чек-лист для «зелёное, но не сработало»
- Ревизия родителя — это коммит из git?
operationState.finishedAtсвежий?- Рендер чарта действительно изменился?
- Процесс перечитал конфигурацию — или новый только файл на диске?
Зелёный статус не отвечает ни на один из этих четырёх вопросов. Единственная честная проверка — наблюдаемое поведение: ответ сервиса, вывод диагностической команды, значение в рантайме.
Выводы
- Helm игнорирует незнакомые ключи values без единого слова. Опечатка или неверная вложенность выглядят ровно как пустая операция.
- Пустой diff рендера при реальной правке — баг в правке.
Syncedсравнивает два рендера. Он никогда не проверяет, что вы имели в виду то, что написали.- Проверяйте изменение конфигурации по его эффекту, а не по статусу пайплайна, который его доставил.