drvpn/runpod_serverless_speedtest_worker repository overview

⁠RunPod Serverless Speedtest Worker

⁠Explore RunPod⁠

This project allows users to install Speedtest, a bandwidth tool that can inspect a RunPod region's network.

⁠Required Environment Variables

To run this application on RunPod serverless, you need to set the following environment variables:

• BUCKET_ENDPOINT_URL: The endpoint URL of your S3-compatible storage.
• BUCKET_ACCESS_KEY_ID: The access key ID for your S3-compatible storage.
• BUCKET_SECRET_ACCESS_KEY: The secret access key for your S3-compatible storage.

These variables are required to store and host the JSON data and the upload and download graphs (PNG)

• DURATION: The amount of time in minutes you want the test to run. The default is 5.
• REGION: The name of the region, ie: EU-RO-1. The default is NO REGION SET

⁠Running on RunPod Serverless

1. Deploy on RunPod

   • Go to RunPod's dashboard and create a new serverless endpoint.
   • Use the drvpn/runpod_serverless_speedtest_worker for image.
   • Set the environment variables: BUCKET_ENDPOINT_URL, BUCKET_ACCESS_KEY_ID, BUCKET_SECRET_ACCESS_KEY, REGION and optionally DURATION

2. Invoke the endpoint

Speedtest doesn't require any input, but RunPod considers it an error to provide no input, so pass in at least 1 input Here is an example:

{
  "input": { "run": "yes"}
}

Use RunPod's interface or an HTTPS client (i.e. Postman) to send this payload to the deployed endpoint.

⁠Input

• provide at least 1 input: Speedtest doesn't require any input, but RunPod considers it an error to provide no input, use { "input": { "run": "yes" } }

⁠Example return value

{
  "delayTime": 7288,
  "executionTime": 313862,
  "id": "your-unique-id-will-be-here",
  "output": {
    "avg_download_speed": 1560.86,
    "avg_upload_speed": 1120.25,
    "best_server": {
      "cc": "RO",
      "country": "Romania",
      "d": 136.05747880300632,
      "host": "speedtest-c2.orange.ro:8080",
      "id": "45319",
      "lat": "46.7712",
      "latency": 43.385,
      "lon": "23.6236",
      "name": "Cluj-Napoca",
      "sponsor": "Orange Romania SA",
      "url": "http://speedtest-c2.orange.ro:8080/speedtest/upload.php"
    },
    "ping_image_url": "https://mybucket.nyc3.digitaloceanspaces.com/Speedtest/EU-RO-1_speed_test_ping_20240617_013652.png",
    "results_url": "https://mybucket.nyc3.digitaloceanspaces.com/Speedtest/EU-RO-1_speed_test_results_20240617_013652.json",
    "speed_image_url": "https://mybucket.nyc3.digitaloceanspaces.com/Speedtest/EU-RO-1_speed_test_speed_20240617_013652.png"
  },
  "status": "COMPLETED"
}

⁠Handler Explanation

The handler.py script orchestrates the following tasks:

• Performs a speed test for the specified time period(default is 5 minutes)
• Uploads the generated JSON data file, graph images of download, upload, and ping speeds to S3-compatible storage and returns the public URLs.

⁠License

This project is licensed under the MIT License.

⁠Source Code

Source code is available on GitHub⁠