Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/riksantikvarieambetet/ksamsok
Mirror of the SOCH source code.
https://github.com/riksantikvarieambetet/ksamsok
aggregator glam ksamsok metadata musetech soch
Last synced: about 1 month ago
JSON representation
Mirror of the SOCH source code.
- Host: GitHub
- URL: https://github.com/riksantikvarieambetet/ksamsok
- Owner: riksantikvarieambetet
- License: mit
- Created: 2020-02-13T12:10:21.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2023-03-21T07:15:03.000Z (almost 2 years ago)
- Last Synced: 2024-06-26T18:56:55.479Z (6 months ago)
- Topics: aggregator, glam, ksamsok, metadata, musetech, soch
- Language: Java
- Homepage:
- Size: 58.8 MB
- Stars: 6
- Watchers: 5
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# K-samsök
K-samsöks primära kodbas innehållande kod för APIet, URI resolver, skördegränssnitt samt filer för datamodell och auktoriteter.
## Installation
Det går att peka till Solr och Postgres som inte finns lokalt.
- ksamsok-solr
- Tomcat 7.0.82
- Java 11
- Postgres (uppsatt med `repo.postgres.sql`)
### Bygga med Gradle
Vi använder gradle som lämpligen anropas med wrappern `./gradlew` så kör man samma version som är testat och dessutom behöver man inte ha gradle installerat lokalt.
Gradle läser lokala inställningar så som servernamn till Postgres och Solr från `src/main/environment/*` se separat readme i den mappen för instruktion.
Bygg så här:
```
./gradlew war
```
eller för att bygga med en annan miljökonfiguration:
```
./gradlew -Penv=local war
```
Obs! Vill du byta miljö att bygga för måste du köra ./gradlew clean först.
### Installation
Förutsatt att du har satt upp och pekat ut Solr och Postgres instanser:
1. Se till att Tomcats Connector konfiguration i server.xml har `URIEncoding="UTF-8"` satt.
2. Deploya ksamsok war-fil till Tomcat (ta eventuellt bort existerande K-samsök från `webapps`).
3. Starta Tomcat.
4. Om din Postgres och/eller Solr instans är tom så vill du eventuellt först skörda ett nytt dataset (`127.0.0.1:8080/ksamsok/admin/`).
### Gradle under the hood
Gradle-skriptet letar efter environment.properties-filen i rätt environment-katalog, hittar de properties som finns och petar in dem på rätt ställe i rätt fil samtidigt som den bygger war-filen. Detta gör den för att det ska fungera att bygga lokalt.
## Kör tester
Kör alla tester:
```
./gradlew test
```
Kör specifik testklass:
```
./gradlew test --tests se.raa.ksamsok.lucene.TimeUtilTest
```
# Säkerhet
## HOWTO: Kontrollera om det finns gamla beroenden
För att kontrollera om projektets beroenden (ingående komponenter) är gamla och finns i nyare versioner.
Gradletasken nedan skapar en rapport över alla ingående komponenter och dess status.
Se även https://plugins.gradle.org/plugin/com.github.ben-manes.versions
```bash
./gradlew dependencyUpdates
```
## HOWTO: Kontrollera om beroenden har kända sårbarheter
För att kontrollera om projektets beroenden (ingående komponenter) har kända sårbarheter (security vulnerabilities).
Gradletasken nedan skapar en rapport över alla ingående komponenter och dess status.
Första gången tasken körs kan ta upp till 20 minuter. Därefter tar det bara några sekunder.
Se även https://plugins.gradle.org/plugin/org.owasp.dependencycheck.
```bash
./gradlew dependencyCheckPurge dependencyCheckUpdate dependencyCheckAnalyze
ls ./build/reports/dependency-check-report.html
```