nykma/docker-utils

A nix flake library for simple docker functions.

Requirements:

• NixOS
• Flakes
• Cross Compilation via boot.binfmt.emulatedSystems

docker-utils

docker-utils is a library that provides the following functions:

docker-utils.lib.allImages

Example:

dockerImage = pkgs.dockerTools.buildImage { ... };

allImages = docker-utils.lib.allImages [ "x86_64-linux" "aarch64-linux" ] dockerImage;

Type allImages :: [String] -> Derivation -> Derivation

Description:

Builds a symbolic link farm for all systems to cross-compiled docker images.

docker-utils.lib.pushAll

Example:

system = "x86_64-linux";

dockerImage = pkgs.dockerTools.buildImage { ... };

pushAll = docker-utils.lib.${system}.pushAll {
  name = "pushAll";
  systems = [ "x86_64-linux" "aarch64-linux" ];
  inherit dockerImage;
};

Type pushAll :: AttrSet {String, [String], Derivation} -> Derivation

Description:

Creates a script to push all images created with allImages using docker manifest. pushAll uses the docker image's tag to tag every image as ${tag}-${system} and then includes them in a manifest with tag as the manifest head.