KEPLIN Docs

Testmiljön

Var testerna skriver i varje databas, testdatasourcen för externa databaser med skrivbehörighet, testanvändarna, de simulerade HTTP-svaren, merge-kontrollen, den schemalagda körningen och gränserna.

Testmiljön anger var testerna skriver, vilka konton de loggar in i appen med och vad som händer med effekter utanför appen. Den öppnas i minifliken Tester, med knappen Testmiljö.

Testmiljön, i ett fönster med fast storlek
Testmiljön, i ett fönster med fast storlek

Obs

Bara en administratör ändrar testmiljön. En developer ser den.

Databaser

Varje datasource i appen visas med typ, åtkomst och vad som händer i testerna:

Datasource I testerna
Appens interna databas En ny kopia med databasens schema, i varje test.
Intern PostgreSQL En tillfällig databas på den förvaltade servern, med den riktigas schema, i varje test.
Extern databas med skrivbehörighet (Läsa och skriva eller Skyddad struktur) Den valda testdatasourcen, obligatorisk. Testdatans tabeller töms före varje test.
Extern databas med Endast läsning Den riktiga databasen, bara för läsning. Testerna läser den och skriver aldrig i den.

Testdatasourcen för externa databaser

En extern databas med skrivbehörighet kan inte kopieras för varje test. Testerna använder en annan datasource i appen, ansluten till en testdatabas med samma struktur. Anslutningar skapas alltid i datasourcerna, i avsnittet Data, och testmiljön väljer bara vilken som används.

  1. Skapa i avsnittet Data en datasource av samma typ, med skrivbehörighet, ansluten till testdatabasen. Det kan också vara en intern datasource.
  2. Öppna Testmiljö.
  3. Klicka på Välj testdatasource på den externa databasens rad och välj den i listan.
  4. Klicka på Spara.

Statusen blir klar. På raden för den valda datasourcen visar miljön vilken databas den är testdatasource för, och testerna använder den som den är.

Varning

Så länge en extern databas med skrivbehörighet saknar vald testdatasource körs inga tester i appen, inte ens de som inte verkar använda den databasen. Ett test når alla appens databaser via en skärm, ett API eller ett skript, och det finns inget säkert sätt att i förväg veta vilka databaser det når. Körningen blir Blockerad och anger vilken databas som saknas.

En extern databas med Endast läsning behöver ingen testdatasource: testerna läser den riktiga databasen, och plattformen vägrar all skrivning, precis som utanför testerna. Full säkerhet får du genom att ansluta databasen med en användare som bara har läsbehörighet.

Testanvändare

Ett test som börjar som en roll loggar in i appen med det konto som har valts här för rollen, med alla det kontots roller.

  1. Klicka på Välj användaren på rollens rad under Testanvändare.
  2. Sök och välj ett aktivt konto som har rollen. Ingen användare ångrar valet.
  3. Klicka på Spara.

Bara befintliga konton kan väljas: konton och roller tilldelas under Appens inställningar › Appens användare. Raden Besökare har inget konto: ett test utan roll har ingen session och ser bara de publika skärmarna och API:erna, som den som öppnar appen utan att logga in.

Varje rad visar hur många tester som använder rollen. Ett test med en roll utan valt konto misslyckas med ”Rollen … har ingen testanvändare”.

Simulerade HTTP-svar

I testerna går en HTTP-förfrågan från ett API eller ett arbetsflöde aldrig ut på nätet: den får det simulerade svar vars adress är början av förfrågans adress (och metoden, om den anges). En förfrågan utan simulerat svar får steget att misslyckas, med adressen, så att det framgår vad som saknas.

Lägg till ett genom att klicka på Lägg till svar och fylla i metoden, adressen (till exempel https://api.exemplo.pt/v1/), koden och kroppen.

Obs

Skript gör sina förfrågningar i sin egen process och går inte via de simulerade svaren.

När de körs av sig själva

  • Före sammanslagning i main: med kontrollen påslagen kör en sammanslagning av en version i main först testerna med de angivna etiketterna (eller alla, utan etiketter) i källversionen. Om de inte godkänns slås inget samman. Se Köra och läsa resultat.
  • Kör alla tester vid tiden i detta cron-uttryck: den schemalagda körningen, till exempel 0 2 * * * (varje natt kl. 02.00). Plattformens schemaläggare måste vara påslagen.

Gränser

  • Sekunder per steg: hur länge ett steg får ta (och hur länge en skärmkontroll väntar). Standard 30.
  • Minuter per körning: hur länge en körning får ta. Standard 10.