Skip to content

AAP-68189: Update RHEL appliance docs for GA readiness#5918

Open
jklech-work wants to merge 1 commit intoansible:mainfrom
jklech-work:AAP-68189
Open

AAP-68189: Update RHEL appliance docs for GA readiness#5918
jklech-work wants to merge 1 commit intoansible:mainfrom
jklech-work:AAP-68189

Conversation

@jklech-work
Copy link
Copy Markdown
Contributor

@jklech-work jklech-work commented Apr 9, 2026

Summary

  • Adds 3 new CLI commands (portal-apply, portal-restore, portal-registry-login) and expands 4 existing commands with new subcommands/options
  • Adds automated deployment scenarios (cloud-init, OVF, pre-seeded config) to appliance concept
  • Adds SSH key recovery procedures for 3 platforms with SELinux guidance
  • Creates disconnected appliance deployment procedure with bootc switch/upgrade workflow
  • Updates assembly with new disconnected module include
  • master.adoc include remains commented out — will be uncommented in a separate PR at GA time

Note: This PR does NOT activate the RHEL appliance chapter in the published guide. A separate PR will uncomment master.adoc line 26 in the GA window (late May 2026).

Test plan

  • Layer 1 review (review-docs): all files pass (false positives only — technical terms)
  • Layer 2 build: self-service-install guide compiles clean with chapter included
  • Layer 3 AI review: 4 parallel agents, all critical/significant issues resolved
  • Technical accuracy: CLI commands cross-checked against engineering README
  • Version-agnostic: hardcoded RHEL 9 replaced with attribute, image paths use placeholders
  • SME review via Google Doc

SME Review Doc: https://docs.google.com/document/d/1Fer7dFHn_eKC-WKaAX-CPGA0NdfD0hTuf-42MPM3p8Q/edit

Resolves: AAP-68189

Update CLI commands reference with portal-apply, portal-restore, and
portal-registry-login. Expand portal-config with export, import, set,
rollback, and regenerate-secrets subcommands. Update portal-backup
with --full, --minimal, --list, and --export options.

Update appliance concept with automated deployment scenarios
(cloud-init, OVF, pre-seeded config) and disconnected environment
support.

Add SSH key recovery procedures for OCP Virtualization, VMware, and
KVM/QEMU with SELinux restorecon and partition detection guidance.

Create disconnected appliance deployment procedure with registry
authentication, bootc switch/upgrade workflow, and rollback steps.

Note: master.adoc include remains commented out until GA window.

Resolves: AAP-68189
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.

1 participant