feat(patterns): add rhoso-gitops pattern docs

Add sandbox-tier documentation for the RHOSO GitOps pattern:
overview, getting started, cluster sizing, configuration, and
troubleshooting pages, reusable AsciiDoc modules, metadata from
pattern-metadata.yaml, shared RHOSO attributes, and spellcheck
wordlist entries.

Pattern repository links use cjeanner/pattern-rhoso-gitops for now.
TODO(repo-move) comments mark github, bugs, and deploy URLs to update
once the repo moves to validatedpatterns-sandbox/rhoso-gitops.

Architecture diagrams (GitOps delivery and infrastructure topology)
were created on Miro and exported as SVG under static/images/rhoso-gitops/.

AI-Assist: Cursor; model=Composer; mode=agent; origin=cursor

Author: cjeanner

.wordlist.txt

@@ -39,9 +39,9 @@ anattama
 anonymized
 anonymizer
 ansible
-api's
 apicast
 apicurito
+api's
 apis
 apiversion
 appdev
@@ -109,6 +109,7 @@ cacert
 cakephp
 canarypausestep
 cas
+ccvdr
 cdd
 cdh
 cdn
@@ -128,6 +129,7 @@ chown
 chroot
 cicd
 cj
+cjeanner
 ckollujlir
 claudiol
 cli
@@ -193,6 +195,7 @@ cryptographic
 csi
 csr
 csv
+csvs
 ctdim
 ctrl
 cuda
@@ -209,6 +212,7 @@ dasv
 datacenter
 dataflow
 datagrid
+dataplane
 dataset
 datasets
 datasheet
@@ -315,6 +319,7 @@ externalurl
 extraconfig
 facto
 fadc
+faipqlsci
 fc
 fcb
 fcea
@@ -340,6 +345,7 @@ fs
 fssl
 fsv
 fsync
+fu
 fvsm
 fx
 gapped
@@ -393,6 +399,7 @@ hc
 hcl
 hcp
 hdsr
+healthcheck
 helloworld
 helmoverrides
 helmrepourl
@@ -510,6 +517,8 @@ jtf
 jumpstart
 jupyter
 jws
+jyerthqlkjdugwqbg
+jyerthqlkjdugwqbg7vcg
 kafdrop
 kafkasource
 kafkatopic
@@ -708,11 +717,12 @@ opendatahub
 openid
 openjdk
 openshift
-openshift's
 openshiftpullsecret
+openshift's
 openshiftsdn
 openshiftversion
 openssl
+openstack
 openvino
 openvinotoolkit
 operatorchannel
@@ -776,6 +786,7 @@ predeploy
 prem
 preplay
 preprocess
+prereq
 prereqs
 prerequisitesrequirements
 privatekey
@@ -831,8 +842,8 @@ renderers
 replicaset
 replicasets
 repo
-repo's
 repolist
+repo's
 repos
 repourl
 reranked
@@ -852,6 +863,7 @@ rhoai
 rhocp
 rhodf
 rhods
+rhoso
 rhpam
 rhpds
 rhsm
@@ -961,6 +973,7 @@ svg
 synapseai
 synched
 syncpolicy
+syncwave
 sys
 syscall
 targetbucket
@@ -1037,8 +1050,8 @@ unsealvault
 untrusted
 updatingconfig
 updatingversion
-upstream's
 upstreaming
+upstream's
 ure
 uri
 usecsv
@@ -1056,6 +1069,7 @@ vaultkeys
 vaultpolicy
 vaultprefixes
 vaultproject
+vcg
 vcpu
 vcpus
 vdjtkgams
@@ -1065,6 +1079,7 @@ vectorized
 veeam
 vfio
 vhjpkievife
+viewform
 virtualmachine
 virtualmachines
 vm
@@ -1091,6 +1106,7 @@ wip
 wjalrxutnfemi/k7mdeng/bpxrficyexamplekey
 wnklrcd
 wtjq
+wypu
 wyr
 xeon
 xeons

content/patterns/rhoso-gitops/_index.adoc

@@ -0,0 +1,37 @@
+---
+title: RHOSO GitOps
+date: 2026-06-15
+tier: sandbox
+summary: Deploy Red Hat OpenStack Services on OpenShift using GitOps via the rhoso-gitops meta-chart.
+rh_products:
+  - Red Hat OpenShift Container Platform
+  - Red Hat OpenShift GitOps
+  - Red Hat OpenStack Services on OpenShift
+industries:
+  - General
+focus_areas:
+  - DevSecOps
+aliases: /rhoso-gitops/
+# TODO(repo-move): update github and bugs URLs to validatedpatterns-sandbox/rhoso-gitops
+links:
+  github: https://github.com/cjeanner/pattern-rhoso-gitops
+  install: getting-started
+  bugs: https://github.com/cjeanner/pattern-rhoso-gitops/issues
+  feedback: https://docs.google.com/forms/d/e/1FAIpQLScI76b6tD1WyPu2-d_9CCVDr3Fu5jYERthqLKJDUGwqBg7Vcg/viewform
+---
+
+:toc:
+:imagesdir: /images
+:_content-type: ASSEMBLY
+include::modules/comm-attributes.adoc[]
+
+include::modules/rhoso-gitops/rhoso-gitops-about.adoc[leveloffset=+1]
+
+include::modules/rhoso-gitops/rhoso-gitops-architecture.adoc[leveloffset=+1]
+
+[id="next-steps_rhoso-gitops-index"]
+== Next steps
+
+* link:getting-started[Deploy the pattern]
+* link:cluster-sizing[Review cluster sizing requirements]
+* link:configuration[Configure upstream pins and overrides]

content/patterns/rhoso-gitops/cluster-sizing.adoc

@@ -0,0 +1,33 @@
+---
+title: Cluster sizing
+weight: 20
+aliases: /rhoso-gitops/cluster-sizing/
+---
+
+:toc:
+:imagesdir: /images
+:_content-type: ASSEMBLY
+include::modules/comm-attributes.adoc[]
+include::modules/rhoso-gitops/metadata-rhoso-gitops.adoc[]
+
+include::modules/cluster-sizing-template.adoc[]
+
+[id="rhoso-gitops-dataplane-hosts"]
+== Data plane host requirements
+
+The hub cluster sizing tables above cover the {rh-ocp} nodes that host the
+{rh-rhoso-short} control plane. A full {rh-rhoso-short} deployment also
+requires separate {rhel-short} hosts for the data plane (compute nodes running
+dataplane elements).
+
+Plan additional {rhel-short} capacity beyond the OpenShift worker sizing in
+`pattern-metadata.yaml`. Operator stages, sync order, and version pins are
+documented in the pattern repository
+link:https://github.com/cjeanner/pattern-rhoso-gitops/blob/main/VERSIONS.md[VERSIONS.md]
+file.
+
+[id="next-steps_rhoso-gitops-cluster-sizing"]
+== Next steps
+
+* link:../getting-started/[Deploy the pattern]
+* link:../configuration/[Configure upstream pins and overrides]

content/patterns/rhoso-gitops/configuration.adoc

@@ -0,0 +1,18 @@
+---
+title: Configuration
+weight: 30
+aliases: /rhoso-gitops/configuration/
+---
+
+:toc:
+:imagesdir: /images
+:_content-type: ASSEMBLY
+include::modules/comm-attributes.adoc[]
+
+include::modules/rhoso-gitops/rhoso-gitops-configuration.adoc[leveloffset=+1]
+
+[id="next-steps_rhoso-gitops-configuration"]
+== Next steps
+
+* link:../getting-started/[Deploy the pattern]
+* link:../troubleshooting/[Troubleshooting]

content/patterns/rhoso-gitops/getting-started.adoc

@@ -0,0 +1,19 @@
+---
+title: Getting started
+weight: 10
+aliases: /rhoso-gitops/getting-started/
+---
+
+:toc:
+:imagesdir: /images
+:_content-type: ASSEMBLY
+include::modules/comm-attributes.adoc[]
+
+include::modules/rhoso-gitops/rhoso-gitops-deploying.adoc[leveloffset=+1]
+
+[id="next-steps_rhoso-gitops-getting-started"]
+== Next steps
+
+* link:../configuration/[Configure the pattern]
+* link:../cluster-sizing/[Review cluster sizing]
+* link:../troubleshooting/[Troubleshooting]

content/patterns/rhoso-gitops/troubleshooting.adoc

@@ -0,0 +1,88 @@
+---
+title: Troubleshooting
+weight: 40
+aliases: /rhoso-gitops/troubleshooting/
+---
+
+:toc:
+:imagesdir: /images
+:_content-type: ASSEMBLY
+include::modules/comm-attributes.adoc[]
+
+[id="troubleshooting-rhoso-gitops"]
+= Troubleshooting the {rhoso-gitops-pattern}
+
+[id="rhoso-gitops-validate-pattern"]
+== Validating the pattern
+
+Run pattern validation commands from the pattern repository root:
+
+[source,terminal]
+----
+$ ./pattern.sh make validate-prereq
+$ ./pattern.sh make validate-schema
+$ ./pattern.sh make argo-healthcheck
+----
+
+[id="rhoso-gitops-check-argocd"]
+== Checking Argo CD application status
+
+The pattern uses two Argo CD namespaces. List applications in each:
+
+[source,terminal]
+----
+$ oc get applications -n vp-gitops
+$ oc get applications -n openshift-gitops
+----
+
+Inspect a child application that is out of sync or unhealthy:
+
+[source,terminal]
+----
+$ oc describe application <application-name> -n openshift-gitops
+----
+
+Use the Argo CD UI in the `openshift-gitops` namespace to review sync waves,
+resource health, and diff details for upstream overlays.
+
+[id="rhoso-gitops-check-pods"]
+== Checking pod status
+
+To verify that workloads deployed successfully, list pods that are not Running or
+Completed:
+
+[source,terminal]
+----
+$ oc get pods -A | grep -v Running | grep -v Completed
+----
+
+Review logs for a specific pod:
+
+[source,terminal]
+----
+$ oc logs -n <namespace> <pod-name>
+----
+
+[id="rhoso-gitops-known-issues"]
+== Known issues
+
+* *`openstack-secrets` disabled* — The default pattern leaves
+  `openstack-secrets` disabled because no Git path is configured (`path: TODO`).
+  Enable it only after you configure secret wiring and a bootstrap credential
+  out of band. See link:../configuration/#rhoso-gitops-secret-zero[Secret zero
+  (bootstrap credential)].
+* *Upstream sync failures* — Confirm `targetRevision` and paths in
+  `overrides/values-rhoso-gitops.yaml` match a tag or branch that exists in
+  link:https://github.com/openstack-k8s-operators/gitops[openstack-k8s-operators/gitops].
+* *Operator install delays* — Infrastructure operators in `operator-dependencies`
+  subscribe from the cluster catalog; allow time for OLM to resolve CSVs before
+  later sync waves run.
+
+For community support, open an issue in the
+link:https://github.com/cjeanner/pattern-rhoso-gitops/issues[pattern repository].
+
+[id="next-steps_rhoso-gitops-troubleshooting"]
+== Next steps
+
+* link:../getting-started/[Getting started]
+* link:../configuration/[Configuration]

modules/comm-attributes.adoc

@@ -115,6 +115,9 @@
 :kebab: image:kebab.png[title="Options menu"]
 :rh-openstack-first: Red{nbsp}Hat OpenStack Platform (RHOSP)
 :openstack-short: RHOSP
+:rh-rhoso: Red{nbsp}Hat OpenStack Services on OpenShift
+:rh-rhoso-short: RHOSO
+:rhoso-gitops-pattern: RHOSO GitOps pattern
 //Assisted Installer
 :ai-full: Assisted Installer
 :ai-version: 2.3

modules/rhoso-gitops/metadata-rhoso-gitops.adoc

@@ -0,0 +1,27 @@
+// This file has been generated automatically from the pattern-metadata.yaml file
+// Do not edit manually!
+:metadata_version: 1.0
+:name: rhoso-gitops
+:description: Deploy Red Hat OpenStack Services on OpenShift (RHOSO) using GitOps via the rhoso-gitops meta-chart and upstream Kustomize example overlays.
+:pattern_version: 0.1.0
+:display_name: RHOSO GitOps
+:repo_url: https://github.com/cjeanner/pattern-rhoso-gitops
+:docs_repo_url: https://github.com/validatedpatterns/docs
+:issues_url: https://github.com/cjeanner/pattern-rhoso-gitops/issues
+:docs_url: https://github.com/cjeanner/pattern-rhoso-gitops#readme
+:tier: sandbox
+:owners: cjeanner
+:requirements_hub_compute_platform_aws_replicas: 3
+:requirements_hub_compute_platform_aws_type: m5.4xlarge
+:requirements_hub_compute_platform_azure_replicas: 3
+:requirements_hub_compute_platform_azure_type: Standard_D16s_v3
+:requirements_hub_compute_platform_gcp_replicas: 3
+:requirements_hub_compute_platform_gcp_type: n1-standard-16
+:requirements_hub_controlPlane_platform_aws_replicas: 3
+:requirements_hub_controlPlane_platform_aws_type: m5.2xlarge
+:requirements_hub_controlPlane_platform_azure_replicas: 3
+:requirements_hub_controlPlane_platform_azure_type: Standard_D8s_v3
+:requirements_hub_controlPlane_platform_gcp_replicas: 3
+:requirements_hub_controlPlane_platform_gcp_type: n1-standard-8
+:extra_features_hypershift_support: false
+:extra_features_spoke_support: false