Skip Navigation
Show nav
Heroku Dev Center
  • Get Started
  • Documentation
  • Changelog
  • Search
  • Get Started
    • Node.js
    • Ruby on Rails
    • Ruby
    • Python
    • Java
    • PHP
    • Go
    • Scala
    • Clojure
  • Documentation
  • Changelog
  • More
    Additional Resources
    • Home
    • Elements
    • Products
    • Pricing
    • Careers
    • Help
    • Status
    • Events
    • Podcasts
    • Compliance Center
    Heroku Blog

    Heroku Blog

    Find out what's new with Heroku on our blog.

    Visit Blog
  • Log inorSign up
View categories

Categories

  • Heroku Architecture
    • Dynos (app containers)
    • Stacks (operating system images)
    • Networking & DNS
    • Platform Policies
    • Platform Principles
  • Command Line
  • Deployment
    • Deploying with Git
    • Deploying with Docker
    • Deployment Integrations
  • Continuous Delivery
    • Continuous Integration
  • Language Support
    • Node.js
    • Ruby
      • Rails Support
      • Working with Bundler
    • Python
      • Background Jobs in Python
      • Working with Django
    • Java
      • Working with Maven
      • Java Database Operations
      • Working with the Play Framework
      • Working with Spring Boot
      • Java Advanced Topics
    • PHP
    • Go
      • Go Dependency Management
    • Scala
    • Clojure
  • Databases & Data Management
    • Heroku Postgres
      • Postgres Basics
      • Postgres Getting Started
      • Postgres Performance
      • Postgres Data Transfer & Preservation
      • Postgres Availability
      • Postgres Special Topics
    • Heroku Data For Redis
    • Apache Kafka on Heroku
    • Other Data Stores
  • Monitoring & Metrics
    • Logging
  • App Performance
  • Add-ons
    • All Add-ons
  • Collaboration
  • Security
    • App Security
    • Identities & Authentication
    • Compliance
  • Heroku Enterprise
    • Private Spaces
      • Infrastructure Networking
    • Enterprise Accounts
    • Enterprise Teams
    • Heroku Connect (Salesforce sync)
      • Heroku Connect Administration
      • Heroku Connect Reference
      • Heroku Connect Troubleshooting
    • Single Sign-on (SSO)
  • Patterns & Best Practices
  • Extending Heroku
    • Platform API
    • App Webhooks
    • Heroku Labs
    • Building Add-ons
      • Add-on Development Tasks
      • Add-on APIs
      • Add-on Guidelines & Requirements
    • Building CLI Plugins
    • Developing Buildpacks
    • Dev Center
  • Accounts & Billing
  • Troubleshooting & Support
  • Integrating with Salesforce
  • Add-ons
  • All Add-ons
  • Stackhero for RabbitMQ
Stackhero for RabbitMQ

This add-on is operated by Stackhero

RabbitMQ on dedicated instances, up-to-date versions and super attractive prices

Stackhero for RabbitMQ

Last updated January 13, 2023

Table of Contents

  • Provisioning the Add-on
  • Local Setup
  • Connect to Stackhero Dashboard
  • Connecting to RabbitMQ
  • RabbitMQ with GoLang
  • RabbitMQ with PHP
  • Upgrading Your Plan
  • Removing the Add-on
  • Support
  • Additional Resources

Stackhero for RabbitMQ provides a managed RabbitMQ running on a fully dedicated instance. It provides the following features:

  • A private instance (dedicated VM)
  • A dedicated public IP (v4)
  • TLS encryption (aka SSL)
  • An automatic backup every 24 hours
  • One click to update to new RabbitMQ versions
  • The ability to start some RabbitMQ plugins
  • The access to AMQP, MQTT and STOMP protocols

Provisioning the Add-on

Stackhero for RabbitMQ can be attached to a Heroku application via the CLI:

A list of all plans available can be found here.

$ heroku addons:create ah-rabbitmq-stackhero --app <your app name>
-----> Adding ah-rabbitmq-stackhero to sharp-mountain-4005... done

After you provision Stackhero for RabbitMQ, the STACKHERO_RABBITMQ_HOST, STACKHERO_RABBITMQ_USER, and STACKHERO_RABBITMQ_PASSWORD config variables are available in your app’s configuration. They contain the URL and credential to connect to your RabbitMQ instance.

Stackhero for RabbitMQ supports the following protocols:

  • AMQP
  • MQTT
  • STOMP

Enable or disable them in your Stackhero dashboard.

Retrieve the URL for each protocol by reading the following environment variables:

  • STACKHERO_RABBITMQ_AMQP_URL_TLS
  • STACKHERO_RABBITMQ_MQTT_URL_TLS
  • STACKHERO_RABBITMQ_STOMP_URL_TLS

You can see the content of these variables via the heroku config:get command:

$ heroku config:get STACKHERO_RABBITMQ_AMQP_URL_TLS
$ heroku config:get STACKHERO_RABBITMQ_MQTT_URL_TLS
$ heroku config:get STACKHERO_RABBITMQ_STOMP_URL_TLS

Local Setup

After you provision the add-on, you must replicate its config variables locally.

Use the Heroku Local command-line tool to configure, run, and manage process types specified in your app’s Procfile. Heroku Local reads configuration variables from an .env file. To view all of your app’s config variables, type heroku config. Use the following command for each value you want to add to your .env file:

heroku config:get <STACKHERO_MEMCACHED_VARIABLE> -s  >> .env

For example:

$ heroku config:get STACKHERO_RABBITMQ_AMQP_URL_TLS -s  >> .env

Don’t commit credentials and other sensitive configuration values to source-control. In Git, exclude the .env file with: echo .env >> .gitignore.

For more information, see Heroku Local.

Connect to Stackhero Dashboard

View your instance usage, restart it, and apply updates with the Stackhero dashboard. You can access the dashboard via the CLI:

$ heroku addons:open ah-rabbitmq-stackhero
Opening ah-rabbitmq-stackhero for sharp-mountain-4005

You can also visit the Heroku Dashboard, select your application, and then select Stackhero for RabbitMQ from the Add-ons menu.

Connecting to RabbitMQ

RabbitMQ uses the AMQP protocol. Select a client library that supports AMQP protocol.

Connect to your RabbitMQ instance with the STACKHERO_RABBITMQ_AMQP_URL_TLS environment variable. It contains your instances host, port, and credentials.

RabbitMQ with GoLang

Here is a simple example to connect to RabbitMQ from a GoLang app using the official Go RabbitMQ Client Library.

  1. Create a new directory and initialize the module: go mod init rabbitmq-example.
  2. Add the RabbitMQ library: go get github.com/rabbitmq/amqp091-go.
  3. Create a new file named main.go and add this content:

    package main
    
    import (
      "fmt"
      "os"
      amqp "github.com/rabbitmq/amqp091-go"
    )
    
    func main() {
      connection, err := amqp.Dial(os.Getenv("STACKHERO_RABBITMQ_AMQP_URL_TLS"))
      AMQP_URL_TLS
      if err != nil {
        panic(err)
      }
      defer connection.Close()
    
      fmt.Println("Successfully connected to RabbitMQ instance")
    }
    
  4. Run your code: go run main.go.

Example of RabbitMQ Go code running on Stackhero Code Hero service

You should see the sentence “Successfully connected to RabbitMQ instance” meaning your code has connect to your RabbitMQ instance in a secured way, using authentication and TLS encryption (amqps URL).

To go further, you’ll find some Go examples on the official RabbitMQ repository here: https://github.com/rabbitmq/rabbitmq-tutorials/tree/main/go.

RabbitMQ with PHP

Here is a simple example to connect to RabbitMQ from PHP using the library php-amqplib.

As Stackhero instances use TLS encryption (SSL), you have to use AMQPSSLConnection to connect to your RabbitMQ server.

use PhpAmqpLib\Connection\AMQPSSLConnection;

$connection = new AMQPSSLConnection(getenv('STACKHERO_RABBITMQ_HOST'), 5671, getenv('STACKHERO_RABBITMQ_USER'), getenv('STACKHERO_RABBITMQ_PASSWORD'), '/', array());

/**
 * @param \PhpAmqpLib\Connection\AbstractConnection $connection
 */
function shutdown($connection)
{
  $connection->close();
}

register_shutdown_function('shutdown', $connection);

Manually download the CA certificate

The TLS connection requires a Certificate Authority (CA). This certificate is probably yet installed on your server and there is a good chance it will work directly. If it is not the case, you can download the certificate by clicking here and save it to your server.

You can then use this code to connect using the CA certificate “isrgrootx1.pem”:

$sslOptions = array(
  'cafile' => realpath(__DIR__ . '/isrgrootx1.pem'),
);

$connection = new AMQPSSLConnection(getenv('STACKHERO_RABBITMQ_HOST'), 5671, getenv('STACKHERO_RABBITMQ_USER'), getenv('STACKHERO_RABBITMQ_PASSWORD'), '/', $sslOptions);

Upgrading Your Plan

You can’t downgrade an existing add-on.

Use the heroku addons:upgrade command to migrate to a new plan.

$ heroku addons:upgrade ah-rabbitmq-stackhero:newplan
-----> Upgrading ah-rabbitmq-stackhero:newplan to sharp-mountain-4005... done
       Your plan has been updated to: ah-rabbitmq-stackhero:newplan

Manage migration timing to ensure your application is available during the migration process.

Removing the Add-on

You can remove Stackhero for RabbitMQ via the CLI:

This destroys all associated data and can’t be undone!

$ heroku addons:destroy ah-rabbitmq-stackhero
-----> Removing ah-rabbitmq-stackhero from sharp-mountain-4005... done

Support

Stackhero for RabbitMQ support and runtime issues should be submitted via one of the Heroku Support channels. We recommend adding support@stackhero.io in copy for urgent issues.

Additional Resources

  • RabbitMQ documentation by Stackhero
  • RabbitMQ managed cloud hosting

Keep reading

  • All Add-ons

Feedback

Log in to submit feedback.

Ziggeo Stackhero for Redis®

Information & Support

  • Getting Started
  • Documentation
  • Changelog
  • Compliance Center
  • Training & Education
  • Blog
  • Podcasts
  • Support Channels
  • Status

Language Reference

  • Node.js
  • Ruby
  • Java
  • PHP
  • Python
  • Go
  • Scala
  • Clojure

Other Resources

  • Careers
  • Elements
  • Products
  • Pricing

Subscribe to our monthly newsletter

Your email address:

  • RSS
    • Dev Center Articles
    • Dev Center Changelog
    • Heroku Blog
    • Heroku News Blog
    • Heroku Engineering Blog
  • Heroku Podcasts
  • Twitter
    • Dev Center Articles
    • Dev Center Changelog
    • Heroku
    • Heroku Status
  • Facebook
  • Instagram
  • Github
  • LinkedIn
  • YouTube
Heroku is acompany

 © Salesforce.com

  • heroku.com
  • Terms of Service
  • Privacy
  • Cookies
  • Cookie Preferences