Связаться с намиПодключиться

Поля и аннотации ресурса Service для Gateway API

Статья создана
Обновлена 24 февраля 2025 г.

Ресурс Service соответствует сервису Kubernetes. Для Gateway API сервисы представляют собой бэкенды, между которыми распределяется входящий трафик в кластере Managed Service for Kubernetes. Сервисы, выступающие в роли бэкендов Application Load Balancer, указываются в ресурсе HTTPRoute.

Service — стандартный ресурс Kubernetes. Ниже описаны поля и аннотации ресурса, с которыми работают инструменты Application Load Balancer для Managed Service for Kubernetes. Полное описание конфигурации ресурса см. в документации Kubernetes.

Service

apiVersion: v1
kind: Service
metadata:
  name: <string>
spec: <ServiceSpec>

Поле

Значение или тип

Описание

apiVersion

v1

Обязательное.

Версия API Kubernetes.

kind

Service

Тип ресурса.

metadata

ObjectMeta

Обязательное.

Метаданные ресурса.

metadata.name

string

Обязательное.

Имя ресурса.

Не является именем балансировщика в Application Load Balancer.

spec

ServiceSpec

Обязательное.

Спецификация ресурса.
Пример
apiVersion: v1
kind: Service
metadata:
  name: alb-demo-1
spec:
  selector:
    app: alb-demo-1
  type: NodePort
  ports:
    - name: http
      port: 80
      protocol: TCP
      nodePort: 30081

ServiceSpec

type: NodePort
ports:
  - <ServicePort>
  -

Поле

Значение или тип

Описание

type

NodePort

Обязательное.

Тип сервиса.

Важно

Сервисы Kubernetes, используемые в качестве бэкендов (указанные в правилах Ingress напрямую или в HttpBackendGroup/GrpcBackendGroup), должны иметь тип NodePort. Подробнее об этом типе см. в документации Kubernetes.

ports

[]ServicePort

Обязательное.

Список портов, на которых доступен сервис.

ServicePort

port: <int32>
name: <string>
protocol: <protocol>
nodePort: <int32>

Поле

Значение или тип

Описание

port

int32

Обязательное.
Номер порта, на котором доступен сервис.

Номер используется при указании сервиса в качестве бэкенда:

  • в Ingress — в поле spec.rules.http.paths.backend.service.port.number (см. конфигурацию);
  • в группе бэкендов HttpBackendGroup — в поле spec.backends.service.port.number (см. конфигурацию).

name

string

Имя порта внутри сервиса.

Имя используется при указании сервиса в качестве бэкенда:

  • в Ingress — в поле spec.rules.http.paths.backend.service.port.name (см. конфигурацию);
  • в группе бэкендов HttpBackendGroup — в поле spec.backends.service.port.name (см. конфигурацию).

protocol

TCP

Сетевой протокол для порта. Только TCP.

nodePort

int32

Номер порта, открытого на узлах кластера, на которых развернут сервис. Балансировщик отправляет трафик на этот порт, а Kubernetes перенаправляет трафик сервису на его порт в параметре port.

Соответствует порту бэкенда в группе бэкендов Application Load Balancer.
Предыдущая
TLSRoute
Следующая
Настройка групп безопасности