Eclipse BaSyx Python SDK - HTTP Server

This repository contains a Dockerfile to spin up an exemplary HTTP/REST server following the Specification of the AAS Part 2 API with ease. The server currently implements the following interfaces:

• Asset Administration Shell Repository Service
• Submodel Repository Service

It uses the HTTP Adapter and the Local-File Backend of the BaSyx Python SDK, which allows server-side data to be stored persistently across container restarts.

Building

The container image can be built via:

$ docker buildx build -t basyx-python-sdk-http-server .

Running

Because the server uses the Local-File Backend, the container needs to be provided with the directory /storage to store AAS and Submodel JSON files. This directory can be mapped via the -v option from another image or a local directory. To map the directory storage inside the container, -v ./storage:/storage can be used. The directory storage will be created in the current working directory, if it doesn't already exist.

The HTTP server inside the container listens on port 80 by default. To expose it on the host on port 8080, use the option -p 8080:80 when running it.

Putting it all together, the container can be started via the following command:

$ docker run -p 8080:80 -v ./storage:/storage basyx-python-sdk-http-server