We removed our free Sandbox April 25th.
You can read more on our blog.

CloudAMQP

This tutorial will walk you through using CloudAMQP’s managed RabbitMQ solution to help you use their RabbitMQ service with your dotCloud application.

  1. Visit http://CloudAMQP.com and sign up for an account
    1. Add your credit card information (if you want a paid version)

    2. Create a new instance.
      1. Select a Name
      2. Pick plan size
      3. Pick Data center location. We recommend Amazon US-East-1 so that it is as close to dotCloud’s servers as possible.
      4. Click Create
    3. Go to the control panel, and copy the URL for your new instance.

  2. Add the environment variables to your dotCloud application.

    There are two ways to get these variables. You can either look at the RabbitMQ URL, or you can look at the variables listed on the instance details page.

    Here is an Example RabbitMQ URL from CloudAMQP

    amqp://myUser:pJEeksq0E@tiger.cloudamqp.com/myUser

    The URLs are broken down like this

    amqp://Username:Password@Hostname:Port/VHost
    Username

    the username for your RabbitMQ instance.

    Password

    the password for your instance.

    Hostname

    the host where your RabbitMQ instance lives.

    Port

    the port number for your RabbitMQ instance on the host. If not there it defaults to 5672.

    VHost

    the virtualHost for your RabbitMQ instance.

    Notice in the example URL above, there is no port number listed, that means it defaults to 5672.

    Using that URL here is our VARIABLES:

    CLOUDAMQP_RABBITMQ_AMQP_HOST=tiger.cloudamqp.com
    CLOUDAMQP_RABBITMQ_AMQP_VIRTUALHOST=myUser
    CLOUDAMQP_RABBITMQ_AMQP_LOGIN=myUser
    CLOUDAMQP_RABBITMQ_AMQP_PASSWORD=pJEeksq0E
    CLOUDAMQP_RABBITMQ_AMQP_PORT=5672
    CLOUDAMQP_RABBITMQ_AMQP_URL=amqp://myUser:pJEeksq0E@tiger.cloudamqp.com/myUser
    

    Given the above variables now we need to add those to our dotCloud application. Replace <app_name> with the name of your dotCloud application.

    Run this on your command line:

    $ dotcloud env set <app_name> \
    'CLOUDAMQP_RABBITMQ_AMQP_HOST=tiger.cloudamqp.com' \
    'CLOUDAMQP_RABBITMQ_AMQP_VIRTUALHOST=myUser' \
    'CLOUDAMQP_RABBITMQ_AMQP_LOGIN=myUser' \
    'CLOUDAMQP_RABBITMQ_AMQP_PASSWORD=pJEeksq0E' \
    'CLOUDAMQP_RABBITMQ_AMQP_PORT=5672' \
    'CLOUDAMQP_RABBITMQ_AMQP_URL=amqp://myUser:pJEeksq0E@tiger.cloudamqp.com/myUser'
    

    After you run the command it will redeploy your application and those variables will now be available to you. To confirm run this command:

    $ dotcloud env list <app_name>
    
  3. Now that you have those variables available to your application, you will need to reference those variables when configuring your connection to RabbitMQ

Learning More

For more information you can look at CloudAMQP’s dotCloud documentation or RabbitMQ’s documentation there is a lot of good information there.