This repository has been archived by the owner on Dec 16, 2021. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
198 lines (143 loc) · 6.34 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
JonDoBrowser Build
=================
For detailed information on JonDoBrowser's building frameworks, please refer to the following wiki.
https://github.com/jondos/jondobrowser-build/wiki
Installing build dependencies
-----------------------------
To build JonDoBrowser, you need a Linux distribution that has support
for runc (such as Debian jessie, Ubuntu 16.04, Fedora 20, etc ...).
On Debian jessie, the runc package is available in backports. On Debian
stretch, the runc package is available in the main repository.
Your user account should have sudo access, which is required to be able
to extract container file systems, start containers and copy files to and
from containers.
The sources of most components are downloaded using git, which needs to
be installed. The sources of webrtc are downloaded using gclient, which
requires GTK+ 2.0 development files and curl to be installed.
You also need a few perl modules installed:
- YAML::XS
- File::Basename
- Getopt::Long
- Template
- IO::Handle
- IO::CaptureOutput
- File::Temp
- File::Slurp
- File::Path
- File::Copy::Recursive
- String::ShellQuote
- Sort::Versions
- Digest::SHA
- Data::UUID
- Data::Dump
If you are running Debian or Ubuntu, you can install them with:
# apt-get install libyaml-libyaml-perl libtemplate-perl \
libio-handle-util-perl libio-all-perl \
libio-captureoutput-perl libfile-slurp-perl \
libstring-shellquote-perl libsort-versions-perl \
libdigest-sha-perl libdata-uuid-perl libdata-dump-perl \
libfile-copy-recursive-perl git libgtk2.0-dev curl runc
The build system is based on rbm, which is included as a git submodule
in the rbm/ directory. You can fetch the rbm git submodule by running
'make submodule-update'.
Please keep in mind that this project depends on latest runc.
-------------------------------------------------------------
sudo apt-get install runc currently installs runc 1.0.0-rc2-dev.(As of October 2017)
You need runc 1.0.0-rc4-dev or later version to build jondobrowser.
If you have already installed go 1.9.2, then you can use it to compile latest runc.
(Don't forget to use go1.9 by typing 'gvm use go1.9' into the shell.)
https://github.com/opencontainers/runc/wiki/Ubuntu-14.04---Mint17-and-runc
[https://avatars3.githubusercontent.com/u/12563465?s=400&v=4]<https://github.com/opencontainers/runc/wiki/Ubuntu-14.04---Mint17-and-runc>
Ubuntu 14.04 Mint17 and runc · opencontainers/runc Wiki ...<https://github.com/opencontainers/runc/wiki/Ubuntu-14.04---Mint17-and-runc>
github.com
runc - CLI tool for spawning and running containers according to the OCI specification
How to install latest runc from source.
---------------------------------------
Install go1.9.
Download latest runc from here.
Follow the instructions to build and install runc.
Starting a build
----------------
To start a build, run one of the following commands, depending on the
channel you want to build:
$ make product
$ make alpha
$ make beta
Please keep in mind that before running make, you should checkout the specific version you want to build.
This project is still under development and new features and bug fixes are constantly added.
In order for you to quickly build the latest successful versions, we created multiple tags.
$ git tag
This will list all the available version you can build.
e.g.
jondobrowser-7.5.1.5
jondobrowser-7.5.5.51
jondobrowser-7.5.5.54
jondobrowser-7.5a1
jondobrowser-7.5a1.1
jondobrowser-7.5a1.2
jondobrowser-7.5a1.3
jondobrowser-7.5a1.4
jondobrowser-7.5a1.5
jondobrowser-7.5a1.6
jondobrowser-7.5a1.7
jondobrowser-7.5a5.5.1
jondobrowser-7.5a5.5.2
jondobrowser-7.5a5.5.3
jondobrowser-7.5a5.5.4
Here versions with 'a' are alpha builds and versions without it are product builds.
If you want to build the latest alpha version, then you can do it with the following commands.
$ git checkout jondobrowser-7.5a5.5.4
$ make alpha
If you want to build the latest product version, then you can do it with the following commands.
$ git checkout jondobrowser-7.5.5.54
$ make product
You can find the build result in the directory product/unsigned/$version
or alpha/unsigned/$version for product or alpha builds.
If you want to build for a specific platform only, append the platform
name to the makefile target:
$ make alpha-linux-x86_64
$ make alpha-linux-i686
$ make alpha-windows-i686
$ make alpha-osx-x86_64
Updating git sources
--------------------
You can run "make fetch" to fetch the latest sources from git for all
components included in JonDoBrowser. You should run this if you want to
make a build with the latest commits.
Number of make processes
------------------------
By default the builds are run with 4 processes simultaneously (with
make -j4). If you want to change the number of processes used, you can
set the RBM_NUM_PROCS environment variable:
$ export RBM_NUM_PROCS=8
You can also set the buildconf/num_procs option in rbm.local.conf.
Signing builds
--------------
If the environment variable RBM_SIGN_BUILD is set to 1, the
sha256sums-unsigned-build.txt file will be signed with gpg.
You can use the RBM_GPG_OPTS environment variable to add some options
to the gpg command used to sign the file. You can also set the
var/sign_build and var/sign_build_gpg_opts options in the rbm.local.conf
file.
Cleaning obsolete files and containers images
---------------------------------------------
You can run 'make clean' to clean old build files and containers that
are no longer used in current builds. Before doing that, you need to
configure the branches and build targets you are using in the
rbm.local.conf file. The cleaning script will check out all the configured
branches to create a list of used build files, and delete the files
from the 'out' directory that are not used. If you want to see the list
of files and containers that would be removed without doing it, you can
use 'make clean-dry-run'.
Common Build Errors
-------------------
You can look at the README.BUILD_ERRORS file for a list of common build
errors and their solutions.
Hacking on the JonDoBrowser build
--------------------------------
The file README.HACKING tries to list the main things to know when
making changes to the JonDoBrowser build.
Description of makefile rules
-----------------------------
You can find a description of the makefile rules in the README.MAKEFILE
file.