epp

End-to-End Tests

This document provides instructions on how to run the end-to-end tests.

Overview

The end-to-end tests are designed to validate end-to-end Gateway API Inference Extension functionality. These tests are executed against a Kubernetes cluster and use the Ginkgo testing framework to ensure the extension behaves as expected.

Prerequisites

• Go installed on your machine.
• Make installed to run the end-to-end test target.
• A Hugging Face Hub token with access to the meta-llama/Llama-3.1-8B-Instruct model.

Running the End-to-End Tests

Follow these steps to run the end-to-end tests:

1. Clone the Repository: Clone the gateway-api-inference-extension repository:

   git clone https://github.com/kubernetes-sigs/gateway-api-inference-extension.git && cd gateway-api-inference-extension

2. Export Your Hugging Face Hub Token: The token is required to run the test model server:

   export HF_TOKEN=<MY_HF_TOKEN>

3. (Optional): Set the test namespace: By default, the e2e test creates resources in the inf-ext-e2e namespace. If you would like to change this namespace, set the following environment variable:

   export E2E_NS=<MY_NS>

4. Run the Tests: Run the test-e2e target:

   make test-e2e

   The test suite prints details for each step. Note that the vllm-llama3-8b-instruct-pool model server deployment may take several minutes to report an Available=True status due to the time required for bootstraping.