This is an automated email from the ASF dual-hosted git repository.
weichiu pushed a commit to branch HDDS-9225-website-v2
in repository https://gitbox.apache.org/repos/asf/ozone-site.git
The following commit(s) were added to refs/heads/HDDS-9225-website-v2 by this
push:
new 64e34833d HDDS-14284. [Website v2] [Docs] [Core Concepts] Overview of
Ozone Namespace (#209)
64e34833d is described below
commit 64e34833ddff4b345dab7718df352bf9ae1d0a55
Author: Bolin Lin <[email protected]>
AuthorDate: Tue Jan 6 13:56:01 2026 -0500
HDDS-14284. [Website v2] [Docs] [Core Concepts] Overview of Ozone Namespace
(#209)
---
docs/03-core-concepts/03-namespace/01-overview.md | 18 +++++++++++++++++-
1 file changed, 17 insertions(+), 1 deletion(-)
diff --git a/docs/03-core-concepts/03-namespace/01-overview.md
b/docs/03-core-concepts/03-namespace/01-overview.md
index c8c958fc0..60b3e3a98 100644
--- a/docs/03-core-concepts/03-namespace/01-overview.md
+++ b/docs/03-core-concepts/03-namespace/01-overview.md
@@ -4,4 +4,20 @@ sidebar_label: Overview
# Overview of Ozone's Namespace
-**TODO:** File a subtask under
[HDDS-9857](https://issues.apache.org/jira/browse/HDDS-9857) and complete this
page or section.
+Apache Ozone organizes data in a three-level hierarchy: Volumes, Buckets, and
Keys. This structure provides a flexible and scalable way to manage large
datasets, similar to how traditional file systems use directories and files,
but optimized for object storage.
+
+## Overview of the Hierarchy
+
+- **[Volumes](volumes/overview):** The top-level organizational unit, akin to
user accounts or home directories.
+- **[Buckets](buckets/overview):** Reside within volumes, similar to
directories or folders, and contain the actual data objects.
+- **[Keys](keys/overview):** The fundamental data objects, analogous to files,
stored inside buckets.
+
+```text
+Volume
+└─── Bucket
+ ├─── Key 1
+ ├─── Key 2
+ └─── ...
+```
+
+This hierarchy is managed by the Ozone Manager, which is the principal
namespace service of Ozone.
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
