From: Thanh Ha <thanh.ha@linuxfoundation.org>
Date: Fri, 9 Feb 2018 18:13:01 +0000 (+0000)
Subject: Merge "Add pip.conf to wrappers"
X-Git-Tag: v0.16.0~2
X-Git-Url: https://gerrit.linuxfoundation.org/infra/gitweb?a=commitdiff_plain;h=757650c835599c0aa4fe62ed99f05eab324c6f37;hp=c4295ab63bdbbceb6647b86ae27732364c2bce26;p=releng%2Fglobal-jjb.git

Merge "Add pip.conf to wrappers"
---

diff --git a/docs/configuration.rst b/docs/configuration.rst
new file mode 100644
index 00000000..af98c6e2
--- /dev/null
+++ b/docs/configuration.rst
@@ -0,0 +1,48 @@
+.. _global-jjb-configuration:
+
+#############
+Configuration
+#############
+
+Jenkins Files
+=============
+
+global-jjb makes use of the Jenkins Config File Provider plugin to provide some
+default configurations for certain tools. This section details the files to
+define in Jenkins' **Manage Files** configuration.
+
+npmrc
+-----
+
+This file contains default npmrc configuration and lives in $HOME/.npmrc.
+Documentation for npmrc is available via the `npm project
+<https://docs.npmjs.com/files/npmrc>`_.
+
+:Required: This file MUST exist. An empty file is acceptable if a
+proxy is not available for the project.
+:type: Custom file
+
+Create a "Custom file" with contents:
+
+.. code::
+
+   registry = https://nexus.opendaylight.org/content/repositories/npmjs/
+
+pip.conf
+--------
+
+This file contains default configuration for the python-pip tool and lives
+in $HOME/.config/pip/pip.conf. Documentation for pip.conf is available via the
+`pip project <https://pip.readthedocs.io/en/stable/user_guide/#configuration>`_.
+
+:Required: This file MUST exist. An empty file is acceptable if a
+proxy is not available for the project.
+:type: Custom file
+
+Create a "Custom file" with contents:
+
+.. code::
+
+   [global]
+   timeout = 60
+   index-url = https://nexus3.opendaylight.org/repository/PyPi/simple
diff --git a/docs/index.rst b/docs/index.rst
index bce1ed9a..19b6380c 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -15,6 +15,7 @@ Guides
    :maxdepth: 2
 
    best-practices
+   configuration
 
 Global JJB Templates
 --------------------
diff --git a/jjb/lf-macros.yaml b/jjb/lf-macros.yaml
index 14c23933..fb179926 100644
--- a/jjb/lf-macros.yaml
+++ b/jjb/lf-macros.yaml
@@ -470,3 +470,5 @@
           files:
             - file-id: npmrc
               target: '$HOME/.npmrc'
+            - file-id: pipconf
+              target: '$HOME/.config/pip/pip.conf'