Skip to content

Commit

Permalink
fix(docs): autogenerate docs (#8299)
Browse files Browse the repository at this point in the history
* docs: auto-generated property docs

* docs: auto-generated Swagger SPEC docs

---------

Co-authored-by: Mohammad Abudayyeh <47318409+moabu@users.noreply.github.com>
  • Loading branch information
mo-auto and moabu committed Apr 17, 2024
1 parent 7a2800d commit d048edc
Show file tree
Hide file tree
Showing 20 changed files with 178 additions and 85 deletions.
2 changes: 1 addition & 1 deletion charts/janssen-all-in-one/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -338,4 +338,4 @@ Kubernetes: `>=v1.22.0-0`
| volumes | list | `[]` | Configure any additional volumes that need to be attached to the pod |

----------------------------------------------
Autogenerated from chart metadata using [helm-docs v1.11.0](https://github.com/norwoodj/helm-docs/releases/v1.11.0)
Autogenerated from chart metadata using [helm-docs v1.13.1](https://github.com/norwoodj/helm-docs/releases/v1.13.1)
2 changes: 1 addition & 1 deletion charts/janssen/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -608,4 +608,4 @@ Kubernetes: `>=v1.22.0-0`
| scim.volumes | list | `[]` | Configure any additional volumes that need to be attached to the pod |

----------------------------------------------
Autogenerated from chart metadata using [helm-docs v1.11.0](https://github.com/norwoodj/helm-docs/releases/v1.11.0)
Autogenerated from chart metadata using [helm-docs v1.13.1](https://github.com/norwoodj/helm-docs/releases/v1.13.1)
2 changes: 1 addition & 1 deletion charts/janssen/charts/auth-server-key-rotation/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,4 +49,4 @@ Kubernetes: `>=v1.22.0-0`
| volumes | list | `[]` | Configure any additional volumes that need to be attached to the pod |

----------------------------------------------
Autogenerated from chart metadata using [helm-docs v1.11.0](https://github.com/norwoodj/helm-docs/releases/v1.11.0)
Autogenerated from chart metadata using [helm-docs v1.13.1](https://github.com/norwoodj/helm-docs/releases/v1.13.1)
2 changes: 1 addition & 1 deletion charts/janssen/charts/auth-server/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,4 +58,4 @@ Kubernetes: `>=v1.22.0-0`
| volumes | list | `[]` | |

----------------------------------------------
Autogenerated from chart metadata using [helm-docs v1.11.0](https://github.com/norwoodj/helm-docs/releases/v1.11.0)
Autogenerated from chart metadata using [helm-docs v1.13.1](https://github.com/norwoodj/helm-docs/releases/v1.13.1)
2 changes: 1 addition & 1 deletion charts/janssen/charts/casa/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,4 +63,4 @@ Kubernetes: `>=v1.21.0-0`
| volumes | list | `[]` | Configure any additional volumes that need to be attached to the pod |

----------------------------------------------
Autogenerated from chart metadata using [helm-docs v1.11.0](https://github.com/norwoodj/helm-docs/releases/v1.11.0)
Autogenerated from chart metadata using [helm-docs v1.13.1](https://github.com/norwoodj/helm-docs/releases/v1.13.1)
2 changes: 1 addition & 1 deletion charts/janssen/charts/cn-istio-ingress/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,4 +22,4 @@ Istio Gateway
Kubernetes: `>=v1.21.0-0`

----------------------------------------------
Autogenerated from chart metadata using [helm-docs v1.11.0](https://github.com/norwoodj/helm-docs/releases/v1.11.0)
Autogenerated from chart metadata using [helm-docs v1.13.1](https://github.com/norwoodj/helm-docs/releases/v1.13.1)
2 changes: 1 addition & 1 deletion charts/janssen/charts/config-api/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,4 +62,4 @@ Kubernetes: `>=v1.22.0-0`
| volumes | list | `[]` | Configure any additional volumes that need to be attached to the pod |

----------------------------------------------
Autogenerated from chart metadata using [helm-docs v1.11.0](https://github.com/norwoodj/helm-docs/releases/v1.11.0)
Autogenerated from chart metadata using [helm-docs v1.13.1](https://github.com/norwoodj/helm-docs/releases/v1.13.1)
2 changes: 1 addition & 1 deletion charts/janssen/charts/config/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -129,4 +129,4 @@ Kubernetes: `>=v1.22.0-0`
| volumes | list | `[]` | Configure any additional volumes that need to be attached to the pod |

----------------------------------------------
Autogenerated from chart metadata using [helm-docs v1.11.0](https://github.com/norwoodj/helm-docs/releases/v1.11.0)
Autogenerated from chart metadata using [helm-docs v1.13.1](https://github.com/norwoodj/helm-docs/releases/v1.13.1)
2 changes: 1 addition & 1 deletion charts/janssen/charts/fido2/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,4 +59,4 @@ Kubernetes: `>=v1.22.0-0`
| volumes | list | `[]` | Configure any additional volumes that need to be attached to the pod |

----------------------------------------------
Autogenerated from chart metadata using [helm-docs v1.11.0](https://github.com/norwoodj/helm-docs/releases/v1.11.0)
Autogenerated from chart metadata using [helm-docs v1.13.1](https://github.com/norwoodj/helm-docs/releases/v1.13.1)
2 changes: 1 addition & 1 deletion charts/janssen/charts/link/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,4 +62,4 @@ Kubernetes: `>=v1.22.0-0`
| volumes | list | `[]` | Configure any additional volumes that need to be attached to the pod |

----------------------------------------------
Autogenerated from chart metadata using [helm-docs v1.11.0](https://github.com/norwoodj/helm-docs/releases/v1.11.0)
Autogenerated from chart metadata using [helm-docs v1.13.1](https://github.com/norwoodj/helm-docs/releases/v1.13.1)
2 changes: 1 addition & 1 deletion charts/janssen/charts/nginx-ingress/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,4 +62,4 @@ Kubernetes: `>=v1.22.0-0`
| nameOverride | string | `""` | |

----------------------------------------------
Autogenerated from chart metadata using [helm-docs v1.11.0](https://github.com/norwoodj/helm-docs/releases/v1.11.0)
Autogenerated from chart metadata using [helm-docs v1.13.1](https://github.com/norwoodj/helm-docs/releases/v1.13.1)
2 changes: 1 addition & 1 deletion charts/janssen/charts/opendj/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,4 +71,4 @@ Kubernetes: `>=v1.22.0-0`
| volumes | list | `[]` | Configure any additional volumes that need to be attached to the pod |

----------------------------------------------
Autogenerated from chart metadata using [helm-docs v1.11.0](https://github.com/norwoodj/helm-docs/releases/v1.11.0)
Autogenerated from chart metadata using [helm-docs v1.13.1](https://github.com/norwoodj/helm-docs/releases/v1.13.1)
2 changes: 1 addition & 1 deletion charts/janssen/charts/persistence/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,4 +49,4 @@ Kubernetes: `>=v1.22.0-0`
| volumes | list | `[]` | Configure any additional volumes that need to be attached to the pod |

----------------------------------------------
Autogenerated from chart metadata using [helm-docs v1.11.0](https://github.com/norwoodj/helm-docs/releases/v1.11.0)
Autogenerated from chart metadata using [helm-docs v1.13.1](https://github.com/norwoodj/helm-docs/releases/v1.13.1)
2 changes: 1 addition & 1 deletion charts/janssen/charts/saml/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,4 +61,4 @@ Kubernetes: `>=v1.21.0-0`
| volumes | list | `[]` | Configure any additional volumes that need to be attached to the pod |

----------------------------------------------
Autogenerated from chart metadata using [helm-docs v1.11.0](https://github.com/norwoodj/helm-docs/releases/v1.11.0)
Autogenerated from chart metadata using [helm-docs v1.13.1](https://github.com/norwoodj/helm-docs/releases/v1.13.1)
2 changes: 1 addition & 1 deletion charts/janssen/charts/scim/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,4 +58,4 @@ Kubernetes: `>=v1.22.0-0`
| volumes | list | `[]` | Configure any additional volumes that need to be attached to the pod |

----------------------------------------------
Autogenerated from chart metadata using [helm-docs v1.11.0](https://github.com/norwoodj/helm-docs/releases/v1.11.0)
Autogenerated from chart metadata using [helm-docs v1.13.1](https://github.com/norwoodj/helm-docs/releases/v1.13.1)
24 changes: 9 additions & 15 deletions docs/admin/install/docker-install/compose.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,8 @@ tags:
- docker image
---

!!! Warning
**This image is for testing and development purposes only. Use Janssen [helm charts](https://github.com/JanssenProject/jans/tree/main/charts/janssen) for production setups.**
> **Warning**
> This image is for testing and development purposes only. Use Janssen [helm charts](https://github.com/JanssenProject/jans/tree/main/charts/janssen) for production setups.
## Overview

Expand Down Expand Up @@ -51,7 +51,7 @@ Installation depends on the set of environment variables shown below. These envi

## How to run

Download the compose file:
Download the compose file

```bash

Expand All @@ -64,7 +64,7 @@ This docker compose file runs two containers, the janssen monolith container and
docker compose -f jans-mysql-compose.yml up -d
```

To view the containers running:
To view the containers running

```bash

Expand All @@ -73,19 +73,14 @@ docker compose -f jans-mysql-compose.yml ps

## Configure Janssen Server

1. Access the Docker container shell using:

```bash
docker compose -f jans-mysql-compose.yml exec jans sh
```
```bash

2. Grab a pair of client_id and client_pw(secret) from `setup.properties` or `/opt/jans/jans-setup/setup.properties.last`
docker compose -f jans-mysql-compose.yml exec jans sh #This opens a bash terminal in the running container

3. Use the CLI tools located under `/opt/jans/jans-cli/` to configure Janssen Server as needed. For example you can run the [TUI](../../config-guide/config-tools/jans-tui/README.md):
```bash
python3 /opt/jans/jans-cli/config-cli-tui.py
```
/opt/jans/jans-cli/config-cli.py #configure using the config-cli

/opt/jans/jans-cli/scim-cli.py #configure using the scim-cli
```

## Access endpoints externally

Expand All @@ -105,4 +100,3 @@ Remove setup and volumes
```
docker compose -f jans-mysql-compose.yml down
```

3 changes: 3 additions & 0 deletions docs/admin/reference/kubernetes/docker-jans-all-in-one.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# jans-aio

Janssen All-In-One image
1 change: 0 additions & 1 deletion docs/admin/reference/kubernetes/docker-jans-monolith.md
Original file line number Diff line number Diff line change
Expand Up @@ -100,4 +100,3 @@ Remove setup and volumes
```
docker compose -f jans-mysql-compose.yml down
```

Loading

0 comments on commit d048edc

Please sign in to comment.