diff --git a/website/content/en/docs/faqs/_index.md b/website/content/en/docs/faqs/_index.md index 2adc81dff9f..8d2fb11b28f 100644 --- a/website/content/en/docs/faqs/_index.md +++ b/website/content/en/docs/faqs/_index.md @@ -346,4 +346,14 @@ where the command `operator-sdk generate kustomize manifests` is not respecting made on this manifest. [cgo-docs]: https://pkg.go.dev/cmd/cgo -[open-issue]: https://github.com/operator-framework/operator-sdk/issues/new/choose \ No newline at end of file +[open-issue]: https://github.com/operator-framework/operator-sdk/issues/new/choose + +## 'operator-sdk run bundle' command fails and the registry pod has an error of 'mkdir: can't create directory '/database': Permission denied' + +In Operator SDK version `v1.22.0`, the `operator-sdk run bundle` command started using the new file-based catalog (FBC) bundle format by default. Earlier releases used the deprecated SQLite format. The command uses `quay.io/operator-framework/opm:latest` as the index image for creating a registry pod. Due to recent pod security updates, using the latest version of `opm` does not work as expected with the SQLite bundle format. + +There are two workarounds available to resolve this issue: +1. You can update the Operator SDK to version `v1.22.0` or later. Updating to a more recent version makes `operator-sdk run bundle` utilize the new FBC bundle format. +2. If you are not ready to update your version of the Operator SDK, you can manually specify the index image by using the `--index-image=quay.io/operator-framework/opm:v1.23.0` flag. + +**Note:** The SQLite bundle format is deprecated and will be removed in a future release. If you can, it is recommended that you upgrade a newer version of the Operator SDK to resolve the issue. diff --git a/website/content/en/docs/olm-integration/tutorial-bundle.md b/website/content/en/docs/olm-integration/tutorial-bundle.md index b153d616319..6e087883e98 100644 --- a/website/content/en/docs/olm-integration/tutorial-bundle.md +++ b/website/content/en/docs/olm-integration/tutorial-bundle.md @@ -152,8 +152,9 @@ INFO[0040] Found ClusterServiceVersion "default/memcached-operator.v0.0.1" pha INFO[0040] OLM has successfully installed "memcached-operator.v0.0.1" ``` -**Note:** If the bundle that is being installed has dependencies, the `--index-image` flag allows adding a bundle to a catalog that contains that bundle's dependencies. +**Note:** If the bundle that is being installed has dependencies, the `--index-image` flag allows adding a bundle to a catalog that contains that bundle's dependencies. +**Note:** Version `v1.22.0` and later of the `operator-sdk` use the new file-based catalog (FBC) bundle format by default. Earlier releases use the deprecated SQLite bundle format. If you use an earlier version of the Operator SDK, you must update to a newer version or specify the index image by adding the `--index-image=quay.io/operator-framework/opm:v1.23.0` flag. For more information about this known issue, see the [FAQ][run-bundle-fbc-sqlite-faq]. ### Upgrading a bundle to a newer version @@ -308,3 +309,4 @@ In-depth discussions of OLM concepts mentioned here: [olm-install]:https://olm.operatorframework.io/docs/tasks/install-operator-with-olm/ [olm-manifests]:https://github.com/operator-framework/operator-lifecycle-manager/blob/master/deploy/upstream/quickstart/olm.yaml [run-bundle]: https://sdk.operatorframework.io/docs/cli/operator-sdk_run_bundle/ +[run-bundle-fbc-sqlite-faq]: https://sdk.operatorframework.io/docs/faqs/#operator-sdk-run-bundle-command-fails-and-the-registry-pod-has-an-error-of-mkdir-cant-create-directory-database-permission-denied