diff options
author | Robert Göhler <github@ghlr.de> | 2023-11-16 21:44:29 +0100 |
---|---|---|
committer | GitHub <noreply@github.com> | 2023-11-16 21:44:29 +0100 |
commit | 3bcfaedc2be097364dd84c3dd2d13cf5ab7042a6 (patch) | |
tree | 22bc7a814edde9db3aebdc501524a194adda1b39 /docs/contributing/build-vyos.rst | |
parent | d9beffe0b68fd477ec2117fcade6fbe7c49ef7e7 (diff) | |
parent | 8182b5bef07d3338ca7d777ab4196056da11723d (diff) | |
download | vyos-documentation-3bcfaedc2be097364dd84c3dd2d13cf5ab7042a6.tar.gz vyos-documentation-3bcfaedc2be097364dd84c3dd2d13cf5ab7042a6.zip |
Merge pull request #1137 from sofukong/equuleus
update build-vyos.rst
Diffstat (limited to 'docs/contributing/build-vyos.rst')
-rw-r--r-- | docs/contributing/build-vyos.rst | 24 |
1 files changed, 7 insertions, 17 deletions
diff --git a/docs/contributing/build-vyos.rst b/docs/contributing/build-vyos.rst index 2ab9b13c..ee23ff22 100644 --- a/docs/contributing/build-vyos.rst +++ b/docs/contributing/build-vyos.rst @@ -23,9 +23,11 @@ also set up your own build machine and run a :ref:`build_native`. The source code remains public and an ISO can be built using the process outlined in this chapter. + Due to some differences in the version update and construction process, + this page no longer includes content related to VyOS 1.4 and above. + This will guide you though the process of building a VyOS ISO using Docker_. -This process has been tested on clean installs of Debian Jessie, Stretch, and -Buster. +This process has been tested on clean installs of Debian Jessie and Buster. .. _build_docker: @@ -34,6 +36,8 @@ Docker Installing Docker_ and prerequisites: +.. hint:: Due to the updated version of Docker, the following examples may + become invalid. `On Debian`_ @@ -109,7 +113,7 @@ ensure that the container is always up-to-date. A rebuild is triggered once the container changes (please note this will take 2-3 hours after pushing to the vyos-build repository). -.. note: If you are using the pre-built container, it will be automatically +.. note:: If you are using the pre-built container, it will be automatically downloaded from DockerHub if it is not found on your local machine when you build the ISO. @@ -122,7 +126,6 @@ To manually download the container from DockerHub, run: $ docker pull vyos/vyos-build:crux # For VyOS 1.2 $ docker pull vyos/vyos-build:equuleus # For VyOS 1.3 - $ docker pull vyos/vyos-build:current # For rolling release Build from source ^^^^^^^^^^^^^^^^^ @@ -135,13 +138,10 @@ The container can also be built directly from source: $ git clone -b crux --single-branch https://github.com/vyos/vyos-build # For VyOS 1.3 (equuleus) $ git clone -b equuleus --single-branch https://github.com/vyos/vyos-build - # For VyOS 1.4 (sagitta, current) - $ git clone -b current --single-branch https://github.com/vyos/vyos-build $ cd vyos-build $ docker build -t vyos/vyos-build:crux docker # For VyOS 1.2 $ docker build -t vyos/vyos-build:equuleus docker # For VyOS 1.3 - $ docker build -t vyos/vyos-build:current docker # For rolling release .. note:: Since VyOS has switched to Debian (11) Bullseye in its ``current`` branch, you will require individual container for `current`, `equuleus` and @@ -208,7 +208,6 @@ following Debian versions installed: - Debian Jessie for VyOS 1.2 (crux) - Debian Buster for VyOS 1.3 (equuleus) -- Debian Bullseye for VyOS 1.4 (sagitta, current) - aka the rolling release To start, clone the repository to your local machine: @@ -220,9 +219,6 @@ To start, clone the repository to your local machine: # For VyOS 1.3 (equuleus) $ git clone -b equuleus --single-branch https://github.com/vyos/vyos-build - # For VyOS 1.4 (sagitta, current) - $ git clone -b current --single-branch https://github.com/vyos/vyos-build - For the packages required, you can refer to the ``docker/Dockerfile`` file in the repository_. The ``./configure`` script will also warn you if any dependencies are missing. @@ -249,9 +245,6 @@ Please note as this will differ for both `current` and `equuleus`. # For VyOS 1.3 (equuleus) $ git clone -b equuleus --single-branch https://github.com/vyos/vyos-build - # For VyOS 1.4 (sagitta, current) - $ git clone -b current --single-branch https://github.com/vyos/vyos-build - Now a fresh build of the VyOS ISO can begin. Change directory to the ``vyos-build`` directory and run: @@ -264,9 +257,6 @@ Now a fresh build of the VyOS ISO can begin. Change directory to the # For VyOS 1.3 (equuleus) $ docker run --rm -it --privileged -v $(pwd):/vyos -w /vyos vyos/vyos-build:equuleus bash - # For VyOS 1.4 (sagitta, current) - $ docker run --rm -it --privileged -v $(pwd):/vyos -w /vyos vyos/vyos-build:current bash - Start the build: .. code-block:: none |