Container Service for Kubernetes:Use MSE Ingresses to access applications in ACK clusters

cat << EOF | kubectl apply -f -
apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: test
spec:
  name: mse-ingress                # Name of the cloud-native gateway
  common:
    instance:
      spec: 2c4g                   # 2 vCPUs, 4 GB memory per replica (default: 4c8g)
      replicas: 3                  # Number of gateway replicas (default: 3)
EOF

Método 1: Usar um recurso Kubernetes IngressClass (recomendado)

Utilize este método para novos serviços que acessam o MSE Ingress. Execute um dos comandos a seguir com base na versão do Kubernetes do seu cluster.

Clusters executando versões do Kubernetes anteriores à v1.19

cat << EOF | kubectl apply -f -
apiVersion: networking.k8s.io/v1beta1
kind: IngressClass
metadata:
  name: mse
spec:
  controller: mse.alibabacloud.com/ingress
  parameters:
    apiGroup: mse.alibabacloud.com       # API group of MseIngressConfig
    kind: MseIngressConfig               # Resource kind
    name: test                           # Name of the MseIngressConfig from Step 1
EOF

Clusters executando Kubernetes v1.19 ou posterior

cat << EOF | kubectl apply -f -
apiVersion: networking.k8s.io/v1
kind: IngressClass
metadata:
  name: mse
spec:
  controller: mse.alibabacloud.com/ingress
  parameters:
    apiGroup: mse.alibabacloud.com       # API group of MseIngressConfig
    kind: MseIngressConfig               # Resource kind
    name: test                           # Name of the MseIngressConfig from Step 1
EOF

Método 2: Usar recursos MseIngressConfig (para migração)

Adote este método ao migrar do NGINX Ingress para o MSE Ingress, ou em cenários onde não é possível criar recursos IngressClass. Durante a migração, tanto o NGINX Ingress quanto o MSE Ingress devem escutar o mesmo recurso IngressClass. Este método permite configurar o IngressClass diretamente dentro do MseIngressConfig, evitando conflitos de nomes de IngressClass.

Adicione o campo ingressClass ao MseIngressConfig criado na Etapa 1:

apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: test
spec:
  name: mse-ingress
  common:
    instance:
      spec: 2c4g
      replicas: 3
  ingress:
    local:
      ingressClass: mse                  # IngressClass name to listen on

A tabela a seguir descreve os valores de ingress.local.ingressClass.

Verificar o status do gateway

Execute o comando a seguir para verificar o status do MseIngressConfig:

kubectl get MseIngressConfig test

Saída esperada:

NAME   STATUS      AGE
test   Listening   3m15s

O status Listening confirma que o gateway nativo da nuvem está em execução e monitorando recursos Ingress associados ao IngressClass mse.

As transições de status ocorrem na seguinte ordem:

Implantar um serviço de backend de exemplo

Execute o comando a seguir para implantar o serviço go-httpbin:

cat << EOF | kubectl apply -f -
apiVersion: apps/v1
kind: Deployment
metadata:
  name: go-httpbin
  namespace: default
spec:
  replicas: 1
  selector:
    matchLabels:
      app: go-httpbin
  template:
    metadata:
      labels:
        app: go-httpbin
        version: v1
    spec:
      containers:
        - image: specialyang/go-httpbin:v3
          args:
            - "--port=8090"            # Application listens on port 8090
            - "--version=v1"           # Reports version v1
          imagePullPolicy: Always
          name: go-httpbin
          ports:
            - containerPort: 8090
---
apiVersion: v1
kind: Service
metadata:
  name: go-httpbin
  namespace: default
spec:
  ports:
    - port: 80                         # Service port exposed to Ingress
      targetPort: 8090                 # Forwards to container port 8090
      protocol: TCP
  selector:
    app: go-httpbin
EOF

Criar um recurso Ingress

Execute um dos comandos a seguir para criar um recurso Ingress. O Ingress roteia solicitações para example.com/version para o serviço go-httpbin.

cat << EOF | kubectl apply -f -
apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  name: ingress
  namespace: default
spec:
  ingressClassName: mse                  # Associates with the MSE IngressClass
  rules:
   - host: example.com
     http:
      paths:
      - path: /version
        backend:
          serviceName: go-httpbin
          servicePort: 80
EOF

cat << EOF | kubectl apply -f -
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: ingress
  namespace: default
spec:
  ingressClassName: mse                  # Associates with the MSE IngressClass
  rules:
  - host: example.com
    http:
      paths:
      - backend:
          service:
            name: go-httpbin
            port:
              number: 80
        path: /version
        pathType: Prefix
EOF

Verificar o resultado

1. Obtenha o endereço atribuído ao Ingress. Saída esperada:

      kubectl get ingress ingress

      NAME      CLASS   HOSTS            ADDRESS         PORTS   AGE
      ingress   mse     example.com      114.55.XX.XX   80      12m

2. Envie uma solicitação de teste usando o endereço do Ingress. Saída esperada: A resposta version:v1 confirma que o tráfego foi roteado através do MSE Ingress para o serviço de backend go-httpbin.

      curl -H "host: example.com" <ADDRESS>/version

      version:v1

kubectl delete ingress ingress
kubectl delete service go-httpbin
kubectl delete deployment go-httpbin