Skip to content

docs(deploy): add Kubernetes and BTP deployment guides - #188

Draft
MichaelSp wants to merge 4 commits into
mainfrom
docs/update-getting-started
Draft

docs(deploy): add Kubernetes and BTP deployment guides#188
MichaelSp wants to merge 4 commits into
mainfrom
docs/update-getting-started

Conversation

@MichaelSp

@MichaelSp MichaelSp commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

What this PR does / why we need it:
People might be a bit lost after running thru the "getting started" and maybe try to install workload on the CP. This PR adds a new "Usage" section to the getting-started docs with two guides:

  • Deploy to Kubernetes — covers OCM (recommended for air-gap/sovereign cloud), Flux, ArgoCD, and kubectl/kustomize approaches, with a comparison table
  • Deploy to SAP BTP — Crossplane-based provisioning of BTP service instances and bindings

Also updates the getting-started index to link the new pages.

Which issue(s) this PR fixes:
Fixes #

Special notes for your reviewer:
The OCM guide links out to ocm.software docs for transfer/transport and artifact building. The BTP guide assumes the platform owner sets up the ProviderConfig.

Release note:

Add usage guides: Deploy to Kubernetes (OCM, Flux, ArgoCD, kubectl) and Deploy to SAP BTP (Crossplane).

@MichaelSp
MichaelSp requested a review from GenosseOtt August 3, 2026 11:16
@MichaelSp
MichaelSp marked this pull request as draft August 3, 2026 11:23
Add deploy section with two new pages:
- Deploy to Kubernetes: OCM (recommended), Flux, ArgoCD, kubectl approaches
- Deploy to SAP BTP: Crossplane-based BTP service provisioning

Update getting-started index to link the new deploy pages.

Signed-off-by: Michael Sprauer <Michael.Sprauer@sap.com>
@MichaelSp
MichaelSp force-pushed the docs/update-getting-started branch from 1b9c343 to 8a278c0 Compare August 3, 2026 11:32
MichaelSp and others added 2 commits August 3, 2026 13:33
Signed-off-by: Michael <MichaelSp@users.noreply.github.com>
Signed-off-by: Michael Sprauer <Michael.Sprauer@sap.com>
@MichaelSp
MichaelSp marked this pull request as ready for review August 3, 2026 11:43
GenosseOtt

This comment was marked as outdated.

@GenosseOtt

Copy link
Copy Markdown
Collaborator

Hey, @MichaelSp I like where this is going and the "end-user" empthy demonstrated :-)

Lets navigate the readers to the power actual Orcehstration that this platform enables and not stop at platform setup guides.

I see two pillars here - and you're touching on both alredy

  1. How do we recommend the platform to be used to roll out software (@sk31337 ) did wonderful work on that
    Can we reuse that and move public?

  2. Referencing a concrete story like BTP is wonderful, but as we are vendor-neutral platform, I'd say lets place similar material to use GCP, Azure, AWS equally (alphabetically ordered ;-) )

@GenosseOtt GenosseOtt left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

see comment

…cluster

Signed-off-by: Michael <MichaelSp@users.noreply.github.com>
@MichaelSp

MichaelSp commented Aug 3, 2026

Copy link
Copy Markdown
Contributor Author

Oh yes, almost forgot about the doc from you @sk31337 That would be even a better fit then my PR. Happy to close it if we can replace it with that.

@sk31337 any plans to make that public?

@MichaelSp
MichaelSp marked this pull request as draft August 6, 2026 11:02
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