From 997f44e4818befe3ad9162435527ecf7b84946b3 Mon Sep 17 00:00:00 2001
From: lrossett <lrossett@redhat.com>
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`.