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.