## Summary Provide user-facing documentation guiding self-managed administrators through installing OpenBao on the same host as a GitLab Linux package, using a co-located Kubernetes cluster. This was the Beta-blocking documentation deliverable for the [OAK Beta Implementation Phase](https://gitlab.com/groups/gitlab-com/gl-infra/software-delivery/-/epics/36). ## Scope User-facing documentation only. The runbook for spinning up a reproducible test environment was originally bundled here and has been split into [`gitlab-org/distribution/runbooks#2`](https://gitlab.com/gitlab-org/distribution/runbooks/-/work_items/2), tracked under the [GA Rollout Implementation epic](https://gitlab.com/groups/gitlab-com/gl-infra/software-delivery/-/epics/87). ### Deliverable - [x] User-facing co-located install guide added to the Secrets Manager documentation, with the Secrets Manager index page presenting both the external-cluster and same-host scenarios. Delivered via [`gitlab-org/gitlab!233700`](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/233700) — *Add co-located OpenBao installation guide*. ### Resulting documentation - [GitLab Secrets Manager](https://docs.gitlab.com/administration/secrets_manager/) — overview presenting both deployment scenarios. - [Install OpenBao on the same host (Linux package)](https://docs.gitlab.com/administration/secrets_manager/linux-package-integration/) — step-by-step user guide. ## References - Parent epic (Beta Implementation): [`gitlab-com/gl-infra/software-delivery&36`](https://gitlab.com/groups/gitlab-com/gl-infra/software-delivery/-/epics/36) - Follow-up runbook issue (split from this one): [`gitlab-org/distribution/runbooks#2`](https://gitlab.com/gitlab-org/distribution/runbooks/-/work_items/2) - Beta feedback collection: [`gitlab-org/omnibus-gitlab#9853`](https://gitlab.com/gitlab-org/omnibus-gitlab/-/work_items/9853) - Design document: [Omnibus-Adjacent Kubernetes (OAK)](https://handbook.gitlab.com/handbook/engineering/architecture/design-documents/omnibus_adjacent_kubernetes/)