cnfsoftware/cnf-q-service repository overview

⁠cnf-q-server Docker Image

This repository contains a Docker image for cnf-q-server, a high-performance queue service written in Go. The service provides a simple API for managing message queues, allowing clients to push, pop, and peek messages efficiently.

⁠Usage

⁠Pull image

docker pull cnfsoftware/cnf-q-server:latest

⁠Run the Container

docker run -d -p 8080:8080 --name cnf-q-server cnfsoftware/cnf-q-server

⁠API Endpoints

• POST /queue/{name}/push – Add a message to a queue
• GET /queue/{name}/pop – Retrieve and remove the first message
• GET /queue/{name}/peek – View the last message without removing it
• GET /queues – List all available queues

⁠Configuration via Environment Variables

You can configure the service using the following environment variables:

⁠Run with Custom Configuration

docker run -d -p 9090:9090 \
  -e CNF_Q_PORT=9090 \
  -e CNF_Q_ACCESS_TOKEN=supersecret \
  -e CNF_Q_TLS_CERT_FILE=/certs/server.crt \
  -e CNF_Q_TLS_KEY_FILE=/certs/server.key \
  -v /path/to/certs:/certs:ro \
  --name cnf-q-server cnfsoftware/cnf-q-server

⁠Example Request

curl -X POST http://localhost:8080/queue/myqueue/push -d "Hello, Queue!"

⁠Maintenance & Support

This project is actively maintained by CNF Software⁠. Regular updates, security patches, and performance improvements are provided. If you encounter any issues or need support, please reach out via the official CNF Software channels.

For more details, visit the GitHub repository⁠. 🚀