marco/plugin-barman-cloud
1
0
Fork 0
mirror of https://github.com/cloudnative-pg/plugin-barman-cloud.git synced 2026-01-11 21:23:12 +01:00
Code Issues Actions Packages Projects Releases Wiki Activity

docs: continue review

Browse Source 
Signed-off-by: Gabriele Bartolini <gabriele.bartolini@enterprisedb.com>
This commit is contained in:
Gabriele Bartolini 2024-12-10 13:30:24 +01:00
parent faa616717c
commit ffd2d523d2
1 changed files with 31 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

50
README.md
View File

@ -49,49 +49,61 @@ plugin, ensuring compatibility and reliability across environments.
## Prerequisites ## Prerequisites
* [CloudNativePG](https://cloudnative-pg.io) 1.25RC1 or newer To use this plugin, ensure the following prerequisites are met:
* [cert-manager](https://cert-manager.io/)
- [**CloudNativePG**](https://cloudnative-pg.io) version **1.25** or newer.
- [**cert-manager**](https://cert-manager.io/) for enabling **TLS communication** between the plugin and the operator.
## Installation ## Installation
**IMPORTANT** The plugin should be installed in the same namespace where the **Important Notes:**
operator is **installed**, usually `cnpg-system`.
**IMPORTANT** This may be different from the namespaces the operator is 1. The plugin **must** be installed in the same namespace where the operator is
listening on. installed (typically `cnpg-system`).
### Step 1 - verify the prerequisites are met 2. Be aware that the operator's **listening namespaces** may differ from its
installation namespace. Ensure you verify this distinction to avoid
configuration issues.
Supposing that CloudNativePG is installed in the default `cnpg-system` Here’s an enhanced version of your instructions for verifying the prerequisites:
namespace, the current version can be verified with:
### Step 1 - Verify the Prerequisites
If CloudNativePG is installed in the default `cnpg-system` namespace, verify its version using the following command:
```sh ```sh
$ kubectl get deployment -n cnpg-system cnpg-controller-manager | grep ghcr.io/cloudnative-pg/cloudnative-pg kubectl get deployment -n cnpg-system cnpg-controller-manager \
| grep ghcr.io/cloudnative-pg/cloudnative-pg
``` ```
Example output:
```output ```output
image: ghcr.io/cloudnative-pg/cloudnative-pg:1.25.0-rc1 image: ghcr.io/cloudnative-pg/cloudnative-pg:1.25.0-rc1
``` ```
Please ensure you're using CloudNativePG 1.25-rc1 or newer. Ensure that the version displayed is **1.25** or newer.
The [cert-manager](https://cert-manager.io) installation can be verified by Then, use the [cmctl](https://cert-manager.io/v1.6-docs/usage/cmctl/#installation)
using the [cmctl](https://cert-manager.io/v1.6-docs/usage/cmctl/#installation) tool to confirm that `cert-manager` is correctly installed:
tool:
```sh ```sh
$ cmctl check api cmctl check api
``` ```
Example output:
```output ```output
The cert-manager API is ready The cert-manager API is ready
``` ```
Both checks are necessary to proceed with the installation.
### Step 2 - install the barman-cloud plugin ### Step 2 - install the barman-cloud plugin
The plugin can be installed via its manifest: **TODO:** temporary section - to be rewritten when manifests are available
<!-- The plugin can be installed via its manifest:
TODO: replace this with the latest manifest as archived in the latest commit of main
-->
```sh ```sh
# Download the plugin-barman-cloud codebase, including its manifest # Download the plugin-barman-cloud codebase, including its manifest