PR#5: mbs docs - centos/stream-team-docs

centos / stream-team-docs

#5 mbs docs

Opened 3 years ago by lrossett. Modified 3 years ago

centos/ lrossett/stream-team-docs mbs-docs into master

lrossett • 3 years ago

997f44

<a class="font-weight-bold ml-2" href="/fork/lrossett/centos/stream-team-docs/blob/7aa1c09eceb402858af62a6c12da310168caeed6/f/README.md" title="View file as of 7aa1c0">README.md</a>

<div class="btn btn-outline-secondary disabled opacity-100 border-0 font-weight-bold"> file modified </div> <div class="btn-group"> <span class="btn btn-success btn-sm font-weight-bold disabled opacity-100">+2</span> </div> <a class="btn btn-outline-primary btn-sm ml-2" href="/fork/lrossett/centos/stream-team-docs/blob/7aa1c09eceb402858af62a6c12da310168caeed6/f/README.md" title="View file as of 7aa1c0"> <i class="fa fa-file-code-o fa-fw"></i> </a> <a class="btn btn-sm btn-outline-primary diffhighlightcollapse ml-2 pointer" data-toggle="collapse" data-target="#diffhighlight_1"> <i class="fa fa-fw fa-caret-up"></i> </a>

		`@@ -7,3 +7,5 @@`
		`[MBBOX](./blob/master/f/mbbox)`

		`[Fedora Messaging](./blob/master/f/fedora-messaging)`
		`+`
		`+ [MBS](./blob/master/f/mbs)`

<a class="font-weight-bold ml-2" href="/fork/lrossett/centos/stream-team-docs/blob/1f11e310934e965ea41e2f0ab8091948adc08288/f/mbs/README.md" title="View file as of 1f11e3">mbs/README.md</a>

<div class="btn btn-outline-success disabled opacity-100 border-0 font-weight-bold"> file added </div> <div class="btn-group"> <span class="btn btn-success btn-sm font-weight-bold disabled opacity-100">+60</span> </div> <a class="btn btn-outline-primary btn-sm ml-2" href="/fork/lrossett/centos/stream-team-docs/blob/1f11e310934e965ea41e2f0ab8091948adc08288/f/mbs/README.md" title="View file as of 1f11e3"> <i class="fa fa-file-code-o fa-fw"></i> </a> <a class="btn btn-sm btn-outline-primary diffhighlightcollapse ml-2 pointer" data-toggle="collapse" data-target="#diffhighlight_2"> <i class="fa fa-fw fa-caret-up"></i> </a>

		`@@ -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`.