Skip to content

Conversation

@jojochuang
Copy link
Contributor

@jojochuang jojochuang commented Dec 4, 2025

What changes were proposed in this pull request?

Provide a one-liner summary of the changes in the PR Title field above.
HDDS-14077. [Docs] Multiple S3 gateway using proxy

Please describe your PR in detail:

  • This commit adds a new user documentation page for using multiple S3 gateways with a proxy for load balancing. The document explains the architecture, benefits, and references to Docker Compose examples in the source tree.

The page is located under Architecture -> Ozone S3 Gateway in the navigation.

What is the link to the Apache JIRA

https://issues.apache.org/jira/browse/HDDS-14077

How was this patch tested?

User doc only no code.

This commit adds a new user documentation page for using multiple S3 gateways with a proxy for load balancing. The document explains the architecture, benefits, and provides an HAProxy configuration example and references to Docker Compose examples in the source tree.

The page is located under Architecture -> Ozone S3 Gateway in the navigation.

Change-Id: Ie88862cad69a3b1a20d1747ed32fdbab3a769b0a
Change-Id: If8febb034cb3cd57421410c9b999d563de70d3f4
Copilot finished reviewing on behalf of jojochuang December 4, 2025 21:26
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds new user documentation for setting up multiple S3 gateways with a load balancer (HAProxy) in Ozone. The documentation explains the stateless nature of S3 gateways that enables horizontal scaling and provides references to Docker Compose examples in the source tree.

Key Changes:

  • Adds a new documentation page explaining S3 Gateway load balancing concepts
  • Documents the stateless architecture that enables multiple S3 Gateway instances
  • References Docker Compose examples with HAProxy configuration for practical implementation

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

This document describes how to set up multiple S3 gateways with a proxy for load balancing.
menu:
main:
parent: "Ozone S3 Gateway"
Copy link

Copilot AI Dec 4, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The menu parent should be "Architecture" instead of "Ozone S3 Gateway". All other concept documentation files (Overview.md, OzoneS3Gateway.md, Recon.md, Datanodes.md) use "Architecture" as the parent in the menu structure. This ensures consistent navigation hierarchy in the documentation site.

Suggested change:

menu:
  main:
    parent: "Architecture"
Suggested change
parent: "Ozone S3 Gateway"
parent: "Architecture"

Copilot uses AI. Check for mistakes.
linkTitle: "S3 Gateway Load Balancing"
date: 2023-11-29
weight: 1
description: >
Copy link

Copilot AI Dec 4, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The frontmatter uses "description:" field, but other documentation files in the concept directory consistently use "summary:" instead. For consistency with the existing documentation structure (see Overview.md, OzoneS3Gateway.md, Recon.md), this should be changed to "summary:".

Suggested change:

summary: >
  This document describes how to set up multiple S3 gateways with a proxy for load balancing.
Suggested change
description: >
summary: >

Copilot uses AI. Check for mistakes.
@adoroszlai adoroszlai added the documentation Improvements or additions to documentation label Dec 5, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants