Changes

Page history
Update home authored by Michael Westergaard's avatar Michael Westergaard
Show whitespace changes
Inline Side-by-side
home.md
View page @ 2d1f1fb4
## Usage ## ## Usage ##
### Setting up application in Gitlab ### I Я Project Manager has many perspectives and they will all make your wildest dreams come true.
## Installation ##
Installation is as simple as 1... 2... 3.
### 1. Setting up application in Gitlab ###
Create an application in your Gitlab instance; you want it to have these settings: Create an application in your Gitlab instance; you want it to have these settings:
![Screenshot_2021-01-13_at_21.05.14](uploads/d052befd2820269548aaf3faa1d56ee7/Screenshot_2021-01-13_at_21.05.14.png) ![Screenshot_2021-01-13_at_21.05.14](uploads/d052befd2820269548aaf3faa1d56ee7/Screenshot_2021-01-13_at_21.05.14.png)
...@@ -23,6 +29,35 @@ http://localhost:8080/reporting/time-sheet ...@@ -23,6 +29,35 @@ http://localhost:8080/reporting/time-sheet
### Run in Docker ### ### Run in Docker ###
#### Prerequisites ####
- [Install Docker](https://docs.docker.com/get-docker/)
#### Start application ####
Execute the below command in a terminal. If you don't have a terminal or don't know how to use a terminal, you'll probably wait until a later version of the application that does not require a terminal.
```
docker run -itp 8080:8080 \
-e eu_brinformatics_servicedesk_auth_endpoint=ENDPOINT \
-e eu_brinformatics_servicedesk_auth_clientid=SECRET \
servicedesk:VERSION
```
`ENDPOINT` is the location of your Gitlab installation. You'll probably not fare well with the cl;oud version right now. The Gitlab where this is hosted is `https://gitlab.westergaard.eu`
`SECRET` is the application id you get when setting up the application in Gitlab. It's not super secret but you should probably also not just hand it out everywhere. The one from the screenshot above is `5fbd9da7b7c6d4b2fe3f89f2e253eb71dfba07ee1de342d5531cdb4a486cd8b4` (though in keeping with the last part that's no longer the case).
`VERSION` is the version of the application to run. See [here](http://TODO) for a list of available versions.
#### Access application ####
- In a browser, navigate to [localhost:8080](http://localhost:8080/) (or click the link)
#### Server installation ####
You can also run the application in a central installation allowing access for multiple people. For that, you'll realistically want to put it behind an encrypting HTTPS proxy. The application may get repackaged to handle that automatically, but for now you're on your own or suggested to use the Kubernetes installation with an ingress below.
### Run on Kubernetes ### ### Run on Kubernetes ###
## Version history ## ## Version history ##
... ...
......