Antes de usar o SDK para enviar e receber mensagens, crie os recursos obrigatórios do ApsaraMQ for RocketMQ: uma instância, um tópico e um grupo de consumidores. Você também precisa do endpoint da instância. Especifique esses recursos no código do SDK.
Pré-requisitos
Informações básicas
Você pode criar recursos no console ou por meio de chamadas de API. O procedimento a seguir utiliza o console.
Para criar recursos usando a OpenAPI, consulte os tópicos abaixo:
Limites
-
Restrições de região
Certifique-se de que a instância criada esteja na mesma região da VPC e do vSwitch configurados nos pré-requisitos.
-
Convenções de nomenclatura
Para as convenções de nomenclatura de instâncias, tópicos e grupos de consumidores, consulte Cotas e limites.
-
Restrições de tipo de tópico
O tipo de mensagem de um tópico deve corresponder ao tipo das mensagens enviadas e recebidas. Por exemplo, se você criar um tópico para mensagens normais, só poderá usá-lo para enviar e receber mensagens normais, e não mensagens ordenadas. Para mais informações, consulte Recomendações de uso de tópicos.
Criar uma instância
Faça logon no console do ApsaraMQ for RocketMQ. No painel de navegação à esquerda, clique em Instances.
Na barra de navegação superior, selecione uma região, por exemplo, China (Hangzhou).
-
Na página Instances, clique em Create Instance. No painel Create Message Queue for Apache RocketMQ Instance, defina Instance Version como V5.0, selecione um Product Type e clique em OK.
O ApsaraMQ for RocketMQ oferece suporte aos seguintes tipos de product:
Subscription: modelo pré-pago com cobrança mensal baseada na especificação de computação da instância.
Pay-as-you-go: modelo pós-pago com cobrança horária baseada na especificação de computação da instância.
-
Serverless: modelo de pagamento conforme o uso, com cobrança baseada no número total de solicitações de mensagens.
NotaInstâncias Serverless estão disponíveis nas seguintes regiões: China (Hangzhou), China (Zhangjiakou), China (Beijing), China (Shenzhen), Singapore (Singapore), Germany (Frankfurt), US (Virginia) e US (Silicon Valley). Novas regiões serão adicionadas gradualmente. Para verificar a disponibilidade atual, consulte Regiões suportadas.
Para detalhes sobre itens faturáveis e cenários aplicáveis, consulte Visão geral de faturamento.
-
Na página de compra, selecione as especificações da instância, clique em Buy Now e conclua o pagamento.
Consulte as tabelas abaixo ao criar uma instância. Para obter detalhes sobre cada parâmetro, veja Selecionar edição da instância.
Serverless
Parâmetro
Valor de exemplo
Primary Edition
Standard
Modo de faturamento
O padrão é Pay-by-request.
Especificação de armazenamento de mensagens
Não é necessário selecionar uma capacidade de armazenamento. A cobrança ocorre com base no espaço de armazenamento realmente utilizado.
VPC ID
vpc-bp1cg09dua6sgh0
ID da VPC criada nos pré-requisitos.
ImportanteApós a criação da instância, não é possível alterar a VPC selecionada. Para mudar a VPC associada, libere a instância adquirida e compre uma nova.
vSwitch ID
vsw-bp1vqb0p9nz3irz
ID do vSwitch criado nos pré-requisitos.
Selecione dois vSwitch ID para uma instância Serverless.
ImportanteApós a criação da instância, não é possível alterar o vSwitch selecionado. Para modificar o vSwitch associado, libere a instância adquirida e compre uma nova.
Internet Access
Off
Nota-
Este procedimento usa acesso via VPC como exemplo; portanto, o acesso à Internet fica desativado por padrão. Para acessar o service pela Internet, defina Internet Access Type como Enabled.
Tipo de acesso à rede interna
O padrão é Pay-By-Data-Transfer.
Instâncias Serverless oferecem suporte apenas a acesso via VPC, sem suporte a acesso pela Internet.
Resource Group
Selecione o grupo de recursos padrão.
Security Group
Selecione o grupo de segurança criado durante os pré-requisitos.
Subscription ou pay-as-you-go
Parâmetro
Valor de exemplo
Primary Edition
Standard
Edição de subcategoria
Cluster High-availability Edition (Recomendado para ambientes de produção)
Especificação de computação para envio e recebimento de mensagens
rmq.s2.2xlarge
VPC ID
vpc-bp1cg09dua6sgh0
ID da VPC criada nos pré-requisitos.
ImportanteApós a criação da instância, não é possível alterar a VPC selecionada. Para mudar a VPC associada, libere a instância adquirida e compre uma nova.
vSwitch ID
vsw-bp1vqb0p9nz3irz
ID do vSwitch criado nos pré-requisitos.
ImportanteApós a criação da instância, não é possível alterar o vSwitch selecionado. Para mudar o vSwitch associado, libere a instância adquirida e compre uma nova.
Tipo de acesso público
Off
NotaEste procedimento usa acesso via VPC como exemplo; portanto, o acesso à Internet fica desativado por padrão. Para acessar o service pela Internet, defina o Internet access type como Enabled.
Resource Group
Selecione o grupo de recursos padrão.
Disk Encryption
Off
NotaA criptografia de disco tem suporte apenas para instâncias Platinum Edition.
Disk Encryption Key
key-hzz66c8207****
NotaID da chave usada para criptografia de disco na mesma região. Este parâmetro é necessário apenas quando Disk Encryption estiver definido como Enable.
-
Obter o endpoint da instância
Na página Instances, clique no nome da instância desejada.
-
Na página Instance Details, visualize as informações de endpoint na seção TCP Endpoint.
Endpoint de VPC: use este endpoint para acessar o ApsaraMQ for RocketMQ a partir de uma VPC. Ele é fornecido por padrão.
Endpoint público: use este endpoint para acessar o service pela Internet. Esta opção aparece apenas se o acesso público estiver ativado.
Obter o nome de usuário e a senha da instância
As etapas a seguir mostram como obter o nome de usuário e a senha do sistema usando o método de controle de acesso padrão: autenticação inteligente.
Caso prefira usar a autenticação por lista de controle de acesso (ACL), crie um usuário ACL, configure as permissões e utilize o nome de usuário e a senha da ACL. Para mais informações, consulte Autenticação de usuário.
Ao conectar um cliente ao servidor do ApsaraMQ for RocketMQ, configure o nome de usuário e a senha de acordo com o método de acesso.
Acesso via Internet: configure obrigatoriamente o nome de usuário e a senha da instância.
Acesso via VPC: para instâncias Serverless, as credenciais não são necessárias se o acesso sem autenticação estiver ativado. Para outros tipos de instância, a autenticação é automática e não exige credenciais.
Na página Instances, clique no nome da instância desejada.
No painel de navegação à esquerda, clique em Access Control.
Clique na aba Intelligent Authentication para visualizar o Username e a Password da instância.
Criar um tópico
Na página Instances, clique no nome da instância desejada.
No painel de navegação à esquerda, clique em Topics. Em seguida, na página Topics, clique em Create Topic.
No painel Create Topic, insira um nome e uma descrição para o tópico, defina Message Type como Normal Message e clique em OK.
Criar um grupo de consumidores
Na página Instances, clique no nome da instância desejada.
No painel de navegação à esquerda, clique em Groups. Em seguida, na página Groups, clique em Create Group.
No painel Create Group, insira um Group ID, mantenha os demais parâmetros com as configurações padrão e clique em OK.