- Kloonaa digiroad2-repo omalle koneellesi
git clone https://github.com/finnishtransportagency/digi-road-2.git
-
Asenna node.js (samalla asentuu npm)
-
Hae ja asenna projektin tarvitsemat riippuvuudet hakemistoon, johon projekti on kloonattu Digiroadin käyttämät paketit on säilötty AWS CodeArtifact, kirjaudu AWS SSO ja aseta npm käyttämään CodeArtifact repositoryä
aws sso login --profile <profiilin nimi>
aws codeartifact login --tool npm --repository digiroad_npm_packages --domain digiroad --domain-owner 475079312496
npm install
- Asenna grunt
npm install -g grunt-cli
Luo .idea kansioon runConfigurations kansio. Kopioi aws/local-dev/idea-run-configurations konfiguraatiot .idea/runConfigurations kansioon. Käynistä IDE uudestaan. Server configuraatiossa ota "use sbt shell" ruksi pois edit configuration.
digiroad2-oracle moduuli toteuttaa oracle-spesifisen tuen digiroad2:n AssetProvider ja UserProvider - rajapinnoista.
Moduuli tuottaa kirjaston, joka lisätään ajonaikaisesti digiroad2-sovelluksen polkuun.
Backend palvelimen käynistäminen edellyttää, että paikallinen tietokanta on päälä ja alustettu.
Laita aws/local-dev/postgis/docker-compose.yaml pääle ja luo ympäristöt unittest ja lokaaliin kehitykseen.
docker-compose -p "localtest" -f .\aws\local-dev\postgis\docker-compose.yaml create docker-compose -p "unittest" -f .\aws\local-dev\postgis\docker-compose.yaml create
Käynnistä joko terminaalissa tai Docker Desktop. docker-compose -p "localtest" -f .\aws\local-dev\postgis\docker-compose.yaml start docker-compose -p "unittest" -f .\aws\local-dev\postgis\docker-compose.yaml start
Alusta kanta ajamalla DataFixture init configuraatio. Sitten aja DataFixture reset tai migrate configuraatio.
Buildin rakentaminen:
grunt
Testien ajaminen:
grunt test
Kehitysserverin pystytys: Aseta ympäristömuuttuja rasterService_apikey=apiavain . Parametri voidaan asettaa Intellij Grunt Configuration Environment.
grunt server
Kehitysserveri ajaa automaattisesti testit, kääntää lessit ja toimii watch -tilassa.
Kehityspalvelin ohjaa API-kutsut API-palvelimelle. Jotta järjestelmä toimii tulee myös API-palvelimen olla käynnissä.
API-palvelimen buildia käsitellään sbt:llä, käyttäen projektin juuressa olevaa launcher-skriptiä sbt. Buildatessa ensimmäisen kerran, sbt hakee paketit CodeArtifact repositorystä.
Hae CodeArtifact Authorization token
aws codeartifact get-authorization-token --domain digiroad --domain-owner 475079312496 --region eu-west-1 --query authorizationToken --output text
Aseta se ympäristö muuttujaksi
set CODE_ARTIFACT_AUTH_TOKEN=<token>
Aja sbt. SBT buildaa projektin ja hakee tarvitut riippuvuudet CodeArtifactista
sbt
Palvelimen voi käynnistää ajamalla Server configuration myös.
API-palvelimen saa käyntiin kehitysmoodiin seuraavalla sbt komennolla:
./sbt '~;container:start; container:reload /'
Ympäristömuuttuja parametri voidaan asettaa Intellij SBT Configuration Environment Variable avulla. Nämä voidaan syöttään myös ympäristömuuttujina:
viiteRestApiEndPoint=url
viite.apikey=insertapikey
vkm.apikey=insertapikey
oag.username=svc_clouddigiroad
oag.password=svc_clouddigiroad
rasterService.apikey=insertapikey
googlemapapi.client_id=XYZ123
googlemapapi.crypto_key=ZYX321
ses.username=sesusername
ses.password=sespassword
bonecp.jdbcUrl=kantaurl
bonecp.username=kantakäyttäjä
bonecp.password=kantasalasana
vvhRest.password=insertpassword
kgv.apikey=insertkey
Windowsissa toimii komento:
run fi.liikennevirasto.digiroad2.ProductionServer
Avaa käyttöliittymä osoitteessa http://localhost:9001/login.html. Kirjaudut sisään käyttäen lokaalia testi käyttäjää nimeltään silari.
Jotta skripti toimisi PostgreSql pitää olla asennettu ja C:{polku sinne minne asennettu}\PostgreSQL\13\bin\ pitää olla lisätty path env.
Mahdollisesti voi tulla viesti "cannot be loaded because the execution of scripts is disabled on this system".
Käynnistä Powershell terminaali admin oikeuksilla ja aja Set-ExecutionPolicy Unrestricted -Scope LocalMachine Lisää tietoa: https://www.sqlshack.com/choosing-and-setting-a-powershell-execution-policy/
Avaa ssh yhteys bastion koneeseen ja ohjaa tietokanta johonkin lokaaliin porttiin. Tarvittavat ohjeet löytyy wiki sivulta https://extranet.vayla.fi/wiki/display/DROTH/AWS+Ohjeita
Aja Powershell terminaalissa skripti projektin juuressa.
.\importRoadlink.ps1
-municipalities "20,10" # kunnat jotka haluat tuoda
-sourceUser digiroad2dbuser
-sourcePassword password
-sourceDB digiroad2
-sourcePort 9999
-destinationPassword digiroad2
-truncateBoolean 1 # 1 tyhjennetään taulu ennen kuin tuodaan uudet linkit, 0 kantaa ei tyhjennetä
.\importRoadlink.ps1 -municipalities "20,10" -sourceUser digiroad2dbuser -sourcePassword password -sourceDB digiroad2 -sourcePort 9999 -destinationPassword digiroad2 -truncateBoolean 1
Palvelun käyttäjien tietoja voi päivittää ja uusia käyttäjiä voi lisätä CSV - tiedostosta, jossa on määritelty uusien ja päivitettävien käyttäjien käyttäjänimet sekä kuntatunnukset joihin näillä käyttäjillä tulisi olla oikeudet.
Alla esimerkki CSV-tiedostosta:
kuntakäyttäjä; ;105, 258, 248, 245;
olemassaolevatunnus; ;410, 411, 412, 413;
elykäyttäjä;0,1,2,3,4,5,6,7,8,9;