In deze handleiding leert u hoe u het DXPR Maven-testautomatiseringsproject kunt klonen en instellen voor lokale ontwikkeling en testen. U beschikt over een Java-runtime-omgeving met het Maven- en TestNG-framework geconfigureerd wanneer u de omgeving succesvol instelt.

Vereisten

  1. Raadpleeg de installatiedocumentatie van de machine voordat u verdergaat met deze handleiding.
  2. Zorg ervoor dat u het DXPR Builder-project al op uw machine hebt ingesteld .

Kloon en stel DXPR Maven in

  1. Kloon de DXPR Maven-repository: git clone [email protected]:dxpr/dxpr_maven.git .
  2. Open de projectmap in uw favoriete teksteditor.
  3. Kopieer het bestand .env.example en hernoem het naar .env
  4. Open het .env- bestand en stel de variabele DXPR_ACCESS_TOKEN=[access_token] in en sla het bestand op. U kunt uw token verkrijgen via de downloadpagina op dxpr.com op het tabblad JSON Web Token​​.
  5. U kunt nu beginnen met het ontwikkelen van het maven-project en het wijzigen van bestanden in de editor van uw voorkeur. De aanbevolen Java-code-editor is de Intellij IDEA community-editie . Zodra u een bestand heeft gewijzigd en de tests wilt uitvoeren, gaat u verder met de volgende stappen.
  6. Zorg ervoor dat u de tweede vereiste hebt gevolgd voordat u doorgaat en dat de QA-demowebsite actief is op http://drupal.docker.localhost:8000/ .
  7. Zorg ervoor dat u zich op een apart terminaltabblad in de hoofdmap van het DXPR maven-project bevindt en voer het vervolgens uit
    ./scripts/qa-demo.test.sh
    Met deze opdracht wordt een seleniumraster en een zelfstandig chroomknooppunt gestart waarop tests kunnen worden uitgevoerd. Nadat de opdracht is uitgevoerd, wordt er een terminalinstantie geopend in een maven-container waarin u een Java-runtimeomgeving hebt.
  8. In deze terminalinstantie in de maven-container hoeft u deze opdracht slechts één keer per kloon uit te voeren
    ./scripts/maven.properties.install.sh
    Hiermee worden enkele omgevingsvariabelen geconfigureerd die essentieel zijn voor het uitvoeren van de Java-applicatie.
  9. Nu kunt u maven-opdrachten gaan uitvoeren alsof u dat in een Java-runtime-omgeving zou doen. Om een ​​TestNG-testsuite uit te voeren, gebruiken we de mvn opdracht run
    ./scripts/qa-demo.wait.sh $DEMO_HOST mvn test -DsuiteXmlFile=$TEST_SUITE
    Laten we uitleggen wat deze opdracht doet:
  • ./scripts/qa-demo.wait.sh : Dit script wacht totdat de QA-demowebsite gereed is voor het afhandelen van verbindingen.
  • $DEMO_HOST : Deze variabele is een parameter die wordt doorgegeven aan het wait-script en die wordt omgezet in de hostnaam van de QA-demowebsite.
  • mvn test -DsuiteXmlFile=$TEST_SUITE : Dit is hoe u normaal gesproken een testsuite zou uitvoeren met behulp van de mvn opdracht, waarbij u de bestandsnaam van de testsuite opgeeft via de variabele $TEST_SUITE .

Na het uitvoeren van deze opdracht zul je merken dat het maven-project begint met bouwen, en na succesvol bouwen begint het met het uitvoeren van de tests. Het uitvoeren van alle tests kan een aanzienlijke hoeveelheid tijd in beslag nemen. Voer dus uit en schakel over naar een andere taak totdat deze klaar is met uitvoeren.

Hoe u de Maven Container Terminal-instantie beëindigt

Als er een proces actief is in de maven-terminal, druk dan eerst op ctrl+c . Als dit niet het geval is, typt u gewoon exit en drukt u op Enter . Hierdoor wordt de terminalsessie in de maven-container afgesloten. Het is altijd een goede stap om de omgeving op te schonen door deze opdracht uit te voeren
./scripts/test.dev.cleanup.sh
Hiermee worden alle gebruikte containers en netwerken gestopt en verwijderd. Mogelijk moet u ook de QA-demowebsite stoppen die u hebt gestart voordat u de maven-terminalsessie opende. Raadpleeg de installatie van de DXPR Builder-projecthandleiding voor informatie over hoe u dit op de juiste manier kunt stoppen.

Probleemoplossen

  • Als u een foutmelding krijgt wanneer u de tests probeert uit te voeren, zorg er dan voor dat de QA-demo actief is en gereed is voor het afhandelen van verbindingen.
  • Als de QA-demo actief is maar u nog steeds fouten krijgt, beëindigt u de maven containerterminal-instantie en voert u deze opdracht opnieuw uit
    ./scripts/qa-demo.test.sh
    Hierdoor wordt de maven containerterminal-instantie opnieuw geopend en kunt u de tests opnieuw uitvoeren.
  • Als u nog steeds problemen ondervindt, controleer dan of de QA-demowebsite naar verwachting functioneert. Als u denkt dat het defect is of een probleem heeft, kunt u de DXPR Builder-projectgids raadplegen en de website opnieuw installeren volgens het gedeelte over het oplossen van problemen.