vyos/vyos-documentation
1
0
Fork 0
mirror of https://github.com/vyos/vyos-documentation.git synced 2025-11-02 11:52:03 +01:00
Code Issues Packages Projects Releases Wiki Activity

build: builds on NFS/SMB shares are not supported

Browse Source
This commit is contained in:
Christian Poessinger 2019-09-06 11:29:53 +02:00
parent 59aa274b43
commit 59d4147a90
1 changed files with 18 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
docs/build-vyos.rst
View File

@ -3,13 +3,16 @@
Building VyOS using Docker
==========================
This will guide you though the process of building a VyOS ISO yourself using Docker and works best on a fresh installation of Debain 8 (Jessie).
This will guide you though the process of building a VyOS ISO yourself using
Docker and works best on a fresh installation of Debain 8 (Jessie).
.. note:: Starting with VyOS 1.2 the developers have decided to change their
release model. VyOS is now **free as in speech, but not as in beer**, meaning
that while VyOS is still an open source project, the release ISO's are no
longer free and can only be obtained via subscription, or by contributing to
the community. Since the source code is still public you can build your own
ISO using the process described here.
.. note:: Starting with VyOS 1.2 the developers have decided to change their release model.
VyOS is now **free as in speech, but not as in beer**, meaning that while VyOS is still an open source project, the release ISO's are no longer free and can only be obtained via subscription, or by contributing to the community.
Since the source code is still public you can build your own ISO using the process described here.
Installing Docker and it's prequisites
.. code-block:: sh
@ -20,16 +23,18 @@ Installing Docker and it's prequisites
root@build:~$ add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/debian $(lsb_release -cs) stable"
root@build:~$ apt update
root@build:~$ apt install docker-ce
Adding you user to the docker group to be able to execute the docker command without sudo
Adding you user to the docker group to be able to execute the ``docker`` command
without sudo.
.. code-block:: sh
root@build:~$ usermod -aG docker user
.. note:: It is recommended to use a non-root user from here on out
.. note:: It is recommended to use a non-root user from here on out.
.. note:: The build process needs to be built on a local file system, building
on SMB or NFS shares is not supported!
Cloning the vyos-build crux branch and creating the docker container
@ -38,21 +43,17 @@ Cloning the vyos-build crux branch and creating the docker container
user@build:~$ git clone -b crux --single-branch https://github.com/vyos/vyos-build.git
user@build:~$ cd vyos-build
user@build:~/vyos-build$ docker build -t vyos-builder docker
Running the container and building the ISO
Running the container and building the ISO
.. code-block:: sh
user@build:~$ docker run --rm -it --privileged -v $(pwd):/vyos -w /vyos vyos-builder bash
vyos_bld@d4220bb519a0:/vyos# ./configure --architecture amd64 --build-by "your@email.tld" --build-type release --version 1.2.0
vyos_bld@d4220bb519a0:/vyos# sudo make iso
You may use these options to customize you ISO
.. code-block:: sh
You may use these options to customize you ISO
code-block:: sh
-h, --help show this help message and exit
--architecture ARCHITECTURE
@ -76,5 +77,5 @@ You may use these options to customize you ISO
Custom APT entry
--custom-apt-key CUSTOM_APT_KEY
Custom APT key file
*Your freshly built ISO should now be in the build directory. Good luck!*