You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/details/minio.md
+8-7Lines changed: 8 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -36,18 +36,19 @@ After the bucket is created, apply the proper [permissions for PBM to use the bu
36
36
37
37
Percona Backup for MongoDB (PBM) needs its own dedicated S3 bucket exclusively for backup-related files. Ensure that this [bucket is created](#storage-bucket-creation) and managed solely by PBM.
38
38
39
-
This is the examplesforthe basic configuration of MinIO and other S3-compatible storagesin Percona Backup for MongoDB. You can find [the configuration file template :octicons-link-external-16:](https://github.com/percona/percona-backup-mongodb/blob/v{{release}}/packaging/conf/pbm-conf-reference.yml) and uncomment the required fields.
39
+
This is the exampleforthe basic configuration of MinIO and other S3-compatible storagesin Percona Backup for MongoDB. You can find [the configuration file template :octicons-link-external-16:](https://github.com/percona/percona-backup-mongodb/blob/v{{release}}/packaging/conf/pbm-conf-reference.yml) and uncomment the required fields.
40
40
41
41
```yaml
42
42
storage:
43
43
type: minio
44
44
minio:
45
-
endpoint: localhost:9100
46
-
bucket: pbm-example
47
-
prefix: data/pbm/test
48
-
credentials:
49
-
access-key-id: <your-access-key-id-here>
50
-
secret-access-key: <your-secret-key-here>
45
+
endpoint: localhost:9100
46
+
region: us-east-1
47
+
bucket: pbm-example
48
+
prefix: data/pbm/test
49
+
credentials:
50
+
access-key-id: <your-access-key-id-here>
51
+
secret-access-key: <your-secret-key-here>
51
52
```
52
53
53
54
For the description of configuration options, see [Configuration file options](../reference/configuration-options.md).
@@ -67,7 +65,6 @@ The name of the storage bucket. See the [AWS Bucket naming rules](https://docs.a
67
65
68
66
The location of the storage bucket.
69
67
Use the [AWS region list](https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region) to define the bucket region
70
-
Use the [AWS region list](https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region) to define the bucket region
71
68
72
69
### storage.s3.prefix
73
70
@@ -88,7 +85,6 @@ The URL to access the bucket.
88
85
*Type*: array of strings <br>
89
86
*Required*: NO
90
87
91
-
The list of custom paths for `pbm-agents` on different servers to the same storage. Use this option if `pbm-agents` reside on servers hidden behind different network configurations. Read more in the [Support for multiple endpoints to the same S3 storage](../details/endpoint-map.md) section. Supported for Amazon S3 and Microsoft Azure Blob storages. Available with version 2.8.0.
92
88
The list of custom paths for `pbm-agents` on different servers to the same storage. Use this option if `pbm-agents` reside on servers hidden behind different network configurations. Read more in the [Support for multiple endpoints to the same S3 storage](../details/endpoint-map.md) section. Supported for Amazon S3 and Microsoft Azure Blob storages. Available with version 2.8.0.
93
89
94
90
### storage.s3.forcePathStyle
@@ -294,7 +290,7 @@ storage:
294
290
*Type*: string <br>
295
291
*Required*: YES
296
292
297
-
The location of the storage bucket. Use the [AWS region list](https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region) to define the bucket region. If undefined, the default `us-east-1` region is used.
293
+
The location of the storage bucket. Use the [AWS region list](https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region) to define the bucket region. If not specified, the default `us-east-1` region is used.
298
294
299
295
### storage.minio.bucket
300
296
@@ -324,7 +320,7 @@ The network address (URL or IP) where your MinIO server is accessible.
324
320
*Type*: array of strings
325
321
*Required*: NO
326
322
327
-
The list of custom paths for `pbm-agents` on different servers to the same storage. Use this option if `pbm-agents` reside on servers hidden behind different network configurations. Read more in the [Support for multiple endpoints to the same S3 storage](../details/endpoint-map.md) section. Supported for Amazon S3 and Microsoft Azure Blob storages. Available with version 2.8.0.
323
+
A mapping of custom endpoints for `pbm-agents` on different servers to the same MinIO storage. Use this option if `pbm-agents` reside on servers hidden behind different network configurations. Read more in the [Support for multiple endpoints to the same S3 storage](../details/endpoint-map.md) section. Supported for Amazon S3, MinIO, and Microsoft Azure Blob storages. Available with version 2.8.0.
328
324
329
325
### storage.minio.secure
330
326
@@ -340,7 +336,7 @@ Defines whether to use HTTP or HTTPS protocol for communication between PBM and
340
336
*Required*: NO
341
337
*Default*: false
342
338
343
-
Disables the TLS verification of the S3 storage. This allows Percona Backup for MongoDB to upload data to S3-like storages that use self-issued TLS certificates. Use it with caution as it might leave a hole for man-in-the-middle attacks.
339
+
Disables the TLS verification of the MinIO / S3-compatible storage. This allows Percona Backup for MongoDB to upload data to MinIO / S3-compatible storages that use self-issued TLS certificates. Use it with caution as it might leave a hole for man-in-the-middle attacks.
344
340
345
341
### storage.minio.forcePathStyle
346
342
@@ -377,7 +373,9 @@ The MinIO session token used to validate the temporary security credentials for
377
373
*Required*: NO
378
374
*Default*: V4
379
375
380
-
Allows using the deprecated AWS Signature version 2. May be used for backward compatibility with the storages that don't support Signature version 4. Default: `V4`.
376
+
Specifies the AWS Signature version to use for authentication. Accepted values: `V2`, `V4`.
377
+
378
+
Allows using the deprecated AWS Signature version 2 for backward compatibility with storages that don't support Signature version 4. Default: `V4`.
381
379
382
380
### storage.minio.partSize
383
381
@@ -390,9 +388,9 @@ The size of data chunks in bytes to be uploaded to the storage bucket. Default:
390
388
391
389
*Type*: int
392
390
*Required*: NO
393
-
*Deafult*: 10
391
+
*Default*: 10
394
392
395
-
The maximum number of retries to upload data to S3 storage. A zero value means no retries will be performed.
393
+
The maximum number of retries to upload data to MinIO / S3-compatible storage. A zero value means no retries will be performed.
396
394
397
395
### storage.minio.maxObjSizeGB
398
396
@@ -567,10 +565,10 @@ The URL to access the data in Microsoft Azure Blob Storage. The default value is
567
565
568
566
### storage.azure.endpointUrlMap
569
567
570
-
*Type*: array of strings <br>
568
+
*Type*: object (host:port -> endpoint URL) <br>
571
569
*Required*: NO
572
570
573
-
The list of custom paths for `pbm-agents` on different servers to the same storage. Use this option if `pbm-agents` reside on servers hidden behind different network configurations. Read more in the [Support for multiple endpoints to the same S3 storage](../details/endpoint-map.md) section. Available with version 2.8.0.
571
+
A mapping of custom endpoint URLs for `pbm-agents` on different servers to the same remote storage. Use this option if `pbm-agents` reside on servers hidden behind different network configurations. Read more in the [Support for multiple endpoints to the same remote storage](../details/endpoint-map.md) section. Available with version 2.8.0.
0 commit comments