# Cluster - OCI Registry

A lightweight OCI (Open Container Initiative) registry implementation written in Go using Fiber v3.

## Features

- OCI Registry API v2 compliant
- Blob upload/download with chunked upload support
- Manifest handling (Docker and OCI formats)
- Tag management and catalog listing
- SQLite database for metadata storage
- File system storage for blobs and manifests
- RESTful API v1 for image management

## Architecture

- **main.go**: Application entry point
- **api/**: API route definitions
- **handler/**: HTTP request handlers
- **controller/**: Business logic controllers
- **internal/**: Internal packages (config, database, middleware, model, rerr, storage)

## Development

### Backend (Go)

```bash
# Build
go mod tidy
go build -o cluster .

# Run
./cluster -debug -address 0.0.0.0:8080 -data-dir ./x-storage

# Or use Makefile
make build
make run
```

### Frontend (React/TypeScript)

```bash
cd frontend

# Install dependencies (requires pnpm)
pnpm install

# Approve build scripts (required for esbuild)
pnpm approve-builds

# Development server
pnpm dev

# Build for production
pnpm run build
```

**Note**: This project uses `pnpm` as the package manager. Install it if needed:
```bash
npm install -g pnpm
# or
curl -fsSL https://get.pnpm.io/install.sh | sh -
```

## API Endpoints

### OCI Registry API v2

- `GET /v2/` - Version check
- `POST /v2/{repo}/blobs/uploads/` - Start blob upload
- `PATCH /v2/{repo}/blobs/uploads/{uuid}` - Upload blob chunk
- `PUT /v2/{repo}/blobs/uploads/{uuid}?digest={digest}` - Complete blob upload
- `GET /v2/{repo}/blobs/{digest}` - Get blob
- `HEAD /v2/{repo}/blobs/{digest}` - Check blob existence
- `PUT /v2/{repo}/manifests/{tag}` - Put manifest
- `GET /v2/{repo}/manifests/{tag}` - Get manifest
- `DELETE /v2/{repo}/manifests/{tag}` - Delete manifest
- `GET /v2/{repo}/tags/list` - List tags
- `GET /v2/_catalog` - List repositories

### API v1

- `GET /api/v1/registry/image/list` - List images

## Configuration

- `-debug`: Enable debug logging
- `-address`: Server address (default: 0.0.0.0:8080)
- `-data-dir`: Data directory for storage (default: ./x-storage)

## License

[Add your license here]