Review greenwave SOP

Signed-off-by: Michal Konečný <mkonecny@redhat.com>
This commit is contained in:
Michal Konečný 2021-08-24 13:47:14 +02:00
parent a4d85a492a
commit c5856741b1
2 changed files with 11 additions and 12 deletions

View file

@ -42,7 +42,7 @@
** xref:geoip-city-wsgi.adoc[geoip-city-wsgi - SOP] ** xref:geoip-city-wsgi.adoc[geoip-city-wsgi - SOP]
** xref:github2fedmsg.adoc[github2fedmsg - SOP] ** xref:github2fedmsg.adoc[github2fedmsg - SOP]
** xref:github.adoc[Using github for Infra Projects - SOP] ** xref:github.adoc[Using github for Infra Projects - SOP]
** xref:greenwave.adoc[greenwave - SOP in review ] ** xref:greenwave.adoc[Greenwave - SOP]
** xref:guestdisk.adoc[guestdisk - SOP in review ] ** xref:guestdisk.adoc[guestdisk - SOP in review ]
** xref:guestedit.adoc[guestedit - SOP in review ] ** xref:guestedit.adoc[guestedit - SOP in review ]
** xref:haproxy.adoc[haproxy - SOP in review ] ** xref:haproxy.adoc[haproxy - SOP in review ]

View file

@ -8,8 +8,6 @@ Contact::
#fedora-qa, #fedora-admin #fedora-qa, #fedora-admin
Persons:: Persons::
gnaponie (giulia), mprahl, lucarval, ralph (threebean) gnaponie (giulia), mprahl, lucarval, ralph (threebean)
Location::
Phoenix
Public addresses:: Public addresses::
* https://greenwave-web-greenwave.app.os.fedoraproject.org/api/v1.0/version * https://greenwave-web-greenwave.app.os.fedoraproject.org/api/v1.0/version
* https://greenwave-web-greenwave.app.os.fedoraproject.org/api/v1.0/policies * https://greenwave-web-greenwave.app.os.fedoraproject.org/api/v1.0/policies
@ -24,7 +22,7 @@ Purpose::
* See * See
http://fedoraproject.org/wiki/Infrastructure/Factory2/Focus/Greenwave[the http://fedoraproject.org/wiki/Infrastructure/Factory2/Focus/Greenwave[the
focus document] for background. focus document] for background.
* See https://pagure.io/docs/greenwave/[the upstream docs] for more * See https://gating-greenwave.readthedocs.io/en/latest/[the upstream docs] for more
detailed info. detailed info.
Greenwave's job is: Greenwave's job is:
@ -36,18 +34,18 @@ Greenwave's job is:
* according to some policy * according to some policy
In particular, we'll be using Greenwave to provide yes/no gating In particular, we'll be using Greenwave to provide yes/no gating
decisions _to Bodhi_ about rpms in each update. Greenwave will do this decisions to _Bodhi_ about rpms in each update. Greenwave will do this
by consulting resultsdb and waiverdb for individual test results and by consulting resultsdb and waiverdb for individual test results and
then combining those results into an aggregate decision. then combining those results into an aggregate decision.
The _policies_ for how those results should be combined or ignored, are The _policies_ for how those results should be combined or ignored, are
defined in ansible in defined in ansible in
`roles/openshift-apps/greenwave/templates/configmap.yml`. We expect to https://pagure.io/fedora-infra/ansible/blob/main/f/roles/openshift-apps/greenwave/templates/configmap.yml[roles/openshift-apps/greenwave/templates/configmap.yml].
grow these over time to new use cases (rawhide compose gating, etc..) We expect to grow these over time to new use cases (rawhide compose gating, etc..)
== Observing Greenwave Behavior == Observing Greenwave Behavior
Login to `os-master01.phx2.fedoraproject.org` as `root` (or, Login to `os-master01.iad2.fedoraproject.org` as `root` (or,
authenticate remotely with openshift using authenticate remotely with openshift using
`oc login https://os.fedoraproject.org`), and run: `oc login https://os.fedoraproject.org`), and run:
@ -65,14 +63,14 @@ It relies on `resultsdb` and `waiverdb` for information.
== Upgrading == Upgrading
You can roll out configuration changes by changing the files in You can roll out configuration changes by changing the files in
`roles/openshift-apps/greenwave/` and running the https://pagure.io/fedora-infra/ansible/blob/main/f/roles/openshift-apps/greenwave[roles/openshift-apps/greenwave/] and running the
`playbooks/openshift-apps/greenwave.yml` playbook. https://pagure.io/fedora-infra/ansible/blob/main/f/playbooks/openshift-apps/greenwave.yml[playbooks/openshift-apps/greenwave.yml] playbook.
To understand how the software is deployed, take a look at these two To understand how the software is deployed, take a look at these two
files: files:
* `roles/openshift-apps/greenwave/templates/imagestream.yml` * https://pagure.io/fedora-infra/ansible/blob/main/f/roles/openshift-apps/greenwave/templates/imagestream.yml[roles/openshift-apps/greenwave/templates/imagestream.yml]
* `roles/openshift-apps/greenwave/templates/buildconfig.yml` * https://pagure.io/fedora-infra/ansible/blob/main/f/roles/openshift-apps/greenwave/templates/buildconfig.yml[roles/openshift-apps/greenwave/templates/buildconfig.yml]
See that we build a fedora-infra specific image on top of an app image See that we build a fedora-infra specific image on top of an app image
published by upstream. The `latest` tag is automatically deployed to published by upstream. The `latest` tag is automatically deployed to
@ -87,6 +85,7 @@ a new os.fp.o build and deployment should be automatically created.
You can watch the build and deployment with `oc` commands. You can watch the build and deployment with `oc` commands.
You can poll this URL to see what version is live at the moment: You can poll this URL to see what version is live at the moment:
https://greenwave-web-greenwave.app.os.fedoraproject.org/api/v1.0/version https://greenwave-web-greenwave.app.os.fedoraproject.org/api/v1.0/version
== Troubleshooting == Troubleshooting