Модуль istio: Custom Resources

IngressIstioController

Scope: Cluster
Version: v1alpha1

• spec

  объект

  Обязательный параметр

  • spec.hostPort

    объект

    Секция настроек для inlet’а HostPort.

    • spec.hostPort.httpPort

      целочисленный

      Порт для небезопасного подключения по HTTP.

      Если параметр не указан, возможность подключения по HTTP отсутствует.

      Обязательный параметр, если не указан httpsPort.

      Пример:

      httpPort: '80'
      

    • spec.hostPort.httpsPort

      целочисленный

      Порт для безопасного подключения по HTTPS.

      Если параметр не указан, возможность подключения по HTTPS отсутствует.

      Обязательный параметр, если не указан httpPort.

      Пример:

      httpsPort: '443'
      

  • spec.ingressGatewayClass

    строка

    Обязательный параметр

    Имя Ingress-gateway класса для обслуживания Istio ingressgateway controller.

    Значение данного параметра используется в качестве селектора лейблов ресурса Gateway.

    Пример лейбла ресурса Gateway: istio.deckhouse.io/ingress-gateway-class: <ingressGatewayClass value>

    Шаблон: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$

    Пример:

    ingressGatewayClass: istio
    

  • spec.inlet

    строка

    Обязательный параметр

    Способ поступления трафика из внешнего мира:

    • LoadBalancer — устанавливается Ingress-контроллер и заказывается Service с типом LoadBalancer;
    • NodePort — устанавливается Ingress-контроллер, который доступен на портах узлов через NodePort;
    • HostPort — устанавливается Ingress-контроллер, который доступен на портах узлов через HostPort.

    Внимание! На одном хосте может быть только один контроллер с данным типом inlet’а.

    Допустимые значения: LoadBalancer, HostPort, NodePort

  • spec.loadBalancer

    объект

    Необязательный параметр.

    Секция настроек для inlet’а LoadBalancer.

    • spec.loadBalancer.annotations

      объект

      Аннотации, которые будут проставлены сервису для гибкой настройки балансировщика.

  • spec.nodePort

    объект

    Секция настроек для inlet’а NodePort.

    • spec.nodePort.httpPort

      целочисленный

      Порт для небезопасного подключения по HTTP.

      Если параметр не указан, возможность подключения по HTTP отсутствует.

      Обязательный параметр, если не указан httpsPort.

      Пример:

      httpPort: '30080'
      

    • spec.nodePort.httpsPort

      целочисленный

      Порт для безопасного подключения по HTTPS.

      Если параметр не указан, возможность подключения по HTTPS отсутствует.

      Обязательный параметр, если не указан httpPort.

      Пример:

      httpsPort: '30443'
      

  • spec.nodeSelector

    объект

    Как в spec.nodeSelector у подов.

    Если ничего не указано или указано false, будет использоваться автоматика.

    Формат: стандартный список nodeSelector. Поды инстанса унаследуют это поле как есть.

  • spec.resourcesRequests

    объект

    Настройки максимальных значений CPU и памяти, которые может запросить под при выборе узла (если VPA выключен, максимальные значения становятся значениями по умолчанию).

    • spec.resourcesRequests.mode

      строка

      Обязательный параметр

      Режим управления реквестами ресурсов.

      По умолчанию: "VPA"

      Допустимые значения: VPA, Static

    • spec.resourcesRequests.static

      объект

      Настройки статического режима управления.

      • spec.resourcesRequests.static.cpu

        строка

        Значение для реквеста к CPU.

        По умолчанию: "350m"

      • spec.resourcesRequests.static.memory

        строка

        Значение для реквеста к памяти.

        По умолчанию: "500Mi"

    • spec.resourcesRequests.vpa

      объект

      Настройки режима работы VPA.

      • spec.resourcesRequests.vpa.cpu

        объект

        Настройки для CPU.

        • spec.resourcesRequests.vpa.cpu.max

          строка

          Максимальное значение, которое может выставить VPA для реквеста к CPU.

          По умолчанию: "100m"

        • spec.resourcesRequests.vpa.cpu.min

          строка

          Минимальное значение, которое может выставить VPA для реквеста к CPU.

          По умолчанию: "50m"

      • spec.resourcesRequests.vpa.memory

        объект

        Значение для реквеста к памяти.

        • spec.resourcesRequests.vpa.memory.max

          строка

          Максимальное значение, которое может выставить VPA для реквеста к памяти.

          По умолчанию: "200Mi"

        • spec.resourcesRequests.vpa.memory.min

          строка

          Минимальное значение, которое может выставить VPA для реквеста к памяти.

          По умолчанию: "100Mi"

      • spec.resourcesRequests.vpa.mode

        строка

        Режим работы VPA.

        По умолчанию: "Initial"

        Допустимые значения: Initial, Auto

  • spec.tolerations

    массив объектов

    Как в spec.tolerations у подов.

    Если ничего не указано или указано false, будет использоваться автоматика.

    Формат: стандартный список toleration. Поды инстанса унаследуют это поле как есть.

    • spec.tolerations.effect

      строка

      Допустимые значения: NoSchedule, PreferNoSchedule, NoExecute

    • spec.tolerations.key

      строка
    • spec.tolerations.operator

      строка

      По умолчанию: "Equal"

      Допустимые значения: Exists, Equal

    • spec.tolerations.tolerationSeconds

      целочисленный
    • spec.tolerations.value

      строка

IstioFederation

Scope: Cluster
Version: v1alpha1

Настраивает удаленный кластер как доверенный.

• spec

  объект

  Обязательный параметр

  Доступно только в enterprise edition.

  • spec.metadataEndpoint

    строка

    Обязательный параметр

    HTTPS URL, по которому опубликованы метаданные удаленного кластера.

    Доступно только в enterprise edition.

    Шаблон: ^(https|file)://[0-9a-zA-Z._/-]+$

    Пример:

    metadataEndpoint: https://istio.k8s.example.com/metadata/
    

  • spec.trustDomain

    строка

    Обязательный параметр

    TrustDomain удаленного кластера.

    Несмотря на то, что это обязательный параметр, он не используется на данный момент (так как Istio не умеет сопоставлять TrustDomain и корневой CA).

    Доступно только в enterprise edition.

    Шаблон: ^[0-9a-zA-Z._-]+$

    Пример:

    trustDomain: cluster.local
    

IstioMulticluster

Scope: Cluster
Version: v1alpha1

Custom resource для обозначения удаленного кластера как доверенного.

• spec

  объект

  Обязательный параметр

  Доступно только в enterprise edition.

  • spec.enableIngressGateway

    булевый

    Использовать ли ingressgateway для доступа к удаленным подам.

    Если поды между кластерами доступны друг другу напрямую («плоская» сеть), тогда выгодно не совершать лишний «хоп».

    По умолчанию: true

    Доступно только в enterprise edition.

  • spec.metadataEndpoint

    строка

    Обязательный параметр

    HTTPS-эндпоинт с метаданными удаленного кластера.

    Доступно только в enterprise edition.

    Шаблон: ^(https|file)://[0-9a-zA-Z._/-]+$

    Пример:

    metadataEndpoint: https://istio.k8s.example.com/metadata/