Het uitproberen, installeren en starten van Abacus kan op verschillende manieren. Is Abacus nieuw voor je, begin dan bij de optie 'Uitproberen'. Kom je er met de onderstaande instructies niet uit, neem dan contact op met het team via [email protected]. Hieronder vind je instructies voor de verschillende methodes.
Als je Abacus wilt uitproberen of testen zonder het te installeren, kun je dit doen op https://abacus-test.nl/. Hier heb je de volgende opties:
- Maak een nieuwe omgeving aan door bovenaan op
Create newte klikken. Deze omgeving is gebaseerd op onze wekelijkse release-builds. - Als je wilt testen hoe de omgeving werkt na de implementatie van een specifieke pull request, klik dan op
Create newbij de relevante regel onder Pull requests. - Zoek je naar een bepaalde pull request maar staat die er niet bij, klik dan op
Sync pull requests. De lijst wordt dan vernieuwd. - Bestaande omgevingen staan onder Running services. Kies hier een omgeving die al is aangemaakt. Als het nodig is kun je hier een zelf aangemaakte omgeving stoppen.
Bij de onderstaande installatiemethodes is aangegeven op welke besturingssystemen ze werken. De methoden voor Linux werken op alle gangbare (recente) Linux-distributies en zijn getest op Ubuntu (22.04 en hoger) en Debian (12/bookworm). De Windows-methoden zijn getest op Windows 11.
Deze methode is de snelste manier om Abacus te gebruiken. Voer hiervoor de volgende stappen uit:
Op de hoofdpagina van de Abacus-repository klik je aan de rechterkant op Releases. Klik onder de bovenste release op Assets en klik vervolgens op het installatiebestand om het te downloaden.
Open een terminal en maak het bestand uitvoerbaar:
chmod +x /path/to/binary/abacus-[OS-version]Voer Abacus uit:
./path/to/binary/abacus-[OS-version] --reset-database --seed-dataDe argumenten zorgen ervoor dat de database wordt gereset en wordt geladen met fixtures. Het is natuurlijk ook mogelijk om Abacus zonder argumenten te starten, maar als je dat doet bevat de app geen data en zie je op de pagina het bericht 'Verkiezingen niet gevonden'.
De kortere versie van deze opdracht is:
./path/to/binary/abacus-[OS-version] -rsZie ook de help.
Open een Command Prompt of Powershell en voer Abacus uit:
start path\to\binary\abacus-windows-[version].exe --reset-database --seed-dataDe argumenten zorgen ervoor dat de database wordt gereset en wordt geladen met fixtures. Het is natuurlijk ook mogelijk om Abacus zonder argumenten te starten, maar als je dat doet bevat de app geen data en zie je op de pagina het bericht 'Verkiezingen niet gevonden'.
De kortere versie van deze opdracht is:
start path\to\binary\abacus-windows-[version].exe -rs
Zie ook de help.
Na het starten zie je een popup van Windows Security over de Windows Firewall. Het maakt niet uit wat je hier selecteert, de omgeving werkt altijd. Klik dus gerust op Cancel (Annuleren).
Wanneer Abacus draait, ga je in je browser naar http://127.0.0.1:8080 om de omgeving te gebruiken.
Je kunt ook zelf een bepaalde build downloaden en starten. Voer hiervoor de volgende stappen uit:
- Ga in de Abacus-repository naar Actions.
- Klik aan de linkerkant op Build, lint & test.
- Filter op
branch:mainen klik op de bovenste build in de lijst. - Download de latest build voor jouw besturingssysteem. Let op: de download is alleen zichtbaar als je bent ingelogd in GitHub.
De download bevat een ZIP-bestand met de binary. Deze binary bevat ook alle frontend-assets. Pak deze binary uit en start hem als volgt:
./path/to/binary/abacus --reset-database --seed-dataDe argumenten zorgen ervoor dat de database wordt gereset en wordt geladen met fixtures. Het is natuurlijk ook mogelijk om Abacus zonder argumenten te starten, maar als je dat doet bevat de app geen data en zie je op de pagina het bericht 'Verkiezingen niet gevonden'.
De kortere versie van deze opdracht is:
./path/to/binary/abacus -rsZie ook de help.
start path\to\binary\abacus.exe --reset-database --seed-dataDe argumenten zorgen ervoor dat de database wordt gereset en wordt geladen met fixtures. Het is natuurlijk ook mogelijk om Abacus zonder argumenten te starten, maar als je dat doet bevat de app geen data en zie je op de pagina het bericht 'Verkiezingen niet gevonden'.
De kortere versie van deze opdracht is:
start path\to\binary\abacus.exe -rsZie ook de help.
Na het starten zie je een popup van Windows Security over de Windows Firewall. Het maakt niet uit wat je hier selecteert, de omgeving werkt altijd. Klik dus gerust op Cancel (Annuleren).
Wanneer Abacus draait, ga je in je browser naar http://127.0.0.1:8080 om de omgeving te gebruiken.
Let op: voor deze methode moet je de repository klonen of downloaden.
Dit is een Bash-script dat is bedoeld om snel Abacus te bouwen en starten. Het staat in de hoofdmap van de repository. Het script maakt geen gebruik van Docker, waardoor het wel nodig is om npm en cargo geïnstalleerd te hebben.
npmis onderdeel van Node.js en dit kun je installeren door de instructies te volgen op de website van Node.js.cargois onderdeel van Rust en installatie-instructies hiervoor vind je op de website van Rust.
Je kunt een git-branch als argument meegeven, zodat je snel de productiebuild van een bepaalde branch kunt starten. Als je het argument weglaat, wordt de huidige branch gebouwd.
Zo start je de huidige branch:
./pull-and-runEn zo start je een specifieke branch:
./pull-and-run [name-of-branch]Wanneer Abacus draait, ga je in je browser naar (http://127.0.0.1:8080) om de omgeving te gebruiken.
Let op: mogelijk zie je een foutmelding die aangeeft dat de package sqlx ontbreekt. Installeer deze package dan eerst en probeer het vervolgens opnieuw:
cargo install sqlx-cli
./pull-and-runLet op: voor deze methode moet je de repository klonen of downloaden.
In plaats van het script kun je ook handmatig cargo run vanuit de backend-map en npm run dev:server vanuit de frontend-map in twee verschillende terminals starten. Hiervoor gelden dezelfde vereisten als bij het uitvoeren van het pull-and-run-script. Deze optie is bedoeld voor development.
Hiermee start je de backend in watch mode. Assets worden geserveerd door de build tool vite en maken dus gebruik van Hot Module Reloading:
docker compose upOok deze optie is bedoeld voor development.
Voor meer informatie over de argumenten bekijk je de helpfunctie via de commandline. Op macOS en Linux gebruik je de volgende opdracht:
./path/to/binary/abacus-[OS-version] --helpEn op Windows:
start path\to\binary\abacus-windows-[version].exe --help