From: Thanh Ha <thanh.ha@linuxfoundation.org>
Date: Tue, 6 Feb 2018 01:48:12 +0000 (-0500)
Subject: Add escalation document
X-Git-Url: https://gerrit.linuxfoundation.org/infra/gitweb?a=commitdiff_plain;h=refs%2Fchanges%2F79%2F8679%2F10;p=releng%2Fdocs.git

Add escalation document

Change-Id: I6a9beb80690ca9abbaf23137f8bb4bb8bbb4db1a
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>
---

diff --git a/docs/infra/escalation.rst b/docs/infra/escalation.rst
new file mode 100644
index 0000000..56fa810
--- /dev/null
+++ b/docs/infra/escalation.rst
@@ -0,0 +1,50 @@
+.. _infra-escalation:
+
+##########
+Escalation
+##########
+
+.. admonition:: Attention
+   :class: danger
+
+   This document is for LF internal release engineering. The information
+   below references communications channels that are not all reachable by
+   non-LF staff.
+
+Infrastructure critical to releng:
+
+1. Gerrit
+2. Nexus
+3. Jenkins
+
+Priority is to make sure developers are able to continue working. This means
+Jenkins, Nexus, and Gerrit are reachable and can perform code builds.
+
+.. note::
+
+   A project failing because of a bug or compile error in their code is not an
+   emergency. If known working code is failing because the job cannot fetch
+   code from Gerrit, or artifacts from Nexus, or builders are not spawning
+   in Jenkins would be an emergency as infrastructure is not working as expected
+   preventing the project from building their code.
+
+If we are unable to perform any builds and these services are offline then we
+need to make sure someone is working on getting these services back online.
+
+1. Look into the problem and see if we can fix it ourselves
+2. Failing that ping the IT team in ``#it-infra`` for help
+
+   .. note::
+
+      Use ``@here`` in the ``#it-infra`` channel to ping everyone in the channel.
+
+3. Contact emergency line: emergency@linuxfoundation.org
+
+   In the email provide these key details:
+
+   1. What project (FD.io / OpenDaylight / ONAP / OPNFV / etc...)
+   2. What service is failing (Gerrit / Jenkins / Nexus)
+
+   .. note::
+
+      The emergency line will ring the pager and contact whoever is on call.
diff --git a/docs/infra/index.rst b/docs/infra/index.rst
index 93bca5f..c0cb5a6 100644
--- a/docs/infra/index.rst
+++ b/docs/infra/index.rst
@@ -11,6 +11,7 @@ Infrastructure provided to projects.
    :maxdepth: 2
 
    inventory
+   escalation
    bootstrap
    jenkins
    jira