mirror of
https://github.com/vyos/vyos-documentation.git
synced 2025-10-26 08:41:46 +01:00
commit
3bcfaedc2b
@ -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
|
The source code remains public and an ISO can be built using the process
|
||||||
outlined in this chapter.
|
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 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
|
This process has been tested on clean installs of Debian Jessie and Buster.
|
||||||
Buster.
|
|
||||||
|
|
||||||
.. _build_docker:
|
.. _build_docker:
|
||||||
|
|
||||||
@ -34,6 +36,8 @@ Docker
|
|||||||
|
|
||||||
Installing Docker_ and prerequisites:
|
Installing Docker_ and prerequisites:
|
||||||
|
|
||||||
|
.. hint:: Due to the updated version of Docker, the following examples may
|
||||||
|
become invalid.
|
||||||
|
|
||||||
`On Debian`_
|
`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
|
container changes (please note this will take 2-3 hours after pushing to the
|
||||||
vyos-build repository).
|
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
|
downloaded from DockerHub if it is not found on your local machine when
|
||||||
you build the ISO.
|
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:crux # For VyOS 1.2
|
||||||
$ docker pull vyos/vyos-build:equuleus # For VyOS 1.3
|
$ docker pull vyos/vyos-build:equuleus # For VyOS 1.3
|
||||||
$ docker pull vyos/vyos-build:current # For rolling release
|
|
||||||
|
|
||||||
Build from source
|
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
|
$ git clone -b crux --single-branch https://github.com/vyos/vyos-build
|
||||||
# For VyOS 1.3 (equuleus)
|
# For VyOS 1.3 (equuleus)
|
||||||
$ git clone -b equuleus --single-branch https://github.com/vyos/vyos-build
|
$ 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
|
$ cd vyos-build
|
||||||
$ docker build -t vyos/vyos-build:crux docker # For VyOS 1.2
|
$ 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: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``
|
.. note:: Since VyOS has switched to Debian (11) Bullseye in its ``current``
|
||||||
branch, you will require individual container for `current`, `equuleus` and
|
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 Jessie for VyOS 1.2 (crux)
|
||||||
- Debian Buster for VyOS 1.3 (equuleus)
|
- 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:
|
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)
|
# For VyOS 1.3 (equuleus)
|
||||||
$ git clone -b equuleus --single-branch https://github.com/vyos/vyos-build
|
$ 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
|
For the packages required, you can refer to the ``docker/Dockerfile`` file
|
||||||
in the repository_. The ``./configure`` script will also warn you if any
|
in the repository_. The ``./configure`` script will also warn you if any
|
||||||
dependencies are missing.
|
dependencies are missing.
|
||||||
@ -249,9 +245,6 @@ Please note as this will differ for both `current` and `equuleus`.
|
|||||||
# For VyOS 1.3 (equuleus)
|
# For VyOS 1.3 (equuleus)
|
||||||
$ git clone -b equuleus --single-branch https://github.com/vyos/vyos-build
|
$ 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
|
Now a fresh build of the VyOS ISO can begin. Change directory to the
|
||||||
``vyos-build`` directory and run:
|
``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)
|
# For VyOS 1.3 (equuleus)
|
||||||
$ docker run --rm -it --privileged -v $(pwd):/vyos -w /vyos vyos/vyos-build:equuleus bash
|
$ 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:
|
Start the build:
|
||||||
|
|
||||||
.. code-block:: none
|
.. code-block:: none
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user