55f888b923
minor grammar tweaks |
||
---|---|---|
.. | ||
startup | ||
build_and_deploy_kasm.sh | ||
build_www.sh | ||
build-and-test-deb | ||
build-and-test-rpm | ||
build-deb | ||
build-deb-inside-docker | ||
build-package | ||
build-rpm | ||
build-rpm-inside-docker | ||
build-tarball | ||
build.sh | ||
dockerfile.centos_core.barebones.rpm.test | ||
dockerfile.centos_core.build | ||
dockerfile.centos_core.rpm.build | ||
dockerfile.centos_core.rpm.test | ||
dockerfile.debian_bullseye.build | ||
dockerfile.debian_bullseye.deb.build | ||
dockerfile.debian_bullseye.deb.test | ||
dockerfile.debian_buster.barebones.deb.test | ||
dockerfile.debian_buster.build | ||
dockerfile.debian_buster.deb.build | ||
dockerfile.debian_buster.deb.test | ||
dockerfile.fedora_thirtythree.barebones.rpm.test | ||
dockerfile.fedora_thirtythree.build | ||
dockerfile.fedora_thirtythree.rpm.build | ||
dockerfile.fedora_thirtythree.rpm.test | ||
dockerfile.kali_kali-rolling.build | ||
dockerfile.kali_kali-rolling.deb.build | ||
dockerfile.kali_kali-rolling.deb.test | ||
dockerfile.ubuntu1604.build | ||
dockerfile.ubuntu_bionic.build | ||
dockerfile.ubuntu_bionic.deb.build | ||
dockerfile.ubuntu_bionic.deb.test | ||
dockerfile.ubuntu_bionic.test | ||
dockerfile.ubuntu_focal.barebones.deb.test | ||
dockerfile.ubuntu_focal.build | ||
dockerfile.ubuntu_focal.deb.build | ||
dockerfile.ubuntu_focal.deb.test | ||
dockerfile.ubuntu_focal.test | ||
dockerfile.www.build | ||
os_ver_cli.sh | ||
README.md | ||
test-deb | ||
test-deb-barebones | ||
test-rpm | ||
test-rpm-barebones |
REQIUREMENTS
Docker CE
Build a deb/rpm package
# builder/build-package <os> <os_codename>
# os_codename is what "lsb_release -c" outputs, e.g. buster, focal.
# Packages will be placed under builder/build/
builder/build-package ubuntu bionic
builder/build-package ubuntu focal
builder/build-package debian buster
builder/build-package debian bullseye
builder/build-package kali kali-rolling
builder/build-package centos core # CentOS 7
builder/build-package fedora thirtythree
Build and test a package
builder/build-and-test-deb ubuntu focal
builder/build-and-test-rpm centos core
Open browser and point to https://localhost:443/ or https://<ip-address>:443/
3 default users are created:
- 'foo' with default password 'foobar'. It can use mouse and keyboard.
- 'foo-ro' with default password 'foobar'. It can only view.
- 'foo-owner' with default password 'foobar'. It can manage other users.
Test a package
If you want to test deb/rpm package you've already built, please use this:
builder/test-deb ubuntu focal
It will install the package inside a new container and run KasmVNC.
Open browser and point to https://localhost:443/ or https://<ip-address>:443/
Package development
deb/rpm package building and testing
First, a tarball is built, and then its files are copied to deb/rpm package as it is being built. Package testing stage installs the deb/rpm package in a fresh docker container and runs KasmVNC.
builder/build-tarball debian buster
builder/build-deb debian buster
builder/test-deb debian buster
Use build-and-test-deb
to perform the whole dev lifecycle, but to iterate
quickly, you'll need to skip building the tarball (which takes a long time), and
just build your deb/rpm with build-deb
and test with test-deb
.
build-rpm
and test-rpm
are also available.
Ensuring packages have all dependencies they need.
If you're working on a deb/rpm package, testing that it has all the necessary dependencies is done via testing in a barebones environment (read: no XFCE). In this way we can be sure that runtime dependencies aren't met accidentally by packages installed with XFCE.
builder/test-deb-barebones ubuntu focal