Java™ Functional Testing

Lär dig skriva Java™-funktionstester för AEM as a Cloud Service

Komma igång med funktionstester getting-started-functional-tests

När en ny koddatabas skapas i Cloud Manager kan it.tests mappen skapas automatiskt med exempelfall.

NOTE
Om din databas skapades innan Cloud Manager skapades automatiskt it.tests kan du även generera den senaste versionen med AEM Project Archetype.

När innehållet i it.tests kan du använda den som bas för dina egna tester och sedan:

  1. Utveckla testfall.
  2. Kör testerna lokalt.
  3. Implementera koden i molnhanterarens databas och kör en Cloud Manager-pipeline.

Skriva anpassade funktionstester writing-functional-tests

Samma verktyg som Adobe använder för att skriva produktfunktionstester kan användas för att skriva dina anpassade funktionstester. Använd funktionsprovningar av produkter i GitHub som ett exempel på hur du skriver dina tester.

Koden för anpassade funktionstester är Java™-kod i it.tests projektmapp. Den ska producera en enda JAR med alla funktionstester. Om bygget skapar mer än en test-JAR är den JAR som är vald icke-deterministisk. Om inga JAR-testversioner skapas godkänns teststeget som standard. Se AEM Project Archetype för stickprov.

Testerna körs på testinfrastruktur som underhålls av Adobe, inklusive minst två författarinstanser, två publiceringsinstanser och en Dispatcher-konfiguration. Detta innebär att dina anpassade funktionstester körs mot hela AEM.

Struktur för funktionstester functional-tests-structure

Anpassade funktionstester måste paketeras som en separat JAR-fil som skapas av samma Maven-bygge som de artefakter som ska distribueras till AEM. I allmänhet är detta bygge en separat Maven-modul. Den resulterande JAR-filen måste innehålla alla nödvändiga beroenden och skulle vanligtvis skapas med maven-assembly-plugin med jar-with-dependencies beskrivare.

Dessutom måste JAR ha Cloud-Manager-TestType manifest header inställd på integration-test.

Här följer ett exempel på konfiguration för maven-assembly-plugin.

<build>
    <plugins>
        <!-- Create self-contained jar with dependencies -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-assembly-plugin</artifactId>
            <version>3.1.0</version>
            <configuration>
                <descriptorRefs>
                    <descriptorRef>jar-with-dependencies</descriptorRef>
                </descriptorRefs>
                <archive>
                    <manifestEntries>
                        <Cloud-Manager-TestType>integration-test</Cloud-Manager-TestType>
                    </manifestEntries>
                </archive>
            </configuration>
            <executions>
                <execution>
                    <id>make-assembly</id>
                    <phase>package</phase>
                    <goals>
                        <goal>single</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

I den här JAR-filen måste klassnamnen för de faktiska tester som ska köras sluta med IT.

En klass med namnet com.myco.tests.aem.it.ExampleIT skulle köras, men en klass med namnet com.myco.tests.aem.it.ExampleTest skulle inte.

Om du vill utesluta testkoden från disponeringskontrollen för kodskanningen måste testkoden dessutom finnas under ett paket med namnet it (filtret för uteslutning av täckning är **/it/**/*.java).

Testklasserna ska vara normala JUnit-tester. Testinfrastrukturen är utformad och konfigurerad så att den är kompatibel med konventionerna som används av aem-testing-clients testbibliotek. Utvecklare uppmuntras att använda det här biblioteket och följa sina bästa rutiner.

Se aem-testing-clients GitHub-repo för mer information.

TIP
Se videon om hur du kan använda anpassade funktionstester för att förbättra ditt förtroende för CI/CD-pipelines.

Förutsättningar prerequisites

  1. Testerna i Cloud Manager körs med en teknisk administratörsanvändare.
NOTE
Om du vill köra funktionstester från den lokala datorn skapar du en användare med administratörsliknande behörigheter för att uppnå samma beteende.
  1. Den inneslutna infrastruktur som omfattar funktionstestning begränsas av följande gränser:
Typ
Värde
Beskrivning
CPU
0,5
Den processortid som reserverats per testkörning
Minne
0,5 Gi
Mängd minne som tilldelats testet, värde i gibibyte
Timeout
30 m
Den varaktighet efter vilken testet avslutas.
Rekommenderad varaktighet
15 m
Adobe rekommenderar att testet inte tar längre tid än så här.
NOTE
Om du behöver mer resurser kan du skapa ett kundvårdsärende och beskriva ditt användningsfall. Adobe teamet granskar din begäran och ger lämplig hjälp.

Beroenden

  • aem-cloud-testing-clients:

Kommande förändringar i den inneslutna infrastruktur som används för att utföra funktionstester kommer att kräva biblioteket aem-cloud-testing-clients som används i ditt anpassade funktionstest för att uppdateras till åtminstone en version 1.2.1
Se till att ditt beroende it.tests/pom.xml har uppdaterats.

<dependency>
   <groupId>com.adobe.cq</groupId>
   <artifactId>aem-cloud-testing-clients</artifactId>
   <version>1.2.1</version>
</dependency>
NOTE
Denna ändring måste utföras före 6 april 2024.
Om du inte uppdaterar beroendebiblioteket kommer det att uppstå ett pipeline-fel i steget"Custom Functional Testing".

Lokal testkörning local-test-execution

Innan du aktiverar funktionstester i en pipeline för Cloud Manager rekommenderar vi att du kör funktionstester lokalt med AEM as a Cloud Service SDK eller en faktisk AEM as a Cloud Service instans.

Köra i en IDE running-in-an-ide

Eftersom testklasser är JUnit-tester kan de köras från vanliga Java™-utvecklingsmiljöer som Eclipse, IntelliJ och NetBeans. Eftersom både produktfunktionstester och anpassade funktionstester baseras på samma teknik, kan båda köras lokalt genom att produkttesterna kopieras till dina anpassade tester.

När du kör dessa tester måste du dock ange olika systemegenskaper som förväntas av aem-testing-clients (och det underliggande Sling Testing Clients) biblioteket.

Systemegenskaperna är följande.

Egenskap
Beskrivning
Exempel
sling.it.instances
antal instanser, för att matcha molntjänsten ska anges till 2
2
sling.it.instance.url.1
ska anges till författarens URL
http://localhost:4502
sling.it.instance.runmode.1
körningsläge för den första instansen, ska anges till author
author
sling.it.instance.adminUser.1
ska anges till författaradministratörsanvändaren.
admin
sling.it.instance.adminPassword.1
ska anges som författarens administratörslösenord.
sling.it.instance.url.2
ska anges till publicerings-URL:en
http://localhost:4503
sling.it.instance.runmode.2
körningsläge för den andra instansen, ska anges till publish
publish
sling.it.instance.adminUser.2
ska ställas in för publiceringsadministratörsanvändaren.
admin
sling.it.instance.adminPassword.2
ska anges till administratörslösenordet för publicering.

Köra alla tester med Maven using-maven

  1. Öppna ett skal och navigera till it.tests i din databas.

  2. Kör följande kommando med de parametrar som krävs för att starta testerna med Maven.

mvn verify -Plocal \
    -Dit.author.url=https://author-<program-id>-<environment-id>.adobeaemcloud.com \
    -Dit.author.user=<user> \
    -Dit.author.password=<password> \
    -Dit.publish.url=https://publish-<program-id>-<environment-id>.adobeaemcloud.com \
    -Dit.publish.user=<user> \
    -Dit.publish.password=<password>
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab