Skip to content

Doc: review pages organization#99

Merged
l00ptr merged 9 commits intomainfrom
doc/review-pages-organization
Mar 12, 2026
Merged

Doc: review pages organization#99
l00ptr merged 9 commits intomainfrom
doc/review-pages-organization

Conversation

@l00ptr
Copy link
Copy Markdown
Collaborator

@l00ptr l00ptr commented Mar 12, 2026

No description provided.

@l00ptr l00ptr requested a review from pchovelon March 12, 2026 10:38
Copy link
Copy Markdown
Collaborator

@pchovelon pchovelon left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Here is my review :)
I think it's a good job that clarify a lot of part.

To run pgBackRest with parameters not directly managed by this plugin,
the `CustomEnvVar` option can be used.

## Supported repositories type (S3 and Azure)
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## Supported repositories type (S3 and Azure)
## Supported repositories types (S3 and Azure)


## Supported repositories type (S3 and Azure)

The pgBackRest plugin enables PostgreSQL backup files to be stored in:
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The pgBackRest plugin enables PostgreSQL backup files to be stored in:
The pgBackRest plugin enables backup and WAL files to be stored in:

"PostgreSQL" here could be confusing. I suggest to remove it and add WAL files in sentence.


The pgBackRest plugin enables PostgreSQL backup files to be stored in:

- Amazon s3
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Amazon s3
- Amazon S3, or S3 compatible solutions

- Amazon s3
- Microsoft Azure Blob Storage

The plugin relies on the protocols that pgBackRest supports natively. To
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The plugin relies on the protocols that pgBackRest supports natively. To
The plugin relies on pgBackRest protocols. To


The plugin relies on the protocols that pgBackRest supports natively. To
configure the repositories for pgBackRest, you must define a `Stanza`
object, which establishes the link between your PostgreSQL `Cluster` and
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
object, which establishes the link between your PostgreSQL `Cluster` and
object, which establishes the link between one PostgreSQL `Cluster` and

Maybe use "one" to be sure people understand that one stanza = one cluster

your backup :

``` console
kubectl cnpg backup cluster-demo -m plugin --plugin-name pgbackrest.dalibo.com
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
kubectl cnpg backup cluster-demo -m plugin --plugin-name pgbackrest.dalibo.com
kubectl cnpg backup cluster-sample -m plugin --plugin-name pgbackrest.dalibo.com

Or with the `cnpg` plugin:

``` console
$ kubectl cnpg backup cluster-demo -m plugin --plugin-name pgbackrest.dalibo.com \
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
$ kubectl cnpg backup cluster-demo -m plugin --plugin-name pgbackrest.dalibo.com \
kubectl cnpg backup cluster-demo -m plugin --plugin-name pgbackrest.dalibo.com \

remove $ because if users use copy button of the code block, it is useless.

also be defined under the specification (`spec`).

Here is a full example of a scheduled backup definition using the
pgbackrest plugin :
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
pgbackrest plugin :
pgBackRest plugin :


## WAL Archiving

WAL archiving can be customized through the `pgbackrest` CRD. It is
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

pgbackrest CRD ? did you mean Stanza ?


As stated in the
[documentation](https://pgbackrest.org/user-guide.html#quickstart/configure-stanza),
a *stanza* is specific to a PostgreSQL instance cluster.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
a *stanza* is specific to a PostgreSQL instance cluster.
a *stanza* is specific to a PostgreSQL instance.

@l00ptr l00ptr merged commit faf089f into main Mar 12, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants