O ApsaraMQ for RocketMQ oferece SDKs de cliente TCP e HTTP para diversas linguagens de programação. Este guia orienta você na ativação do serviço, na criação de recursos e no envio das suas primeiras mensagens normais.
Escolha um protocolo
Cada instância do ApsaraMQ for RocketMQ disponibiliza um endpoint TCP e um endpoint HTTP. Selecione o protocolo adequado à sua carga de trabalho e utilize o SDK e o endpoint correspondentes.
|
Protocolo |
SDK |
|
TCP |
SDK de cliente TCP |
|
HTTP |
SDK de cliente HTTP |
Sempre associe o SDK ao seu endpoint correspondente. O SDK de cliente TCP conecta-se exclusivamente ao endpoint TCP, enquanto o SDK de cliente HTTP conecta-se apenas ao endpoint HTTP.
Pré-requisitos
Antes de começar, verifique se você possui:
Uma conta Alibaba Cloud com o ApsaraMQ for RocketMQ ativado
Permissões do RAM para crie e gerencie recursos do ApsaraMQ for RocketMQ
Um ambiente de cliente com o SDK da sua linguagem de programação instalado
Envie e receba mensagens normais
O ApsaraMQ for RocketMQ suporta quatro tipos de mensagem. Os passos a seguir utilizam mensagens normais como exemplo. Para trabalhar com mensagens ordenadas, transacionais ou agendadas, consulte a documentação específica de cada tipo.
Etapa 1: Ative o serviço e conceda permissões
Ative o ApsaraMQ for RocketMQ no console do Alibaba Cloud e configure as permissões do RAM para sua conta.
Etapa 2: Crie recursos
Crie uma instância, um tópico e um grupo no console do ApsaraMQ for RocketMQ.
Ao criar o tópico, selecione Normal Message como tipo de mensagem. Cada tópico suporta apenas um tipo de mensagem; portanto, um tópico de mensagem normal não pode enviar ou receber outros tipos.
Recomendamos criar grupos separados para consumidores TCP e HTTP, pois protocolos diferentes exigem SDKs de cliente distintos. Para limites de grupos e detalhes de configuração, consulte Gerenciar grupos.
Etapa 3: Obtenha o endpoint
Localize o endpoint TCP ou HTTP da sua instância. Escolha o endpoint compatível com o seu protocolo.
Endpoints públicos e privados estão disponíveis para TCP e HTTP em todas as regiões:
|
Tipo de endpoint |
Quando usar |
|
Endpoint de VPC (recomendado) |
Cargas de trabalho de produção. Sem cobrança de tráfego de Internet. |
|
Endpoint público |
Acesso entre regiões, data centers locais ou acesso via Internet quando a Cloud Enterprise Network (CEN) não estiver disponível. Há cobrança de tráfego de saída. Para mais detalhes, consulte Faturamento de tráfego de Internet. |
Etapa 4: Envie e receba mensagens
Utilize o SDK da sua linguagem de programação para conectar-se ao endpoint, enviar mensagens para o tópico e inscrever-se nas mensagens do tópico.
Para TCP, consulte Enviar e inscrever-se em mensagens com SDKs de cliente TCP.
Para HTTP, consulte Enviar e inscrever-se em mensagens com SDKs de cliente HTTP.
O fluxograma abaixo ilustra o processo de ponta a ponta:
