WIP added image-index methods

[WYGIN]

CNB Pack Manifest Commands: Streamlining Multi-Architecture Image Management

This proposal introduces a new experimental set of commands to the CNB tooling ecosystem: pack manifest. These commands empower buildpack authors to efficiently manage and distribute multi-architecture images, aligning with functionalities offered by existing tools like podman manifest and docker manifest.

Key Features:

• Create manifest lists: Construct local manifest lists for annotating and pushing to container registries.
• Annotate manifests: Add essential information like architecture, OS, or variant to existing manifest lists.
• Add/remove images: Manage individual image entries within manifest lists.
• Push manifests: Publish constructed manifest lists to container registries.
• Inspect manifests: View detailed information about locally stored manifest lists.

Benefits:

Simplified workflows: Centralized management of multi-architecture image variants for efficient distribution.
Enhanced interoperability: Potential adherence to established standards for seamless integration with existing tools and runtimes.
Improved developer experience: Streamlined workflows and user-friendly commands for managing manifest lists.
Target Users:

Buildpack authors seeking to distribute their buildpacks across diverse architectures.

Example Workflow:

Create a manifest list:

pack manifest create cnbs/sample-package:hello-multiarch-universe \
    cnbs/sample-package:hello-universe \
    cnbs/sample-package:hello-universe-windows

Annotate architecture:

pack manifest annotate --arch amd64 cnbs/sample-package:hello-multiarch-universe cnbs/sample-package:hello-universe
pack manifest annotate --arch amd64 cnbs/sample-package:hello-multiarch-universe cnbs/sample-package:hello-universe-windows

Push to registry:

pack manifest push cnbs/sample-package:hello-multiarch-universe

Current Status:

These commands are initially experimental and gated behind the pack config experimental flag. They will transition to supported status upon deemed readiness by maintainers.

This innovative addition to the CNB ecosystem empowers buildpack authors to streamline multi-architecture image management, fostering efficient distribution and enhanced developer experiences.

Development setup:

This guide outlines the steps to set up your development environment and test the pack manifest commands under development in the image-index branch of the github.com/WYGIN/buildpacks-pack repository against the github.com/WYGIN/buildpacks-imgutil repository.

Prerequisites:

• Docker installed and running on your system.
• Git version control system installed.

Steps:

1. Clone the repositories:

git clone https://github.com/WYGIN/buildpacks-pack.git

2. Navigate to the buildpacks-pack repository:

cd buildpacks-pack

3. Checkout the image-index branch:

git checkout image-index

4. Build the pack binary:

make build

5. Install the pack binary:

sudo make install

6. Enable pack's experimental features:

pack config experimental true

7. Run pack manifest:

pack manifest create cnbs/sample-package:hello-multiarch-universe \
     cnbs/sample-package:hello-universe \

     cnbs/sample-package:hello-universe-windows

# annotate first image
pack manifest annotate --arch amd64 cnbs/sample-package:hello-multiarch-universe cnbs/sample-package:hello-universe
# annotate second image
pack manifest annotate --arch amd64 cnbs/sample-package:hello-multiarch-universe cnbs/sample-package:hello-universe-windows

pack manifest add cnbs/sample-package:hello-multiarch-universe \
					cnbs/sample-package:hello-universe-riscv-linux

pack manifest delete cnbs/sample-package:hello-multiarch-universe

pack manifest rm cnbs/sample-package:hello-multiarch-universe \
					cnbs/sample-package:hello-universe-windows

pack manifest push cnbs/sample-package:hello-multiarch-universe

pack manifest inspect cnbs/sample-builder:multiarch

Resolves:

1. issue: Create an new interface to handle Manifest Lists #188