From a10daf14c19aa144cb5c155607e7d316e711ca07 Mon Sep 17 00:00:00 2001 From: Pavel Raiskup Date: Mon, 4 Mar 2024 18:01:12 +0100 Subject: [PATCH] wip --- doc/maintenance/announce_outage.rst | 30 +++++++++--- .../announce_outage_example_01.rst | 49 +++++++++++++++++++ 2 files changed, 71 insertions(+), 8 deletions(-) create mode 100644 doc/maintenance/announce_outage_example_01.rst diff --git a/doc/maintenance/announce_outage.rst b/doc/maintenance/announce_outage.rst index c99e8e525..2bb80e8bd 100644 --- a/doc/maintenance/announce_outage.rst +++ b/doc/maintenance/announce_outage.rst @@ -19,20 +19,34 @@ follow the steps outlined in this document. Planned outage -------------- -1. Prepare the infrastructure ticket similar to `this old one `_. +1. Red Hatters-only: Schedule a calendar event, and invite the ``Engineering + Outage Calendar`` room. -2. Send email to `copr-devel`_ mailing list informing about an upcomming - release. We usually copy-paste text of the infrastructure ticket created in a - previous step. Don't forget to put a link to the ticket at the end of the - email. See the `example `_. +2. Prepare `an infrastructure ticket + `_ using one of these + templates -3. Adjust the `Matrix channel`_ title so it contains a message similar to:: + .. toctree:: + :maxdepth: 1 + + Upgrading packages + +3. Send email to `copr-devel`_ mailing list informing about an upcomming + release. We usually copy-paste text of the infrastructure ticket, including + a back-reference to the *infra ticket*. Sending to:: + + copr-devel@lists.fedorahosted.org + copr-team@redhat.com + OPT-IN buildsys@lists.fedoraproject.org + OPT-IN devel@lists.fedoraproject.org + +4. Adjust the `Matrix channel`_ title so it contains a message similar to:: Planned outage 2022-08-17 20:00 UTC - https://pagure.io/fedora-infrastructure/issue/10854 -4. Create a new "planned" `Fedora Status SOP`_ entry. +5. Create a new "planned" `Fedora Status SOP`_ entry. -6. Create warning banner on Copr homepage:: +7. Create warning banner on Copr homepage:: copr-frontend warning-banner --outage_time "2022-12-31 13:00-16:00 UTC" --ticket 1234 diff --git a/doc/maintenance/announce_outage_example_01.rst b/doc/maintenance/announce_outage_example_01.rst new file mode 100644 index 000000000..43d26c5f4 --- /dev/null +++ b/doc/maintenance/announce_outage_example_01.rst @@ -0,0 +1,49 @@ +.. _outage_announce_01: + +Upgrading packages +------------------ + +The Fedora Infra ticket and the e-mail may look like:: + + Subject: Fedora Copr Outage - Updating to a Version + ------------------------------------------------------------------ + + There will be a Fedora Copr outage starting at + + $ date --date "2023-11-28 13:30 UTC" + + The outage will last approximately 2 hours. The build queue processing will + be stopped during the outage, and the Frontend/Web-UI will be down most of + the time (no new tasks accepted). + + + The DNF packages and repositories (hosted on copr-backend) will be available + during this outage. + + + The DNF packages and repositories (hosted on copr-backend) will be + unavailable for a short period, about 10 minutes, as the copr-backend + machine will be rebooted. + + Reason for outage: + We will update the infrastructure machines to the latest packages that are + currently being developed. + + Affected Services: + https://copr.fedorainfracloud.org/ + https://download.copr.fedorainfracloud.org/results/ + + Upstream ticket: + https://github.com/fedora-copr/copr/issues/ + + + Infrastructure ticket: + https://pagure.io/fedora-infrastructure/issue/11468 + + Please join Fedora Build System Matrix channel: + https://matrix.to/#/#buildsys:fedoraproject.org + + Outage Contacts: + @nikromen (Jiří Kyjovský) / @frostyx (Jakub Kadlčík) / @praiskup (Pavel Raiskup) + + Or comment on this ticket.