SeaweedFS is a distributed storage system for object storage (S3), file systems, Iceberg table buckets, and Lance vector buckets, designed to handle billions of files with O(1) disk access and effortless horizontal scaling.
Go blob-storagecloud-drivedistributed-file-systemdistributed-storageerasure-codingfusehadoop-hdfshdfskuberneteslancelancedbobject-storageposixs3s3-storageseaweedfstiered-file-systemvector-search
package shell
import (
"context"
"flag"
"fmt"
"io"
"github.com/seaweedfs/seaweedfs/weed/pb/filer_pb"
"github.com/seaweedfs/seaweedfs/weed/s3api/s3_constants"
"github.com/seaweedfs/seaweedfs/weed/util"
)
func init() {
Commands = append(Commands, &commandS3BucketLock{})
}
type commandS3BucketLock struct {
}
func (c *commandS3BucketLock) Name() string {
return "s3.bucket.lock"
}
func (c *commandS3BucketLock) Help() string {
return `view or enable Object Lock for an S3 bucket
Example:
# View the current Object Lock status of a bucket
s3.bucket.lock -name <bucket_name>
# Enable Object Lock on an existing bucket (irreversible)
s3.bucket.lock -name <bucket_name> -enable
Object Lock provides WORM (Write Once Read Many) protection for objects.
Once enabled, Object Lock cannot be disabled on a bucket.
Requirements:
- Versioning will be automatically enabled if not already enabled
- Object Lock can only be enabled, never disabled (following AWS S3 behavior)
After enabling Object Lock, you can:
- Set default retention policy on the bucket
- Set retention and legal hold on individual objects
`
}
func (c *commandS3BucketLock) HasTag(CommandTag) bool {
return false
}
func (c *commandS3BucketLock) Do(args []string, commandEnv *CommandEnv, writer io.Writer) (err error) {
bucketCommand := flag.NewFlagSet(c.Name(), flag.ContinueOnError)
bucketName := bucketCommand.String("name", "", "bucket name")
enableLock := bucketCommand.Bool("enable", false, "enable Object Lock on the bucket (irreversible)")
if err = bucketCommand.Parse(args); err != nil {
return err
}
if *bucketName == "" {
return fmt.Errorf("empty bucket name")
}
err = commandEnv.WithFilerClient(false, func(client filer_pb.SeaweedFilerClient) error {
resp, err := client.GetFilerConfiguration(context.Background(), &filer_pb.GetFilerConfigurationRequest{})
if err != nil {
return fmt.Errorf("get filer configuration: %w", err)
}
filerBucketsPath := resp.DirBuckets
// Look up the bucket entry
lookupResp, err := client.LookupDirectoryEntry(context.Background(), &filer_pb.LookupDirectoryEntryRequest{
Directory: filerBucketsPath,
Name: *bucketName,
})
if err != nil {
return fmt.Errorf("lookup bucket %s: %w", *bucketName, err)
}
entry := lookupResp.Entry
// Check current Object Lock status
currentLockEnabled := false
currentVersioningEnabled := false
if entry.Extended != nil {
if lockStatus, ok := entry.Extended[s3_constants.ExtObjectLockEnabledKey]; ok {
currentLockEnabled = string(lockStatus) == s3_constants.ObjectLockEnabled
}
if versioningStatus, ok := entry.Extended[s3_constants.ExtVersioningKey]; ok {
currentVersioningEnabled = string(versioningStatus) == s3_constants.VersioningEnabled
}
}
// If -enable is provided, enable Object Lock
if *enableLock {
if currentLockEnabled {
fmt.Fprintf(writer, "Object Lock is already enabled on bucket %s\n", *bucketName)
return nil
}
if entry.Extended == nil {
entry.Extended = make(map[string][]byte)
}
// Enable versioning if not already enabled (required for Object Lock)
if !currentVersioningEnabled {
entry.Extended[s3_constants.ExtVersioningKey] = []byte(s3_constants.VersioningEnabled)
fmt.Fprintf(writer, "Enabling versioning on bucket %s (required for Object Lock)\n", *bucketName)
}
// Enable Object Lock
entry.Extended[s3_constants.ExtObjectLockEnabledKey] = []byte(s3_constants.ObjectLockEnabled)
fmt.Fprintf(writer, "Enabling Object Lock on bucket %s\n", *bucketName)
// Update the entry
if _, err := client.UpdateEntry(context.Background(), &filer_pb.UpdateEntryRequest{
Directory: filerBucketsPath,
Entry: entry,
}); err != nil {
return fmt.Errorf("failed to update bucket: %w", err)
}
fmt.Fprintf(writer, "Object Lock enabled successfully.\n")
fmt.Fprintf(writer, "WARNING: This action is irreversible. Object Lock cannot be disabled.\n")
return nil
}
// Display current status (no flags provided)
fmt.Fprintf(writer, "Bucket: %s\n", *bucketName)
fmt.Fprintf(writer, "Path: %s\n", util.NewFullPath(filerBucketsPath, *bucketName))
if currentVersioningEnabled {
fmt.Fprintf(writer, "Versioning: Enabled\n")
} else {
fmt.Fprintf(writer, "Versioning: Disabled\n")
}
if currentLockEnabled {
fmt.Fprintf(writer, "Object Lock: Enabled\n")
} else {
fmt.Fprintf(writer, "Object Lock: Disabled\n")
fmt.Fprintf(writer, "\nTo enable Object Lock, run:\n")
fmt.Fprintf(writer, " s3.bucket.lock -name %s -enable\n", *bucketName)
}
return nil
})
return err
}