Сначала определите границу формата
Этот процесс подходит для манифестов, инвентарей, экспортов и конфигураций, где смешаны разные идентификаторы инфраструктуры. Сохраните исходную строку и поле источника. До выбора валидатора определите, является ли значение IP или CIDR, MAC-адресом, AWS ARN или ссылкой на Docker-образ.
Проверяйте, не уничтожая доказательства
ip-address-validator проверяет IPv4, IPv6 и поддерживаемую запись CIDR. mac-address-validator работает с формами через двоеточие, дефис, стиль Cisco и без разделителей. Храните полученное значение рядом с нормализованным, чтобы отличить различие представления от настоящей ошибки разбора.
Для облачных и контейнерных строк используйте aws-arn-validator и docker-image-tag-validator. Неверные октеты, недопустимый префикс, сломанные разделители, неполные части ARN или неправильное имя образа нужно вернуть в исходную запись для исправления.
Формулируйте результат без лишних обещаний
Прохождение формата позволяет продолжить синтаксическую проверку, но не описывает реальное состояние инфраструктуры. Оно не доказывает ответ IP, принадлежность MAC устройству, существование ARN или наличие прав, а также наличие скачиваемого образа в реестре. Для таких вопросов используйте network-triage-debugging, network-convert или разрешенный процесс для облака и реестра. Для других идентификаторов подойдет связанный процесс validation-format.