doc(Makefile): describe some environment variables

This commit is contained in:
Markus Pesch 2019-09-04 13:53:58 +02:00
parent 04bc3baffe
commit 036ff28175
Signed by: volker.raschek
GPG Key ID: 852BCC170D81A982

View File

@ -5,27 +5,35 @@
UID?=$(shell id --user) UID?=$(shell id --user)
GID?=$(shell id --group) GID?=$(shell id --group)
IMAGE_VERSION:=$(or ${VERSION}, latest)
# VERSION/RELEASE # VERSION/RELEASE
# If no version is specified as a parameter of make, the last git hash # If no version is specified as a parameter of make, the last git hash
# value is taken. # value is taken.
VERSION?=$(shell git describe --abbrev=0)+hash.$(shell git rev-parse --short HEAD) VERSION?=$(shell git describe --abbrev=0)+hash.$(shell git rev-parse --short HEAD)
RELEASE?=1 RELEASE?=1
# CONTAINER_IMAGE_VERSION
# Defines the version of the container image which has included the executable
# binary. This is somethimes different to the variable VERSION, because the
# container image version should be latest instead contains the latest git tag
# and hash sum.
CONTAINER_IMAGE_VERSION:=$(or ${VERSION}, latest)
# CONTAINER_RUNTIME # CONTAINER_RUNTIME/BUILD_IMAGE
# The CONTAINER_RUNTIME variable will be used to specified the path to a
# container runtime. This is needed to start and run a container image defined
# by the BUILD_IMAGE variable. The BUILD_IMAGE container serve as build
# environment to execute the different make steps inside. Therefore, the bulid
# environment requires all necessary dependancies to build this project.
CONTAINER_RUNTIME?=$(shell which docker) CONTAINER_RUNTIME?=$(shell which docker)
BUILD_IMAGE:=volkerraschek/build-image:latest
# GH_USER/GITHUB_TOKEN # GH_USER/GITHUB_TOKEN
# It's the user name from github.com and his token. This token and the username # It's the user name from github.com and his token. This token and the username
# can be set over encrypted environment variables in the ci/cd pipeline # can be set over encrypted environment variables in the ci/cd pipeline. It's
# necessary to push the releases on github.com
GITHUB_USER=volker-raschek GITHUB_USER=volker-raschek
GITHUB_TOKEN?="" GITHUB_TOKEN?=""
# BUILD_IMAGE
BUILD_IMAGE:=volkerraschek/build-image:latest
# EXECUTABLE # EXECUTABLE
# Executable binary which should be compiled for different architecures # Executable binary which should be compiled for different architecures
EXECUTABLE:=flucky EXECUTABLE:=flucky