Polaris Runtime Service

May 4, 2026 ยท View on GitHub

Overview

The polaris-runtime-service module is the core runtime service implementation of Apache Polaris. It serves as the main service layer that provides the REST API endpoints and business logic.

Integration tests

Integration tests from the :polaris-tests module can be run against a local Polaris Quarkus instance for each supported cloud storage. Set the appropriate environment variables for your target cloud, then run the tests as shown below.

For S3:

export INTEGRATION_TEST_S3_PATH="s3://bucket/subpath"
export INTEGRATION_TEST_S3_ROLE_ARN="your-role-arn"
./gradlew :polaris-runtime-service:cloudTest

For ADLS:

export INTEGRATION_TEST_AZURE_PATH="abfss://bucket/subpath"
export INTEGRATION_TEST_AZURE_TENANT_ID="your-tenant-id"
./gradlew :polaris-runtime-service:cloudTest

For GCS:

export INTEGRATION_TEST_GCS_PATH="gs://bucket/subpath"
export INTEGRATION_TEST_GCS_SERVICE_ACCOUNT="your-service-account"
./gradlew :polaris-runtime-service:cloudTest

To run the GCP federated catalog test using end-user credentials:

export INTEGRATION_TEST_GCS_FEDERATED_CATALOG=YOUR_GCS_WAREHOUSE 
export INTEGRATION_TEST_GCS_FEDERATED_PATH=YOUR_GCS_BUCKET_PATH
export INTEGRATION_TEST_GCS_FEDERATED_QUOTA_PROJECT=YOUR_PROJECT_ID
export INTEGRATION_TEST_GCS_SERVICE_ACCOUNT=YOUR_SERVICE_ACCOUNT_USER@YOUR_PROJECT_ID.iam.gserviceaccount.com 
./gradlew :polaris-runtime-service:cloudTest --tests "org.apache.polaris.service.it.GcpCatalogFederationIntegrationIT"