From d92ed04680652ae6718f7de9b823f3e8171cc6c8 Mon Sep 17 00:00:00 2001
From: CrazyMax <1951866+crazy-max@users.noreply.github.com>
Date: Mon, 9 Mar 2026 11:11:00 +0100
Subject: [PATCH] buildx(imagetools): add skip support and configurable create
 command silence

Signed-off-by: CrazyMax <1951866+crazy-max@users.noreply.github.com>
---
 __tests__/buildx/imagetools.test.itg.ts | 11 ++++++++++
 __tests__/buildx/imagetools.test.ts     | 28 +++++++++++++++++++++++--
 src/buildx/imagetools.ts                | 10 ++++++++-
 src/types/buildx/imagetools.ts          |  2 ++
 4 files changed, 48 insertions(+), 3 deletions(-)

diff --git a/__tests__/buildx/imagetools.test.itg.ts b/__tests__/buildx/imagetools.test.itg.ts
index 1fc76c5..4aaa48d 100644
--- a/__tests__/buildx/imagetools.test.itg.ts
+++ b/__tests__/buildx/imagetools.test.itg.ts
@@ -94,3 +94,14 @@ maybe('attestationDigests', () => {
     expect(digests).toEqual(['sha256:0709528fae1747ce17638ad2978ee7936b38a294136eaadaf692e415f64b1e03']);
   });
 });
+
+maybe('create', () => {
+  it('skips create command execution when skipExec is set', async () => {
+    const result = await new ImageTools().create({
+      sources: ['sha256:0709528fae1747ce17638ad2978ee7936b38a294136eaadaf692e415f64b1e03'],
+      tags: ['docker.io/user/app', 'docker.io/user/app2'],
+      skipExec: true
+    });
+    expect(result).toBeUndefined();
+  });
+});
diff --git a/__tests__/buildx/imagetools.test.ts b/__tests__/buildx/imagetools.test.ts
index 0a11cfe..a397fe9 100644
--- a/__tests__/buildx/imagetools.test.ts
+++ b/__tests__/buildx/imagetools.test.ts
@@ -70,7 +70,8 @@ describe('create', () => {
 
     const result = await new ImageTools({buildx}).create({
       sources: ['cwd://descriptor.json', 'docker.io/library/alpine:latest'],
-      tags: ['docker.io/user/app:latest']
+      tags: ['docker.io/user/app:latest'],
+      silent: true
     });
 
     expect(getCommand).toHaveBeenCalledWith(['imagetools', 'create', '--tag', 'docker.io/user/app:latest', '--metadata-file', metadataFile, '--file', 'descriptor.json', 'docker.io/library/alpine:latest']);
@@ -104,7 +105,8 @@ describe('create', () => {
 
     const result = await new ImageTools({buildx}).create({
       sources: ['docker.io/library/alpine:latest'],
-      dryRun: true
+      dryRun: true,
+      silent: true
     });
 
     expect(getCommand).toHaveBeenCalledWith(['imagetools', 'create', '--dry-run', 'docker.io/library/alpine:latest']);
@@ -114,4 +116,26 @@ describe('create', () => {
     });
     expect(result).toBeUndefined();
   });
+
+  it('skips command execution when skipExec is enabled', async () => {
+    const getCommand = vi.fn().mockResolvedValue({
+      command: 'docker',
+      args: ['buildx', 'imagetools', 'create']
+    });
+    const buildx = {getCommand} as unknown as Buildx;
+    const execSpy = vi.spyOn(Exec, 'getExecOutput').mockResolvedValue({
+      exitCode: 0,
+      stdout: '',
+      stderr: ''
+    });
+
+    const result = await new ImageTools({buildx}).create({
+      sources: ['docker.io/library/alpine:latest'],
+      skipExec: true
+    });
+
+    expect(getCommand).toHaveBeenCalledWith(['imagetools', 'create', '--metadata-file', metadataFile, 'docker.io/library/alpine:latest']);
+    expect(execSpy).not.toHaveBeenCalled();
+    expect(result).toBeUndefined();
+  });
 });
diff --git a/src/buildx/imagetools.ts b/src/buildx/imagetools.ts
index 99fdd01..aab77fe 100644
--- a/src/buildx/imagetools.ts
+++ b/src/buildx/imagetools.ts
@@ -15,6 +15,8 @@
  */
 
 import fs from 'fs';
+import * as core from '@actions/core';
+
 import {Buildx} from './buildx.js';
 import {Context} from '../context.js';
 import {Exec} from '../exec.js';
@@ -164,9 +166,15 @@ export class ImageTools {
     }
 
     const cmd = await this.getCreateCommand(args);
+    if (opts.skipExec) {
+      core.info(`[command]${cmd.command} ${cmd.args.join(' ')}`);
+      core.info(`Skipped create command`);
+      return undefined;
+    }
+
     return await Exec.getExecOutput(cmd.command, cmd.args, {
       ignoreReturnCode: true,
-      silent: true
+      silent: opts.silent
     }).then(res => {
       if (res.stderr.length > 0 && res.exitCode != 0) {
         throw new Error(res.stderr.trim());
diff --git a/src/types/buildx/imagetools.ts b/src/types/buildx/imagetools.ts
index 3ce5c5e..35f7fe6 100644
--- a/src/types/buildx/imagetools.ts
+++ b/src/types/buildx/imagetools.ts
@@ -33,6 +33,8 @@ export interface CreateOpts {
   tags?: Array<string>;
   platforms?: Array<string>;
   dryRun?: boolean;
+  silent?: boolean;
+  skipExec?: boolean;
 }
 
 export interface CreateResponse {