Plastron STOMP daemon
Project description
plastron-stomp
STOMP listener client for asynchronous and synchronous operations
Running with Python
As a Python module:
python -m plastron.stomp.daemon -c <config file>
Using the console script entrypoint:
plastrond-stomp -c <config file>
Integration Tests
See the integration test README for instructions on running the manual integration tests.
Docker Image
The plastron-stomp package contains a Dockerfile for
building the plastrond-stomp
Docker image.
Building
Important: This image MUST be built from the main plastron project directory, in order to include the other plastron packages in the build context.
docker build -t docker.lib.umd.edu/plastrond-stomp:latest \
-f plastron-stomp/Dockerfile .
Running with Docker Swarm
This repository contains a compose.yml file that defines
part of a plastrond
Docker stack intended to be run alongside the
umd-fcrepo-docker stack. This repository's configuration adds a
plastrond-stomp
container.
# if you are not already running in swarm mode
docker swarm init
# build the image
docker build -t docker.lib.umd.edu/plastrond-stomp:latest \
-f plastron-stomp/Dockerfile .
# Create an "archelon_id" private/public key pair
# The Archelon instance should be configured with "archelon_id.pub" as the
# PLASTRON_PUBLIC_KEY
ssh-keygen -q -t rsa -N '' -f archelon_id
# Copy the docker-plastron-template.yml and edit the configuration
cp docker-plastron.template.yml docker-plastron.yml
vim docker-plastron.yml
# deploy the stack to run the STOMP application
docker stack deploy -c plastron-stomp/compose.yml plastrond
To watch the logs:
docker service logs -f plastrond_stomp
To stop the STOMP service:
docker service rm plastrond_stomp
Configuration
See docker-plastron.template.yml for an example of the config file.
STOMP Message Headers
The Plastron Daemon expects the following headers to be present in messages
received on the JOBS
destination:
PlastronCommand
PlastronJobId
Additional arguments for a command are sent in headers with the form PlastronArg-{name}
.
Many of these are specific to the command, but there is one with standard behavior across
all commands:
Header | Description |
---|---|
PlastronArg-on-behalf-of |
Username to delegate repository operations to |
See the messages documentation for details on the headers and bodies of the messages the Plastron STOMP Daemon emits.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for plastron_stomp-4.3.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 04f8a74120deb38728ae8cef5fedfee3291c07eca648f0bcaf523f86c1d46a52 |
|
MD5 | 8c1ae16b988eca90d95d50a403f5a3a7 |
|
BLAKE2b-256 | b17200643be397e22a9ad0369e1ac30e84efdfaff15d93c7f7dac2248a225320 |