docs: cleanup, fix links, add comments

docs/content/examples/image/_index.md

@@ -4,8 +4,8 @@ weight: 30
 
 Instead of deploying a 3rd party image, we can build our own.
 
-We rely on the upstream [`dockerTools`](https://github.com/NixOs/nixpkgs/tree/master/pkgs/built-support/docker) package here.
-Specifically, we can use the `buildImage` function to define our image:
+We rely on the upstream [`dockerTools`](https://nixos.org/manual/nixpkgs/stable/#sec-pkgs-dockerTools) package here.
+Specifically, we can use the `buildLayeredImage` function to define our image:
 
 {{< source "image.nix" >}}
 
@@ -60,7 +60,5 @@ Render the generated manifests again and see that it now refers to the newly bui
 Of course, to actually deploy, we need to push the image to our registry. The script defined at {{< option "docker.copyScript" >}} does just that.
 
 ```sh
-$(nix build -f . --json config.docker.copyScript | jq -r '.[].outputs.out')
+$(nix build -f . --print-out-paths config.docker.copyScript)
 ```
-
- <!-- TODO: can we make that `nix run -f . config.docker.copyScript` ? -->

docs/content/examples/image/default.nix

@@ -1,15 +1,10 @@
-{kubenix ? import ../../../..}:
+{ kubenix ? import ../../../.. }:
 kubenix.evalModules.${builtins.currentSystem} {
-  module = {
-    kubenix,
-    config,
-    pkgs,
-    ...
-  }: {
-    imports = with kubenix.modules; [k8s docker];
+  module = { kubenix, config, pkgs, ... }: {
+    imports = with kubenix.modules; [ k8s docker ];
     docker = {
       registry.url = "docker.somewhere.io";
-      images.example.image = pkgs.callPackage ./image.nix {};
+      images.example.image = pkgs.callPackage ./image.nix { };
     };
     kubernetes.resources.pods.example.spec.containers = {
       custom.image = config.docker.images.example.path;

docs/content/examples/image/image.nix

@@ -1,10 +1,7 @@
-{
-  dockerTools,
-  nginx,
-}:
+{ dockerTools, nginx }:
 dockerTools.buildLayeredImage {
   name = "nginx";
-  contents = [nginx];
+  contents = [ nginx ];
   extraCommands = ''
     mkdir -p etc
     chmod u+w etc
@@ -12,9 +9,9 @@ dockerTools.buildLayeredImage {
     echo "nginx:x:1000:nginx" > etc/group
   '';
   config = {
-    Cmd = ["nginx" "-c" "/etc/nginx/nginx.conf"];
+    Cmd = [ "nginx" "-c" "/etc/nginx/nginx.conf" ];
     ExposedPorts = {
-      "80/tcp" = {};
+      "80/tcp" = { };
     };
   };
 }