Sign inSign up

vtchrispeterson/rabbitmqadmin

By vtchrispeterson

•Updated about 7 years ago

A docker image for administration of RabbitMQ (rabbitmqadmin)

Image
0

500K+

vtchrispeterson/rabbitmqadmin repository overview

⁠Overview

A docker image for administration of RabbitMQ (using rabbitmqadmin)

The container contains the following:

⁠Tags⁠

  • latest

In the future, additional tags may be used to allow clients to pin to specific functionality

⁠Usage

Pull the docker image from Docker Hub:

docker pull vtchrispeterson/rabbitmqadmin

By default, this will pull the latest tag.

The default CMD is rmqa which invokes rabbitmqadmin honoring environment varibles⁠.

⁠Environment Variables

A few environment variables can be provided:

namedefaultdescription
RABBIT_HOST127.0.0.1IP or FQDN of the RabbitMQ server
RABBIT_PORT15672Management port of the RabbitMQ server
RABBIT_USERguestAdministrator username
RABBIT_PASSWORDguestAdministrator password
RABBIT_ECHO<unset> (disabled)If set, commands are echoed to console
⁠Examples

The following are some common examples for how you might use the container.

⁠Example: List Queues
docker run -e RABBIT_HOST=rabbitmqserver \
   -e RABBIT_USER=admin -e RABBIT_PASSWORD=p@ssw0rd \
   vtchrispeterson/rabbitmqadmin rmqa list queues
⁠Example: Export Configuration
docker run -e RABBIT_HOST=rabbitmqserver \
   -e RABBIT_USER=admin -e RABBIT_PASSWORD=p@ssw0rd \
   vtchrispeterson/rabbitmqadmin rmqa export config.json
⁠Example: Show Overview
docker run -e RABBIT_HOST=rabbitmqserver \
   -e RABBIT_USER=admin -e RABBIT_PASSWORD=p@ssw0rd \
   vtchrispeterson/rabbitmqadmin rmqa show overview --format=pretty_json
⁠Example: GitLab CI
stages:
- snapshot
- deploy
- rollback

image: vtchrispeterson/rabbitmqadmin

variables:
  RABBIT_USER: admin
  RABBIT_PASSWORD: p@ssw0rd

.snapshot:
  stage: snapshot
  script: rmqa export $RABBIT_HOST.config
  artifacts:
    paths:
    - $RABBIT_HOST.config
    expire_in: 1 week

.deploy:
  stage: deploy
  script: scripts/deploy.sh
  when: manual

.rollback:
  stage: rollback
  script: rmqa import $RABBIT_HOST.config
  when: manual

snapshot:test:
  extends: .snapshot
  environment: test
  variables:
    RABBIT_HOST: test-rabbitmqserver

deploy:test:
  extends: .deploy
  environment: test
  variables:
    RABBIT_HOST: test-rabbitmqserver

rollback:test:
  extends: .rollback
  environment: test
  variables:
    RABBIT_HOST: test-rabbitmqserver

snapshot:production:
  extends: .snapshot
  environment: production
  variables:
    RABBIT_HOST: production-rabbitmqserver

deploy:production:
  extends: .deploy
  environment: production
  variables:
    RABBIT_HOST: production-rabbitmqserver

rollback:production:
  extends: .rollback
  environment: production
  variables:
    RABBIT_HOST: production-rabbitmqserver

⁠Local Development

To build the latest image from source, run make

To get a list of commands supported by rabbitmqadmin, consult documentation⁠, or run make help.

To test out the container in interactive mode, make interactive.

For testing, consider running RabbitMQ locally:

docker run -p 15672:15672 rabbitmq:3.7.17-management

Tag summary

Content type

Image

Digest

Size

16.2 MB

Last updated

about 7 years ago

docker pull vtchrispeterson/rabbitmqadmin