Metropolis Microservices/RidgeRun Services/PTZ: Difference between revisions

You can run this microservice with the following command:

docker run --runtime nvidia -it --privileged --net=host --ipc=host --name ptz-service  ridgerun/ptz-service:latest --host=0.0.0.0

This will run PTZ in port 5020

For convenience, a docker image is available in dockerhub which as of today is available for Jetpack 6.0. Use the following command to pull it.

docker pull ridgerun/ptz-service

====Build your image (Dockerfile)====

You can get the source code with the following command:

git clone https://gitlab.ridgerun.com/open/ridgerun-microservices/ptz.git

First, we need to prepare the context directory for this build, please create a directory and include all the necessary repositories (listed below). The Dockerfile will look for all the source code in the context directory and copy them to the container.

Then build the container image running the the following command from the folder containing the Dockerfile and context directory:

sudo docker build \

--network=host \

-f Dockerfile \

-t ridgerun/ptz-service:latest ptz-context/

Change '''ptz-context''' to your context's path and the tag (-t) to the name you want to give to your image.

Here we are creating a container called '''ptz-service''' that will start the ptz-service application in the default address and port and use the default output resolution. If a different address, port, or output resolution has to be used, you can do it by running:

sudo docker run --runtime nvidia -it --privileged --net=host --ipc=host --name ptz-service  ridgerun/ptz-service:latest --host=HOST --port=PORT --ptz-window-size=PTZ_WINDOW_SIZE

===As a standalone application===

The project is configured (via setup.py) to install the service with the name '''ptz'''. So to install it run:

cd ptz

pip install .

Then you will have the service with the following options:

usage: ptz [-h] [--port PORT] [--host HOST] [--ptz-window-size PTZ_WINDOW_SIZE]

   --ptz-window-size PTZ_WINDOW_SIZE

                         Size of the PTZ output window in pixels. The final resolution will be (Size x Size)

After this, the service will be available under the name '''ptz'''.

You can get and install '''rrms-utils''' by running:

git clone https://gitlab.ridgerun.com/open/ridgerun-microservices/rrms-utils.git

cd rrms-utils

pip install .

}}