celforyon/dpkg repository overview

⁠Brief

Docker image with dpkg utilities to make Debian packages

⁠makedeb

Contains a makedeb script to generate Debian packages from a specific architecture

⁠environment variables

⁠Required

• DIST: the distribution codename (jessie, stretch, ...)
• ARCH: the architecture (amd64, i386, ...)

⁠Optional

• PROJECT_NAME: the project name, defaults to ${CI_PROJECT_NAME} (defined by GitLab CI)
• DEPLOY_DIR: the deploy directory, defaults to deploy
• PKG_ROOTDIR: the package root directory (full path will be ${DEPLOY_DIR}/${PKG_ROOTDIR}), defaults to root_dir
• VERBOSE: outputs more information if set
• SKIP_CHECKS: do not run any test if set
• SKIP_CHECK_LINTIAN: do not run lintian if set
• SKIP_CHECK_SHELL: do not run shellcheck if set
• IGNORE_CHECKS: ignore any check failure if set
• IGNORE_CHECK_LINTIAN: ignore lintian failure if set
• IGNORE_CHECK_SHELL: ignore shellcheck failure if set
• SHELLCHECK_EXCLUDE_CODES: set to a comma separated list of shellcheck codes (e.g.: SC1009,SC2086) to ignore in shellcheck reporting. See man shellcheck
• DEPLOY: set to 0 to disable the deployment (defaults to 1)
• xxx_FILE: the "xxx" file (see below) (full path will be ${DEPLOY_DIR}/${xxx_FILE}), where xxx can be INSTALL, VERSION, MAINTAINER, SECTION, PRIORITY, DESCRIPTION defaults to xxx in lower case

⁠input

⁠root_dir

This is the project's root directory, which will be used to build the .deb file using dpkg-deb

⁠install file

Each line of this file is read as: source:destination:... where source is the current file location (if relative, from the makedeb working directory, which is Git's root directory when running in GitLab CI) and destination is the relative destination path, from the package root directory The last part, :... is optional and should look like: :script1:script2:... where script1, script2, ... are shell command lines. The special {} token can be used and will be replaced by destination. All scripts are executed after the copy is done.

⁠version file

This file must contain one line with the version identifier

⁠maintainer file

This file must contain one line with the maintainer (format: Firstname Lastname <[email protected]>)

⁠section file

This file must contain one line with the section (e.g. admin)

⁠priority file

This file must contain one line with the priority (e.g. optional)

⁠description file

This file must contain the description using the control file format. All but the first line must start with a space. The lines beginning with a space are extended description.

⁠output

the output will be into /shared/$(mktemp -d)/${CI_PROJECT_NAME}\_${version}\_${DIST}\_${ARCH}.deb

⁠Steps of makedeb

• check input variables (env)
• find DEBIAN directory
• process install file
• generate DEBIAN/control file
• generate debian package
• run some checks (lintian, shellcheck)
• deploy into /shared