From af97a0320e4c114b2e2a21b32d98a9867c130de4 Mon Sep 17 00:00:00 2001 From: Tim Flink Date: Tue, 9 May 2023 11:28:31 -0600 Subject: [PATCH] adding a sysadmin SOP for adding externally hosted services --- modules/sysadmin_guide/nav.adoc | 1 + .../pages/externally-hosted-services.adoc | 41 +++++++++++++++++++ 2 files changed, 42 insertions(+) create mode 100644 modules/sysadmin_guide/pages/externally-hosted-services.adoc diff --git a/modules/sysadmin_guide/nav.adoc b/modules/sysadmin_guide/nav.adoc index 83fa465..1684b5e 100644 --- a/modules/sysadmin_guide/nav.adoc +++ b/modules/sysadmin_guide/nav.adoc @@ -26,6 +26,7 @@ ** xref:dnf-counting.adoc[DNF Counting - SOP] ** xref:dns.adoc[DNS repository for fedoraproject - SOP] ** xref:docs.fedoraproject.org.adoc[Docs - SOP] +** xref:externally-hosted-services.adoc[Externally Hosted Services - SOP] ** xref:fas-notes.adoc[Fedora Account System - SOP] ** xref:fas-openid.adoc[FAS-OpenID - SOP] ** xref:fedmsg-certs.adoc[fedmsg (Fedora Messaging) Certs, Keys, and CA - SOP] diff --git a/modules/sysadmin_guide/pages/externally-hosted-services.adoc b/modules/sysadmin_guide/pages/externally-hosted-services.adoc new file mode 100644 index 0000000..e913f8f --- /dev/null +++ b/modules/sysadmin_guide/pages/externally-hosted-services.adoc @@ -0,0 +1,41 @@ += Externally Hosted Services + +There are services which are requested but not hosted using the traditional Fedora infrastructure. This SOP describes +the process for getting those services integrated. + + +== Contact Information +Owner::: + Fedora Infrastructure Team +Contact::: + #fedora-admin, sysadmin-main, sysadmin-dns +Purpose::: + Allow externally hosted services to appear as *.fedoraproject.org + +== Description + +Allowing external services to have a *.fedoraproject.org DNS entry will be decided on a case-by-case basis. Regardless +of where or how a service is hosted, if it can be accessed via a Fedora project domain, there is an impression that we +are responsible and that the service represents us. + +To submit a service for consideration, open a ticket with the following information: + + * What is the promise of support? + + * Is there a point of contact for issues of normal priority? + + - If there are problems identified, this is the contact point that will deal with them. + - Use common sense to decide whether the point of contact should be included in the ticket. If it's not included, + be ready to submit it via less public channels. + + * Is there a point of contact for emergency or sensitive issues? + + - This is for issues which either can't wait for the normal support process or require more descretion. + - This will frequently be contact information (email, phone number) for a specific person + - Do not put contact information for individuals in the ticket + + * Acknowlegement that the service provider has been told who is authorized to ask for changes and a list of who + those people are. + +Once the ticket has been submitted, there will be a discussion and decision on whether or not a *.fedoraproject.org +DNS entry will be allocated for this service.