This documentation describes the steps to run integration tests for the Oracle WebLogic Server Kubernetes Operator locally on a Oracle Linux environment. The tests are written in the JUnit5 framework and driven by Maven profile.

Directory structure of the integration test source is as follows:

weblogic-kubernetes-operator/integration-tests - location of module pom.xml  
weblogic-kubernetes-operator/integration-tests/src/test/java/oracle/weblogic/kubernetes - integration test(JUnit5) classes and utility classes  
weblogic-kubernetes-operator/integration-tests/src/test/resources - properties, YAML files and other bash scripts

• Build WebLogic Server Kubernetes Operator image from the downloaded Git branch.
• Install the latest version of WebLogic Server Deploy Tooling (WDT) and WebLogic Image Tool (WIT).
• Install supported Istio service mesh.
• Pull the specified version of WebLogic image from container-registry.oracle.com (OCR).
• Install WebLogic Server Kubernetes Operator.
• Build a WebLogic domain resource.
• Make sure that the WebLogic domain is running by verifying the corresponding server pod and Kubernetes service status.
• After test execution, delete all the namespaces, Kubernetes Objects created during test execution.
• Archive the test standard output for each test class and Kubernetes object details for each test method in the diagnostic directory for triage when tests fail or when the env variable COLLECT_LOGS_ON_SUCCESS is set to true.

• Install supported version of Helm and Kubernetes cluster. For details, see the WebLogic Server Kubernetes Operator guide.
• Install supported version of JDK. Need JDK version 11+ or later.
• Clone the weblogic-kubernetes-operator repository.
• Set up a personal account on container-registry.oracle.com.
• Log in to https://container-registry.oracle.com and accept Oracle Standard Terms and Restrictions to pull WebLogic images from container-registry.oracle.com/middleware/weblogic.
• Following environment variables must be set before running the tests. BASE_IMAGES_REPO variables are used to download the Oracle public images. TEST_IMAGES_REPO variables are used to store any public images used to certify the WebLogic Kubernates Operator (such as NGNIX Controller, Prometheous etc.) and to store the intermediate WebLogic domain images while running the integration tests.

   export BASE_IMAGES_REPO="container-registry.oracle.com"
   export BASE_IMAGES_REPO_USERNAME=<ocr_username>
   export BASE_IMAGES_REPO_PASSWORD=<ocr_password> 
   export BASE_IMAGES_REPO_EMAIL=<ocr_email>
  
   export TEST_IMAGES_REPO="local-registry.oracle.com"
   export TEST_IMAGES_REPO_USERNAME=<local_username>
   export TEST_IMAGES_REPO_PASSWORD=<local_password> 
   export TEST_IMAGES_REPO_EMAIL=<local_email>
  
  

• cd weblogic-kubernetes-operator and run the following commands:

    # Build the WebLogic Server Kubernetes Operator binary 
    mvn clean install 
    # Run tests in sequential order
    mvn -pl -integration-tests -P integration-tests clean verify
    # Run tests in parallel
    mvn -DPARALLEL=true -DNUMBER_OF_THREADS=2 -pl -integration-tests -P integration-tests verify
  

mvn -Dit.test=ItMiiDomain,ItMiiUpdateDomainConfig -pl integration-tests -P integration-tests verify

mvn -Dit.test="ItMiiUpdateDomainConfig#testMiiDeleteSystemResources" -pl integration-tests -P integration-tests verify

mvn -Dit.test="!ItCrossDomainTransaction,!ItMiiUpdateDomainConfig" -pl integration-tests -P integration-tests verify

After the completion of running the integration tests, the results are archived in a directory-based environment variable LOG_DIR (the default value is /tmp/it-testsresults/diagnostic) and runtime artifacts are available in a directory-based environment variable RESULTS_ROOT (the default value is /tmp/it-testresults). After the completion of the test ItMiiDomain, a typical diagnostic logs directory content will look as follows. The standard output for the tests is captured in ItMiiDomain.out. For each test method ( for example testCreateMiiDomain, testCreateMiiSecondDomain), a directory is created and the corresponding Kubernetes object description log(s) and server pod logs are saved if the test fails or environment variable COLLECT_LOGS_ON_SUCCESS set to true.

itMiiDomain

|-- ItMiiDomain.out

|-- testCreateMiiDomain

|   |-- ns-gggs.list.services.log

|   |-- ns-gggs.pod.weblogic-operator-7b8-lwqzm.container.weblogic-operator.log

|   |-- ns-luaf.pod.domain1-admin-server.container.weblogic-server.log

|   |-- ns-luaf.pod.domain1-managed-server1.container.weblogic-server.log

|   |-- ns-luaf.pod.domain1-managed-server2.container.weblogic-server.log

-- testCreateMiiSecondDomain

    |-- ns-gggs.list.configmaps.log

    |-- ns-gggs.list.domains.log

    |-- ns-gggs.list.services.log

    |-- ns-gggs.pod.weblogic-operator-7b8f-lwqzm.container.weblogic-operator.log

    |-- ns-luaf.list.configmaps.log

    |-- ns-luaf.pod.domain1-admin-server.container.weblogic-server.log

    |-- ns-luaf.pod.domain1-managed-server1.container.weblogic-server.log

The diagnostic logs files in the method-scoped directory in ${LOGS_DIR}/<testClass>/<testMehod> and the test stdout ${LOGS_DIR}/<testClass>.out is the starting point to triage a test failure.