Commands

Console Scripts

fedmsg provides a number of console scripts for use with random shell scripts.

fedmsg-logger

fedmsg.commands.logger.logger()

fedmsg-tail

fedmsg.commands.tail.tail()

fedmsg-dg-replay

fedmsg.commands.replay.replay()

fedmsg-collectd

fedmsg.commands.collectd.collectd()

fedmsg-check

fedmsg-check is used to check the status of consumers and producers. It requires the moksha.monitoring.socket key to be set in the configuration.

See usage details with fedmsg-check --help.

Service Daemons

fedmsg-hub

fedmsg.commands.hub.hub()

fedmsg-relay

fedmsg.commands.relay.relay()

Relay messages from an inbound subscription socket to an outbound publishing socket.

This service binds to two sockets, relay_inbound and relay_outbound. The inbound socket is a ZeroMQ SUB socket and the outbound socket is a ZeroMQ PUB socket.

Tools like fedmsg-logger require that an instance of fedmsg-relay be running somewhere and that it’s inbound address be listed in the config as one of the entries in relay_inbound.

fedmsg-signing-relay

fedmsg.commands.relay.signing_relay()

Sign and relay fedmsgs.

This relay behaves like the default relay, except that messages it receives are signed with the certificate referenced in the signing_relay key of the certnames dictionary in the fedmsg configuration.

This allows users to send unsigned messages on a trusted network and have a single exit point to an untrusted network that is cryptographically signed.

fedmsg-irc

fedmsg.commands.ircbot.ircbot()

fedmsg-gateway

fedmsg.commands.gateway.gateway()

Writing your own fedmsg commands

The fedmsg.commands module provides a @command decorator to help simplify this.

class fedmsg.commands.BaseCommand

Bases: object

daemonizable = False

execute()

extra_args = None

get_config()