Challengefile (WIP)

Challengefile is a tool to deploy tcp-based challengs on Kubernetes.

Installation

1. Clone the repository:

   git clone https://github.com/chxmxii/challengefile.git
   cd challengefile

2. Install the tool:

   make install

Usage

1. Create a challengefile for your challenge like the example below:

   library:
   
     Metadata:
       Author: chxmxii
       Namespace: lib-pwn
       category: pwn
     
     Deployment:
       name: library
       image: chxmxii/library
       replicas: 2 # ignored when hpa is true
       hpa: true
       healthCheck: true
   
     Service:
       name: library-svc
       port: 30330
       protocol: TCP

2. Run commands to manage challenges:

   • Deploy a challenge:

     challengefile deploy -f <challengefile> -c <challenge_name> -k <path/to/kubeconfig> 

   • Destroy a challenge:

     challengefile destroy -f <challengefile> -c <challenge_name> -k <path/to/kubeconfig>

   • Validate the challengefile:

     challengefile validate -f <file>

   • View the full command list:

     challengefile help

• Note: The challengefile and kubeconfig are optional arguments. If not provided, the tool will look for the challengefile file in the current directory and use the default kubeconfig under $HOME/.kube/config.

Features

• Deploy challenges to Kubernetes with ease.
• Validate configurations before deployment.
• Support for HPA and health checks.
• Service management with flexible options.

TODO

• Support for more http-based challenge types.