Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/juliaaano/showroom


https://github.com/juliaaano/showroom

Last synced: 6 days ago
JSON representation

Awesome Lists containing this project

README

        

# SHOWROOM

Welcome to the showroom OpenShift application.

## Install

A basic installation will vary depending if you have a docs site running or you want to build and serve
the documentation from the source code.

### Bring your own docs

In this scenario you have the docs served externally with a public URL:

```
helm template ./helm \
--set deployer.domain=apps.cluster-guid.sandbox.opentlc.com \
--set documentation.url=https://my-documentation.external.com | oc apply -f -
```

### Build docs from source

In this scenario you have a Git repo URL with an Antora website and want OpenShift to build and deploy
the documentation from the source code.

This installation mode requires Openshift Pipelines (Tekton) installed in the cluster.

```
oc create -f ./openshift-pipelines.yaml
```

Now you're ready to install showroom by just providing the documentation source repository:

```
helm template ./helm \
--set deployer.domain=apps.cluster-guid.sandbox.opentlc.com \
--set documentation.repoUrl=https://github.com/tonykay/showroom-poc-2023-06 | oc apply -f -
```

## ArgoCD

It is possible to deploy the helm chart with ArgoCD. This repo provides an ArgoCD/Application for
your convenience.

```
oc create -f ./argocd/application.yaml
```

## Multi-user installation

The chart can be installed multiple times in one namespace per user. You control this in helm values.yaml.

An easy way to setup and manage a multi-user deployment is via the ArgoCD/ApplicationSet.

```
oc create -f ./argocd/applicationset.yaml
```