Openstack Handler

This project is gRPC server for OpenStack cloud services on NTNU. This is also a microservice for deploying nodes/inrastructure defined in the SDL to the Openstack environment.

Development

We would suggest to use the provided devcontainer configuration for development. This will ensure that the development environment is consistent across all developers. However, if you are not using the devcontainer, you can follow the following steps to setup the development environment.

Requirements

1. UV by astral for dependency management

2. Python 3.12+ and Python Virtual Environment Package

Building

Just run

make compile
make install

N.B. If you are using ubnutu22.04 run apt install python3-cachecontrol

Running

This project uses uv for dependency management. To run the project, you need to use the following command for their respective handlers (building is required before running the handlers):

Check the .env files for the environment variables and configurations.

• Machiner

  uv run machiner
  

• Switcher

  uv run switcher
  

• Executor

  uv run executor
  

• Templater

  uv run templater
  

• General

  uv run general
  

Testing

Just run

make test-report