armbian-next: artifacts: firmware/rootfs and actual usage of artifacts during image build

- artifacts: introduce `ARTIFACT_IGNORE_CACHE=yes`
- artifacts: introduce `DONT_BUILD_ARTIFACTS`, list of artifacts that if not found cached, fail the build
- kernel_package_source() is no more
- a long dissertation about kernels, families, and the universe
- artifacts: actually use rootfs artifact for image build
- artifacts: detangle via artifact_base_dir
- artifacts: rootfs: use folders in artifact_name; include cache_type
- artifacts: some cleanups / validations
- rootfs artifact; drop old rootfs cli
- artifacts: new CLI shortcuts; remove old firmware CLI
- artifacts: full firmware & usage
- use firmware artifacts in image build and install its debs
- kernel artifact sans legacy; use tmpdir for .deb target for all packages
- legacy artifact versions is no more; pack/unpack now in common obtain;
- artifacts: uboot: cleanup legacy renaming, use artifact version directly
- artifacts: add firmware (small) artifact
- deploy uboot to loop from artifact; allow tty to artifact; todos for cleaning
- fixes, kernel dtb/headers conditional; remove `.git` from Makefile url; use mapfile for finding files to hash
  - completely remove KERNEL_HAS_WORKING_HEADERS_FULL_SOURCE and `kernel_package_callback_linux_headers_full_source()`
  - don't use realpath for artifact_file_relative
  - curb some warnings
  - fix: only install headers & dtbs if such exist
- kernel .config hook modification hash versioning
- OCI_TARGET_BASE vs per-artifact defaults; only deploy to remote from CLI with OTB
- artifact revolver & installing into image
  - add artifact_map_packages and artifact_map_debs dicts
  - revolver accumulates all info
  - REPOSITORY_INSTALL is no more (for uboot/kernel, later others)
  - rename `VER` to `IMAGE_INSTALLED_KERNEL_VERSION`

lib/functions/artifacts/artifact-full_firmware.sh

@@ -0,0 +1,94 @@
+function artifact_full_firmware_prepare_version() {
+	artifact_version="undetermined"        # outer scope
+	artifact_version_reason="undetermined" # outer scope
+
+	local ARMBIAN_FIRMWARE_SOURCE="${ARMBIAN_FIRMWARE_GIT_SOURCE:-"https://github.com/armbian/firmware"}"
+	local ARMBIAN_FIRMWARE_BRANCH="branch:${ARMBIAN_FIRMWARE_GIT_BRANCH:-"master"}"
+
+	debug_var ARMBIAN_FIRMWARE_SOURCE
+	debug_var ARMBIAN_FIRMWARE_BRANCH
+	debug_var MAINLINE_FIRMWARE_SOURCE
+
+	declare short_hash_size=4
+
+	declare -A GIT_INFO=([GIT_SOURCE]="${ARMBIAN_FIRMWARE_SOURCE}" [GIT_REF]="${ARMBIAN_FIRMWARE_BRANCH}")
+	run_memoized GIT_INFO "git2info" memoized_git_ref_to_info
+	debug_dict GIT_INFO
+
+	declare -A GIT_INFO_MAINLINE=([GIT_SOURCE]="${MAINLINE_FIRMWARE_SOURCE}" [GIT_REF]="branch:main")
+	run_memoized GIT_INFO_MAINLINE "git2info" memoized_git_ref_to_info
+	debug_dict GIT_INFO_MAINLINE
+
+	declare fake_unchanging_base_version="1"
+
+	declare short_sha1="${GIT_INFO[SHA1]:0:${short_hash_size}}"
+	declare short_sha1_mainline="${GIT_INFO_MAINLINE[SHA1]:0:${short_hash_size}}"
+
+	# get the hashes of the lib/ bash sources involved...
+	declare hash_files="undetermined"
+	calculate_hash_for_files "${SRC}"/lib/functions/compilation/packages/firmware-deb.sh "${SRC}"/lib/functions/artifacts/artifact-firmware.sh
+	declare bash_hash="${hash_files}"
+	declare bash_hash_short="${bash_hash:0:${short_hash_size}}"
+
+	# outer scope
+	artifact_version="${fake_unchanging_base_version}-SA${short_sha1}-SM${short_sha1_mainline}-B${bash_hash_short}"
+
+	declare -a reasons=(
+		"Armbian firmware git revision \"${GIT_INFO[SHA1]}\""
+		"Mainline firmware git revision \"${GIT_INFO_MAINLINE[SHA1]}\""
+		"framework bash hash \"${bash_hash}\""
+	)
+
+	artifact_version_reason="${reasons[*]}" # outer scope
+
+	artifact_map_packages=(
+		["armbian-firmware-full"]="armbian-firmware-full"
+	)
+
+	artifact_map_debs=(
+		["armbian-firmware-full"]="armbian-firmware-full_${artifact_version}_all.deb"
+	)
+
+	artifact_name="armbian-firmware-full"
+	artifact_type="deb"
+	artifact_base_dir="${DEB_STORAGE}"
+	artifact_final_file="${DEB_STORAGE}/armbian-firmware-full_${artifact_version}_all.deb"
+
+	return 0
+}
+
+function artifact_full_firmware_build_from_sources() {
+	FULL="-full" REPLACE="" LOG_SECTION="compile_firmware_full" do_with_logging compile_firmware
+}
+
+function artifact_full_firmware_cli_adapter_pre_run() {
+	declare -g ARMBIAN_COMMAND_REQUIRE_BASIC_DEPS="yes" # Require prepare_host_basic to run before the command.
+
+	# "gimme root on a Linux machine"
+	cli_standard_relaunch_docker_or_sudo
+}
+
+function artifact_full_firmware_cli_adapter_config_prep() {
+	declare KERNEL_ONLY="yes"                            # @TODO: this is a hack, for the board/family code's benefit...
+	use_board="no" prep_conf_main_minimal_ni < /dev/null # no stdin for this, so it bombs if tries to be interactive.
+}
+
+function artifact_full_firmware_get_default_oci_target() {
+	artifact_oci_target_base="ghcr.io/rpardini/armbian-release/"
+}
+
+function artifact_full_firmware_is_available_in_local_cache() {
+	is_artifact_available_in_local_cache
+}
+
+function artifact_full_firmware_is_available_in_remote_cache() {
+	is_artifact_available_in_remote_cache
+}
+
+function artifact_full_firmware_obtain_from_remote_cache() {
+	obtain_artifact_from_remote_cache
+}
+
+function artifact_full_firmware_deploy_to_remote_cache() {
+	upload_artifact_to_oci
+}