|
| 1 | +# Development on OpenShift |
| 2 | + |
| 3 | +This directory contains a Helm chart which can be used to deploy a development version of this app for rapid testing. |
| 4 | + |
| 5 | +Before you use it, you will need to download & install Helm 3. |
| 6 | + |
| 7 | +To use it, move to the `development` directory (i.e. `cd development/`), and deploy using the following Helm command: |
| 8 | + |
| 9 | +```shell script |
| 10 | +helm template . \ |
| 11 | + --set git.uri=https://github.com/rht-labs/open-management-portal-git-api.git \ |
| 12 | + --set git.ref=master \ |
| 13 | + --set cacheService=<your-infinispan-service-name> \ |
| 14 | + --set cacheUseAuth=<use-infinispan-auth> \ |
| 15 | + --set configRepositoryId=<your-config-repository-id> \ |
| 16 | + --set deployKey=<your-gitlab-deploy-key-id> \ |
| 17 | + --set gitLabApiUrl=<your-gitlab-base-url> \ |
| 18 | + --set gitLabPersonalAccessToken=<your-gitlab-personal-access-token> \ |
| 19 | + --set jwtVerifyPublicKeyLocation=<your-openid-connect-cert-url> \ |
| 20 | + --set residenciesParentRepositoryId=<your-gitlab-group-id> \ |
| 21 | + --set templateRepositoryId=<your-template-repository-id> \ |
| 22 | + --set trustedClientKey=<your-trusted-client-key> \ |
| 23 | +| oc apply -f - |
| 24 | +``` |
| 25 | + |
| 26 | +It accepts the following variables |
| 27 | + |
| 28 | +| Variable | Use | |
| 29 | +|---|---| |
| 30 | +| `git.uri` | The HTTPS reference to the repo (your fork!) to build | |
| 31 | +| `git.ref` | The branch name to build | |
| 32 | +| `cacheService` | The service name of the Infinispan deployment | |
| 33 | +| `cacheUseAuth` | Enable authentication against the cache | |
| 34 | +| `configRepositoryId` | The GitLab ID of the config repository | |
| 35 | +| `deployKey` | The ID of the GitLab deploy key to enable on newly-created repositories | |
| 36 | +| `gitLabApiUrl` | The base URL of the GitLab instance to use | |
| 37 | +| `gitLabPersonalAccessToken` | The access token to use to auth against GitLab | |
| 38 | +| `jwtVerifyPublicKeyLocation` | The URL at which your OpenID Connect (SSO) provider exposes its public key | |
| 39 | +| `residenciesParentRepositoryId` | The ID of the GitLab group under which to create new projects | |
| 40 | +| `templateRepositoryId` | The ID of the GitLab repository which defines a template to use for creating new repos | |
| 41 | +| `trustedClientKey` | [Temporary] Used as a placeholder to authenticate client requests, being replaced by validating JWT tokens against the `jwtVerifyPublicKeyLocation` | |
| 42 | + |
| 43 | +This will spin up all of the usual resources that this service needs in production, plus a `BuildConfig` configured to build it from source from the Git repository specified. To trigger this build, use `oc start-build omp-git-api`. |
0 commit comments