Skip to content

Add S3 storage and multi-hop transfer tutorial section#766

Open
alessio94 wants to merge 7 commits into
rucio:mainfrom
alessio94:alessio94-s3-tutorial-v3
Open

Add S3 storage and multi-hop transfer tutorial section#766
alessio94 wants to merge 7 commits into
rucio:mainfrom
alessio94:alessio94-s3-tutorial-v3

Conversation

@alessio94
Copy link
Copy Markdown

This PR supersedes #744 and #739.

Addresses feedback from PR #744:

  • Remove Jupyter notebook
  • Inline script content directly as code blocks
  • Replace inline script comments with prose descriptions
  • Remove docker exec wrapping; assume reader is in a Rucio admin environment
  • Narrow scope to S3 RSE setup only; remove environment initialization steps
  • Thanks for the feedback
    @voetberg

alessio94 and others added 3 commits March 23, 2026 14:13
Addresses feedback from PR rucio#744:
- Remove Jupyter notebook
- Inline script content directly as code blocks
- Replace inline script comments with prose descriptions
- Remove docker exec wrapping; assume reader is in a Rucio admin environment
- Narrow scope to S3 RSE setup only; remove environment initialization steps
Comment thread docs/operator/setting_up_demo.md Outdated
Comment thread docs/operator/setting_up_demo.md Outdated
Comment thread docs/operator/setting_up_demo.md Outdated
Comment thread docs/operator/setting_up_demo.md
Comment thread docs/operator/setting_up_demo.md Outdated
@voetberg
Copy link
Copy Markdown
Contributor

voetberg commented May 1, 2026

Hi @alessio94 , have you gotten a chance to look at these comments?

@alessio94
Copy link
Copy Markdown
Author

Hi @voetberg, thanks for the follow-up and apologies for the slow response.

I'll address the remaining comments, but I want to be transparent: this PR is now at its third or fourth iteration and I'm finding it difficult to prioritize given that my ATLAS qualification task effectively concluded weeks ago. I'd appreciate if you could consolidate any remaining feedback in one pass once I push the next update, so we can move toward a final review without further back-and-forth.

A couple of questions before I start: for the suggested changes you left inline, should I simply accept them as-is, or are there parts you'd like me to rework independently? Also, given how many commits have landed on main since this branch was created, would it make more sense to open a fresh PR on a rebased branch rather than continuing here?

I'll aim to push the changes within the next few days.

alessio94 added a commit to alessio94/documentation-rucio that referenced this pull request May 13, 2026
Added detailed instructions for configuring S3 storage and multi-hop transfers in Rucio, including setting up MinIO instances, registering RSEs, and verifying the setup.

This PR supersedes rucio#744, rucio#739, and rucio#766.

Addresses feedback from PR rucio#766.

Thanks for the review, @voetberg. I have implemented the requested documentation changes:

- Updated the introduction to reflect that `rucio` and `rucio-admin` have been merged since Rucio 38, and that admin access is now handled through permission policies.
- Reduced the duplicated MinIO RSE registration commands to a loop over `MINIO1` and `MINIO2`.
- Added explanatory comments for the RSE attributes used in the S3 protocol configuration.
- Reworked the `rse-accounts.cfg` section to separate the commands used to generate the file from the rendered configuration output, using a `console` block for the inspected file content.
- Simplified the explanation of RSE distances and added a Mermaid diagram to make the multi-hop topology clearer.
- Removed the Jupyter notebook material from the documentation, keeping the demo setup focused on the operator workflow.
@voetberg
Copy link
Copy Markdown
Contributor

I'll address the remaining comments, but I want to be transparent: this PR is now at its third or fourth iteration and I'm finding it difficult to prioritize given that my ATLAS qualification task effectively concluded weeks ago. I'd appreciate if you could consolidate any remaining feedback in one pass once I push the next update, so we can move toward a final review without further back-and-forth.

I will do my best on this, but if you make changes that need additional comments after this, I cannot make promises.

A couple of questions before I start: for the suggested changes you left inline, should I simply accept them as-is, or are there parts you'd like me to rework independently?

It makes more sense to just modify this existing PR with the suggested changes, you can simply use git commit --amend to add in those changes.

Also, given how many commits have landed on main since this branch was created, would it make more sense to open a fresh PR on a rebased branch rather than continuing here?

All the content on this page is new, so it shouldn't have to be rebased. The PR doesn't show any conflicts so making a new PR or rebasing won't do anything.

alessio94 and others added 4 commits May 29, 2026 16:58
Co-authored-by: voetberg <magpie127@gmail.com>
I have addressed the inline review comments. In the meanwhile Mario asked me to look into trying the same setup with another S3-compatible backend other than MinIO, RustFS so I added a short RustFS compatibility section at the end.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants