Skip to content

Add modular RMT documentation with Ansible-based configuration#737

Open
ngetahun wants to merge 4 commits into
SUSE:mainfrom
ngetahun:rmt-ansible-modular-port
Open

Add modular RMT documentation with Ansible-based configuration#737
ngetahun wants to merge 4 commits into
SUSE:mainfrom
ngetahun:rmt-ansible-modular-port

Conversation

@ngetahun

Copy link
Copy Markdown

Summary

Ports the Repository Mirroring Tool (RMT) documentation into the modular topic-based format as three Smart Doc articles. The modular repo previously had no RMT documentation.

Content is migrated from the SLE RMT Guide (doc-sle) and updated for the new ansible-rmt-server playbook workflow, replacing the YaST-based setup — this is a modular port of SUSE/doc-sle#1945.

Articles added

Article Assembly / DC
Installing and configuring an RMT server articles/rmt-installing-configuring.asm.xml
Mirroring repositories on an RMT server articles/rmt-mirroring-repositories.asm.xml
Migrating from SMT to RMT articles/rmt-migrating-from-smt.asm.xml

25 topics (tasks/concepts/references/glues) + 3 assemblies + 3 DC files + 2 images.

Key changes carried over from the source PR

  • Installation: ansible-rmt-server package instead of yast2-rmt
  • Configuration: new &ansible; playbook section (ansible-playbook site.yml, group_vars/all.yml)
  • Certificate management: regeneration via the Ansible playbook (--tags certificates)
  • Credentials & SMT import: configured through Ansible variables
  • Removed the entire YaST configuration workflow

Notes

  • Cross-references to chapters not ported (RMT client setup, rmt-cli reference) link to the online RMT Guide.
  • Missing entities substituted (&prompt.root.sun;/&prompt.root.sirius;&prompt.root;); the two required images were fetched from doc-sle.
  • maintainer/assignee metadata are left as placeholders and should be filled in before publishing.

Test plan

  • All three articles pass daps validate (DAPS 4 + geekodoc): Document is valid.
  • All three render to HTML with images and Ansible content intact

🤖 Generated with Claude Code

Port the Repository Mirroring Tool (RMT) documentation into the modular
topic-based format as three Smart Doc articles:

- Installing and configuring an RMT server
- Mirroring repositories on an RMT server
- Migrating from SMT to RMT

Content is migrated from the SLE RMT Guide (doc-sle) and updated for the
new ansible-rmt-server playbook workflow, replacing the YaST-based setup
(port of SUSE/doc-sle#1945). Cross-references to un-ported chapters point
to the online RMT Guide. All three articles pass DAPS 4 + geekodoc
validation and render to HTML.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@Amrita42 Amrita42 self-assigned this Jul 22, 2026
@Amrita42

Copy link
Copy Markdown
Contributor

Update: So I have cloned your forked repo and I am adding changes where needed. Once this is done , a team member will review for grammar/style.

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