feat: simple version of docker runx decorate

Allow to attach a RunX config file to an image or an index.

    docker runx decorate IMAGE --tag DEST --with-config CONFIG_FILE

Signed-off-by: Yves Brissaud <yves.brissaud@gmail.com>

Author: eunomie

.golangci.yml

@@ -9,13 +9,11 @@ linters:
     - typecheck
     - unused
     - unconvert
-    - gofmt
     - misspell
     - bodyclose
     - revive
     - gocyclo
     - whitespace
-    - goimports
     - unparam
 linters-settings:
   gosimple:

docs/reference/docker_runx.yaml

@@ -5,9 +5,11 @@ usage: docker runx [command]
 pname: docker
 plink: docker.yaml
 cname:
+    - docker runx decorate
     - docker runx help
     - docker runx version
 clink:
+    - docker_runx_decorate.yaml
     - docker_runx_help.yaml
     - docker_runx_version.yaml
 deprecated: false

docs/reference/docker_runx_decorate.yaml

@@ -0,0 +1,34 @@
+command: docker runx decorate
+short: Decorate an image by attaching a runx manifest
+long: Decorate an image by attaching a runx manifest
+usage: docker runx decorate OPTIONS IMAGE
+pname: docker runx
+plink: docker_runx.yaml
+options:
+    - option: tag
+      shorthand: t
+      value_type: string
+      description: Tag to push the decorated image to
+      deprecated: false
+      hidden: false
+      experimental: false
+      experimentalcli: false
+      kubernetes: false
+      swarm: false
+    - option: with-config
+      value_type: string
+      default_value: runx.yaml
+      description: Path to the runx manifest file
+      deprecated: false
+      hidden: false
+      experimental: false
+      experimentalcli: false
+      kubernetes: false
+      swarm: false
+deprecated: false
+hidden: false
+experimental: false
+experimentalcli: false
+kubernetes: false
+swarm: false
+

docs/reference/runx.md

@@ -5,10 +5,11 @@ Docker Run, better
 
 ### Subcommands
 
-| Name                         | Description                                      |
-|:-----------------------------|:-------------------------------------------------|
-| [`help`](runx_help.md)       | Display information about the available commands |
-| [`version`](runx_version.md) | Show Docker RunX version information             |
+| Name                           | Description                                      |
+|:-------------------------------|:-------------------------------------------------|
+| [`decorate`](runx_decorate.md) | Decorate an image by attaching a runx manifest   |
+| [`help`](runx_help.md)         | Display information about the available commands |
+| [`version`](runx_version.md)   | Show Docker RunX version information             |
 
 
 

docs/reference/runx_decorate.md

@@ -0,0 +1,15 @@
+# docker runx decorate
+
+<!---MARKER_GEN_START-->
+Decorate an image by attaching a runx manifest
+
+### Options
+
+| Name            | Type     | Default     | Description                        |
+|:----------------|:---------|:------------|:-----------------------------------|
+| `-t`, `--tag`   | `string` |             | Tag to push the decorated image to |
+| `--with-config` | `string` | `runx.yaml` | Path to the runx manifest file     |
+
+
+<!---MARKER_GEN_END-->
+

examples/alpine-hello.runx.yaml

@@ -0,0 +1,4 @@
+actions:
+  - id: hello
+    type: run
+    cmds: --rm {{.Ref}} echo hello

go.mod

@@ -3,19 +3,22 @@ module github.com/eunomie/docker-runx
 go 1.23.1
 
 require (
+	github.com/briandowns/spinner v1.23.1
 	github.com/docker/cli v27.3.1+incompatible
 	github.com/docker/cli-docs-tool v0.8.0
+	github.com/google/go-containerregistry v0.20.2
 	github.com/spf13/cobra v1.8.1
 	github.com/spf13/pflag v1.0.5
 )
 
 require (
 	github.com/Azure/go-ansiterm v0.0.0-20210617225240-d185dfc1b5a1 // indirect
-	github.com/Microsoft/go-winio v0.4.14 // indirect
+	github.com/Microsoft/go-winio v0.6.1 // indirect
 	github.com/beorn7/perks v1.0.1 // indirect
 	github.com/cenkalti/backoff/v4 v4.3.0 // indirect
 	github.com/cespare/xxhash/v2 v2.3.0 // indirect
 	github.com/containerd/log v0.1.0 // indirect
+	github.com/containerd/stargz-snapshotter/estargz v0.14.3 // indirect
 	github.com/cpuguy83/go-md2man/v2 v2.0.4 // indirect
 	github.com/distribution/reference v0.6.0 // indirect
 	github.com/docker/distribution v2.8.3+incompatible // indirect
@@ -25,6 +28,7 @@ require (
 	github.com/docker/go-connections v0.5.0 // indirect
 	github.com/docker/go-metrics v0.0.0-20180209012529-399ea8c73916 // indirect
 	github.com/docker/go-units v0.5.0 // indirect
+	github.com/fatih/color v1.7.0 // indirect
 	github.com/felixge/httpsnoop v1.0.4 // indirect
 	github.com/fvbommel/sortorder v1.1.0 // indirect
 	github.com/go-logr/logr v1.4.2 // indirect
@@ -34,8 +38,12 @@ require (
 	github.com/gorilla/mux v1.7.0 // indirect
 	github.com/grpc-ecosystem/grpc-gateway/v2 v2.22.0 // indirect
 	github.com/inconshreveable/mousetrap v1.1.0 // indirect
+	github.com/klauspost/compress v1.16.5 // indirect
+	github.com/mattn/go-colorable v0.1.2 // indirect
+	github.com/mattn/go-isatty v0.0.8 // indirect
 	github.com/matttproud/golang_protobuf_extensions v1.0.1 // indirect
 	github.com/miekg/pkcs11 v1.0.2 // indirect
+	github.com/mitchellh/go-homedir v1.1.0 // indirect
 	github.com/moby/docker-image-spec v1.3.1 // indirect
 	github.com/moby/sys/sequential v0.6.0 // indirect
 	github.com/moby/term v0.5.0 // indirect
@@ -50,6 +58,7 @@ require (
 	github.com/russross/blackfriday/v2 v2.1.0 // indirect
 	github.com/sirupsen/logrus v1.9.3 // indirect
 	github.com/theupdateframework/notary v0.7.0 // indirect
+	github.com/vbatts/tar-split v0.11.3 // indirect
 	go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.46.1 // indirect
 	go.opentelemetry.io/otel v1.21.0 // indirect
 	go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc v0.44.0 // indirect
@@ -62,12 +71,14 @@ require (
 	go.opentelemetry.io/otel/trace v1.21.0 // indirect
 	go.opentelemetry.io/proto/otlp v1.3.1 // indirect
 	golang.org/x/crypto v0.27.0 // indirect
+	golang.org/x/mod v0.17.0 // indirect
 	golang.org/x/net v0.29.0 // indirect
 	golang.org/x/sync v0.8.0 // indirect
 	golang.org/x/sys v0.25.0 // indirect
 	golang.org/x/term v0.24.0 // indirect
 	golang.org/x/text v0.18.0 // indirect
 	golang.org/x/time v0.6.0 // indirect
+	golang.org/x/tools v0.21.1-0.20240508182429-e35e4ccd0d2d // indirect
 	google.golang.org/genproto/googleapis/api v0.0.0-20240903143218-8af14fe29dc1 // indirect
 	google.golang.org/genproto/googleapis/rpc v0.0.0-20240903143218-8af14fe29dc1 // indirect
 	google.golang.org/grpc v1.66.1 // indirect