The following scripts can be used with podman instead of docker
as a virtualisation engine. In order to use podman you should
set environment variable USE_PODMAN="True".
Static binaries building using custom alpine image.
docker-static-build.sh will build tezos binaries
image defined in Dockerfile. In order to build them you should specify
TEZOS_VERSION env variable and run the script:
export TEZOS_VERSION="v7.3"
./docker-static-build.sh
After that, directory will contain built static binaries.
This script can optionally accept argument to define resulting binaries target architecture.
Currently supported architectures are: host and aarch64, so that
one can build native binaries for current architecture or build aarch64 binaries on
x86_64 machine.
Docker image defined in Dockerfile.aarch64 uses qemu for
compilation on aarch64. In particular it uses qemu-aarch64-static binary from
qemu-user-static repo.
In order to be able to compile tezos using aarch64 emulator you'll need to run:
docker run --rm --privileged multiarch/qemu-user-static:register --reset
This command will register qemu emulator in binfmt_misc.
Once this is done you should run the following command to build aarch64 static tezos binaries:
./docker-static-build.sh aarch64
It's possible to create packages (ubuntu/debian & fedora) using already built binaries. This means that the build step of the package will be reduced to copying the binaries instead of building again from scratch.
Using Ubuntu/Debian and assuming all Tezos binaries are located in the binaries directory:
cd .. && ./docker/docker-tezos-packages.sh --os ubuntu --type binary --binaries-dir binariesUsing Fedora and assuming all Tezos binaries are located in the binaries directory:
cd .. && ./docker/docker-tezos-packages.sh --os fedora --type binary --binaries-dir binariesThe resulting packages will be located in ../out directory.
We provide a way to build both binary and source native Ubuntu packages.
docker-tezos-packages.sh script with ubuntu argument
will build source or binary packages depending on the passed argument (source and binary respectively).
This script builds packages inside docker image defined in Dockerfile-ubuntu.
This script uses python script which generates meta information for
tezos packages based on information defined in meta.json and current tezos
version defined in meta.json and build native ubuntu packages.
In order to build binary .deb packages specify TEZOS_VERSION and
run the following command:
export TEZOS_VERSION="v7.3"
cd .. && ./docker/docker-tezos-packages.sh --os ubuntu --type binary
It is also possible to build single package. In order to do that run the following:
# cd .. && ./docker/docker-tezos-packages.sh --os ubuntu --type binary --package <tezos-binary-name>
# Example for baker
export TEZOS_VERSION="v7.3"
cd .. && ./docker/docker-tezos-packages.sh --os ubuntu --type binary --package tezos-baker-007-PsDELPH1
The build can take some time due to the fact that we build tezos and its dependencies from scratch for each package individually.
Once the build is completed the packages will be located in ../out directory.
In order to install .deb package run the following command:
sudo apt install <path to deb file>
In order to build source packages run the following commands:
export TEZOS_VERSION="v7.3"
cd .. && ./docker/docker-tezos-packages.sh --os ubuntu --type source
# you can also build single source package
cd .. && ./docker/docker-tezos-packages.sh --os ubuntu --type source --package tezos-baker-007-PsDELPH1
Once the packages build is complete ../out directory will contain files required
for submitting packages to the Launchpad.
There are 5 files for each package: .orig.tar.gz, .debian.tar.xz,
.dsc, .build-info, .changes.
You can test source package building using pbuilder.
In order to push the packages to the Launchpad PPA *.changes files should should be updated with
the submitter info and signed.
In order to update *.changes files with the proper signer info run the following:
sed -i "s/^Changed-By: .*$/Changed-By: $signer_info/" ../out/*.changes
For example, signer_info can be the following: Roman Melnikov <[email protected]>
Once these files are updated, they should be signed using debsign.
debsign ../out/*.changes
If you're not running dput on Ubuntu, you'll need to provide a config for it.
Sample config can be found here. Put the contents of this config
into ~/.dput.cf. In case you already have a config, add the following piece
to it for the further convenience:
[tezos-serokell]
fqdn = ppa.launchpad.net
method = ftp
incoming = ~serokell/ubuntu/tezos
login = anonymous
[tezos-rc-serokell]
fqdn = ppa.launchpad.net
method = ftp
incoming = ~serokell/ubuntu/tezos-rc
login = anonymous
Signed files now can be submitted to Launchpad PPA. In order to do that run the following
command for each .changes file:
dput tezos-serokell ../out/<package>.changes
# or tezos-rc-serokell in case the corresponding upstream version is release-candidate
dput tezos-rc-serokell ../out/<package>.changes
In case you're uploading the same version of the package but with a different
release number, you'll highly likely have to use the same source archive (.orig.tar.gz archive)
that was used for the first release in the scope of the same version, it can be downloaded from
the launchpad package details (e.g. https://launchpad.net/~serokell/+archive/ubuntu/tezos/+sourcefiles/tezos-client/2:7.4-0ubuntu2/tezos-client_7.4.orig.tar.gz).
Otherwise, Launchpad will prohibit the build of the new release.
In order to build new proper source package using existing source archive run the following:
cd .. && ./docker/docker-tezos-packages.sh --os ubuntu --type source --package tezos-client --sources <path to .orig.tar.gz>
After that, the resulting source package can be signed and uploaded to the Launchpad using the commands described previously.
We provide a way to build both binary(.rpm) and source(.src.rpm) native Fedora packages.
docker-tezos-packages.sh script with fedora argument
will build source or binary packages depending on the passed argument (source and binary respectively).
In order to build binary .rpm packages specify TEZOS_VERSION and
run the following command:
export TEZOS_VERSION="v7.3"
cd .. && ./docker/docker-tezos-packages.sh --os fedora --type binary
It is also possible to build single package. In order to do that run the following:
# cd .. && ./docker/docker-tezos-packages.sh --os fedora --type binary --package <tezos-binary-name>
# Example for baker
export TEZOS_VERSION="v7.3"
cd .. && ./docker/docker-tezos-packages.sh --os fedora --type binary --package tezos-baker-007-PsDELPH1
The build can take some time due to the fact that we build tezos and its dependencies from scratch for each package individually.
Once the build is completed the packages will be located in ../out directory.
In order to install .rpm package run the following command:
sudo yum localinstall <path to rpm file>
In order to build source packages run the following commands:
export TEZOS_VERSION="v7.3"
cd .. && ./docker/docker-tezos-packages.sh --os fedora --type source
# you can also build single source package
cd .. && ./docker/docker-tezos-packages.sh --os fedora --type source --package tezos-baker-007-PsDELPH1
Sign source packages:
rpm --addsign out/*.src.rpm
Note, that in order to sign them, you'll need gpg key to be set up in ~/.rpmmacros.
Signed package can be submitted to the Copr repository via copr-cli.
Read more about setting up copr-cli here.
In order to submit source package for building run the following command:
copr-cli build @Serokell/Tezos --nowait <path to '.src.rpm' file>
# or @Serokell/Tezos-rc in case the corresponding upstream version is release-candidate
copr-cli build @Serokell/Tezos-rc --nowait <path to '.src.rpm' file>