ApsaraMQ for RocketMQ:Use instances

Instâncias padrão

As instâncias padrão compartilham um namespace global:

• Os nomes de recursos devem ser globalmente únicos, tanto dentro quanto entre todas as instâncias.

• Para usuários existentes, o sistema cria automaticamente uma instância padrão em cada região onde já existem recursos.

Para configurar o endpoint, acesse a página Instance Details no console do ApsaraMQ for RocketMQ e copie o valor do endpoint.

// Recommended
properties.put(PropertyKeyConst.NAMESRV_ADDR, "xxxx");

// Legacy (still supported, but NAMESRV_ADDR is preferred)
properties.put(PropertyKeyConst.ONSAddr, "xxxx");

Instâncias com namespaces

Instâncias com namespaces independentes restringem os nomes de recursos ao nível da instância:

• Os nomes de recursos precisam ser únicos apenas dentro da mesma instância. Diferentes instâncias podem reutilizar os mesmos nomes.

• Esse modelo é útil para configurações com várias equipes ou ambientes, nas quais cada equipe ou ambiente possui sua própria instância.

Para configurar o endpoint, acesse a página Instance Details no console do ApsaraMQ for RocketMQ e copie o valor do endpoint.

// Recommended
properties.put(PropertyKeyConst.NAMESRV_ADDR, "xxx");

O que mudou

Anteriormente, o ApsaraMQ for RocketMQ gerenciava três tipos de recurso — tópicos, producer IDs e consumer IDs — com relacionamentos N:N. Cada tópico exigia associações explícitas tanto com um produtor quanto com um consumidor, o que dificultava a manutenção em grande escala.

Group IDs substituem producer e consumer IDs

Producer IDs e consumer IDs agora estão unificados em group IDs. No console do ApsaraMQ for RocketMQ, os módulos Producers e Consumers foram mesclados em um único módulo Groups.

Fluxo de trabalho simplificado:

1. Crie um tópico (sem alterações).

2. Crie um group ID — não são necessários producer ou consumer IDs separados.

3. Associe o group ID a um tópico no código — sem necessidade de associação manual no console.

Atualize seu código

Use PropertyKeyConst.GROUP_ID em vez dos parâmetros obsoletos PropertyKeyConst.ProducerId e PropertyKeyConst.ConsumerId.

Recomendado:

// Use GROUP_ID for both producers and consumers.
// ProducerId and ConsumerId are deprecated.
properties.put(PropertyKeyConst.GROUP_ID, "The original CID-XXX or the GID-XXX");

Legado (ainda suportado):

// Producer
properties.put(PropertyKeyConst.ProducerId, "The original PID-XXX or the GID-XXX");

// Consumer
properties.put(PropertyKeyConst.ConsumerId, "The original CID-XXX or the GID-XXX");

Notas de compatibilidade

• Os producer e consumer IDs existentes continuam funcionando. Os serviços em execução não sofrem impacto.

• Consumer IDs que começam com CID- ou CID_ permanecem válidos. Especifique-os como valor de PropertyKeyConst.ConsumerId ou PropertyKeyConst.GROUP_ID.

• A lista de producer IDs não está mais visível no console, mas isso não afeta os serviços em execução.