Skip to content

Add ArgoCD, FluxCD and OpenShift install guides for KubeStash#79

Merged
tamalsaha merged 7 commits into
masterfrom
distro-install
Jun 16, 2026
Merged

Add ArgoCD, FluxCD and OpenShift install guides for KubeStash#79
tamalsaha merged 7 commits into
masterfrom
distro-install

Conversation

@tamalsaha

@tamalsaha tamalsaha commented Jun 12, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Document deploying KubeStash declaratively via ArgoCD using three Application manifests (ace-user-roles, license-proxyserver, kubestash), with notes on the ignoreDifferences blocks that keep the apps in sync against rotating certs and webhook CA bundles.
  • Document deploying KubeStash declaratively via FluxCD using an OCI HelmRepository pointing at ghcr.io/appscode-charts plus three HelmRelease resources for the same three charts. helm-controller reconciles via helm upgrade, so no ignoreDifferences equivalent is needed.
  • Document two ways to install KubeStash on OpenShift: the standard chart with global.distro.openshift=true / global.distro.ubi=all, and the Red Hat certified kubestash-certified chart, which must be paired with the separate kubestash-certified-crds chart because the certified chart ships without CRDs.

Test plan

  • Build the docs site locally and confirm the new ArgoCD, FluxCD and OpenShift sections render correctly under docs/setup/install/kubestash/.
  • Verify intra-page links to #verify-installation resolve.

kodiak-appscode[bot]
kodiak-appscode Bot previously approved these changes Jun 12, 2026
kodiak-appscode[bot]
kodiak-appscode Bot previously approved these changes Jun 12, 2026
@tamalsaha tamalsaha changed the title Add ArgoCD and OpenShift install guides for KubeStash Add ArgoCD, FluxCD and OpenShift install guides for KubeStash Jun 12, 2026
kodiak-appscode[bot]
kodiak-appscode Bot previously approved these changes Jun 15, 2026
kodiak-appscode[bot]
kodiak-appscode Bot previously approved these changes Jun 15, 2026
kodiak-appscode[bot]
kodiak-appscode Bot previously approved these changes Jun 15, 2026
kodiak-appscode[bot]
kodiak-appscode Bot previously approved these changes Jun 15, 2026
kodiak-appscode[bot]
kodiak-appscode Bot previously approved these changes Jun 15, 2026
kodiak-appscode[bot]
kodiak-appscode Bot previously approved these changes Jun 15, 2026
kodiak-appscode[bot]
kodiak-appscode Bot previously approved these changes Jun 15, 2026
kodiak-appscode[bot]
kodiak-appscode Bot previously approved these changes Jun 16, 2026
kodiak-appscode[bot]
kodiak-appscode Bot previously approved these changes Jun 16, 2026
kodiak-appscode[bot]
kodiak-appscode Bot previously approved these changes Jun 16, 2026
kodiak-appscode[bot]
kodiak-appscode Bot previously approved these changes Jun 16, 2026
Document deploying KubeStash declaratively via ArgoCD using the
ace-user-roles, license-proxyserver and kubestash Application
manifests, and document two ways to install on OpenShift: the
standard chart with global.distro.openshift/ubi values, and the
Red Hat certified chart paired with the separate CRDs chart.

Signed-off-by: Tamal Saha <tamal@appscode.com>
Document deploying KubeStash declaratively via FluxCD using an
OCI HelmRepository for ghcr.io/appscode-charts and three
HelmReleases for ace-user-roles, license-proxyserver and
kubestash, mirroring the ArgoCD flow.

Signed-off-by: Tamal Saha <tamal@appscode.com>
tamalsaha and others added 3 commits June 16, 2026 12:29
Signed-off-by: Tamal Saha <tamal@appscode.com>
Split the single setup/install/kubestash/index.md into a section with
one page per installation method (Helm, YAML, ArgoCD, FluxCD, OpenShift)
plus a common configuration page holding the verify steps, mirroring
kubedb/docs#885. Repoint referencing pages to the new _index.md.

Signed-off-by: Arnob Kumar Saha <arnob@appscode.com>
- yaml.md: prodecure -> procedure
- openshift.md: replace 'chart shown above' with a link to the Helm page
- argocd/fluxcd/openshift: reword the verify link to Common Configuration

Signed-off-by: Arnob Kumar Saha <arnob@appscode.com>
kodiak-appscode[bot]
kodiak-appscode Bot previously approved these changes Jun 16, 2026
Point the per-method install guide cross-links at the actual .md files so
the liche link checker can resolve them locally (the pretty-URL form with a
trailing slash has no matching file/directory on disk).

Signed-off-by: Anisur Rahman <anisur@appscode.com>
kodiak-appscode[bot]
kodiak-appscode Bot previously approved these changes Jun 16, 2026
Comment thread docs/setup/install/kubestash/configuration.md Outdated
Comment thread docs/setup/install/kubestash/configuration.md
Comment thread docs/setup/install/kubestash/fluxcd.md
Signed-off-by: Anisur Rahman <anisur@appscode.com>
@github-actions

Copy link
Copy Markdown

Visit the preview URL for this PR (updated for commit 5de2a72):

https://kubestash-qa--pr79-distro-install-9mbqrq47.web.app

(expires Tue, 23 Jun 2026 07:58:56 GMT)

🔥 via Firebase Hosting GitHub Action 🌎

Sign: 7765752f86b485f0f549c1d5d58c61af5e2ecd74

@tamalsaha tamalsaha merged commit 99b97fe into master Jun 16, 2026
6 of 7 checks passed
@tamalsaha tamalsaha deleted the distro-install branch June 16, 2026 08:15
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.

3 participants