Merge pull request #1014 from crazy-max/imagetools-annotations

buildx(imagetools): add annotations support for create command

Author: crazy-max

__tests__/buildx/imagetools.test.ts

@@ -117,6 +117,43 @@ describe('create', () => {
     expect(result).toBeUndefined();
   });
 
+  it('passes annotations to imagetools create', 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'],
+      annotations: ['index:org.opencontainers.image.title=Alpine', 'manifest-descriptor:org.opencontainers.image.description=Base image'],
+      silent: true
+    });
+
+    expect(getCommand).toHaveBeenCalledWith([
+      'imagetools',
+      'create',
+      '--annotation',
+      'index:org.opencontainers.image.title=Alpine',
+      '--annotation',
+      'manifest-descriptor:org.opencontainers.image.description=Base image',
+      '--metadata-file',
+      metadataFile,
+      'docker.io/library/alpine:latest'
+    ]);
+    expect(execSpy).toHaveBeenCalledWith('docker', ['buildx', 'imagetools', 'create'], {
+      ignoreReturnCode: true,
+      silent: true
+    });
+    expect(result).toBeUndefined();
+  });
+
   it('skips command execution when skipExec is enabled', async () => {
     const getCommand = vi.fn().mockResolvedValue({
       command: 'docker',

src/buildx/imagetools.ts

@@ -153,6 +153,11 @@ export class ImageTools {
         args.push('--platform', platform);
       }
     }
+    if (opts.annotations) {
+      for (const annotation of opts.annotations) {
+        args.push('--annotation', annotation);
+      }
+    }
     if (opts.dryRun) {
       args.push('--dry-run');
     } else {

src/types/buildx/imagetools.ts

@@ -32,6 +32,7 @@ export interface CreateOpts {
   sources: Array<string>;
   tags?: Array<string>;
   platforms?: Array<string>;
+  annotations?: Array<string>;
   dryRun?: boolean;
   silent?: boolean;
   skipExec?: boolean;