summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--docs/contributing/build-vyos.rst3
-rw-r--r--docs/contributing/development.rst22
2 files changed, 23 insertions, 2 deletions
diff --git a/docs/contributing/build-vyos.rst b/docs/contributing/build-vyos.rst
index 2c490e44..4b77a697 100644
--- a/docs/contributing/build-vyos.rst
+++ b/docs/contributing/build-vyos.rst
@@ -37,7 +37,6 @@ To be able to use Docker_, the current non-root user should be added to the
.. note:: The build process needs to be built on a local file system, building
on SMB or NFS shares will result in the container failing to build properly!
-
Build Docker Container
----------------------
@@ -61,6 +60,8 @@ The container can always be built directly from source:
container in ``crux`` and ``current`` can and will differ once VyOS makes
the move towards Debian (10) Buster.
+.. _build_iso:
+
Build ISO
---------
diff --git a/docs/contributing/development.rst b/docs/contributing/development.rst
index 61c45dba..09cb361a 100644
--- a/docs/contributing/development.rst
+++ b/docs/contributing/development.rst
@@ -617,8 +617,28 @@ Migrating old CLI
- None
- All logic should be in the scripts
+Continous Integration
+---------------------
+
+VyOS makes use of Jenkins_ as our Continous Integration (CI) service. Our CI
+server is publicly accessible here: https://ci.vyos.net. You can get a brief
+overview of all required components shipped in a VyOS ISO.
+
+To build our modules we utilize a CI/CD Pipeline script. Each and every VyOS
+component comes with it's own ``Jenkinsfile`` which is (more or less) a copy.
+The Pipeline utilizes the Docker container from the :ref:`build_iso` section -
+but instead of building it from source on every run, we rather always fetch a
+fresh copy (if needed) from Dockerhub_.
+
+Each module is build on demand if a new commit on the branch in question is
+found. After a successfull run the resulting Debian Package(s) will be deployed
+to our Debian repository which is used during build time. It is located here:
+http://dev.packages.vyos.net/repositories/.
+
.. _process: https://blog.vyos.io/vyos-development-digest-10
.. _VyConf: https://github.com/vyos/vyconf/blob/master/data/schemata
.. _vyos-1x: https://github.com/vyos/vyos-1x/blob/current/schema/
.. _Jinja2: https://jinja.palletsprojects.com/
-.. _Phabricator: https://phabricator.vyos.net \ No newline at end of file
+.. _Phabricator: https://phabricator.vyos.net/
+.. _Jenkins: https://jenkins.io/
+.. _Dockerhub: https://hub.docker.com/u/vyos/