echonesis commented on code in PR #207: URL: https://github.com/apache/ozone-site/pull/207#discussion_r2659007789
########## docs/03-core-concepts/03-namespace/02-buckets/01-overview.md: ########## @@ -4,4 +4,58 @@ sidebar_label: Overview # Buckets Overview -**TODO:** File a subtask under [HDDS-9857](https://issues.apache.org/jira/browse/HDDS-9857) and complete this page or section. +## What is a Bucket? + +A **Bucket** is the second level in the Ozone data hierarchy, residing within a volume. Buckets are analogous to directories or folders in a traditional file system. +They serve as containers for keys (data objects). + +**Key Characteristics:** + +- **Contained within Volumes:** Every bucket must belong to a volume. +- **Container for Keys:** A bucket can contain any number of keys. +- **No Nested Buckets:** Unlike directories, buckets cannot contain other buckets. + +## Details + +### Creation and Management + +Buckets are created within a specified volume. + +```bash +ozone sh bucket create /myvolume/mybucket +``` + +For more details on bucket operations, refer to the [Ozone CLI documentation](../../../04-user-guide/01-client-interfaces/01-o3.md#bucket-operations). + +### Bucket Layouts (Object Store vs. File System Optimized) + +Ozone supports different bucket layouts, primarily: + +- **Object Store (OBS):** The traditional object storage layout, where keys are stored with their full path names. This is suitable for S3-like access patterns. +- **File System Optimized (FSO):** An optimized layout for Hadoop Compatible File System (HCFS) semantics, where intermediate directories are stored separately, improving performance for file system operations like listing and renaming. +For more details, refer to the [Prefix FSO documentation](../../../07-system-internals/07-features/01-filesystem-optimization.md). + +### Erasure Coding + +Erasure Coding (EC) can be enabled at the bucket level to define data redundancy strategies. This allows for more efficient storage compared to replication, especially for large datasets. +For more information, see the [Erasure Coding documentation](../../../07-system-internals/07-features/04-erasure-coding.md). + +### Snapshots + +Ozone's snapshot feature allows users to take point-in-time consistent images of a given bucket. These snapshots are immutable and can be used for backup, recovery, archival, and incremental replication purposes. +For more details, refer to the [Ozone Snapshot documentation](../../../07-system-internals/07-features/03-bucket-snapshots.md). Review Comment: Thanks! I've updated it and created a brief intro to bucket snapshot under Core Concepts -> Namespace -> Buckets -> Snapshots. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
