Add link defs to sections 29/62129/2
authorThanh Ha <zxiiro@gmail.com>
Thu, 31 Oct 2019 21:37:53 +0000 (17:37 -0400)
committerThanh Ha <zxiiro@gmail.com>
Fri, 1 Nov 2019 15:12:35 +0000 (11:12 -0400)
Add link definitions to the Jenkins sections so that we can
intersphinx link to them in downstream docs.

Signed-off-by: Thanh Ha <zxiiro@gmail.com>
Change-Id: Icee5bd3bfaefc6be33fec57747f22937cead81dd

docs/jenkins.rst

index fc10379..d1c804c 100644 (file)
@@ -20,6 +20,7 @@ Jenkins jobs.
 
     jenkins-sandbox
 
+.. _jenkins-quick-start:
 
 Quick Start
 ===========
@@ -105,6 +106,8 @@ the jobs published in Jenkins.
 This will push the jobs to Gerrit and your jobs will appear in Jenkins once the
 releng/builder or ci-management teams has reviewed and merged your patch.
 
+.. _jenkins-build-minions:
+
 Build minions
 =============
 
@@ -130,6 +133,8 @@ section to understand how the configuration changes get merged.
 For details on how to build an image for a particular build flavor, refer to the
 :ref: `Packer Images <lfdocs-packer-images>` section.
 
+.. _jenkins-cloud-cfg:
+
 Cloud configuration (Global Configuration)
 ------------------------------------------
 
@@ -177,6 +182,8 @@ LFIT configures a cloud and build minions via OpenStack Cloud plugin:
 
       The value should match an available ``Label`` for the node template.
 
+.. _jenkins-build-minion-flavors:
+
 Build minion flavors
 --------------------
 
@@ -186,6 +193,8 @@ This section points to each LF project's build minions availability and flavors.
 
 .. todo:: Add more LF projects build minions links
 
+.. _jenkins-log-server:
+
 Log Server
 ==========
 
@@ -228,6 +237,8 @@ Nexus log repository. You can access these files through the URL.
 * Jenkins Sandbox:
   ``https://logs.example.org/sandbox``
 
+.. _jenkins-log-cleanup-schedule:
+
 Log Cleanup Schedule
 ====================
 
@@ -238,6 +249,8 @@ scheduled intervals.
   than 180 days.
 * Jenkins Sandbox: Delete logs and jobs every week on Saturday at 08:00 UTC.
 
+.. _jenkins-jjb:
+
 Jenkins Job Builder
 ===================
 
@@ -246,6 +259,8 @@ and uses them to configure Jenkins.
 
 * `Jenkins Job Builder (JJB) documentation <http://ci.openstack.org/jenkins-job-builder>`_
 
+.. _jenkins-jjb-overview:
+
 JJB Overview
 ------------
 
@@ -255,6 +270,8 @@ for consumption by Jenkins. When testing new Jenkins Jobs in the
 ``jenkins-jobs`` executable to translate a set of jobs into their XML
 descriptions and upload them to the Jenkins Sandbox server.
 
+.. _jenkins-jjb-install:
+
 Install JJB
 -----------
 
@@ -263,6 +280,8 @@ You can install the latest version of JJB and its dependencies with
 specific version of JJB in `jjb/requirements.txt`, as a workaround for known
 issues. The documentation is available in `pip-assisted <Install JJB using pip_>`_ install.
 
+.. _jenkins-virtualenv:
+
 Virtual Environments
 --------------------
 
@@ -304,6 +323,8 @@ To deactivate your virtual environment.
 
     deactivate
 
+.. _jenkins-jjb-install-pip:
+
 Install JJB using pip
 ---------------------
 
@@ -433,6 +454,8 @@ line in the logs that look like::
 
 This line provides the name of the new image we built.
 
+.. _jenkins-prod-sandbox:
+
 Jenkins Production & Jenkins Sandbox
 ====================================
 
@@ -475,6 +498,8 @@ to test compared to production Jenkins.
 Documentation on using the Jenkins Sandbox and uploading jobs is available
 :doc:`here <jenkins-sandbox>`.
 
+.. _jenkins-test-unmerged-cr:
+
 How to test unmerged CR in global-jjb or lftools with Jenkins
 =============================================================