summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorsofukong <130022807+sofukong@users.noreply.github.com>2023-11-03 14:45:35 +0800
committersofukong <130022807+sofukong@users.noreply.github.com>2023-11-03 14:45:35 +0800
commit354d09858baab04d1a26076b64cea7fe0bfd5e67 (patch)
tree023f8bb30cc6b6438f803fb61148aa89b45d2821 /docs
parent77e17d2ed52030af1c3d7b91d90a751ffa742ce0 (diff)
downloadvyos-documentation-354d09858baab04d1a26076b64cea7fe0bfd5e67.tar.gz
vyos-documentation-354d09858baab04d1a26076b64cea7fe0bfd5e67.zip
更新 build-vyos.rst
因为版本更新,构建过程出现差异,因此删除了本页一些版本>=1.4的相关内容
Diffstat (limited to 'docs')
-rw-r--r--docs/contributing/build-vyos.rst34
1 files changed, 7 insertions, 27 deletions
diff --git a/docs/contributing/build-vyos.rst b/docs/contributing/build-vyos.rst
index 87d21a45..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,8 +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)
-- Debian (unknown) for VyOS 1.5 (current) - aka the rolling release
To start, clone the repository to your local machine:
@@ -221,12 +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)
- $ git clone -b sagitta --single-branch https://github.com/vyos/vyos-build
-
- # For VyOS 1.5 (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.
@@ -253,12 +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)
- $ git clone -b sagitta --single-branch https://github.com/vyos/vyos-build
-
- # For VyOS 1.5 (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:
@@ -271,12 +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)
- $ docker run --rm -it --privileged -v $(pwd):/vyos -w /vyos vyos/vyos-build:sagitta bash
-
- # For VyOS 1.5 (current)
- $ docker run --rm -it --privileged -v $(pwd):/vyos -w /vyos vyos/vyos-build:current bash
-
Start the build:
.. code-block:: none