IngressClass

IngressClass представляет класс Ingress, на который ссылается спецификация Ingress. Аннотацию ingressclass.kubernetes.io/is-default-class можно использовать, чтобы указать, что IngressClass следует считать классом по умолчанию. Если для единственного ресурса IngressClass эта аннотация установлена в значение true, новым ресурсам Ingress, для которых класс не указан, будет назначен этот класс по умолчанию.

Документация по концепции IngressClass

Ingress

Сделайте свою сетевую службу HTTP (или HTTPS) доступной с помощью механизма конфигурации, учитывающего протокол и понимающего такие веб-понятия, как URI, имена хостов, пути и другие. Концепция Ingress позволяет направлять трафик к разным серверным службам на основе правил, заданных через API Kubernetes.

apiVersion: networking.k8s.io/v1

import "k8s.io/api/networking/v1"

IngressClass

Поле	Описание
`apiVersion` string	APIVersion определяет версионированную схему этого представления объекта. Серверы должны преобразовывать распознанные схемы в последнее внутреннее представление и могут отклонять нераспознанные значения. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`kind` string	Kind — строковое значение, представляющее ресурс REST, который описывает этот объект. Серверы могут определять его по конечной точке, на которую клиент отправляет запросы. Не может быть обновлено. В формате CamelCase. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`metadata` ObjectMeta	Стандартные метаданные объекта. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
`spec` IngressClassSpec	spec — желаемое состояние IngressClass. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

IngressClassSpec

IngressClassSpec содержит сведения о классе Ingress.

Поле Описание

controller
string controller указывает имя контроллера, который должен обрабатывать этот класс. Это позволяет использовать разные «варианты», управляемые одним и тем же контроллером. Например, для одного и того же реализующего контроллера можно задать разные параметры. Значение следует указывать в виде пути с доменным префиксом длиной не более 250 символов, например "acme.io/ingress-controller". Это поле неизменяемо.

parameters
IngressClassParametersReference parameters — ссылка на пользовательский ресурс, содержащий дополнительную конфигурацию контроллера. Это поле необязательно, если контроллеру не требуются дополнительные параметры.

Поле	Описание
`controller` string	controller указывает имя контроллера, который должен обрабатывать этот класс. Это позволяет использовать разные «варианты», управляемые одним и тем же контроллером. Например, для одного и того же реализующего контроллера можно задать разные параметры. Значение следует указывать в виде пути с доменным префиксом длиной не более 250 символов, например "acme.io/ingress-controller". Это поле неизменяемо.
`parameters` IngressClassParametersReference	parameters — ссылка на пользовательский ресурс, содержащий дополнительную конфигурацию контроллера. Это поле необязательно, если контроллеру не требуются дополнительные параметры.

IngressClassList

IngressClassList — это коллекция объектов IngressClass.

Поле	Описание
`apiVersion` string	APIVersion определяет версионированную схему этого представления объекта. Серверы должны преобразовывать распознанные схемы в последнее внутреннее представление и могут отклонять нераспознанные значения. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`items` * Массив IngressClass	items — список объектов IngressClass.
`kind` string	Kind — строковое значение, представляющее ресурс REST, который описывает этот объект. Серверы могут определять его по конечной точке, на которую клиент отправляет запросы. Не может быть обновлено. В формате CamelCase. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`metadata` ListMeta	Стандартные метаданные списка.

IngressClassParametersReference

IngressClassParametersReference идентифицирует объект API. Его можно использовать для указания ресурса уровня кластера или пространства имён.

Поле	Описание
`apiGroup` string	apiGroup — группа ресурса, на который ведёт ссылка. Если APIGroup не указан, заданный Kind должен относиться к основной группе API. Для любых других типов сторонних разработчиков APIGroup является обязательным.
`kind` * string	kind — тип ресурса, на который ведёт ссылка.
`name` * string	name — имя ресурса, на который ведёт ссылка.
`namespace` string	namespace — пространство имён ресурса, на который ведёт ссылка. Это поле обязательно, если для scope задано значение "Namespace", и должно быть не задано, если для scope задано значение "Cluster".
`scope` string	scope указывает, относится ли ссылка к ресурсу уровня кластера или пространства имён. Здесь можно задать значение "Cluster" (по умолчанию) или "Namespace".

© 2026 The Kubernetes Authors | Documentation Distributed under CC BY 4.0
Copyright © 2026 The Linux Foundation ®. All rights reserved.
https://kubernetes.io/docs/reference/kubernetes-api/networking/ingress-class-v1/