Sign inSign up

adamiy/globalping-toolkit

By adamiy

•Updated 11 months ago

Toolkit image containing `globalping-cli`, `curl`, and other essential utilities.

Image
Networking
Developer tools
Monitoring & observability
0

1.4K

adamiy/globalping-toolkit repository overview

⁠Globalping Toolkit Docker Image

Docker Pulls GitHub Stars

A lightweight Docker image containing globalping-cli, curl, and other essential utilities.

⁠✨ Features

  • globalping-cli: Comes with globalping-cli v1.5.0 pre-installed.
  • Lightweight: Built on the minimal alpine:3.20 base image.
  • Multi-Arch: Ready to be built for different architectures like amd64 and arm64.

⁠🚀 How to Use

⁠Pull from Docker Hub

The pre-built image is available on Docker Hub.

docker pull adamiy/globalping-toolkit:latest
⁠Usage with docker run

1. Run an interactive shell:

This is useful for debugging or exploring the container's environment.

docker run -it --rm adamiy/globalping-toolkit:latest

2. Run a one-off command:

You can easily run any globalping command directly.

docker run --rm adamiy/globalping-toolkit:latest globalping http example.com from Germany
⁠Usage with Kubernetes (CronJob Example)

This image is suitable for running scheduled jobs in Kubernetes. The example below defines a basic health check that runs every 15 minutes. The job's success or failure depends on the exit code of the globalping command.

# cronjob-example.yaml
apiVersion: batch/v1
kind: CronJob
metadata:
  name: website-health-check
spec:
  schedule: "*/15 * * * *" # Runs every 15 minutes
  jobTemplate:
    spec:
      template:
        spec:
          containers:
            - name: globalping-check
              image: adamiy/globalping-toolkit:latest
              imagePullPolicy: IfNotPresent
              # The command to run. Customize it for your needs.
              command:
                - /bin/sh
                - -c
                - |
                  # This is a basic check. The job will succeed if globalping exits with 0,
                  # and fail otherwise.
                  #
                  echo "Pinging your-service.example.com from 3 probes in Europe..."
                  globalping http --limit 3 your-service.example.com from Europe
          # 'OnFailure' will restart the job if the command fails, which might be useful for transient errors.
          # Use 'Never' if you don't want retries within the same job run.
          restartPolicy: OnFailure

⁠🛠️ Building the Image Locally

To build the image yourself, clone the repository and run the Docker build command.

git clone [https://github.com/adamori/globalping-toolkit.git](https://github.com/adamori/globalping-toolkit.git)
cd globalping-toolkit
docker build -t adamiy/globalping-toolkit:latest .
⁠Customization

You can customize the version of globalping-cli at build time using the GLOBALPING_VERSION build argument.

docker build --build-arg GLOBALPING_VERSION=1.4.0 -t adamiy/globalping-toolkit:custom .

⁠🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page⁠.

⁠📄 License

This project is licensed under the MIT License.

Tag summary

Content type

Image

Digest

sha256:a5cf11030…

Size

9.5 MB

Last updated

about 1 year ago

docker pull adamiy/globalping-toolkit