Update CI Resources and Requirements

Indicates what requirements each resource type should meet in order to
be considered part of OPNFV CI along with listing of the resources
available.

Includes a list of labels applied to servers and their intended use.

JIRA: RELENG-403
Change-Id: I0ba2671e95e29141d051019938fba930a42e7f56
Signed-off-by: Trevor Bramwell <tbramwell@linuxfoundation.org>

1 files changed, 58 insertions, 26 deletions

diff --git a/docs/ci/resources.rst b/docs/ci/resources.rst
index 572852c48..b4efe9704 100644
--- a/docs/ci/resources.rst
+++ b/docs/ci/resources.rst
@@ -13,49 +13,81 @@ verification needs. Each resource must meet a set of criteria in order
 to be part of CI for an OPNFV release. There are three types of
 resources:
 
-  - Baremetal PODs (PODs)
-  - Virtual PODs (vPODs)
-  - Build Servers
+- Baremetal PODs (PODs)
+- Virtual PODs (vPODs)
+- Build Servers
+
+
+.. _ci-resources-baremetal-pods:
 
---------------
 Baremetal PODs
 --------------
 
-TBD
+Baremetal PODs are used to deploy OPNFV on to baremetal hardware through
+one of the installer projects. They enable the full range of scenarios
+to be deployed and tested.
 
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Baremetal PODs Requirements
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
+**Requirements**
 
 In order of a POD to be considered CI-Ready the following requirements
 must be met:
 
-  #. Pharos Compliant and has a PDF
-  #. Connected to Jenkins
-  #. 24/7 Uptime
-  #. No Development
-  #. No manual intervention
+#. Pharos Compliant and has a PDF
+#. Connected to Jenkins
+#. 24/7 Uptime
+#. No Development
+#. No manual intervention
 
-------------
-Virtual PODS
+.. include:: tables/ci-baremetal-servers.rst
+
+
+.. _ci-resources-virtual-pods:
+
+Virtual PODs
 ------------
 
-TBD
+Virtual PODs are used to deploy OPNFV in a virtualized environment
+generally on top of KVM through libvirt.
 
-~~~~~~~~~~~~
-Requirements
-~~~~~~~~~~~~
+**Requirements**
 
-TBD
+#. Have required virtualization packages installed
+#. Meet the Pharos resource specification for virtual PODs
+#. Connected to Jenkins
+#. 24/7 Uptime
+
+.. include:: tables/ci-virtual-servers.rst
+
+.. _ci-resources-build-servers:
 
--------------
 Build Servers
 -------------
 
-TBD
+Build servers are used to build project, run basic verifications (such
+as unit tests and linting), and generate documentation.
+
+**Requirements**
+
+#. Have required `packages_` installed
+#. 24/7 Uptime
+#. Connected to Jenkins
+
+.. include:: tables/ci-build-servers.rst
+
+.. _dev-resources:
+
+=====================
+Development Resources
+=====================
+
+.. include:: tables/none-ci-servers.rst
+
+.. _ci-lables:
+
+===================
+CI Resources Labels
+===================
 
-~~~~~~~~~~~~
-Requirements
-~~~~~~~~~~~~
+.. include:: tables/ci-labels.rst
 
-TBD
+.. _packages: https://wiki.opnfv.org/display/INF/Continuous+Integration#ContinuousIntegration-BuildServers