vterdunov / janna-api

Janna provides a REST API interface for some ESXi/vSphere functions

janna-api

Janna provides a REST API interface for some VMware/vSphere functions. Like deploy Virtual Machnine from OVA, manage snapshots.

Quick start

• Choose a docker tag
• Pull image docker pull vterdunov/janna-api:<tag>
• Pass desired environment variables using --env or --env-file directives. And run it:

docker run -d --name=janna-api --env-file=envfile vterdunov/janna-api:<tag>

Configuration

Janna accept environment variables as its config.
See available environment variables examples in .env.example. E.g.:

export VMWARE_URL=username:[e-mail]
export VMWARE_INSECURE=1
export VMWARE_DATACENTER=DC1
export VMWARE_FOLDER=DevVMs

Development

• Install Go v1.11+ environment.

• Copy cp .env.example .env and change env file.

• Compile and Run

make run

or using Docker and Docker Compose

make dc

Run make help to additional useful commands.

API docs

See OpenAPI file