Microservices Engine:Configure an MseIngressConfig

Como funciona

O MSE Ingress Controller monitora os recursos MseIngressConfig no cluster e mantém dinamicamente o gateway nativo da nuvem correspondente. Após a associação do gateway ao servidor de API do cluster, o plano de controle sincroniza as alterações nos recursos de Ingress e atualiza as regras de roteamento em tempo real. Ao receber uma solicitação, o gateway a compara com as regras de roteamento do Ingress e encaminha o tráfego para o pod de backend apropriado.

O diagrama a seguir ilustra a relação entre os componentes.

Os principais componentes são:

• Service: Abstração dos serviços de backend. Um service representa um conjunto de pods replicados.

• Ingress: Contém regras de proxy reverso que roteiam solicitações HTTP ou HTTPS para services com base em nomes de host e caminhos.

• IngressClass: Declara qual implementação de controller de Ingress gerencia um conjunto de recursos de Ingress. Associe uma IngressClass a um MseIngressConfig para ativar o gateway nativo da nuvem do MSE para esses recursos.

• MseIngressConfig: CRD que fornece a configuração do gateway, incluindo especificações da instância, configurações de rede, políticas globais e escopo de escuta do Ingress.

• MSE Ingress Controller: Plano de controle que monitora os recursos MseIngressConfig e coordena o gateway nativo da nuvem. Não atua como plano de dados de rede.

Cada MseIngressConfig corresponde exatamente a um gateway nativo da nuvem do MSE. Para executar vários gateways, crie múltiplos MseIngressConfigs.

Referência do MseIngressConfig

apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: test
spec:
  name: mse-ingress
  common:
    pay:
      payType: POSTPAY
    instance:
      spec: 4c8g
      replicas: 3
    network:
      vSwitches:
      - "vsw-1"
      - "vsw-2"
      publicSLBSpec: slb.s2.small
    securityGroupType: normal
  global:
    tls:
      enableHardwareAcceleration: true
    ipAccessControl:
      whitelist:
      - 1.1.XX.XX
      - 2.2.XX.XX
  monitor:
    logging:
      sls:
        reuseProject: "xxx"   # Leave blank to use the default project
    tracing:
      xTrace:
        sampleRate: "100"
  ingress:
    local:
      ingressClass: mse
      watchNamespace: ""      # Leave blank to listen to all namespaces

kubectl get mseingressconfig

NAME   STATUS     MESSAGE
test   Listening

Criar um gateway nativo da nuvem do MSE

1. Aplique um MseIngressConfig para criar o gateway. O exemplo a seguir cria um gateway chamado mse-ingress com 3 réplicas na especificação 2c4g.

   apiVersion: mse.alibabacloud.com/v1alpha1
   kind: MseIngressConfig
   metadata:
     name: test
   spec:
     name: mse-ingress
     common:
       instance:
         spec: 2c4g
         replicas: 3

2. Crie um recurso IngressClass e vincule-o ao MseIngressConfig.

   apiVersion: networking.k8s.io/v1
   kind: IngressClass
   metadata:
     name: mse
   spec:
     controller: mse.alibabacloud.com/ingress
     parameters:
       apiGroup: mse.alibabacloud.com
       kind: MseIngressConfig
       name: test

   Após aplicar ambos os recursos, o gateway nativo da nuvem associado processará os recursos de Ingress com IngressClass mse.

3. Verifique se o gateway está em execução.

   kubectl get mseingressconfig test

   O status progride na ordem Pending → Running → Listening. Quando o status exibir Listening, o gateway estará pronto.

Reutilizar um gateway nativo da nuvem do MSE existente

Para reutilizar um gateway existente, defina spec.id como o ID do gateway (no formato gw-xxx) e controle a sobrescrita da configuração com spec.override.

apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: reuse
spec:
  id: gw-xxxx
  override: false
  ingress:
    local:
      ingressClass: mse

Comportamento de spec.override:

Excluir um gateway nativo da nuvem do MSE

Excluir um MseIngressConfig remove o gateway associado na maioria dos casos. A exceção ocorre em cenários de reutilização, nos quais o gateway é preservado.

Execute o comando a seguir para excluir um MseIngressConfig:

kubectl delete mseingressconfig <your-config-name>

Comportamento de exclusão por cenário:

Configurar controle de acesso por IP

apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: test
spec:
  name: mse-ingress
  global:
    ipAccessControl:
      whitelist:
      - 1.1.XX.XX
      - 2.0.XX.XX/8

apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: test
spec:
  name: mse-ingress
  global:
    ipAccessControl:
      blacklist:
      - 1.1.XX.XX
      - 2.0.XX.XX/8

Ativar o Simple Log Service

Antes de ativar o Simple Log Service (SLS), conceda permissões do SLS ao MSE Ingress Controller de acordo com o tipo do seu cluster:

• Cluster ACK gerenciado ou dedicado: Consulte a seção "Conceder permissões ao MSE Ingress Controller em um cluster ACK dedicado" em Conceder permissões ao MSE Ingress Controller.

• Cluster ACK Serverless: Consulte a seção "Conceder permissões ao MSE Ingress Controller em um cluster ACK Serverless" em Conceder permissões ao MSE Ingress Controller.

• Cluster ACS: Consulte a seção "Conceder permissões ao MSE Ingress Controller em um cluster ACS" em Conceder permissões ao MSE Ingress Controller.

O exemplo a seguir configura o gateway para enviar logs de acesso a um projeto do SLS chamado demo. Para usar o projeto padrão, deixe reuseProject em branco.

apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: test
spec:
  name: mse-ingress
  monitor:
    logging:
      sls:
        reuseProject: "demo"

Ativar o Managed Service for OpenTelemetry

A configuração do Managed Service for OpenTelemetry habilita o rastreamento distribuído ponta a ponta para ajudar a diagnosticar e localizar problemas em produção.

O exemplo a seguir define a taxa de amostragem como 100%.

apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: test
spec:
  name: mse-ingress
  monitor:
    tracing:
      xTrace:
        sampleRate: "100"