Todos os produtos
Search
Central de documentação

Microservices Engine:Adicionar uma origem de service

Última atualização: Jul 20, 2026

Adicione serviços de contêiner (ACK e ACK Serverless Cluster), EDAS Built-in Registry, SAE Built-in Registry, SAE Kubernetes, MSE ZooKeeper (apenas para instâncias de gateway padrão) ou MSE Nacos como origens de service do Cloud Native Gateway.

Observações de uso

  • Se uma origem de service configurada se tornar inválida, remova-a manualmente. Caso contrário, problemas de estabilidade podem ocorrer, como falhas na sincronização de informações de service de outras origens.

  • Você pode adicionar serviços com domínios DNS ou endereços IP fixos sem configurar uma origem de service. Para mais informações, consulte Create a service.

  • Se a instância de gateway não oferecer suporte ao monitoramento de Kubernetes Ingress, atualize o gateway. Para mais informações, consulte Upgrade a Cloud Native Gateway.

  • Ao adicionar um serviço de contêiner ACK, o gateway monitora os recursos Service e Endpoints do cluster para descobrir serviços. Se você configure HTTPS por meio do Kubernetes Ingress, o gateway também monitorará recursos Secret para obter informações de certificado.

  • Se você tiver configurado políticas de controle de acesso para o API Server no cluster ACK, garanta que o gateway tenha permissão para acessá-lo.

Procedimento

  1. Faça login no console do MSE. Na barra de navegação superior, selecione uma região.

  2. No painel de navegação à esquerda, escolha Cloud-native Gateway > Gateways. Na página Gateways, clique em no ID do gateway.

  3. No painel de navegação à esquerda, clique em Routes. Em seguida, clique em na aba Source.

  4. Clique em Add Source. No painel Add Source, configure os parâmetros e clique em OK.

    As origens de service suportadas são Container Service, MSE Nacos, MSE ZooKeeper (apenas para instâncias de gateway padrão), SAE Built-in Registry e EDAS Built-in Registry.

    Container Service

    Parâmetro

    Descrição

    ACK/ACK Serverless Cluster

    Selecione o cluster onde o serviço de back-end está implantado.

    Nota

    Crie o gateway na mesma VPC do cluster de back-end para permitir a descoberta automática dos clusters nessa VPC ao adicionar uma origem de service.

    Importante

    A versão do cluster ACK deve ser 1,18 ou posterior. Se a versão for anterior a 1,18, atualize o cluster antes de associá-lo como origem de service. Recomenda-se a versão 1,28 ou posterior.

    Listen to Kubernetes Ingress

    • Ao ative esta opção, o gateway monitora automaticamente os recursos Ingress e aplica as configurações de domínio e rota correspondentes.

    • Ao desativar esta opção, o gateway para de monitorar recursos Ingress e todas as configurações aplicadas anteriormente via Ingress tornam-se inválidas. Use esta opção com cautela.

    Importante

    As configurações de domínio e rota definidas manualmente no console têm prioridade sobre as provenientes de recursos Ingress.

    Ingress Class

    A IngressClass usada pelo gateway para filtrar recursos Ingress.

    • Se este campo permanecer em branco, o gateway monitorará todos os recursos Ingress no cluster.

    • Se você especifique um valor, o gateway monitorará apenas os recursos Ingress nos quais o valor da anotação kubernetes.io/ingress.class ou do campo spec.ingressClassName corresponda ao valor definido. Apenas um único valor é suportado. Por exemplo, se você defina este parâmetro como nginx, o gateway monitorará recursos Ingress cuja IngressClass seja nginx ou não esteja especificada.

    Namespace

    O namespace no qual o gateway monitora recursos Ingress.

    • Se este campo permanecer em branco, o gateway monitorará recursos Ingress em todos os namespaces.

    • Se você especifique um valor, o gateway monitorará recursos Ingress apenas nesse namespace específico. Apenas um único valor é suportado.

    Update Ingress Status

    Ao ative esta opção, o gateway atualiza o campo status dos recursos Ingress monitorados com o endereço IP da instância SLB associada ao Cloud Native Gateway.

    Nota

    Este recurso está disponível apenas para instâncias de gateway da versão 1.2.9 ou posterior.

    Security Group Authorization

    O pool de nós do cluster de contêineres é protegido por um grupo de segurança. Para permitir que componentes externos acessem serviços no cluster, abra as portas de service necessárias nas regras do grupo de segurança.

    Você pode modifique as regras do grupo de segurança. Para mais informações, consulte Set security group rules.

    MSE Nacos

    Parâmetro

    Descrição

    Nacos Instance

    Selecione uma instância.

    Nota

    Apenas instâncias do MSE Nacos com MCPEnabled definido como true são exibidas. Você pode alterar essa configuração nos parâmetros da instância do MSE Nacos.

    MSE ZooKeeper

    Nota

    O MSE ZooKeeper é suportado como origem de service apenas para instâncias padrão do Cloud Native Gateway, não sendo compatível com instâncias serverless.

    Parâmetro

    Descrição

    Cluster Name

    Selecione um cluster.

    SAE Built-in Registry

    Parâmetro

    Descrição

    Namespace

    Selecione o namespace onde o serviço está implantado no SAE.

    Service Group

    Se o serviço usar um grupo de serviços específico, clique em Add Service Group para adicioná-lo.

    EDAS Built-in Registry

    Parâmetro

    Descrição

    Microservices Space

    Selecione o espaço de microsserviços onde o serviço está implantado no EDAS.

    Service Group

    Se o serviço usar um grupo de serviços específico, clique em Add Service Group para adicioná-lo.

    SAE Kubernetes

    Parâmetro

    Descrição

    Namespace

    Selecione o namespace onde o serviço está implantado no SAE Kubernetes.

Verificar o resultado

Retorne à página Routes e selecione a aba Source. Verifique se a nova origem de service aparece na lista.