Add more descriptive gl-oci tool description.

Signed-off-by: Tobias Wolf <[email protected]>
On-behalf-of: SAP <[email protected]>

Author: NotTheEvilOne

src/gardenlinux/oci/__main__.py

@@ -18,7 +18,9 @@
 @click.group()
 def cli() -> None:
     """
-    gl-oci click argument entrypoint
+    gl-oci provides functionality to handle OCI containers. It can pull and push
+    images from remote repositories as well as handle GardenLinux artifacts, OCI
+    image indices and manifests.
 
     :since: 0.7.0
     """
@@ -77,7 +79,7 @@ def add_container_to_index(
 
     manifest = manifest_container.read_manifest()
 
-    index_resource = Container(index, insecure=insecure)
+    index_resource = Container(f"{index}:{index_tag}", insecure=insecure)
 
     image_index = index_resource.read_or_generate_index()
     image_index.append_manifest(manifest)
@@ -187,7 +189,7 @@ def build_container(
 )
 def load_container(oci_archive: str, additional_tag: List[str]) -> None:
     """
-    Push to an OCI registry.
+    Load an OCI archive.
 
     :since: 1.0.0
     """
@@ -213,7 +215,7 @@ def load_container(oci_archive: str, additional_tag: List[str]) -> None:
 )
 def load_containers_from_directory(directory: str) -> None:
     """
-    Push to an OCI registry.
+    Load multiple OCI archives.
 
     :since: 1.0.0
     """
@@ -249,7 +251,7 @@ def new_index(
     index: str, index_tag: str, insecure: bool, additional_tag: List[str]
 ) -> None:
     """
-    Push a list of files from the `manifest_folder` to an index.
+    Create a new OCI image index.
 
     :since: 1.0.0
     """
@@ -285,7 +287,7 @@ def new_index(
 )
 def pull_container(container: str, tag: str, platform: str, insecure: bool) -> None:
     """
-    Push to an OCI registry.
+    Pull an OCI image container from a remote OCI registry.
 
     :since: 1.0.0
     """
@@ -318,7 +320,7 @@ def pull_container(container: str, tag: str, platform: str, insecure: bool) -> N
 )
 def push_container(container: str, tag: str, destination: str, insecure: bool) -> None:
     """
-    Push to an OCI registry.
+    Push an OCI image container to a remote OCI registry.
 
     :since: 1.0.0
     """
@@ -473,7 +475,8 @@ def push_manifest(
     additional_tag: List[str],
 ) -> None:
     """
-    Push artifacts and the manifest from a directory to a registry.
+    Push to an OCI image container given GardenLinux canonical named artifacts
+    in a specified directory.
 
     :since: 0.7.0
     """
@@ -545,7 +548,7 @@ def push_manifest_tags(
     tag: List[str],
 ) -> None:
     """
-    Push artifacts and the manifest from a directory to a registry.
+    Push tags to an OCI image container for a given GardenLinux canonical named image.
 
     :since: 0.10.0
     """
@@ -574,7 +577,7 @@ def push_manifest_tags(
 )
 def save_container(container: str, tag: str, oci_archive: str) -> None:
     """
-    Push to an OCI registry.
+    Saves a given OCI image container as an OCI archive.
 
     :since: 1.0.0
     """
@@ -604,7 +607,7 @@ def save_container(container: str, tag: str, oci_archive: str) -> None:
 )
 def tag_container(container: str, tag: str, additional_tag: List[str]) -> None:
     """
-    Push to an OCI registry.
+    Adds additional tags to a given OCI image container.
 
     :since: 1.0.0
     """