mirror of
https://github.com/samply/bridgehead.git
synced 2025-06-16 21:50:14 +02:00
Compare commits
6 Commits
feature/au
...
feature/ex
Author | SHA1 | Date | |
---|---|---|---|
1a714e28ac | |||
39a02e2b2f | |||
faa8abd4ee | |||
7693289d4d | |||
d482324361 | |||
b7a42f3d3b |
36
README.md
36
README.md
@ -24,6 +24,9 @@ This repository is the starting point for any information and tools you will nee
|
|||||||
- [BBMRI-ERIC Directory entry needed](#bbmri-eric-directory-entry-needed)
|
- [BBMRI-ERIC Directory entry needed](#bbmri-eric-directory-entry-needed)
|
||||||
- [Directory sync tool](#directory-sync-tool)
|
- [Directory sync tool](#directory-sync-tool)
|
||||||
- [Loading data](#loading-data)
|
- [Loading data](#loading-data)
|
||||||
|
- [Teiler (Frontend)](#teiler-frontend)
|
||||||
|
- [Data Exporter Service](#data-exporter-service)
|
||||||
|
- [Data Quality Report](#data-quality-report)
|
||||||
4. [Things you should know](#things-you-should-know)
|
4. [Things you should know](#things-you-should-know)
|
||||||
- [Auto-Updates](#auto-updates)
|
- [Auto-Updates](#auto-updates)
|
||||||
- [Auto-Backups](#auto-backups)
|
- [Auto-Backups](#auto-backups)
|
||||||
@ -379,6 +382,39 @@ Normally, you will need to build your own ETL to feed the Bridgehead. However, t
|
|||||||
|
|
||||||
You can find the profiles for generating FHIR in [Simplifier](https://simplifier.net/bbmri.de/~resources?category=Profile).
|
You can find the profiles for generating FHIR in [Simplifier](https://simplifier.net/bbmri.de/~resources?category=Profile).
|
||||||
|
|
||||||
|
### Teiler (Frontend)
|
||||||
|
|
||||||
|
Teiler is the web-based frontend of the Bridgehead, providing access to its various internal, and external services and components.
|
||||||
|
To learn how to integrate your custom module into Teiler, please refer to https://github.com/samply/teiler-dashboard.
|
||||||
|
- To activate Teiler, set the following environment variable in your `<PROJECT>.conf` file:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
ENABLE_TEILER=true
|
||||||
|
```
|
||||||
|
[For further information](ccp/modules/teiler.md)
|
||||||
|
|
||||||
|
### Data Exporter Service
|
||||||
|
|
||||||
|
The Exporter is a dedicated service for extracting and exporting Bridgehead data in (tabular) formats such as Excel, CSV, Opal, JSON, XML, ...
|
||||||
|
- To enable the Exporter service, set the following environment variable in your `<PROJECT>.conf` file:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
ENABLE_EXPORTER=true
|
||||||
|
```
|
||||||
|
|
||||||
|
#### Data Quality Report
|
||||||
|
To assess the quality and plausibility of your imported data, the Reporter component is pre-configured to generate Excel reports with data quality metrics and statistical analyses. Reporter is part of the Exporter and can be enabled by setting the same environment variable in your `<PROJECT>.conf` file:
|
||||||
|
```bash
|
||||||
|
ENABLE_EXPORTER=true
|
||||||
|
```
|
||||||
|
|
||||||
|
For convenience, it's recommended to enable the Teiler web frontend alongside the Exporter to access export and quality control features via a web interface: set the following environment varibles in your `<PROJECT>.conf` file:
|
||||||
|
```bash
|
||||||
|
ENABLE_TEILER=true
|
||||||
|
ENABLE_EXPORTER=true
|
||||||
|
```
|
||||||
|
[For further information](ccp/modules/exporter.md)
|
||||||
|
|
||||||
## Things you should know
|
## Things you should know
|
||||||
|
|
||||||
### Auto-Updates
|
### Auto-Updates
|
||||||
|
@ -1,20 +1,20 @@
|
|||||||
-----BEGIN CERTIFICATE-----
|
-----BEGIN CERTIFICATE-----
|
||||||
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
|
||||||
8riQJIhY4huX
|
GeWQ1wQNTEBX
|
||||||
-----END CERTIFICATE-----
|
-----END CERTIFICATE-----
|
||||||
|
@ -79,10 +79,8 @@ services:
|
|||||||
- "traefik.http.routers.reporter_bbmri.middlewares=reporter_bbmri_strip"
|
- "traefik.http.routers.reporter_bbmri.middlewares=reporter_bbmri_strip"
|
||||||
- "traefik.http.routers.reporter_bbmri.priority=20"
|
- "traefik.http.routers.reporter_bbmri.priority=20"
|
||||||
|
|
||||||
#- "traefik.http.routers.reporter_bbmri.middlewares=reporter_bbmri_strip,exporter_auth"
|
|
||||||
- "traefik.http.routers.reporter_bbmri_api.middlewares=reporter_bbmri_strip,exporter_auth"
|
- "traefik.http.routers.reporter_bbmri_api.middlewares=reporter_bbmri_strip,exporter_auth"
|
||||||
- "traefik.http.routers.reporter_bbmri_api.rule=PathRegexp(`/bbmri-reporter/.+`)"
|
- "traefik.http.routers.reporter_bbmri_api.rule=PathRegexp(`/bbmri-reporter/.+`)"
|
||||||
- "traefik.http.routers.reporter_bbmri_api.tls=true"
|
- "traefik.http.routers.reporter_bbmri_api.tls=true"
|
||||||
- "traefik.http.routers.reporter_bbmri_api.priority=25"
|
- "traefik.http.routers.reporter_bbmri_api.priority=25"
|
||||||
#- "traefik.http.middlewares.reporter_auth.basicauth.users=${EXPORTER_USER}"
|
|
||||||
|
|
||||||
|
@ -5,11 +5,4 @@ if [ "$ENABLE_EXPORTER" == true ]; then
|
|||||||
OVERRIDE+=" -f ./$PROJECT/modules/exporter-compose.yml"
|
OVERRIDE+=" -f ./$PROJECT/modules/exporter-compose.yml"
|
||||||
EXPORTER_DB_PASSWORD="$(echo \"This is a salt string to generate one consistent password for the exporter. It is not required to be secret.\" | sha1sum | openssl pkeyutl -sign -inkey /etc/bridgehead/pki/${SITE_ID}.priv.pem | base64 | head -c 30)"
|
EXPORTER_DB_PASSWORD="$(echo \"This is a salt string to generate one consistent password for the exporter. It is not required to be secret.\" | sha1sum | openssl pkeyutl -sign -inkey /etc/bridgehead/pki/${SITE_ID}.priv.pem | base64 | head -c 30)"
|
||||||
EXPORTER_API_KEY="$(echo \"This is a salt string to generate one consistent API KEY for the exporter. It is not required to be secret.\" | sha1sum | openssl pkeyutl -sign -inkey /etc/bridgehead/pki/${SITE_ID}.priv.pem | base64 | head -c 64)"
|
EXPORTER_API_KEY="$(echo \"This is a salt string to generate one consistent API KEY for the exporter. It is not required to be secret.\" | sha1sum | openssl pkeyutl -sign -inkey /etc/bridgehead/pki/${SITE_ID}.priv.pem | base64 | head -c 64)"
|
||||||
|
|
||||||
if [ -z "$EXPORTER_USER" ]; then
|
|
||||||
log "INFO" "Now generating basic auth for the exporter and reporter (see adduser in bridgehead for more information). "
|
|
||||||
generated_passwd="$(cat /proc/sys/kernel/random/uuid | sed 's/[-]//g' | head -c 32)"
|
|
||||||
add_basic_auth_user $PROJECT $generated_passwd "EXPORTER_USER" $PROJECT
|
|
||||||
fi
|
|
||||||
|
|
||||||
fi
|
fi
|
||||||
|
@ -5,5 +5,4 @@ if [ "$ENABLE_TEILER" == true ];then
|
|||||||
OVERRIDE+=" -f ./$PROJECT/modules/teiler-compose.yml"
|
OVERRIDE+=" -f ./$PROJECT/modules/teiler-compose.yml"
|
||||||
TEILER_DEFAULT_LANGUAGE=EN
|
TEILER_DEFAULT_LANGUAGE=EN
|
||||||
TEILER_DEFAULT_LANGUAGE_LOWER_CASE=${TEILER_DEFAULT_LANGUAGE,,}
|
TEILER_DEFAULT_LANGUAGE_LOWER_CASE=${TEILER_DEFAULT_LANGUAGE,,}
|
||||||
# add_public_oidc_redirect_url "/ccp-teiler/*"
|
|
||||||
fi
|
fi
|
||||||
|
@ -3,7 +3,6 @@ BROKER_URL=https://${BROKER_ID}
|
|||||||
PROXY_ID=${SITE_ID}.${BROKER_ID}
|
PROXY_ID=${SITE_ID}.${BROKER_ID}
|
||||||
PRIVATEKEYFILENAME=/etc/bridgehead/pki/${SITE_ID}.priv.pem
|
PRIVATEKEYFILENAME=/etc/bridgehead/pki/${SITE_ID}.priv.pem
|
||||||
BROKER_URL_FOR_PREREQ=$BROKER_URL
|
BROKER_URL_FOR_PREREQ=$BROKER_URL
|
||||||
echo $PRIVATEKEYFILENAME
|
|
||||||
|
|
||||||
# Makes sense for all European Biobanks
|
# Makes sense for all European Biobanks
|
||||||
: ${ENABLE_ERIC:=true}
|
: ${ENABLE_ERIC:=true}
|
||||||
@ -13,8 +12,6 @@ echo $PRIVATEKEYFILENAME
|
|||||||
|
|
||||||
FOCUS_RETRY_COUNT=${FOCUS_RETRY_COUNT:-64}
|
FOCUS_RETRY_COUNT=${FOCUS_RETRY_COUNT:-64}
|
||||||
|
|
||||||
POSTGRES_TAG=15.6-alpine
|
|
||||||
|
|
||||||
for module in $PROJECT/modules/*.sh
|
for module in $PROJECT/modules/*.sh
|
||||||
do
|
do
|
||||||
log DEBUG "sourcing $module"
|
log DEBUG "sourcing $module"
|
||||||
|
@ -1,19 +1,180 @@
|
|||||||
# Teiler
|
# Teiler
|
||||||
This module orchestrates the different microfrontends of the bridgehead as a single page application.
|
|
||||||
|
**Teiler** is the central frontend of the **bridgehead system**. It brings together multiple independent tools—each built as a **microfrontend**—into a single, unified web application.
|
||||||
|
|
||||||
|
Users interact with Teiler as one coherent interface, but behind the scenes, it dynamically integrates and displays self-contained modules developed with different technologies (**Angular**, **Vue**, **React**, etc.). This modular approach makes Teiler highly flexible, allowing teams to develop, deploy, and maintain features independently.
|
||||||
|
|
||||||
|
Teiler ensures:
|
||||||
|
|
||||||
|
* **A consistent look and feel** across tools.
|
||||||
|
* **Smooth navigation** between components.
|
||||||
|
* **Seamless user authentication** across the entire interface.
|
||||||
|
|
||||||
|
Each independent tool integrated into Teiler is called a **bridgehead app**. A bridgehead app can be:
|
||||||
|
|
||||||
|
- A fully standalone microfrontend with its own frontend and backend services.
|
||||||
|
- An embedded service inside the Teiler Dashboard.
|
||||||
|
- An external link to another service, possibly hosted on a central server or elsewhere in the federated research network.
|
||||||
|
|
||||||
|
The modularity of Teiler enables it to adapt easily to the evolving needs of the research federated network by simply adding, updating, or removing bridgehead apps.
|
||||||
|
|
||||||
|
Below is a breakdown of Teiler's internal components that make this orchestration possible.
|
||||||
|
|
||||||
|
- [Teiler Orchestrator](#teiler-orchestrator)
|
||||||
|
- [Teiler Dashboard](#teiler-dashboard)
|
||||||
|
- [Teiler Backend](#teiler-backend)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## Teiler Orchestrator
|
## Teiler Orchestrator
|
||||||
Single SPA component that consists on the root HTML site of the single page application and a javascript code that
|
|
||||||
gets the information about the microfrontend calling the teiler backend and is responsible for registering them. With the
|
|
||||||
resulting mapping, it can initialize, mount and unmount the required microfrontends on the fly.
|
|
||||||
|
|
||||||
The microfrontends run independently in different containers and can be based on different frameworks (Angular, Vue, React,...)
|
The **Teiler Orchestrator** is the entry point of the **Single Page Application (SPA)**. It consists of:
|
||||||
This microfrontends can run as single alone but need an extension with Single-SPA (https://single-spa.js.org/docs/ecosystem).
|
|
||||||
There are also available three templates (Angular, Vue, React) to be directly extended to be used directly in the teiler.
|
- An **HTML root page**.
|
||||||
|
- A **JavaScript layer** that:
|
||||||
|
- **Retrieves microfrontend configurations** from the backend.
|
||||||
|
- **Registers and manages** the microfrontends using [**Single-SPA**](https://single-spa.js.org/), the framework Teiler uses to create and coordinate its microfrontend environment.
|
||||||
|
|
||||||
|
Using this information, the orchestrator dynamically **loads the correct microfrontend** for a given route and manages its **lifecycle** (*init*, *mount*, *unmount*) in real time.
|
||||||
|
|
||||||
|
**Microfrontends** run in their own containers and can be implemented with any major frontend framework. To be compatible with Teiler, they must integrate with **Single-SPA**.
|
||||||
|
|
||||||
|
To encourage developers to create their own microfrontends and integrate them into Teiler, we provide **starter templates** for **Angular**, **Vue**, and **React**. Developing a new microfrontend is straightforward:
|
||||||
|
|
||||||
|
1. Use one of the templates.
|
||||||
|
2. Extend it with your own functionality.
|
||||||
|
3. Add its configuration in the **Teiler Backend**.
|
||||||
|
|
||||||
|
This modular approach accelerates development and fosters collaboration.
|
||||||
|
|
||||||
|
**GitHub repository:** [https://github.com/samply/teiler-orchestrator](https://github.com/samply/teiler-orchestrator)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## Teiler Dashboard
|
## Teiler Dashboard
|
||||||
It consists on the main dashboard and a set of embedded services.
|
|
||||||
### Login
|
The **Teiler Dashboard** is the unified interface users interact with after logging in. It provides:
|
||||||
user and password in ccp.local.conf
|
|
||||||
|
- A **single point of access** where various bridgehead apps are embedded as microfrontends.
|
||||||
|
- **Central navigation** and **session management** for a smooth user experience.
|
||||||
|
|
||||||
|
### Authentication and Authorization
|
||||||
|
|
||||||
|
Teiler uses **OpenID Connect (OIDC)** for user authentication, accessible via the **top navigation bar**.
|
||||||
|
|
||||||
|
We consider three possible **application roles**:
|
||||||
|
|
||||||
|
| Role | Description |
|
||||||
|
|--------|-----------------------------------------------------------|
|
||||||
|
| Public | Accessible by any user without the need to log in |
|
||||||
|
| User | Normal users working with various bridgehead applications |
|
||||||
|
| Admin | Bridgehead system administrators |
|
||||||
|
|
||||||
|
It is possible to **deactivate OIDC authentication** entirely. In such cases, **all apps must have at least the public role** to allow access. While this may be suitable for development or testing, we **strongly encourage** at least some external authentication mechanism or network-level access control to secure the bridgehead environment.
|
||||||
|
|
||||||
|
Alternatively, basic authentication can be enforced through the existing **Traefik infrastructure** integrated with the bridgehead.
|
||||||
|
|
||||||
|
**GitHub repository:** [https://github.com/samply/teiler-dashboard](https://github.com/samply/teiler-dashboard)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## Teiler Backend
|
## Teiler Backend
|
||||||
In this component, the microfrontends are configured.
|
|
||||||
|
The **Teiler Backend** serves as the central configuration hub for all microfrontends and bridgehead apps. It defines:
|
||||||
|
|
||||||
|
- Which bridgehead apps are available.
|
||||||
|
- Their loading URLs and routes.
|
||||||
|
- Optional metadata such as display names, icons, roles, and activation status.
|
||||||
|
|
||||||
|
It enables the orchestrator to remain **generic and flexible**, adapting dynamically to whatever apps are defined in the backend configuration.
|
||||||
|
|
||||||
|
### Assets Directory
|
||||||
|
|
||||||
|
There is an **assets** directory where you can save images and other static files to be accessible to your microfrontends. This helps configure and customize apps more easily and quickly.
|
||||||
|
|
||||||
|
Assets can be referenced via:
|
||||||
|
|
||||||
|
```
|
||||||
|
<Teiler Backend URL>/assets/<filename>
|
||||||
|
```
|
||||||
|
|
||||||
|
### App Configuration via Environment Variables
|
||||||
|
|
||||||
|
Apps are configured using environment variables with the following structure:
|
||||||
|
|
||||||
|
```
|
||||||
|
TEILER_APP<Number>_<suffix>
|
||||||
|
Optional: TEILER_APP<Number>_<LanguageCode>_<suffix>
|
||||||
|
```
|
||||||
|
|
||||||
|
- The **number** is just for grouping variables for a single app and has no intrinsic meaning.
|
||||||
|
- The **app** is the unit within Teiler, shown as a box in the dashboard.
|
||||||
|
- Apps can be:
|
||||||
|
- Embedded apps inside the Teiler Dashboard (there is a helper Python script for generating embedded apps: [create-embedded-app.py](https://github.com/samply/teiler-dashboard/blob/main/create-embedded-app.py))
|
||||||
|
- External links (e.g., central services outside the local bridgehead instance)
|
||||||
|
- An app's frontend (microfrontend or embedded app) can either contain the entire functionality or serve as a frontend communicating with other backend microservices in the bridgehead.
|
||||||
|
|
||||||
|
Currently supported languages in the main projects DKTK and BBMRI are **English (EN)** and **German (DE)**, but the system can be extended to other languages.
|
||||||
|
|
||||||
|
The Teiler Dashboard requests variables from the backend for each app and passes the desired language code. If a language-specific variable is unavailable, the default language value is returned.
|
||||||
|
|
||||||
|
### App Availability Monitoring
|
||||||
|
|
||||||
|
The Teiler Backend regularly **pings apps** to check availability and displays status messages such as:
|
||||||
|
|
||||||
|
- "Frontend not available"
|
||||||
|
- "Backend not available"
|
||||||
|
- "Frontend and Backend not available"
|
||||||
|
|
||||||
|
### Accepted TEILER_APP Variable Suffixes
|
||||||
|
|
||||||
|
| Suffix | Description |
|
||||||
|
|------------------|---------------------------------------------------------------------------------------------------------------|
|
||||||
|
| NAME | Identifier of the app (no spaces). For embedded apps, must match the identifier defined in Teiler Dashboard. |
|
||||||
|
| TITLE | Display title shown to users. |
|
||||||
|
| DESCRIPTION | Brief description of the app. |
|
||||||
|
| BACKENDURL | URL of the backend microservice (if applicable). |
|
||||||
|
| BACKENDCHECKURL | URL that the backend pings to verify backend availability. Defaults to BACKENDURL if not specified. |
|
||||||
|
| SOURCEURL | URL of the microfrontend or external link (not used for embedded apps). |
|
||||||
|
| SOURCECHECKURL | URL to ping to check microfrontend or external link availability. Defaults to SOURCEURL if not specified. |
|
||||||
|
| ROLES | Comma-separated roles allowed: `TEILER_PUBLIC`, `TEILER_USER`, `TEILER_ADMIN`. |
|
||||||
|
| ISACTIVATED | `true` or `false`. Used to temporarily deactivate an app without deleting its config. |
|
||||||
|
| ICONCLASS | Bootstrap icon class to display in app box (e.g., `"bi bi-search"`). |
|
||||||
|
| ICONSOURCEURL | URL to an image icon. Prefer using local assets instead of external URLs. |
|
||||||
|
| ORDER | Relative display order of the app in the dashboard. |
|
||||||
|
| ISEXTERNALLINK | `true` or `false`. Indicates if the app is an external link outside the local bridgehead. |
|
||||||
|
| ISLOCAL | `true` or `false`. Indicates if the app runs locally within the bridgehead site or on a central server. |
|
||||||
|
|
||||||
|
*Note:* Embedded apps often have many of these variables preconfigured and may not require manual specification. See the [Teiler Dashboard documentation](https://github.com/samply/teiler-dashboard) for details.
|
||||||
|
|
||||||
|
### Additional Teiler Backend Variables for Dashboard Configuration
|
||||||
|
|
||||||
|
| Variable Prefix | Description |
|
||||||
|
|------------------------------------|--------------------------------------------------------------------------------------------------------------|
|
||||||
|
| TEILER_DASHBOARD_ | General configuration of the dashboard. |
|
||||||
|
| TEILER_DASHBOARD_<LangCode>_ | Language-specific configuration overrides. |
|
||||||
|
|
||||||
|
Important suffixes include:
|
||||||
|
|
||||||
|
| Suffix | Description |
|
||||||
|
|------------------|------------------------------------------------------------------|
|
||||||
|
| WELCOME_TITLE | Title shown on the initial screen before login. |
|
||||||
|
| WELCOME_TEXT | Welcome message or instructions before login. |
|
||||||
|
| FURTHER_INFO | Additional informational text or links. |
|
||||||
|
| BACKGROUND_IMAGE_URL | URL to a background image (SVG recommended for scalability). |
|
||||||
|
| LOGO_URL | URL to the project or bridgehead logo. |
|
||||||
|
| LOGO_HEIGHT | Height of the displayed logo. |
|
||||||
|
| LOGO_TEXT | Title text of the bridgehead (e.g., "DKTK Bridgehead"). |
|
||||||
|
| COLOR_PALETTE | JSON link to color palettes for text, lines, icons, and background (especially for SVGs). |
|
||||||
|
| COLOR_PROFILE | Selected color profile from the palette. |
|
||||||
|
| FONT | Font family for the dashboard text. |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**GitHub repository:** [https://github.com/samply/teiler-backend](https://github.com/samply/teiler-backend)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
If you want to create your own bridgehead app and integrate it into Teiler, start by selecting a template or building a microfrontend compatible with **Single-SPA**. Then add your app’s configuration in the Teiler Backend as described above.
|
||||||
|
|
||||||
|
This flexible, modular design enables easy expansion
|
||||||
|
8
ccp/vars
8
ccp/vars
@ -11,14 +11,10 @@ BROKER_URL_FOR_PREREQ=$BROKER_URL
|
|||||||
OIDC_USER_GROUP="DKTK_CCP_$(capitalize_first_letter ${SITE_ID})"
|
OIDC_USER_GROUP="DKTK_CCP_$(capitalize_first_letter ${SITE_ID})"
|
||||||
OIDC_ADMIN_GROUP="DKTK_CCP_$(capitalize_first_letter ${SITE_ID})_Verwalter"
|
OIDC_ADMIN_GROUP="DKTK_CCP_$(capitalize_first_letter ${SITE_ID})_Verwalter"
|
||||||
OIDC_PRIVATE_CLIENT_ID=${SITE_ID}-private
|
OIDC_PRIVATE_CLIENT_ID=${SITE_ID}-private
|
||||||
# OIDC_PUBLIC_CLIENT_ID=${SITE_ID}-public
|
OIDC_PUBLIC_CLIENT_ID=${SITE_ID}-public
|
||||||
# OIDC_URL="https://sso.verbis.dkfz.de/application/o/${SITE_ID}/"
|
OIDC_URL="https://login.verbis.dkfz.de/realms/test-realm-01"
|
||||||
OIDC_PUBLIC_CLIENT_ID=bridgehead-test-public
|
|
||||||
OIDC_URL="https://sso.verbis.dkfz.de/application/o/bridgehead-test-public/"
|
|
||||||
OIDC_GROUP_CLAIM="groups"
|
OIDC_GROUP_CLAIM="groups"
|
||||||
|
|
||||||
POSTGRES_TAG=15.6-alpine
|
|
||||||
|
|
||||||
for module in $PROJECT/modules/*.sh
|
for module in $PROJECT/modules/*.sh
|
||||||
do
|
do
|
||||||
log DEBUG "sourcing $module"
|
log DEBUG "sourcing $module"
|
||||||
|
@ -8,8 +8,6 @@ PRIVATEKEYFILENAME=/etc/bridgehead/pki/${SITE_ID}.priv.pem
|
|||||||
|
|
||||||
BROKER_URL_FOR_PREREQ=$BROKER_URL
|
BROKER_URL_FOR_PREREQ=$BROKER_URL
|
||||||
|
|
||||||
POSTGRES_TAG=15.6-alpine
|
|
||||||
|
|
||||||
for module in ccp/modules/*.sh
|
for module in ccp/modules/*.sh
|
||||||
do
|
do
|
||||||
log DEBUG "sourcing $module"
|
log DEBUG "sourcing $module"
|
||||||
|
@ -301,34 +301,19 @@ function sync_secrets() {
|
|||||||
if [[ $secret_sync_args == "" ]]; then
|
if [[ $secret_sync_args == "" ]]; then
|
||||||
return
|
return
|
||||||
fi
|
fi
|
||||||
|
|
||||||
if [ "$PROJECT" == "bbmri" ]; then
|
|
||||||
# If the project is BBMRI, use the BBMRI-ERIC broker and not the GBN broker
|
|
||||||
proxy_id=$ERIC_PROXY_ID
|
|
||||||
broker_url=$ERIC_BROKER_URL
|
|
||||||
broker_id=$ERIC_BROKER_ID
|
|
||||||
root_crt_file="/srv/docker/bridgehead/bbmri/modules/${ERIC_ROOT_CERT}.root.crt.pem"
|
|
||||||
else
|
|
||||||
proxy_id=$PROXY_ID
|
|
||||||
broker_url=$BROKER_URL
|
|
||||||
broker_id=$BROKER_ID
|
|
||||||
root_crt_file="/srv/docker/bridgehead/$PROJECT/root.crt.pem"
|
|
||||||
fi
|
|
||||||
|
|
||||||
mkdir -p /var/cache/bridgehead/secrets/ || fail_and_report 1 "Failed to create '/var/cache/bridgehead/secrets/'. Please run sudo './bridgehead install $PROJECT' again."
|
mkdir -p /var/cache/bridgehead/secrets/ || fail_and_report 1 "Failed to create '/var/cache/bridgehead/secrets/'. Please run sudo './bridgehead install $PROJECT' again."
|
||||||
touch /var/cache/bridgehead/secrets/oidc
|
touch /var/cache/bridgehead/secrets/oidc
|
||||||
echo $PRIVATEKEYFILENAME
|
|
||||||
docker run --rm \
|
docker run --rm \
|
||||||
-v /var/cache/bridgehead/secrets/oidc:/usr/local/cache \
|
-v /var/cache/bridgehead/secrets/oidc:/usr/local/cache \
|
||||||
-v $PRIVATEKEYFILENAME:/run/secrets/privkey.pem:ro \
|
-v $PRIVATEKEYFILENAME:/run/secrets/privkey.pem:ro \
|
||||||
-v $root_crt_file:/run/secrets/root.crt.pem:ro \
|
-v /srv/docker/bridgehead/$PROJECT/root.crt.pem:/run/secrets/root.crt.pem:ro \
|
||||||
-v /etc/bridgehead/trusted-ca-certs:/conf/trusted-ca-certs:ro \
|
-v /etc/bridgehead/trusted-ca-certs:/conf/trusted-ca-certs:ro \
|
||||||
-e TLS_CA_CERTIFICATES_DIR=/conf/trusted-ca-certs \
|
-e TLS_CA_CERTIFICATES_DIR=/conf/trusted-ca-certs \
|
||||||
-e NO_PROXY=localhost,127.0.0.1 \
|
-e NO_PROXY=localhost,127.0.0.1 \
|
||||||
-e ALL_PROXY=$HTTPS_PROXY_FULL_URL \
|
-e ALL_PROXY=$HTTPS_PROXY_FULL_URL \
|
||||||
-e PROXY_ID=$proxy_id \
|
-e PROXY_ID=$PROXY_ID \
|
||||||
-e BROKER_URL=$broker_url \
|
-e BROKER_URL=$BROKER_URL \
|
||||||
-e OIDC_PROVIDER=secret-sync-central.central-secret-sync.$broker_id \
|
-e OIDC_PROVIDER=secret-sync-central.central-secret-sync.$BROKER_ID \
|
||||||
-e SECRET_DEFINITIONS=$secret_sync_args \
|
-e SECRET_DEFINITIONS=$secret_sync_args \
|
||||||
docker.verbis.dkfz.de/cache/samply/secret-sync-local:latest
|
docker.verbis.dkfz.de/cache/samply/secret-sync-local:latest
|
||||||
|
|
||||||
|
@ -49,6 +49,12 @@ if [ -z "$TRANSFAIR_AUTH" ]; then
|
|||||||
fi
|
fi
|
||||||
fi
|
fi
|
||||||
|
|
||||||
|
if [ -z "$EXPORTER_USER" ]; then
|
||||||
|
log "INFO" "Now generating basic auth for the exporter and reporter (see adduser in bridgehead for more information). "
|
||||||
|
generated_passwd="$(cat /proc/sys/kernel/random/uuid | sed 's/[-]//g' | head -c 32)"
|
||||||
|
add_basic_auth_user $PROJECT $generated_passwd "EXPORTER_USER" $PROJECT
|
||||||
|
fi
|
||||||
|
|
||||||
log "INFO" "Registering system units for bridgehead and bridgehead-update"
|
log "INFO" "Registering system units for bridgehead and bridgehead-update"
|
||||||
cp -v \
|
cp -v \
|
||||||
lib/systemd/bridgehead\@.service \
|
lib/systemd/bridgehead\@.service \
|
||||||
|
@ -1,3 +1,4 @@
|
|||||||
FOCUS_TAG=develop
|
FOCUS_TAG=develop
|
||||||
BEAM_TAG=develop
|
BEAM_TAG=develop
|
||||||
BLAZE_TAG=main
|
BLAZE_TAG=main
|
||||||
|
POSTGRES_TAG=15.13-alpine
|
@ -1,3 +1,4 @@
|
|||||||
FOCUS_TAG=main
|
FOCUS_TAG=main
|
||||||
BEAM_TAG=main
|
BEAM_TAG=main
|
||||||
BLAZE_TAG=0.32
|
BLAZE_TAG=0.32
|
||||||
|
POSTGRES_TAG=15.13-alpine
|
@ -1,3 +1,4 @@
|
|||||||
FOCUS_TAG=develop
|
FOCUS_TAG=develop
|
||||||
BEAM_TAG=develop
|
BEAM_TAG=develop
|
||||||
BLAZE_TAG=main
|
BLAZE_TAG=main
|
||||||
|
POSTGRES_TAG=15.13-alpine
|
Reference in New Issue
Block a user