Skip to content

docs: add disconnected cluster support documentation (RHOAIENG-90699) - #157

Merged
MRGuziX merged 1 commit into
mainfrom
tips-missing-models-on-disconected
Sep 14, 2026
Merged

MRGuziX merged 1 commit into
mainfrom
tips-missing-models-on-disconected

Conversation

@MRGuziX

@MRGuziX MRGuziX commented Sep 14, 2026

Copy link
Copy Markdown
Collaborator

Description

Add comprehensive guidance for running AutoRAG indexing on air-gapped clusters

Motivation

https://redhat.atlassian.net/browse/RHOAIENG-90699

Changes

  • add infiormation about the disconnected clusters

Testing

How did you test this?

Checklist

  • Tests added/updated
  • Documentation updated
  • Code follows style guide
  • All checks passing

Add comprehensive guidance for running AutoRAG indexing on air-gapped clusters:

- Add "Prerequisites for Disconnected Clusters" section to maas_indexing_template.ipynb
  with warnings and configuration instructions
- Add code cells to validate DOCLING_ARTIFACTS_PATH and HF_HOME environment variables
- Update extract_text() call to pass docling_artifacts_path parameter
- Add "Appendix: Downloading Models for Offline Use" with step-by-step instructions:
  - Download Docling artifacts on internet-connected machine
  - Pre-download HuggingFace models
  - Transfer artifacts to disconnected cluster
  - Set environment variables
- Update README.md with "Running on Disconnected Clusters" section covering:
  - Which models are required (Docling, HuggingFace)
  - How to pre-download them
  - How to transfer to cluster
  - Environment variable setup
- Add tests to verify notebook includes all required documentation

Fixes: RHOAIENG-90699

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

Signed-off-by: Tomasz Guzik <tguzik@redhat.com>
@MRGuziX
MRGuziX force-pushed the tips-missing-models-on-disconected branch from ed48b03 to d3fa393 Compare September 14, 2026 11:07
@MRGuziX
MRGuziX merged commit 5a84c9b into main Sep 14, 2026
4 checks passed
@MRGuziX
MRGuziX deleted the tips-missing-models-on-disconected branch September 14, 2026 11:16
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