From ec013d181a6c3fb09458ec336416c8417e188384 Mon Sep 17 00:00:00 2001 From: Ivan Mahonin Date: Dec 12 2019 06:58:14 +0000 Subject: update readme --- diff --git a/config.sh.blank b/config.sh.blank index a18e1b9..cdbbfae 100644 --- a/config.sh.blank +++ b/config.sh.blank @@ -1,15 +1,21 @@ -# PACKET_BUILD_DIR=/data/builder -# PROXY=http://1.2.3.4:1234 -# CHROOTER_BUILD_OPTIONS="--build-arg=http_proxy=$PROXY --build-arg=https_proxy=$PROXY" +PACKET_BUILD_DIR=/data/builder # where you will store a build data + +CHROOTER_BUILD_OPTIONS="--privileged=true" # required by appimagekit + # default value is env-builder-data/build + # but we recommend to use directory outside of project sources + +# PROXY=http://1.2.3.4:1234 # if you are behind a proxy +# CHROOTER_BUILD_OPTIONS="$CHROOTER_BUILD_OPTIONS --build-arg=http_proxy=$PROXY --build-arg=https_proxy=$PROXY" # CHROOTER_RUN_OPTIONS="-e http_proxy=$PROXY -e https_proxy=$PROXY" -# chrooter() { -# export CHROOTER_PREFIX="/mnt" -# $BASE_DIR/chrooter/chrooter.sh $@ -# } +chrooter() { # configure chrooter command +# export CHROOTER_PREFIX="/tmp" # where to mount a virtual environment + # if you will build os images from scratch you need 10Gb of free space + $BASE_DIR/chrooter/chrooter.sh $@ # chrooter is required, it is to commnads in virtual environment +} -# gen_name_template() { -# local NAME="$1" +# gen_name_template() { # here you may override a naming rules for out packages +# local NAME="$1" # see build-*.sh, publish/publish.sh # local TAG="$2" # local PLATFORM="$3" # local ARCH="$4" @@ -22,6 +28,6 @@ # echo "$NAME-%VERSION%-${ARCH}bit-$PLATFORM$TAG-%DATE%-%COMMIT%$SUFFIX" # } -# OPENTOONZ_TESTING_TAG="test" -# SYNFIGSTUDIO_TESTING_TAG="test" +# OPENTOONZ_TESTING_TAG="test" # uses in build-opentoonz-testing.sh for naming out packages +# SYNFIGSTUDIO_TESTING_TAG="test" # uses in build-synfigstudio.sh for naming out packages diff --git a/readme b/readme index f786545..ba5bf2b 100644 --- a/readme +++ b/readme @@ -1,70 +1,193 @@ -Build env: +Install: - cd env - ./run.sh # sudo? +run all commands from root (as superuser) -Example usage: - ./run-native.sh with_deps unpack MEGAPROGRAM-1.0.0 - cd env - ./run.sh env_release MEGAPROGRAM-1.0.0 # sudo? +install dependency packages: + you need: bash aufs-tools fuse-zip + for apt based OS use comand: + apt-get install bash aufs-tools fuse-zip -ready environment will placed into: +create and edit config file: + use config.sh.blank as a base: + cp config.sh.blank config.sh + + we use config (some_path is a fake): + PACKET_BUILD_DIR=/some_path/builder-packet + CHROOTER_BUILD_OPTIONS="--privileged=true" + chrooter() { + export CHROOTER_PREFIX="/some_path_to_mount" + $BASE_DIR/chrooter/chrooter.sh $@ + } + OPENTOONZ_TESTING_TAG="morevna" + + +download virtual environment: + you may download our (we are Morevna Project) os images from: + https://coolbug.org/downloads/builder-images/ + + you need two files: + https://coolbug.org/downloads/builder-images/morevnaproject_build-debian-7-32.zip + https://coolbug.org/downloads/builder-images/morevnaproject_build-debian-7-64.zip + approximate 6.5Gb, place both into chrooter/images/ + + +build virtual environment: + if you does not want to download os images you can build it + + Impotant: + Debian project does not support Debian 7 (wheezy) anymore + so you need to find an active hosting of Debian 7 packages + enter valid url into files: + env/debian-7-32bit/files/sources.list + env/debian-7-64bit/files/sources.list + env/debian-7-32bit/build-zip.sh into variable apt_mirror + env/debian-7-64bit/build-zip.sh into variable apt_mirror + + here you still can download a base debian images from: + https://coolbug.org/downloads/builder-images/debian-wheezy-i386.zip + https://coolbug.org/downloads/builder-images/debian-wheezy-amd64.zip + approximate 500Mb, place first into env/debian-7-32bit and second into env/debian-7-64bit + + or build these images from scratch by debootstrap + install packages: debootstrap zip; for apt based OS use command: + apt-get install debootstrap zip + and build base debian images + cd env/debian-7-32bit # go to env/debian-7-32bit + ./build-zip.sh + cd ../debian-7-64bit # go to env/debian-7-64bit + ./build-zip.sh + cd ../.. # go back + + now when you have files debian-wheezy-XXXX.zip you can build os images for builder + it's a long process because it will build GCC and MinGW from scratch + run commands: + cd env/debian-7-32bit # go to env/debian-7-32bit + ./build-base.sh # just to copy base os image into chrooter/images + ./build.sh # a long build process + cd ../debian-7-64bit # go to env/debian-7-64bit + ./build-base.sh # just to copy base os image into chrooter/images + ./build.sh # a long build process + cd ../.. # go back + + build environment ready + + +installation done + + + +Usage: + + +now you may build packages by macro script: + see files ./build-*.sh + +also you can add hooks to publish built packages: + for example create file publish/publish-synfigstudio.sh with content: + #!/bin/bash + cp "$1" /var/www/public/downloads/ + when build is done new synfigstudio packge will placed into web-site directory + you may look file publish/publish.sh for more info + +run internal builder commands in virtual environment: + cd env + ./run.sh some_command + +also you may use: + env/debian-7-32bit/run.sh + env/debian-7-64bit/run.sh + env/debian-7-64bit/win32.sh + env/debian-7-64bit/win64.sh + +run build commands in native environment + ./run-native.sh some_command + +build a selected package: + cd env + ./run.sh env_release MEGAPROGRAM-1.0.0 + +take files from directory + env-builder-data/build/packet/linux-x64/MEGAPROGRAM-1.0.0/env_release +or + your_build_path/packet/linux-x64/MEGAPROGRAM-1.0.0/env_release - env-builder-data/build/packet/linux-x64/MEGAPROGRAM-1.0.0/env_release "dry_run" option for paranoics: - ./run-native dry_run with_deps unpack MEGAPROGRAM-1.0.0 + ./run.sh dry_run with_deps unpack MEGAPROGRAM-1.0.0 - List of commands - - do for - List of actions: - - download - - unpack - - build - - install - - install_release - - envdeps - - envdeps_release - - env - - env_release - - dry_run - - simulate activity - - with_deps - - execute for and all deps - - clean_ACTION - - remove all data of completed ACTION for - ex.: clean_unpack MEGAPROGRAM-1.0.0 - - clean_all_unpack - - cleans download and unpack - see: clean_ACTION - - clean_all_env - - cleans install, install_release, envdeps, envdeps_release, env and env_release - see: clean_ACTION - - clean_all_install - - cleans all env and build - see: clean_all_env , clean_ACTION - - clean_all - - remove all data of all completed actions for - - set_undone_ACTION - set_undone_all_unpack - set_undone_all_env - set_undone_all_install - set_undone_all - - mark ACTION incomplete for , but keep action data - see: clean_* comands - - shell - - run shell in environment of - + + do for + List of actions: + - download + - unpack + - build + - install + - install_release + - envdeps + - envdeps_release + - env + - env_release + + dry_run + - simulate activity + + with_deps + - execute for and all deps + + clean_ACTION + - remove all data of completed ACTION for + ex.: clean_unpack MEGAPROGRAM-1.0.0 + + clean_all_unpack + - cleans download and unpack + see: clean_ACTION + + clean_all_env + - cleans install, install_release, envdeps, envdeps_release, env and env_release + see: clean_ACTION + + clean_all_install + - cleans all env and build + see: clean_all_env , clean_ACTION + + clean_all + - remove all data of all completed actions for + + set_undone_ACTION + set_undone_all_unpack + set_undone_all_env + set_undone_all_install + set_undone_all + - mark ACTION incomplete for , but keep action data + see: clean_* comands + + shell + - run shell in environment of + + chain chain ... + - run several command sequentially wihtout remounting of environment to increase speed + +see also + env-builder-data/build/script/common/manager.sh + + +Troubles: + sometimes virtual environmens does not unmounted properly + to clear this you need to unmount all mounts for */chrooter-* + look mounts list by command: + mount + + unmount by command: + umount "/some_path/chrooter-SOME_UUID" + or with "force" option + umount -f "/some_path/chrooter-SOME_UUID" + + after that remove the files + you MUST do unmount before, if some dir are still mounted you can remove some system files + we recommend to check content of directories before remove + option "--one-file-system" for additional protection but anyway BE CAREFULL!! + command: + rm -rf --one-file-system /some_path/chrooter-*