From 21c40863991a1c6748551ba86ae5ca270e52feab Mon Sep 17 00:00:00 2001 From: Shubham Singh <116020663+1Shubham7@users.noreply.github.com> Date: Tue, 8 Aug 2023 00:40:10 +0530 Subject: [PATCH] adding `oras manifest fetch` to the docs "Pushing_and_pulling" (#241) * adding `oras manifest fetch` to the docs "Pushing_and_pulling" Signed-off-by: Shubham Singh <116020663+1Shubham7@users.noreply.github.com> * similarly adding `oras manifest fetch` in manifest_annotations.mdx Signed-off-by: Shubham Singh <116020663+1Shubham7@users.noreply.github.com> * changes suggested by sanjayantony Signed-off-by: Shubham Singh <116020663+1Shubham7@users.noreply.github.com> * changes suggested by @sanjayantony Signed-off-by: Shubham Singh <116020663+1Shubham7@users.noreply.github.com> --------- Signed-off-by: Shubham Singh <116020663+1Shubham7@users.noreply.github.com> --- docs/how_to_guides/manifest_annotations.mdx | 8 +++++++- docs/how_to_guides/pushing_and_pulling.mdx | 8 +++++++- 2 files changed, 14 insertions(+), 2 deletions(-) diff --git a/docs/how_to_guides/manifest_annotations.mdx b/docs/how_to_guides/manifest_annotations.mdx index c7cbecde..b59aeb19 100644 --- a/docs/how_to_guides/manifest_annotations.mdx +++ b/docs/how_to_guides/manifest_annotations.mdx @@ -82,6 +82,12 @@ In order to add annotations using the `annotations.json`, you may run the follow oras push --annotation-file annotations.json localhost:5000/club:party cake.txt juice.txt ``` +The push command would upload the blob and put a manifest. Running the following command to output the manifest: + +``` +oras manifest fetch localhost:5000/club:party --pretty +``` + Expected Output: ```json @@ -118,4 +124,4 @@ Expected Output: "foo": "bar" } } -``` \ No newline at end of file +``` diff --git a/docs/how_to_guides/pushing_and_pulling.mdx b/docs/how_to_guides/pushing_and_pulling.mdx index 9f8418f5..64b52837 100644 --- a/docs/how_to_guides/pushing_and_pulling.mdx +++ b/docs/how_to_guides/pushing_and_pulling.mdx @@ -97,7 +97,13 @@ See [OCI Artifacts](https://github.com/opencontainers/image-spec/blob/main/manif ./docs/:application/vnd.acme.rocket.docs.layer.v1+tar ``` -- The push would generate the following manifest: +- The push will generate a manifest. Run the following command to output the manifest: + + ``` + oras manifest fetch localhost:5000/hello-artifact:v2 --pretty + ``` + + Results in: ```json {