Skip to content

Update docs#369

Open
DerDaehne wants to merge 33 commits intomainfrom
feature/update-docs
Open

Update docs#369
DerDaehne wants to merge 33 commits intomainfrom
feature/update-docs

Conversation

@DerDaehne
Copy link
Copy Markdown
Contributor

Right now we basically have all of our documentation inside the README.md. This PR will split and update the documentation, creating multiple markdown files in ./docs/ as well as introduce a new method to automatically create ./docs/Configuration.md

@DerDaehne DerDaehne marked this pull request as ready for review March 11, 2026 14:28
ThomasMichael1811 and others added 11 commits March 18, 2026 15:10
We now use k3d's registry functionallity to setup and bind an registry to an
empty cluster, mirroring the necessary images and finally creating a gop config
which can be used for testing
…base url and an optional

argument "harbor". If you pass, beside the base url, also the "harbor", the
script will perform various api calls, assuming the target registry is the
product "harbor". if the second argument is omitted, it simply copies images
used by gop into the target registry

### Repositories and layout

When installing the GitOps playground, the following Git repositories are created and initialized:
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

example apps is not installed by default


* Separation of app repo (e.g. `petclinic-plain`) and GitOps repo (e.g. `argocd/example-app`)
* Config is maintained in app repo,
* CI Server writes to GitOps repo and creates PullRequests.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

ref to gitops build lib?


The applications implement a simple staging mechanism:

* After a successful Jenkins build, the staging application will be deployed into the cluster by the GitOps operator.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

GitOps operator?

It is possible to deploy `Ingress` objects for all components. You can either

* set a common base url (`--base-url=https://example.com`) or
* individual URLS: <- falsch!
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

  • individual URLS: <- falsch! ?
    external config?

* on a local k3d cluster
Works best on Linux, but is possible on [Windows and Mac](./Running-on-Windows-Mac.md).
* on a remote k8s cluster
* each with the option
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

remove this?

DerDaehne and others added 4 commits March 31, 2026 12:50
Co-authored-by: Niklas Hußmann <niklas.hussmann-extern@cloudogu.com>
Co-authored-by: Niklas Hußmann <niklas.hussmann-extern@cloudogu.com>
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