Mention `uid` field

This commit is contained in:
erthalion 2018-06-01 16:44:57 +02:00
parent b82faf66bb
commit e661ea1ea7
2 changed files with 19 additions and 5 deletions

View File

@ -195,13 +195,26 @@ metadata:
name: acid-test-cluster name: acid-test-cluster
spec: spec:
clone: clone:
uid: "efd12e58-5786-11e8-b5a7-06148230260c"
cluster: "acid-batman" cluster: "acid-batman"
timestamp: "2017-12-19T12:40:33+01:00" timestamp: "2017-12-19T12:40:33+01:00"
``` ```
Here `cluster` is a name of a target cluster that is going to be cloned. If Here `cluster` is a name of a target cluster that is going to be cloned. If
`timestamp` is not empty, then a new cluster will be cloned from an S3 bucket `timestamp` is not empty, then a new cluster will be cloned from an S3 bucket,
using the latest backup before the `timestamp`. If `timestamp` is empty or that was created by operator,
absent, a new cluster will be cloned from an existing alive cluster using using the latest backup before the `timestamp`. In this case `uid` field is
pg_basebackup. Note that timezone required for `timestamp` (offset relative to also mandatory - operator will use it to find an S3 bucket. You can find this
UTC, see RFC 3339 section 5.6) field from metadata of a target cluster:
```yaml
apiVersion: acid.zalan.do/v1
kind: postgresql
metadata:
name: acid-test-cluster
uid: efd12e58-5786-11e8-b5a7-06148230260c
```
If `timestamp` is empty or absent, a new cluster will be cloned from an
existing alive cluster using pg_basebackup. Note that timezone required for
`timestamp` (offset relative to UTC, see RFC 3339 section 5.6)

View File

@ -48,6 +48,7 @@ spec:
# with a non-empty timestamp, clone from an S3 bucket using the latest backup before the timestamp # with a non-empty timestamp, clone from an S3 bucket using the latest backup before the timestamp
# with an empty/absent timestamp, clone from an existing alive cluster using pg_basebackup # with an empty/absent timestamp, clone from an existing alive cluster using pg_basebackup
# clone: # clone:
# uid: "efd12e58-5786-11e8-b5a7-06148230260c"
# cluster: "acid-batman" # cluster: "acid-batman"
# timestamp: "2017-12-19T12:40:33+01:00" # timezone required (offset relative to UTC, see RFC 3339 section 5.6) # timestamp: "2017-12-19T12:40:33+01:00" # timezone required (offset relative to UTC, see RFC 3339 section 5.6)
maintenanceWindows: maintenanceWindows: