vrr/g3
2
0
Fork 0
mirror of https://github.com/bytedance/g3.git synced 2026-05-04 22:51:02 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 6
g3/doc/packaging.md
Zhang Jingqiang 055195ab32 update doc
2025-05-19 12:07:38 +08:00

2.2 KiB
Raw Blame History

Release and Packaging

deb and rpm package files are provided by default for each application, you can use them to build binary packages to install on other machines.

Package a tagged version

We set tags for each release of each application in the form <name>-v<version>. You can use these tags to generate source tarballs and then build packages from these tarballs.

  1. generate a release tarball

    # if we have a tag <name>-v<version>
./scripts/release/build_tarball.sh <name>-v<version>
# if no tags usable, you need to specify the git revision (e.g. HEAD)
./scripts/release/build_tarball.sh <name> <rev>

    All vendor sources will be added to the source tarball, so you can save the source tarball and build it offline at anywhere that has the compiler and dependencies installed.

  2. build the package

    For deb package:

    tar xf <name>-<version>.tar.xz
cd <name>-<version>
./build_deb_from_tar.sh

    For rpm package:

    rpmbuild -ta ./<name>-<version>.tar.xz
# if failed, you can run the following commands manually:
tar xvf <name>-<version>.tar.xz ./<name>-<version>/<name>.spec
cp <name>-<version>.tar.xz ~/rpmbuild/SOURCES/
rpmbuild -ba ./<name>-<version>/<name>.spec

Package a specific git commit

  • Check out that git commit first

  • For deb package:

    ./build_deb_from_git.sh <name>

  • For rpm package:

    ./build_rpm_from_git.sh <name>

Pre-Built Packages

It is recommended to build packages yourself if you want to install them in a production environment.

For testing purpose, we have built and uploaded some packages to cloudsmith, you can find installation instructions there.

Build Docker Image

You can find Dockerfile(s) under docker folder of each application. The build command will be like

# run this in the source root dir
docker build -f <app>/docker/debian.Dockerfile . -t <app>:<tag>
# build without the source code
docker build -f <app>/docker/debian.Dockerfile github.com/bytedance/g3 -t <app>:<tag>
# if you have a source tarball, you can also use the URL of that tarball