animal/README.md

animals

animals

Runtime: Java 17 · Spring Boot 3.2
Owner: group:default/demo-admins
Platform: Humanitec · Project cjot-platform

Quick Start

Prerequisites

• JDK 17+
• Maven 3.9+

Run locally

mvn spring-boot:run

The service listens on http://localhost:8080.

Endpoints

Method	Path	Description
GET	/api/items	List all items
POST	/api/items	Create a new item
GET	/api/items/{id}	Get item by ID
PUT	/api/items/{id}	Update item
DELETE	/api/items/{id}	Delete item
GET	/actuator/health	Health check
GET	/actuator/prometheus	Prometheus metrics

Example requests

# Create an item
curl -X POST http://localhost:8080/api/items \
  -H "Content-Type: application/json" \
  -d '{"name": "Widget", "description": "A demo widget"}'

# List all items
curl http://localhost:8080/api/items

Build

mvn package -DskipTests
java -jar target/*.jar

Container

docker build -t animals:dev .
docker run -p 8080:8080 animals:dev

CI/CD

Push to main triggers:

1. build-push.yml — Maven build → ACR push
2. deploy-humanitec.yml — humctl score deploy to ``

Links

• Humanitec Console
• Source Repository
• TechDocs