Conectar nos brokers

Me diz onde bater.

— Marshall

Os brokers que você adiciona ficam como cartões na primeira tela. Os marcados com estrela vêm primeiro. Cada broker aberto ganha uma aba, então dá para deixar vários abertos; Broker › Abrir outro broker (⌘ N) adiciona mais um.

Kafka

Campo	Observação
Nome	Como o cartão e a aba aparecem
Bootstrap servers	host:porta, separados por vírgula quando são vários

Como ele entra

Opção	Quer dizer
Nenhuma	Conexão simples, sem credencial
TLS	Criptografado, mas o broker não pergunta quem você é
SASL	Você prova quem é, mas a conexão vai em texto puro
SASL + TLS	Criptografado, e você diz quem é. O que clusters gerenciados quase sempre pedem
mTLS	O seu certificado de cliente prova quem você é

• Mecanismos SASL: PLAIN, SCRAM-SHA-256 e SCRAM-SHA-512, com usuário e senha.
• Autoridade certificadora: Usar a do Mac (o trust store do macOS, o certo para um cluster gerenciado) ou escolher um arquivo PEM para uma CA própria.
• mTLS: escolha o seu certificado e a chave privada dele como arquivos PEM.

As senhas vão para o seu Keychain, nunca para um arquivo. Ao editar um broker, deixar a senha em branco mantém a que já está salva.

Schema Registry

Para decodificar Avro, coloque a URL do registry, e o usuário e a senha se ele pedir. Ele precisa ser compatível com o da Confluent. Deixe em branco se o cluster não tem. Veja Avro e Schema Registry.

RabbitMQ

O Marshall conversa com o RabbitMQ pela API de gerenciamento, então o plugin de management precisa estar ligado.

Campo	Observação
API de gerenciamento	A URL do management. A porta padrão é 15672, não a 5672 do AMQP
Usuário, Senha	Um usuário do management
Virtual host	Opcional

Ler uma mensagem do RabbitMQ tem um custo; veja RabbitMQ.

Bater antes

Testar conexão confere se tem alguém em casa antes de salvar. Nada é lido nessa etapa. Ele conta o que respondeu (por exemplo, que respondeu e tem um tópico), ou que ninguém respondeu, sem tirar conclusões.

No cartão

Cada cartão diz como o broker está protegido: criptografado, pede senha (guardada no seu Keychain), pede certificado, ou sem senha nenhuma. Editar este broker e Esquecer este broker ficam no menu dele.