Add section about volume increase #315
Conversation
docs/user.md
Outdated
| ## Increase volume size | ||
|
|
||
| PostgreSQL operator supports statefulset volume resize if you're using the | ||
| operator on top of AWS. For that you need to apply manifest with a new size, |
There was a problem hiding this comment.
I'd change it something like (not clear about which size you are talking about, could be more than one volume that needs to be changed):
'you need to change the size field of the volume description in the cluster manifest and apply it; the operator compares the new value of the size field with the previous one and acts on differences.'
docs/user.md
Outdated
| size: 5Gi # new volume size | ||
| ``` | ||
|
|
||
| You can only increase a volume size in this way, if a new requested size is |
There was a problem hiding this comment.
You can only enlarge the volume with the process described above, shrinking is not supported and will emit a warning.
docs/user.md
Outdated
|
|
||
| You can only increase a volume size in this way, if a new requested size is | ||
| smaller than the previous one nothing will be done. After this update all the | ||
| new pods in a statefulset will be created with a new volume size. To increase a |
There was a problem hiding this comment.
new volumes in the statefulset are allocated according to the new size.
docs/user.md
Outdated
| You can only increase a volume size in this way, if a new requested size is | ||
| smaller than the previous one nothing will be done. After this update all the | ||
| new pods in a statefulset will be created with a new volume size. To increase a | ||
| volume size on already existing pods in a statefulset, the operator will |
There was a problem hiding this comment.
to enlarge persistent volumes attached to the running pods, the operator performs the following actions:
docs/user.md
Outdated
| volume size on already existing pods in a statefulset, the operator will | ||
| perform the following steps: | ||
|
|
||
| * modify EBS volume size |
There was a problem hiding this comment.
call AWS API to change the volume size (AWS rate-limits this operation to no more than once every 6 hours)
docs/user.md
Outdated
|
|
||
| * modify EBS volume size | ||
|
|
||
| * resize an actuall filesystem use `resize2fs` |
There was a problem hiding this comment.
resize the filesystem with resize2fs by doing the equivalent of kubectl exec on the pod.
docs/user.md
Outdated
|
|
||
| * resize an actuall filesystem use `resize2fs` | ||
|
|
||
| Note that if before a volume size was increased a statefulset was scaled down |
There was a problem hiding this comment.
something like '
if the statefulset is scaled down before resizing the size changes are only applied to the volumes attached to the running pods; the size of the volumes that correspond to the previously running pods is not changed.'
|
👍 |
1 similar comment
|
👍 |
Another important feature to document