KasmVNC/builder
Kasm 55f888b923
Update README.md
minor grammar tweaks
2021-04-13 08:59:37 -04:00
..
startup Deb: make easy-start script easier to modify 2021-03-14 21:19:08 +13:00
build_and_deploy_kasm.sh Initial commit 2020-09-20 12:16:44 +00:00
build_www.sh added dockerfile build process for www 2021-01-10 19:03:13 +00:00
build-and-test-deb Move build-and-test-* to builder/ 2021-02-28 21:28:14 +13:00
build-and-test-rpm Move build-and-test-* to builder/ 2021-02-28 21:28:14 +13:00
build-deb Deb: release numbers (18.04) -> codenames (bionic) 2021-01-28 22:10:46 +13:00
build-deb-inside-docker Merge branch 'master' into create_ubuntu20_package 2021-02-14 18:59:53 +13:00
build-package CI: build all distros and upload to S3 2021-03-25 22:27:27 +13:00
build-rpm Rpm: automate rpm building with build-rpm 2021-02-11 21:50:14 +13:00
build-rpm-inside-docker Rpm: run rpmlint after building rpm 2021-02-12 23:07:03 +13:00
build-tarball build-tarball: only rebuild www if it was changed 2021-02-16 22:21:48 +13:00
build.sh Apply patch for 1.20.x 2021-03-26 19:53:04 +00:00
dockerfile.centos_core.barebones.rpm.test Deb/rpm: update barebones images 2021-03-26 01:10:43 +13:00
dockerfile.centos_core.build Rpm: CentOS dfart. Rpm building isn't automated yet. 2021-02-05 23:49:47 +13:00
dockerfile.centos_core.rpm.build Rpm: run rpmlint after building rpm 2021-02-12 23:07:03 +13:00
dockerfile.centos_core.rpm.test Rpm: group kasmvnc -> kasmvnc-cert 2021-02-22 22:28:30 +13:00
dockerfile.debian_bullseye.build Deb: add Bullseye support 2021-01-29 21:29:04 +13:00
dockerfile.debian_bullseye.deb.build Deb: fix build dependencies install 2021-02-24 21:16:53 +13:00
dockerfile.debian_bullseye.deb.test Deb: test images have lsb-release now 2021-03-14 23:24:14 +13:00
dockerfile.debian_buster.barebones.deb.test Code formatting 2021-03-13 23:51:33 +13:00
dockerfile.debian_buster.build Deb: release numbers (18.04) -> codenames (bionic) 2021-01-28 22:10:46 +13:00
dockerfile.debian_buster.deb.build Deb: fix build dependencies install 2021-02-24 21:16:53 +13:00
dockerfile.debian_buster.deb.test Deb: test images have lsb-release now 2021-03-14 23:24:14 +13:00
dockerfile.fedora_thirtythree.barebones.rpm.test Deb/rpm: update barebones images 2021-03-26 01:10:43 +13:00
dockerfile.fedora_thirtythree.build tarball: include Xvnc.1 man page 2021-02-19 22:58:38 +13:00
dockerfile.fedora_thirtythree.rpm.build tarball: include Xvnc.1 man page 2021-02-19 22:58:38 +13:00
dockerfile.fedora_thirtythree.rpm.test Rpm: group kasmvnc -> kasmvnc-cert 2021-02-22 22:28:30 +13:00
dockerfile.kali_kali-rolling.build Deb: add Kali kali-rolling support 2021-01-28 23:46:21 +13:00
dockerfile.kali_kali-rolling.deb.build Deb: fix build dependencies install 2021-02-24 21:16:53 +13:00
dockerfile.kali_kali-rolling.deb.test Deb: test images have lsb-release now 2021-03-14 23:24:14 +13:00
dockerfile.ubuntu1604.build Added build docker images for debian and others 2020-12-24 19:54:58 +00:00
dockerfile.ubuntu_bionic.build Apply patch for 1.20.x 2021-03-26 19:53:04 +00:00
dockerfile.ubuntu_bionic.deb.build Deb: fix build dependencies install 2021-02-24 21:16:53 +13:00
dockerfile.ubuntu_bionic.deb.test Deb: test images have lsb-release now 2021-03-14 23:24:14 +13:00
dockerfile.ubuntu_bionic.test Deb: release numbers (18.04) -> codenames (bionic) 2021-01-28 22:10:46 +13:00
dockerfile.ubuntu_focal.barebones.deb.test Deb/rpm: update barebones images 2021-03-26 01:10:43 +13:00
dockerfile.ubuntu_focal.build Deb: release numbers (18.04) -> codenames (bionic) 2021-01-28 22:10:46 +13:00
dockerfile.ubuntu_focal.deb.build Deb: fix build dependencies install 2021-02-24 21:16:53 +13:00
dockerfile.ubuntu_focal.deb.test Deb: fix Ubuntu Focal (vnc_startup.sh XFCE start issue) 2021-03-14 23:38:48 +13:00
dockerfile.ubuntu_focal.test Deb: release numbers (18.04) -> codenames (bionic) 2021-01-28 22:10:46 +13:00
dockerfile.www.build added dockerfile build process for www 2021-01-10 19:03:13 +00:00
os_ver_cli.sh Deb: release numbers (18.04) -> codenames (bionic) 2021-01-28 22:10:46 +13:00
README.md Update README.md 2021-04-13 08:59:37 -04:00
test-deb Add verbose logging via KASMVNC_VERBOSE_LOGGING env var 2021-02-28 21:21:49 +13:00
test-deb-barebones Deb: update Debian Buster barebones test to work 2021-03-03 22:47:48 +13:00
test-rpm Add verbose logging via KASMVNC_VERBOSE_LOGGING env var 2021-02-28 21:21:49 +13:00
test-rpm-barebones Deb/rpm: change test user password to "foobar" 2021-02-28 20:48:17 +13:00

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