Deckhouse Platform устанавливает CRD, но не удаляет их при отключении модуля. Если вам больше не нужны созданные CRD, удалите их.

Стадия жизненного цикла модуля: General Availability

У модуля есть требования для установки

IngressIstioController

Scope: Cluster
Version: v1alpha1

  • spec
    объект

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

    • spec.hostPort
      объект

      Секция настроек для инлета 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])?$

      Максимальная длина: 63

      Пример:

      ingressGatewayClass: istio
      
    • spec.inlet
      строка

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

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

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

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

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

    • spec.loadBalancer
      объект

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

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

      • spec.loadBalancer.annotations
        объект

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

      • spec.loadBalancer.loadBalancerClass
        строка

        Класс балансировщика входящих сетевых запросов (передаётся в параметре spec.loadBalancerClass заказанного сервиса с типом LoadBalancer).

    • spec.networkTopology
      объект

      Настройки определения исходных атрибутов клиента (например, IP-адреса источника), когда шлюз развёрнут за другими прокси или балансировщиками нагрузки.

      Подробнее — в документации Istio о топологии сети шлюза.

      • spec.networkTopology.numTrustedProxies
        целочисленный

        Количество доверенных прокси, развёрнутых перед прокси Istio gateway.

        Используется для корректного извлечения адреса клиента из заголовка X-Forwarded-For и заполнения заголовка X-Envoy-External-Address, который используется вышестоящими сервисами.

        Например, если перед шлюзом находятся облачный балансировщик и обратный прокси, укажите 2.

        Может использоваться вместе с proxyProtocol. Если настроены оба параметра и входящий запрос содержит заголовок X-Forwarded-For, Istio использует доверенную цепочку X-Forwarded-For вместо атрибутов PROXY-протокола.

        Допустимые значения: 0 <= X

        Пример:

        numTrustedProxies: 2
        
      • spec.networkTopology.proxyProtocol
        булевый

        Включает поддержку PROXY-протокола на шлюзе для входящих TCP-соединений, чтобы сохранить атрибуты клиента (например, IP-адрес источника), передаваемые вышестоящим L4/TCP-балансировщиком.

        Может использоваться вместе с numTrustedProxies. Если настроены оба параметра и входящий запрос содержит заголовок X-Forwarded-For, Istio использует доверенную цепочку X-Forwarded-For вместо атрибутов PROXY-протокола.

        Пример:

        proxyProtocol: true
        
    • spec.nodePort
      объект

      Секция настроек для инлета 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
      объект

      Настройки запросов (requests) CPU и памяти подами ingress gateway.

      Если параметр не указан, используются встроенные настройки режима VPA. В режиме Static запросы задаются непосредственно в секции static. В режиме VPA VPA изменяет запросы в заданных минимальных и максимальных пределах.

      • spec.resourcesRequests.mode
        строка

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

        Режим управления ресурсами:

        • Static — позволяет задать запросы непосредственно в секции static;
        • VPA — использует VPA. Настроить этот режим можно в секции vpa.

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

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

      • spec.resourcesRequests.static
        объект

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

        • spec.resourcesRequests.static.cpu
          строка

          Настройка запроса CPU (CPU requests).

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

        • spec.resourcesRequests.static.memory
          строка

          Настройка запроса памяти (memory requests).

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

      • spec.resourcesRequests.vpa
        объект

        Параметры управления ресурсами в режиме VPA.

        • spec.resourcesRequests.vpa.cpu
          объект

          Настройки VPA при работе с CPU.

          • spec.resourcesRequests.vpa.cpu.max
            строка

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

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

          • spec.resourcesRequests.vpa.cpu.min
            строка

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

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

        • spec.resourcesRequests.vpa.memory
          объект

          Настройки VPA при работе с памятью.

          • spec.resourcesRequests.vpa.memory.max
            строка

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

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

          • spec.resourcesRequests.vpa.memory.min
            строка

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

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

        • spec.resourcesRequests.vpa.mode
          строка

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

          • Initial — VPA устанавливает начальные значения requests при создании пода. В дальнейшем значения ресурсов не изменяются автоматически.

          • InPlaceOrRecreate — VPA пытается изменить ресурсы пода «на месте» (in-place), если это поддерживается кластером. Если in-place обновление невозможно, под будет пересоздан.

          • Auto — VPA автоматически пересоздаёт поды для применения новых значений ресурсов. Начиная с версии Deckhouse 1.75 данный режим считается устаревшим. Рекомендуется использовать InPlaceOrRecreate.

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

          Допустимые значения: Initial, InPlaceOrRecreate, 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
    объект

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

    Доступно в редакциях: Ultimate/EE, Certified Pro/CSE Pro (1.73)

    • spec.metadata
      объект
      • spec.metadata.ca
        строка

        Доступно в редакциях: Ultimate/EE, Certified Pro/CSE Pro (1.73)

        Сертификат для проверки HTTPS URL, который используется для публикации метаданных удаленного кластера.

        Пример:

        ca: "-----BEGIN CERTIFICATE----- ..... -----END CERTIFICATE-----"
        
      • spec.metadata.insecureSkipVerify
        булевый

        Доступно в редакциях: Ultimate/EE, Certified Pro/CSE Pro (1.73)

        Исключение проверки HTTPS-сертификата на стороне клиента для URL, который используется для публикации метаданных удаленного кластера.

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

        Пример:

        insecureSkipVerify: true
        
    • spec.metadataEndpoint
      строка

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

      Доступно в редакциях: Ultimate/EE, Certified Pro/CSE Pro (1.73)

      HTTPS-эндпоинт, который используется для публикации метаданных удаленного кластера.

      Пример:

      metadataEndpoint: https://istio.k8s.example.com/metadata/
      
    • spec.trustDomain
      строка

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

      Доступно в редакциях: Ultimate/EE, Certified Pro/CSE Pro (1.73)

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

      Deckhouse использует это значение, чтобы сертификаты удалённого кластера были доверенными только для этого домена, а не для сервисов локального mesh.

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

      Пример:

      trustDomain: cluster.local
      
  • status
    объект
    • status.conditions
      массив объектов

      Готовность обмена метаданными с удалённым кластером.

      Если spec.trustDomain совпадает с доменом этого кластера, ресурс не участвует в федерации: после успешного обмена публичными метаданными приватные не запрашиваются, и PrivateMetadataExchangeReady — False с причиной ClusterDomainMismatch; удалённый кластер получает от этого кластера UnknownSourceCluster.

      • PublicMetadataExchangeReady — удалённый public.json доступен и валиден. Причины:
        • Succeeded (True) — публичные метаданные удалённого кластера получены.
        • FetchFailed (False) — запрос к адресу метаданных не выполнен: сеть, DNS, таймаут, TLS, перенаправление 3xx (перенаправления запрещены), адрес резолвится в запрещённый IP (loopback, link-local, unspecified, multicast), ответ больше 1 МиБ. Ошибка — в message.
        • EndpointNotFound (False) — HTTP 404: скорее всего, metadataEndpoint ведёт не на metadata-exporter удалённого кластера, либо в удалённом кластере выключены и федерация, и мультикластер.
        • ServerError (False) — HTTP 5xx: metadata-exporter удалённого кластера или его Ingress недоступны.
        • AccessDenied (False) — HTTP 401 или 403: запрос отклонил кто-то по пути к metadata-exporter удалённого кластера (Ingress или прокси с ограничением доступа); код — в message.
        • UnexpectedHTTPStatus (False) — другой код ответа, отличный от 200; код — в message.
        • InvalidJSON (False) — ответ не является корректным JSON; проверьте, что metadataEndpoint ведёт на metadata-exporter удалённого кластера.
        • InvalidPublicMetadata (False) — в удалённом public.json нет clusterUUID, authnKeyPub или rootCA.
        • ClusterUUIDMismatch (False) — UUID из ответа эндпоинта не совпадает с status.metadataCache.public.clusterUUID: удалённый кластер пересоздан или metadataEndpoint теперь ведёт на другой кластер. Оба UUID — в message.
      • PrivateMetadataExchangeReady — удалённые приватные метаданные доступны и валидны. Причины:
        • AwaitingPublic (Unknown) — обмен публичными метаданными не проходит (причина — в условии PublicMetadataExchangeReady), поэтому приватные метаданные не запрашиваются.
        • TokenGenerationFailed (False) — не удалось подписать запрос authn-ключом этого кластера; проверьте Secret с ключом в этом кластере.
        • FetchFailed (False) — запрос к приватному адресу не выполнен: сеть, DNS, таймаут, TLS, перенаправление 3xx, запрещённый IP, ответ больше 1 МиБ. Ошибка — в message.
        • UnknownSourceCluster (False) — удалённый кластер не знает этот кластер: в нём нет ресурса об этом кластере, обмен публичными метаданными этого ресурса ни разу не прошёл (ClusterUUIDMismatch там означает, что этот кластер пересоздан и удалённый ресурс нужно пересоздать), либо это IstioFederation, у которого spec.trustDomain совпадает с доменом удалённого кластера (там ClusterDomainMismatch).
        • TrustLost (False) — тот же отказ, что и UnknownSourceCluster, но этот кластер уже получал приватные метаданные от удалённого: ресурс об этом кластере там удалён, пересоздан или стал игнорироваться, либо сменился authn-ключ этого кластера. После пересоздания ресурса или смены ключа условие проходит за минуту-две, как только удалённый кластер заберёт публичные метаданные этого кластера.
        • WrongAllianceKind (False) — удалённый кластер зарегистрировал этот кластер как IstioMulticluster, а не IstioFederation; замените его на IstioFederation в удалённом кластере.
        • EndpointNotFound (False) — HTTP 404: публичный адрес ответил, поэтому, скорее всего, в удалённом кластере выключена федерация (federation.enabled).
        • ServerError (False) — HTTP 5xx: metadata-exporter удалённого кластера ответил ошибкой на приватном пути.
        • ClusterDomainMismatch (False) — для федерации домены кластеров должны различаться: либо spec.trustDomain совпадает с доменом этого кластера (приватные метаданные не запрашиваются; укажите в spec.trustDomain домен удалённого кластера), либо удалённый кластер сообщает в приватных метаданных домен этого кластера (не проверяется, если удалённый кластер не публикует свой домен). Домен — в message.
        • WrongJWTAudience (False) — удалённый кластер отверг токен как выписанный другому кластеру: публичный и приватный запросы обслужили разные кластеры (DNS, балансировщик или прокси ведёт на несколько кластеров).
        • TokenExpired (False) — токен просрочен из-за расхождения часов; проверьте синхронизацию времени (NTP) в обоих кластерах.
        • InvalidToken (False) — удалённый кластер не получил или не разобрал токен: прокси или ingress по пути срезает заголовок Authorization, либо ошибка платформы.
        • WrongJWTScope (False) — токен выписан для другого приватного пути: ошибка платформы или прокси, переписывающий путь.
        • AccessDenied (False) — HTTP 401 или 403 без машиночитаемой причины: metadata-exporter удалённого кластера старой версии и не сообщает причину (чаще всего он не знает этот кластер), либо запрос отклонил Ingress или прокси по пути; код — в message.
        • UnexpectedHTTPStatus (False) — другой код ответа, отличный от 200; код — в message.
        • InvalidJSON (False) — приватный ответ удалённого кластера не является корректным JSON.
        • InvalidPrivateMetadata (False) — в приватных метаданных удалённого кластера нет publicServices.
        • MissingIngressGateways (False) — удалённый кластер не опубликовал адреса ingress gateway (обычно у его LoadBalancer ещё нет адреса, либо metadata-exporter удалённого кластера не смог их собрать). Используются приватные метаданные, полученные в последний раз, включая адреса шлюза.
        • Succeeded (True) — приватные метаданные удалённого кластера получены.
      • DataplaneConnectionReady — успешна межкластерная health-проверка dataplane к сервису alliance-healthcheck. Причины:
        • AwaitingPublic (Unknown) — в status.metadataCache ещё нет публичных метаданных.
        • AwaitingPrivate (Unknown) — в status.metadataCache есть публичные метаданные, но ещё нет приватных. У нового подключения это состояние сохраняется один-два цикла проверки (до двух минут) после получения приватных метаданных, чтобы меш успел их применить до первой проверки.
        • ProbeFailed (False) — проверка через ingress gateway удалённого кластера не проходит; в message — ошибка запроса или код ответа. Если удалённый кластер на старой версии модуля (он не проверяет вид ресурса и не публикует свой домен), неверный вид ресурса в удалённом кластере или совпадающие домены кластеров при spec.trustDomain, указывающем на другой домен, видны только здесь.
        • ConfigurationError (False) — приватные метаданные получены, но в publicServices удалённого кластера нет сервиса alliance-healthcheck (например, в удалённом кластере старая версия модуля istio). Подробности — в message.
        • MetadataUnavailable (False) — ошибка платформы: UUID удалённого кластера не удаётся прочитать из закешированных метаданных.
        • Succeeded (True) — связность dataplane с удалённым кластером есть.
      • status.conditions.lastProbeTime
        строка

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

      • status.conditions.lastTransitionTime
        строка

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

      • status.conditions.message
        строка

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

      • status.conditions.reason
        строка

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

      • status.conditions.status
        строка

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

        Допустимые значения: True, False, Unknown

      • status.conditions.type
        строка

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

    • status.metadataCache
      объект
      • status.metadataCache.private
        объект
        • status.metadataCache.private.clusterDomain
          строка
        • status.metadataCache.private.ingressGateways
          массив объектов
          • status.metadataCache.private.ingressGateways.address
            строка
          • status.metadataCache.private.ingressGateways.port
            целочисленный
        • status.metadataCache.private.publicServices
          массив объектов
          • status.metadataCache.private.publicServices.hostname
            строка
          • status.metadataCache.private.publicServices.ports
            массив объектов
            • status.metadataCache.private.publicServices.ports.name
              строка
            • status.metadataCache.private.publicServices.ports.port
              целочисленный
            • status.metadataCache.private.publicServices.ports.protocol
              строка
      • status.metadataCache.public
        объект
        • status.metadataCache.public.authnKeyPub
          строка
        • status.metadataCache.public.clusterUUID
          строка
        • status.metadataCache.public.rootCA
          строка

IstioMulticluster

Scope: Cluster
Version: v1alpha1

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

  • spec
    объект

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

    Доступно в редакциях: Ultimate/EE, Certified Pro/CSE Pro (1.73)

    • spec.enableIngressGateway
      булевый

      Доступно в редакциях: Ultimate/EE, Certified Pro/CSE Pro (1.73)

      Обращаться ли к подам удалённого кластера через его ingress gateway.

      Если поды кластеров доступны друг другу напрямую (плоская сеть), задайте false, чтобы избежать лишнего перехода через ingress gateway.

      Задайте одинаковое значение с обеих сторон: в удалённом кластере — в IstioMulticluster, который описывает этот кластер. Кластер разворачивает свой ingress gateway, только если в нём включена федерация или хотя бы в одном IstioMulticluster задано enableIngressGateway: true. Если false задано только с одной стороны, другая сторона может не найти ingress gateway для подключения (причина IngressGatewayNotDeployed в status.conditions).

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

    • spec.metadata
      объект
      • spec.metadata.ca
        строка

        Доступно в редакциях: Ultimate/EE, Certified Pro/CSE Pro (1.73)

        HTTPS-сертификат удостоверяющего центра для чтения метаданных удалённого кластера.

      • spec.metadata.insecureSkipVerify
        булевый

        Доступно в редакциях: Ultimate/EE, Certified Pro/CSE Pro (1.73)

        Включение или выключение проверки сертификата удостоверяющего центра для чтения метаданных удалённого кластера.

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

        Пример:

        insecureSkipVerify: true
        
    • spec.metadataEndpoint
      строка

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

      Доступно в редакциях: Ultimate/EE, Certified Pro/CSE Pro (1.73)

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

      Пример:

      metadataEndpoint: https://istio.k8s.example.com/metadata/
      
  • status
    объект
    • status.conditions
      массив объектов

      Готовность обмена метаданными с удалённым кластером.

      • PublicMetadataExchangeReady — удалённый public.json доступен и валиден. Причины:
        • Succeeded (True) — публичные метаданные удалённого кластера получены.
        • FetchFailed (False) — запрос к адресу метаданных не выполнен: сеть, DNS, таймаут, TLS, перенаправление 3xx (перенаправления запрещены), адрес резолвится в запрещённый IP (loopback, link-local, unspecified, multicast), ответ больше 1 МиБ. Ошибка — в message.
        • EndpointNotFound (False) — HTTP 404: скорее всего, metadataEndpoint ведёт не на metadata-exporter удалённого кластера, либо в удалённом кластере выключены и федерация, и мультикластер.
        • ServerError (False) — HTTP 5xx: metadata-exporter удалённого кластера или его Ingress недоступны.
        • AccessDenied (False) — HTTP 401 или 403: запрос отклонил кто-то по пути к metadata-exporter удалённого кластера (Ingress или прокси с ограничением доступа); код — в message.
        • UnexpectedHTTPStatus (False) — другой код ответа, отличный от 200; код — в message.
        • InvalidJSON (False) — ответ не является корректным JSON; проверьте, что metadataEndpoint ведёт на metadata-exporter удалённого кластера.
        • InvalidPublicMetadata (False) — в удалённом public.json нет clusterUUID, authnKeyPub или rootCA.
        • ClusterUUIDMismatch (False) — UUID из ответа эндпоинта не совпадает с status.metadataCache.public.clusterUUID: удалённый кластер пересоздан или metadataEndpoint теперь ведёт на другой кластер. Оба UUID — в message.
      • PrivateMetadataExchangeReady — удалённые приватные метаданные доступны и валидны. Причины:
        • AwaitingPublic (Unknown) — обмен публичными метаданными не проходит (причина — в условии PublicMetadataExchangeReady), поэтому приватные метаданные не запрашиваются.
        • TokenGenerationFailed (False) — не удалось подписать запрос authn-ключом этого кластера; проверьте Secret с ключом в этом кластере.
        • FetchFailed (False) — запрос к приватному адресу не выполнен: сеть, DNS, таймаут, TLS, перенаправление 3xx, запрещённый IP, ответ больше 1 МиБ. Ошибка — в message.
        • UnknownSourceCluster (False) — удалённый кластер не знает этот кластер: в нём нет ресурса об этом кластере, обмен публичными метаданными этого ресурса ни разу не прошёл (ClusterUUIDMismatch там означает, что этот кластер пересоздан и удалённый ресурс нужно пересоздать), либо в удалённом кластере об этом кластере создан IstioFederation вместо IstioMulticluster (при совпадающих доменах, как требует мультикластер, он там игнорируется, поэтому неверный вид ресурса виден здесь, а не как WrongAllianceKind).
        • TrustLost (False) — тот же отказ, что и UnknownSourceCluster, но этот кластер уже получал приватные метаданные от удалённого: ресурс об этом кластере там удалён, пересоздан или стал игнорироваться, либо сменился authn-ключ этого кластера. После пересоздания ресурса или смены ключа условие проходит за минуту-две, как только удалённый кластер заберёт публичные метаданные этого кластера.
        • WrongAllianceKind (False) — удалённый кластер зарегистрировал этот кластер как IstioFederation, а не IstioMulticluster; замените его на IstioMulticluster в удалённом кластере.
        • EndpointNotFound (False) — HTTP 404: публичный адрес ответил, поэтому, скорее всего, в удалённом кластере выключен мультикластер (multicluster.enabled).
        • ServerError (False) — HTTP 5xx: metadata-exporter удалённого кластера ответил ошибкой на приватном пути.
        • ClusterDomainMismatch (False) — домен удалённого кластера отличается от домена этого кластера, а для мультикластера домены должны совпадать. Оба домена — в message. Не проверяется, если удалённый кластер не публикует свой домен.
        • WrongJWTAudience (False) — удалённый кластер отверг токен как выписанный другому кластеру: публичный и приватный запросы обслужили разные кластеры (DNS, балансировщик или прокси ведёт на несколько кластеров).
        • TokenExpired (False) — токен просрочен из-за расхождения часов; проверьте синхронизацию времени (NTP) в обоих кластерах.
        • InvalidToken (False) — удалённый кластер не получил или не разобрал токен: прокси или ingress по пути срезает заголовок Authorization, либо ошибка платформы.
        • WrongJWTScope (False) — токен выписан для другого приватного пути: ошибка платформы или прокси, переписывающий путь.
        • AccessDenied (False) — HTTP 401 или 403 без машиночитаемой причины: metadata-exporter удалённого кластера старой версии и не сообщает причину (чаще всего он не знает этот кластер), либо запрос отклонил Ingress или прокси по пути; код — в message.
        • UnexpectedHTTPStatus (False) — другой код ответа, отличный от 200; код — в message.
        • InvalidJSON (False) — приватный ответ удалённого кластера не является корректным JSON.
        • InvalidPrivateMetadata (False) — в приватных метаданных удалённого кластера пустые networkName или apiHost.
        • MissingIngressGateways (False) — spec.enableIngressGateway равен true, но удалённый кластер не опубликовал адреса ingress gateway (обычно у его LoadBalancer ещё нет адреса, либо metadata-exporter удалённого кластера не смог их собрать). Удалённый кластер на более старой версии модуля, в котором ingress gateway не развёрнут, тоже отображается с этой причиной, а не с IngressGatewayNotDeployed. Используются приватные метаданные, полученные в последний раз, включая адреса шлюза.
        • IngressGatewayNotDeployed (False) — spec.enableIngressGateway равен true, но в удалённом кластере ingress gateway не развёрнут. Чаще всего в IstioMulticluster, который описывает этот кластер в удалённом кластере, задано spec.enableIngressGateway: false, и ничто другое там не требует ingress gateway (подробнее — в описании параметра spec.enableIngressGateway); что ещё проверить в удалённом кластере, указано в message. Кешированные адреса удаляются, и до исправления этот кластер не подключается к удалённому.
        • Succeeded (True) — приватные метаданные удалённого кластера получены.
      • RemoteAPIServerReady — удалённый API-хост multicluster (apiHost) отвечает на аутентифицированный /api. Причины:
        • AwaitingPrivate (Unknown) — обмен приватными метаданными ещё не завершился успешно (причина — в условии PrivateMetadataExchangeReady), в том числе пока не проходит обмен публичными метаданными.
        • TokenGenerationFailed (False) — не удалось подписать API-токен authn-ключом этого кластера; проверьте Secret с ключом в этом кластере.
        • MissingAPIHost (False) — apiHost удалённого кластера состоит только из пробелов (пустой apiHost отражается как InvalidPrivateMetadata в PrivateMetadataExchangeReady).
        • RemoteAPIUnreachable (False) — запрос к API удалённого кластера не выполнен: сеть, DNS, таймаут, TLS, перенаправление, apiHost не HTTPS, запрещённый IP, ответ больше 1 МиБ. Ошибка — в message.
        • RemoteAPIBadResponse (False) — API удалённого кластера ответил кодом, отличным от 200 (код — в message); проверьте api-proxy и права в удалённом кластере.
        • RemoteAPIInvalidResponse (False) — ответ API удалённого кластера не является корректным JSON; проверьте, что apiHost ведёт на api-proxy удалённого кластера.
        • RemoteAPIUnexpectedResponse (False) — по apiHost отвечает не Kubernetes API (kind ответа не APIVersions).
        • RemoteAPIReachable (True) — API-сервер удалённого кластера доступен.
      • DataplaneConnectionReady — успешна межкластерная health-проверка dataplane к сервису alliance-healthcheck. Причины:
        • AwaitingPublic (Unknown) — в status.metadataCache ещё нет публичных метаданных.
        • AwaitingPrivate (Unknown) — в status.metadataCache есть публичные метаданные, но ещё нет приватных. У нового подключения это состояние сохраняется один-два цикла проверки (до двух минут) после получения приватных метаданных, чтобы меш успел их применить до первой проверки.
        • ProbeFailed (False) — проверка сервиса alliance-healthcheck удалённого кластера не проходит (через его ingress gateway или напрямую к подам, если spec.enableIngressGateway равен false); в message — ошибка запроса или код ответа. Если удалённый кластер на старой версии модуля, неверный вид ресурса или разные домены кластеров видны только здесь.
        • MetadataUnavailable (False) — ошибка платформы: UUID удалённого кластера не удаётся прочитать из закешированных метаданных.
        • Succeeded (True) — связность dataplane с удалённым кластером есть.
      • status.conditions.lastProbeTime
        строка

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

      • status.conditions.lastTransitionTime
        строка

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

      • status.conditions.message
        строка

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

      • status.conditions.reason
        строка

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

      • status.conditions.status
        строка

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

        Допустимые значения: True, False, Unknown

      • status.conditions.type
        строка

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

    • status.metadataCache
      объект
      • status.metadataCache.private
        объект
        • status.metadataCache.private.ambientGateways
          массив объектов
          • status.metadataCache.private.ambientGateways.address
            строка
          • status.metadataCache.private.ambientGateways.port
            целочисленный
        • status.metadataCache.private.apiHost
          строка
        • status.metadataCache.private.ca
          строка
        • status.metadataCache.private.clusterDomain
          строка
        • status.metadataCache.private.clusterID
          строка
        • status.metadataCache.private.ingressGateways
          массив объектов
          • status.metadataCache.private.ingressGateways.address
            строка
          • status.metadataCache.private.ingressGateways.port
            целочисленный
        • status.metadataCache.private.networkName
          строка
      • status.metadataCache.public
        объект
        • status.metadataCache.public.authnKeyPub
          строка
        • status.metadataCache.public.clusterUUID
          строка
        • status.metadataCache.public.rootCA
          строка

WaypointInstance

Short names: wpi

Scope: Namespaced
Version: v1alpha1

  • metadata
    объект
    • metadata.name
      строка

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

      Максимальная длина: 51

  • spec
    объект
    • spec.allowedRoutes
      объект

      Конфигурация ограничения того, какие Routes могут прикрепляться к Gateway.

      • spec.allowedRoutes.namespaces
        объект

        Конфигурация ограничения неймспейсов Routes, которые могут прикрепляться к Gateway.

        • spec.allowedRoutes.namespaces.from
          строка

          Указывает, из каких неймспейсов разрешено прикреплять Routes к этому Gateway.

          Возможные значения:

          • All: Routes из всех неймспейсов могут быть прикреплены.
          • Selector: только Routes из неймспейсов, соответствующих selector, могут быть прикреплены.
          • Same: только Routes из того же неймспейса, что и Gateway, могут быть прикреплены.

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

          Допустимые значения: All, Selector, Same

        • spec.allowedRoutes.namespaces.selector
          объект

          Label selector для выбора неймспейсов.

          Обязателен, когда from имеет значение Selector.

          • spec.allowedRoutes.namespaces.selector.matchExpressions
            массив объектов

            Список требований к label selector.

            • spec.allowedRoutes.namespaces.selector.matchExpressions.key
              строка

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

            • spec.allowedRoutes.namespaces.selector.matchExpressions.operator
              строка

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

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

            • spec.allowedRoutes.namespaces.selector.matchExpressions.values
              массив строк
          • spec.allowedRoutes.namespaces.selector.matchLabels
            объект

            Карта пар {ключ, значение}.

            Одна пара {ключ, значение} в matchLabels эквивалентна элементу matchExpressions с оператором In и массивом values, содержащим только это значение.

    • spec.nodeSelector
      объект

      Селектор узла для подов waypoint proxy.

    • spec.replicasManagement
      объект

      Настройки управления репликацией и масштабированием для waypoint instance.

      • spec.replicasManagement.hpa
        объект

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

        • spec.replicasManagement.hpa.maxReplicas
          целочисленный

          Верхняя граница количества реплик, до которой HPA может масштабировать вверх.

          Допустимые значения: 1 <= X

        • spec.replicasManagement.hpa.metrics
          массив объектов

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

          • spec.replicasManagement.hpa.metrics.targetAverageUtilization
            целочисленный

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

            Целевое значение средней метрики ресурсов по всем соответствующим подам, выраженное в процентах от запрошенного значения.

            Допустимые значения: 1 <= X <= 100

          • spec.replicasManagement.hpa.metrics.type
            строка

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

            Тип метрики.

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

        • spec.replicasManagement.hpa.minReplicas
          целочисленный

          Нижняя граница количества реплик, до которой HPA может масштабировать вниз.

          Допустимые значения: 1 <= X

      • spec.replicasManagement.mode
        строка

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

        Возможные значения:

        • Static: режим, в котором количество реплик задаётся явно.
        • HPA: режим, в котором количество реплик рассчитывается автоматически с помощью HPA на основе загрузки CPU.

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

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

      • spec.replicasManagement.static
        объект

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

        • spec.replicasManagement.static.replicas
          целочисленный

          Желаемое количество реплик.

          Допустимые значения: 1 <= X

    • spec.resourcesManagement
      объект

      Настройки запросов и лимитов CPU и памяти для подов waypoint.

      • spec.resourcesManagement.mode
        строка

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

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

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

      • spec.resourcesManagement.static
        объект

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

        • spec.resourcesManagement.static.limits
          объект

          Лимиты ресурсов.

          • spec.resourcesManagement.static.limits.cpu
            строка

            Лимит CPU.

          • spec.resourcesManagement.static.limits.memory
            строка

            Лимит памяти.

        • spec.resourcesManagement.static.requests
          объект

          Запрашиваемые ресурсы.

          • spec.resourcesManagement.static.requests.cpu
            строка

            Запрос CPU.

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

          • spec.resourcesManagement.static.requests.memory
            строка

            Запрос памяти.

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

      • spec.resourcesManagement.vpa
        объект

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

        • spec.resourcesManagement.vpa.cpu
          объект

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

          • spec.resourcesManagement.vpa.cpu.limitRatio
            число

            Соотношение лимитов/запросов для CPU.

            Если задано, лимиты рассчитываются на основе запросов и указанного соотношения.

          • spec.resourcesManagement.vpa.cpu.max
            строка

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

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

          • spec.resourcesManagement.vpa.cpu.min
            строка

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

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

        • spec.resourcesManagement.vpa.memory
          объект

          Настройки VPA для памяти.

          • spec.resourcesManagement.vpa.memory.limitRatio
            число

            Соотношение лимитов/запросов для памяти.

            Если задано, лимиты рассчитываются на основе запросов и указанного коэффициента.

          • spec.resourcesManagement.vpa.memory.max
            строка

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

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

          • spec.resourcesManagement.vpa.memory.min
            строка

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

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

        • spec.resourcesManagement.vpa.mode
          строка

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

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

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

    • spec.tolerations
      массив объектов

      Tolerations для подов waypoint proxy.

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

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

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

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

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

      • spec.tolerations.tolerationSeconds
        целочисленный
      • spec.tolerations.value
        строка
    • spec.waypointFor
      строка

      Управляет значением лейбла istio.io/waypoint-for на всех управляемых ресурсах.

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

      Допустимые значения: All, Service, Workload

  • status
    объект
    • status.observedGeneration
      целочисленный

      Допустимые значения: 0 <= X

    • status.synced
      булевый

      True, когда желаемые и фактические ресурсы синхронизированы.