Como configurar o RabbitMQ como um serviço fornecido pelo usuário

Este documento mostra como vincular o aplicativo a uma instância do RabbitMQ não listada no marketplace do Kf (incluindo o click-to-deploy do RabbitMQ no Marketplace com o Spring Cloud Foundry Connector). Isso faz com que as credenciais do RabbitMQ sejam injetadas no aplicativo e a vinculação aos serviços seja provisionada pelos planos do Marketplace.

Antes de começar

  • Verifique se o RabbitMQ está instalado e acessível pelo cluster do Kf.
  • Verifique se o RabbitMQ já foi configurado para o aplicativo.
  • Confirme se você definiu como destino o Space que está executando o aplicativo.

Criar a instância fornecida pelo usuário

Para o Kf vincular um aplicativo à instância do RabbitMQ, a variável de ambiente mínima é o URI (por exemplo, amqp://username:password@host:port/vhost?query). Também é possível incluir outros pares de chave-valor. A documentação do RabbitMQ pode ajudar na criação de uma string de URI. O exemplo a seguir deve ser suficiente para implantações básicas.

kf cups service-instance-name -p '{"uri":"amqp://username:password@rabbitmq-host:5672"}' -t "rabbitmq"

Vincular o aplicativo

Agora que o serviço fornecido pelo usuário foi criado, você pode vincular um aplicativo ao nome da instância:

kf bind-service application-name service-instance-name

Reinicie o aplicativo para que as alterações entrem em vigor:

kf restart application-name

É possível confirmar as novas variáveis de ambiente que estão sendo fornecidas ao aplicativo:

kf vcap-services application-name

Atualizar a instância fornecida pelo usuário

Se houver alterações no ambiente (por exemplo, atualização de senha ou host no URI ou o acréscimo de novos pares de chave-valor) que precisem ser transmitidas para qualquer aplicativo vinculado a ele, será possível atualizar a instância fornecida pelo usuário.

kf uups service-instance-name -p '{"uri":"new-uri", "some-new-key": "some-new-value"}'

Documentos relacionados