infra-docs-fpo/modules/sysadmin_guide/pages/infra_handover.adoc
Mark O Brien 1cf219687d add SOP for initiative handovers
Signed-off-by: Mark O Brien <markobri@redhat.com>
2022-02-28 17:25:11 +00:00

85 lines
3.7 KiB
Text

== Infra & Releng Initiative Handover Template
---
=== Overview
The following is a Questionnaire to be filled out when an initiative is being handed over to the Infra & releng team. Some questions may be simple answers or not applicable. The answers for these questions should then form the basis an SOP.
A Pull Request for this SOP should then be raised against https://pagure.io/infra-docs-fpo for Fedora Infrastructure and Release Engineering or https://git.centos.org/centos/centos-infra-docs for CentOS infrastructure.
A code walkthrough may be necessary as part of the handover to the I&R team member to help with understanding.
It may not be the case that every question matches to every initiative but please answer the questions as applicable and discuss any others with the Infra & Releng point of contact.
---
=== Questionnaire
.Infra & Releng Point of Contact:
_Name of the I&R team member who will take the handover_
.Initiative subject matter expert:
_Name of the initiative lead and any others on the team who would be confident in debugging issues in the application, this person will likely remain the POC for difficult to resolve issues_
.Outline the project. What does it do:
_A brief description of what the project does_
.Tech details:
_What language is the project written in, does it have a
.Steps to reboot the service:
_This may be as simple as reloading the package but should be recorded_
.Location of logs:
_Where are the logs stored_
.Where are the docs:
_Link to documentation of the project_
.What are the first steps to take when debugging:
_Where should we look first? Httpd logs, journal logs etc.._
.Is there any ephemeral data:
_If the service was to suddenly go offline would there be anything lost or unrecoverable_
.Is there any persistent data:
_Is there any data such as a db we should know about? Is there a model of it? How do we search it and what information may be useful_
.Is there data that needs to be backed up:
_Location of any data that may need to be backed up_
.Upgrade process:
_What is the process to upgrade the application? Include any steps related to cutting a new release. This could be a link to documentation._
.Any related applications:
_Does it link to any other application e.g. fedora-messaging if yes where and how._
.How is it deployed:
_Is this in openshift, does it use s2i, RPMs, built from git?, or on a server. how is it installed: RPM, git checkout?, what are the required packages etc.. There may be some crossover with the upgrade section here._
.Does this have any special requirements:
_Does this require a specific hardware? e.g. needs to be x86 or aarch64. Does it require X amount of space? Does it need to be bare metal?_
.What access requirements or permissions are needed:
_Does this need openshift access, what groups can access the server etc.._
.Are there any security requirements:
_Does this require tight access or certain network rules or Security audit etc.._
.Where are bug reports to go?
_What tracker should we use to report bugs for this project?_
.Are there any GDPR related concerns?
_Does this contain any Personally identifiable information? If yes, where is it stored and how is it used?_
.Mechanisms to deal with PII?
_How do we deal with GDPR requests for a user? Does it have a SAR script following the agreed upon API? Has the SAR script been integrated into the ansible playbook?_
.Monitoring:
_Are there tests that Nagios could alert on? Are there metrics that should be graphed with collectd/rrdtool? Are there metrics that should be alerted on?_
.Any other considerations:
_This is a catch all for anything that is particular to just one initiative. If there is something in this section that may occur in other initiatives it should be added as a new question._