Para conectar um cliente a uma instância do ApsaraMQ for Kafka, você precisa do endpoint correto para o tipo de rede e os requisitos de segurança. Este tópico descreve os tipos de endpoint disponíveis e mostra como localizá-los no console do ApsaraMQ for Kafka.
Tipos de endpoint
O ApsaraMQ for Kafka oferece três tipos de endpoint:
|
Tipo de endpoint |
Rede |
Autenticação SASL |
Criptografia |
Caso de uso |
|
Endpoint padrão |
VPC |
Não |
Não |
Mensagens internas na VPC sem autenticação no nível do cliente |
|
Endpoint SASL |
VPC |
Sim |
Não |
Mensagens internas na VPC com autenticação no nível do cliente |
|
Endpoint SSL |
Internet |
Sim |
Sim (TLS) |
Mensagens pela internet com criptografia e autenticação |
Para obter uma comparação detalhada, consulte Comparação entre endpoints.
Endpoints exibidos por tipo de instância
Os endpoints disponíveis no console dependem da configuração da sua instância:
|
Tipo de instância |
Endpoints exibidos |
|
Conectada à VPC |
Endpoint padrão |
|
Conectada à Internet e à VPC |
Endpoint padrão, endpoint SSL |
Os endpoints SASL não ficam habilitados por padrão. Para usá-los, ative-os pelo recurso ACL. Para mais informações, consulte Usar o recurso ACL para controle de acesso.
Formato do endpoint
Os endpoints usam o seguinte formato:
<Instance domain name>:<Port number>Instâncias legadas ainda podem exibir endpoints no formato <Broker IP address>:<Port number>. Para garantir estabilidade a longo prazo, migre para o formato de nome de domínio. Consulte a seção "Migrar um endpoint legado para o formato de nome de domínio" abaixo.
Localizar seu endpoint no console
Faça login no console do ApsaraMQ for Kafka.
Na seção Resource Distribution da página Overview, selecione a região onde a instância está localizada.
Na página Instances, clique em nome da instância.
Na página Instance Details, clique em aba Instance Information.
Na seção Endpoint Information, localize o endpoint na coluna Domain Name.
Migrar um endpoint legado para o formato de nome de domínio
Se a instância ainda usar o formato legado <Broker IP address>:<Port number>, migre para o formato de nome de domínio para garantir estabilidade a longo prazo:
Na página Instance Details, clique em aba Instance Information.
Na seção Endpoint Information, clique em Enable Domain Name Feature na coluna Actions.
Na caixa de diálogo de confirmação Enable Domain Name Feature, clique em Enable.
Localize o novo endpoint na coluna Domain name.
Após a migração, você ainda pode visualizar o endpoint original baseado em IP passando o mouse sobre o nome de domínio.
Conectar um cliente usando o endpoint
Depois de obter o endpoint, use um SDK para conectar um cliente à instância do ApsaraMQ for Kafka. Para mais informações, consulte Visão geral do SDK.
Se a instância se conectar a uma VPC por meio de uma linha dedicada, defina os endereços de registro DNS como 100.100.2.136 e 100.100.2.138 antes de usar um SDK para acessar a instância.