Replication
Console
Cache
Encryption
Versioning
Observability
Object Immutability
Key Management Server
S3 Compatibility
Identity + Access Mgt
Catalog
Object Prompt
Lifecycle
Firewall
AIHub
Erasure Code Calculator
Reference Hardware
Integrations with MinIO
Download MinIO Object Store
Events
Batch Framework
Overview
The MinIO Batch Framework allows you to create, manage, monitor, and execute jobs using a YAML-formatted job definition file (a “batch file”). The batch jobs run directly on the MinIO deployment to take advantage of the server-side processing power without constraints of the local machine where you run the MinIO Client.
A batch file defines one job task.
Once started, MinIO starts processing the job. Time to completion depends on the resources available to the deployment.
If any portion of the job fails, MinIO retries the job up to the number of times defined in the job definition.
The MinIO Batch Framework supports the following job types:
Job Type |
Description |
|---|---|
Perform a one-time replication procedure from one MinIO location to another MinIO location. |
|
Perform a one-time process to cycle the sse-s3 or sse-kms cryptographic keys on objects. |
|
Perform a one-time immediate expiration of objects in a bucket. |
MinIO Batch CLI
Install the MinIO Client
Define an
aliasfor the MinIO deployment
The mc batch commands include
The |
|
The |
|
The |
|
The Changed in version mc: RELEASE.2024-07-03T20-17-25Z Batch status displays summaries for active, in-progress jobs or any batch job completed in the previous three (3) days. |
|
The |
|
The |
Access to mc batch
Each batch job executes using the credentials specified in the batch definition. The success of a given batch job depends on those credentials having the appropriate permissions to perform all requested actions.
The user executing the batch job must have the following permissions. You can alternatively restrict users from accessing these functions by blocking or limiting access to these actions:
admin:ListBatchJobsGrants the user the ability to see batch jobs currently in process.
admin:DescribeBatchJobsGrants the user the ability to see the definition details of batch job currently in process.
admin:StartBatchJobGrants the user the ability to start a batch job. The job may be further restricted by the credentials the job uses to access either the source or target deployments.
admin:CancelBatchJobAllows the user to stop a batch job currently in progress.
You can assign any of these actions to users independently or in any combination.
The built-in ConsoleAdmin policy includes sufficient access to perform all of these types of batch job actions.
Local Deployment
You run a batch job against a particular deployment by passing an alias to the mc batch command.
The deployment you specify in the command becomes the local deployment within the context of that batch job.
