From db5efd4323b7af51a1c9afbac8caae4fc71242ec Mon Sep 17 00:00:00 2001 From: Juan Bustamante Date: Thu, 17 Aug 2023 08:23:04 -0500 Subject: [PATCH] updating some feedback Signed-off-by: Juan Bustamante --- content/docs/features/experimental/_index.md | 6 ++++++ .../experimental}/export-to-oci-layout.md | 9 +++++---- 2 files changed, 11 insertions(+), 4 deletions(-) create mode 100644 content/docs/features/experimental/_index.md rename content/docs/{app-developer-guide => features/experimental}/export-to-oci-layout.md (91%) diff --git a/content/docs/features/experimental/_index.md b/content/docs/features/experimental/_index.md new file mode 100644 index 000000000..d86c4e808 --- /dev/null +++ b/content/docs/features/experimental/_index.md @@ -0,0 +1,6 @@ ++++ +title="Experimental" +weight=1 +include_summaries=true +expand=false ++++ diff --git a/content/docs/app-developer-guide/export-to-oci-layout.md b/content/docs/features/experimental/export-to-oci-layout.md similarity index 91% rename from content/docs/app-developer-guide/export-to-oci-layout.md rename to content/docs/features/experimental/export-to-oci-layout.md index 5cbe5984c..53c5254a3 100644 --- a/content/docs/app-developer-guide/export-to-oci-layout.md +++ b/content/docs/features/experimental/export-to-oci-layout.md @@ -9,11 +9,11 @@ summary="Learn how to export your application image to disk in OCI layout format
See the specification.
-Exporting to OCI layout format is an **experimental** feature available on pack since version X.Y.Z +Exporting to OCI layout format is an **experimental** feature available on pack since version 0.30.0 ### 1. Enable experimental feature -Verify your pack version is equal or greater than 0.29.0 +Verify your pack version is equal or greater than 0.30.0 ```bash pack version @@ -33,7 +33,8 @@ experimental = true layout-repo-dir = "<$HOME>/.pack/layout-repo" ``` -The configuration shows the experimental mode was **enabled** and a local directory to save images on disk was configured to path `<$HOME>/.pack/layout-repo`. +The configuration shows the experimental mode was **enabled** and a local directory to save images on disk was configured to path `<$HOME>/.pack/layout-repo`. `layout-repo-dir` is being used as a [local repository](https://github.com/buildpacks/rfcs/blob/main/text/0119-export-to-oci.md#how-it-works) +to save images requires by `pack build` command in OCI layout format. ### 2. Build the app @@ -143,7 +144,7 @@ But [crane](https://github.com/google/go-containerregistry/tree/main/cmd/crane) ```bash crane pull --format=oci ``` -It will give you `application/vnd.docker.distribution.manifest.list.v2+json`, which will fail +It will give you `application/vnd.docker.distribution.manifest.list.v2+json`, which will fail because of the [state of our current implementation](https://github.com/buildpacks/rfcs/pull/203#discussion_r1092449172), we will improve this behavior in future versions.