feat: add container handles and user provided container names
This MR introduces container handles, enabling users to retrieve handles to their created containers, either by repository name or a user provided name.
The container handle_key
defaults to the repository name of the container's associated image, but can also be specified through supplying a container_name
during ImageInstance
creation.
Resolving the handle_key
will fail in three scenarios:
-
Using the repository name as the key when there exists multiple containers with the same repository name and no user specified
container_name
, -
Using the
container_name
as the key when there exists multiple containers with the samecontainer_name
-
Providing a non-existing key