docs: add troubleshooting section (#509)

Signed-off-by: Jeff Mealo <[email protected]>
Signed-off-by: Gabriele Bartolini <[email protected]>
Signed-off-by: Jonathan Battiato <[email protected]>
Co-authored-by: Gabriele Bartolini <[email protected]>
Co-authored-by: Jonathan Battiato <[email protected]>

Author: 3 people

.wordlist.txt

@@ -1,3 +1,4 @@
+AccessDenied
 AdditionalContainerArgs
 Akamai
 Azurite
@@ -21,9 +22,12 @@ IRSA
 IfNotPresent
 InstanceSidecarConfiguration
 JSON
+Kustomize
 Lifecycle
 Linode
 MinIO
+Misconfiguration
+NoSuchBucket
 ObjectMeta
 ObjectStore
 ObjectStoreSpec
@@ -42,6 +46,7 @@ SAS
 SFO
 SPDX
 SPDX
+SSL
 ServerRecoveryWindow
 Slonik
 TLS
@@ -54,18 +59,21 @@ amz
 api
 apiVersion
 apiextensions
+archiver
 args
 auth
 autocert
 aws
 backend
 backends
 barmanObjectName
+barmanObjectStore
 barmancloud
 boto
 bzip
 cd
 cloudnative
+cloudnativepg
 clusterrole
 clusterrolebinding
 cmctl
@@ -76,7 +84,9 @@ cpu
 creds
 csi
 customresourcedefinition
+declaratively
 deps
+desc
 devel
 env
 externalClusters
@@ -88,11 +98,19 @@ hostpath
 http
 https
 imagePullPolicy
+instanceID
+instanceName
+instanceRole
+involvedObject
 io
 isWALArchiver
+jq
+jsonpath
 kb
+krew
 kubectl
 kubernetes
+lastTimestamp
 lifecycle
 localhost
 md
@@ -102,6 +120,8 @@ namespaces
 objectstore
 objectstores
 pluginConfiguration
+podName
+postgres
 postgresql
 primaryUpdateStrategy
 rbac
@@ -112,6 +132,7 @@ retentionCheckInterval
 retentionPolicy
 rolebinding
 rollout
+rpc
 sc
 secretKeyRef
 selfsigned

web/docs/intro.md

@@ -21,11 +21,30 @@ for detailed instructions.
 
 ## Requirements
 
-To use the Barman Cloud Plugin, you need:
+Before using the Barman Cloud Plugin, ensure that the following components are
+installed and properly configured:
 
-- [CloudNativePG](https://cloudnative-pg.io) version **1.26** <!-- ADD WHEN 1.27 IS OUT "or later" -->
-- [cert-manager](https://cert-manager.io/) to enable TLS communication between
-  the plugin and the operator
+- [CloudNativePG](https://cloudnative-pg.io) version 1.26 or later
+
+  - We strongly recommend version 1.27.0 or later, which includes improved
+    error handling and status reporting for the plugin.
+  - If you are running an earlier release, refer to the
+    [upgrade guide](https://cloudnative-pg.io/documentation/current/installation_upgrade).
+
+- [cert-manager](https://cert-manager.io/)
+
+  - The recommended way to enable secure TLS communication between the plugin
+    and the operator.
+  - Alternatively, you can provide your own certificate bundles. See the
+    [CloudNativePG documentation on TLS configuration](https://cloudnative-pg.io/documentation/current/cnpg_i/#configuring-tls-certificates).
+
+- [`kubectl-cnpg`](https://cloudnative-pg.io/documentation/current/kubectl-plugin/)
+  plugin (optional but recommended)
+
+  - Simplifies debugging and monitoring with additional status and inspection
+    commands.
+  - Multiple installation options are available in the
+    [installation guide](https://cloudnative-pg.io/documentation/current/kubectl-plugin/#install).
 
 ## Key Features