Jump to content

Wikimedia Cloud Services team/Clinic duties

From Wikitech

The WMCS team practices a clinic duty rotation that runs from one weekly team meeting to the next. Each team member takes a turn sequentially performing these duties. Clinic Duty runs from one weekly meeting to the next. Your shift begins after the weekly meeting, and ends with the next.

In a similar fashion, we have two oncall duty rotations, that also run for one week (see the calendar).

Clinic duty

Start of clinic duty

  • Archive the weekly meeting etherpad:
    • copy the entire content of the etherpad to https://office.wikimedia.org/wiki/Wikimedia_Cloud_Services/Meeting_Notes/YYYY-MM-DD
    • Create next week's etherpad at https://etherpad.wikimedia.org/p/WMCS-YYYY-MM-DD
    • Copy-paste the content of the old Etherpad to the new Etherpad
    • In the new Etherpad:
      • delete anything outdated, such as the meeting-specific agenda
      • modify the dates in the archive links at the top
      • update the "starts"/"ends" dates in the Clinic Duty section
      • update the "Next oncalls" section (you can import this calendar link to Google Calendar or to your calendar app)
      • remove the color highlight by clicking the "eye" icon in the Etherpad toolbar (Clear Authorship Colors)
    • In the old (archived) Etherpad:
      • delete all the content except the first four lines with the links to the archive
  • Update the topic (title) of the IRC channel #wikimedia-cloud-admin connect:
    • You need to first get op status on the channel: /msg chanserv op #wikimedia-cloud-admin (If that gives an error, you might not have the necessary permissions on the channel. Ask for help! :) )
    • Edit the channel topic:
      • if you are using IRCCloud, click on the "cog" icon on the top right, then on "Set topic..."
      • you can also use /topic New topic... or /msg chanserv topic #wikimedia-cloud-admin New topic...
    • The topic should point to the etherpad for the next meeting and indicate the nick of the person on clinic duty (usually it will be your nick if you're setting this message)
    • Remove your op status when you're done: /msg chanserv deop #wikimedia-cloud-admin


  • Monday: attend the "SRE Staff Meeting" (if scheduled for that week)
    • Report any WMCS updates that might be of interest to the wider SRE group:
      • Copy the "outgoing updates" from the WMCS Etherpad to the "SRE Staff Meeting" document (linked in the calendar event)
      • Feel free to add more items, or ask in IRC if you need suggestions
      • If you want to speak during the SRE meeting, put one or more items in bold, otherwise people will still see the items, but you will not be asked to speak about them
    • Listen to anything that could be relevant for the WMCS team:
      • Take notes during the meeting and add them to the WMCS etherpad under "Report from SRE meeting"
  • Thursday (at the end of the clinic duty shift): Facilitate the Weekly WMCS team meeting


Community Requests

Check for and respond to incoming requests. For new project requests or quota requests, please seek and obtain at least one other person's approval before approving and granting the request. Ensure this permission is explicitly documented on the phabricator ticket. For all floating IP requests, and any request you are unsure about, please bring up to the weekly meeting. Requests that represent an increase of more than double the quota or more than 300GB of storage should also be reviewed at the weekly meeting.


  • #wikimedia-cloud connect monitoring
    • Respond to help requests
    • Watch for pings to other team members and intercept if appropriate
    • Watch for pings to !help
    • Call people out for poor behavior in the channel
    • Praise people for helping constructively

Oncall duty

Oncall duty is a different shift than clinic duty, during your shift, you will be paged for critical issues, and you are expected to monitor and react to alerts, as well as highly prioritize working on tasks that improve the current alert/monitoring/stability of the platforms. See Decision Record for more information.


Cloud VPS alerts

These include things WMCS isn't directly responsible for. For this reason, most of these alerts aren't critical and aren't WMCS's problem to solve. However, projects for which WMCS is the owner / admin, like tools, admin, etc, are important and we should respond as the responsible party.


This list isn't exhaustive. Dashboards can be utilized to debug or confirm issues within WMCS platforms.


If nothing currently requires immediate attention, you should work on improving tooling in this area. Consider: