github.com/operator-framework/operator-lifecycle-manager@v0.30.0/test/e2e/README.md (about)

     1  # Backend end to end tests
     2  
     3  This runs a series of tests against the Kubernetes API to verify that OLM is functioning properly.
     4  
     5  ## Requirements
     6  
     7  * Helm > 2.7.0
     8  
     9  ## How to use
    10  
    11  
    12  Execute `make e2e-local` in the root of the repository, which will:
    13  
    14  - optionally update `test/e2e/assets/chart/zz_chart.go` as needed
    15  - build local executables used during testing
    16    - `bin/e2e-local.test`
    17    - `bin/wait`
    18    - `bin/cpb`
    19    - `bin/catalog`
    20    - `bin/olm`
    21    - `bin/package-server`
    22  - build docker file `e2e.Dockerfile` which includes the local executables in a `kind` image archive `test/e2e-local.image.tar`
    23  - execute `ginkgo` to run the pre-compiled test package `bin/e2e-local.test` with the `kind` image archive. This runs BDD tests defined in `test/e2e`
    24    - these tests are run in a kind cluster that is started fresh each time the test is executed
    25  
    26  
    27  Examples:
    28  
    29  - Run all BDD tests (this takes a long time)
    30  
    31    ```bash
    32    make e2e-local
    33    ```
    34  
    35  - Run a specific BDD test using the `TEST` argument to make. Note that this argument uses regular expressions.
    36  
    37    ```bash
    38    make e2e-local TEST='API service resource not migrated if not adoptable'
    39    ```
    40  
    41  - If you have previously created the `bin/e2e-local.test` executable and want a quick way to ensure that your TEST regex argument will work, you can bypass the 
    42  make file and use `-dryRun` with `-focus` and see if the regex would trigger your specific test(s).
    43    
    44    ```bash
    45    GO111MODULE=on go run github.com/onsi/ginkgo/v2/ginkgo -dryRun -focus 'API service resource not migrated if not adoptable' bin/e2e-local.test
    46    ```
    47  
    48  - It is also possible to specify the number of parallel test nodes (i.e. one or more instances of `go test`) to run using the `NODES` argument. Defaults to 1 if not specified
    49  
    50    ```bash
    51    make e2e-local NODES=2
    52    ```
    53  
    54  ## Build infrastructure
    55  
    56  Note that the make file target `e2e-local` is executed by the github workflow `.github/workflows/e2e-tests.yml` and uses two parallel `go test` processes.