diff --git a/CHANGELOG.md b/CHANGELOG.md index 012a7a9..9eba479 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,4 +1,42 @@ # Changelog +## 1.29.0 +### Backend + - Upgraded `leidinggevenden-consumer` (OP-3533, OP-3511) + +### Deploy notes +``` +drc down; +``` +Update `docker-compose.override.yml` to: +``` + leidinggevenden-consumer: + environment: + DCR_SYNC_BASE_URL: "https://loket.lokaalbestuur.vlaanderen.be" # or another endpoint + DCR_LANDING_ZONE_DATABASE: "virtuoso" # for the initial sync, we go directly to virtuoso + DCR_REMAPPING_DATABASE: "virtuoso" # for the initial sync, we go directly to virtuoso + DCR_DISABLE_DELTA_INGEST: "false" + DCR_DISABLE_INITIAL_SYNC: "false" +``` +Then: +``` +drc up -d migrations +drc up -d db leidinggevenden-consumer +# Wait until success of the previous step +``` +Then, update `docker-compose.override.yml` to: +``` + leidinggevenden-consumer: + environment: + DCR_SYNC_BASE_URL: "https://loket.lokaalbestuur.vlaanderen.be" # choose the correct endpoint + DCR_LANDING_ZONE_DATABASE: "database" + DCR_REMAPPING_DATABASE: "database" + DCR_DISABLE_DELTA_INGEST: "false" + DCR_DISABLE_INITIAL_SYNC: "false" +``` +``` +drc up -d +``` + ## 1.28.2 (2025-01-13) ### Backend - Added "Opdrachthoudende vereniging met private deelname" in delta public (DL-6368) diff --git a/README.md b/README.md index a59e0e3..08a8e67 100644 --- a/README.md +++ b/README.md @@ -11,6 +11,44 @@ Backend for the organization portal application, based on the mu.semte.ch micros You can shut down using `docker-compose stop` and remove everything using `docker-compose rm`. +#### Setup consumers +The application depends on external data. You'll have to perform extra steps if you want this data to be available. +These are multiple data sets, we'll try to be exhaustive on how to ingest these. Even though the procedures are similar. + +#### Setup http://data.lblod.info/vocabularies/leidinggevenden/Functionaris +Note: this is assuming you have never ran this before. +``` +drc down; +``` +Update `docker-compose.override.yml` to: +``` + leidinggevenden-consumer: + environment: + DCR_SYNC_BASE_URL: "https://loket.lokaalbestuur.vlaanderen.be" # or another endpoint + DCR_LANDING_ZONE_DATABASE: "virtuoso" # for the initial sync, we go directly to virtuoso + DCR_REMAPPING_DATABASE: "virtuoso" # for the initial sync, we go directly to virtuoso + DCR_DISABLE_DELTA_INGEST: "false" + DCR_DISABLE_INITIAL_SYNC: "false" +``` +Then: +``` +drc up -d migrations +drc up -d db leidinggevenden-consumer +# Wait until success of the previous step +``` +Then, update `docker-compose.override.yml` to: +``` + leidinggevenden-consumer: + environment: + DCR_SYNC_BASE_URL: "https://loket.lokaalbestuur.vlaanderen.be" # choose the correct endpoint + DCR_LANDING_ZONE_DATABASE: "database" + DCR_REMAPPING_DATABASE: "database" + DCR_DISABLE_DELTA_INGEST: "false" + DCR_DISABLE_INITIAL_SYNC: "false" +``` +``` +drc up -d +``` ### Setting up the delta-producers related services To make sure the app can share data, producers need to be set up. There is an intial sync, that is potentially very expensive, and must be started manually