From 997f44e4818befe3ad9162435527ecf7b84946b3 Mon Sep 17 00:00:00 2001 From: lrossett Date: Mar 30 2021 11:14:22 +0000 Subject: mbs docs --- diff --git a/README.md b/README.md index d320502..7aa1c09 100644 --- a/README.md +++ b/README.md @@ -7,3 +7,5 @@ This repository aims to contain several procedures for the centos stream team me [MBBOX](./blob/master/f/mbbox) [Fedora Messaging](./blob/master/f/fedora-messaging) + +[MBS](./blob/master/f/mbs) diff --git a/mbs/README.md b/mbs/README.md new file mode 100644 index 0000000..1f11e31 --- /dev/null +++ b/mbs/README.md @@ -0,0 +1,60 @@ +# MBS + +MBS is deployed in centos stream by the following components: + +* Ansible Fedmsg Role +* Ansible MBS Role + +Note: MBS depends on Fedmsg as a bridge to fedora-messaging. + +## Ansible Fedmsg Role + +Repository: https://github.com/CentOS/ansible-role-fedmsg + +### Dependencies + +None + +### Description + +This role installs fedmsg in a host with zeromq enabled. + +We need zeromq enabled since that's what is used to bridge fedmsg to fedora-messaging. + +It is currently deployed in the same host used by MBS. + +## Ansible MBS Role + +Repository: https://github.com/CentOS/ansible-role-mbs + + +### Dependencies + +* https://github.com/CentOS/ansible-role-fedmsg +* https://github.com/CentOS/ansible-role-httpd +* https://github.com/CentOS/ansible-role-postgresql + +### Description + +This role installs both mbs-frontend and mbs-backend. + +Including the role without specifying a task file will install everything in the same host +but you can select to install either one by including a specific task file: https://github.com/CentOS/ansible-role-mbs/tree/staging/tasks - keep in mind you may also need to select `system.yml` if doing so. + +MBS Frontend requirements: + +* kerberos keytabfile for httpd POST authentication (GET requests are authless). +* HTTPD CA, certificate and key files; + +MBS Backend requirements: + +* keytab file for koji authentication + +Fedmsg usage: + +* Bridges fedora-messaging messages to MBS; +* communication between mbs-frontend to mbs-backend; +* listen to messages sent by fedora-messaging; +* koji updates will be sent to fedora-messaging which will be consumed by a mbs consumer and trigger workers accordingly. + +You can see messages sent to fedmsg by running `fedmsg-tail` or `fedmsg-tail --include org.centos.prod.buildsys`.