Package configuration

    Configure and upload your package to Gatling Enterprise.

    Manage packages

    To access your packages, click on Sources in the navigation bar. You need the Leader role or higher to access this page.

    The Packages tab inside the Sources view contains all the packages you have configured with the

    • name,
    • format,
    • team,
    • filename of the uploaded package if not empty, and
    • the date of the last upload.

    The Gatling version of the package is displayed in a badge next to the filename.

    Packages table

    Create a package

    To add a package, click on the Create button above the Packages table.

    Package creation
    • Name: the name that will appear on the simulations general step.
    • Team: select the team who has access to the package.
    • Simulation packaged with Gatling Enterprise plugin: optional (see below). The generated package file to upload.

    Depending on the language used for your simulation, the package created is assigned to the JVM (Java, Kotlin, Scala) or the JS (Javascript, Typescript) type. This type cannot be updated. For example, a JS package cannot replace a JVM package: you have to create a new package.

    Upload packages

    Option 1: Manual Upload

    In order to fill the package with your bundled simulation, click on the Browse files button or drag and drop your file directly on the dashed-bordered area.

    Upon successful file upload, you should see your file:

    Package upload filled

    Option 2: API Upload

    You can also upload packages programmatically with our REST API.

    You’ll need:

    • an API token with at least the Packages permission
    • the Package’s ID, which can be copied from the WebUI.

    You can then upload your package, eg with curl:

    curl -X PUT --upload-file <PACKAGE_LOCAL_PATH> \
  "https://<DOMAIN>/api/public/artifacts/<PACKAGE_ID>/content?filename=<PACKAGE_FILE_NAME>" \
  -H "Authorization:<API_TOKEN>"

    Option 3: Plugin configuration

    Maven, Gradle, sbt and JavaScript/TypeScript plugins offer commands to automatically deploy and manage your packages and simulations.

    Use a package in a simulation

    You can configure which package to use for a simulation in the simulation’s General step.

    Package upload filled

    Edit this page on GitHub

    ← Introduction to sources
    Package generation →