CDN service

Link to the original project

Components

Auth service

Check the documentation here.

CDN API service

Check the documentation here.

Video Converter service

Check the documentation here.

Stream API service

Check the documentation here.

Service ports mappings for the local development

0. auth: port 8001
1. cdn_api: port 8002
2. stream_api: port 8003

HOW TO

HOW TO START

1. Run dev docker compose:

   sh ./scripts/dev.sh up
   

2. Set up each service following docs from this section.

HOW TO USE

1. Create user with superuser privileges following the docs.
2. Sign in at Auth service to get JWT credentials. Save access JWT, you will need it later.

   curl --location 'http://localhost:8001/api/v1/auth/signin' \
   --header 'Content-Type: application/x-www-form-urlencoded' \
   --data-urlencode 'username=superuser' \
   --data-urlencode 'password=Qwerty123'
   

3. Upload video via CDN API service. Save id of a task to check its status later.

   curl --location 'http://localhost:8002/api/v1/upload?video_id=c1efb7fe-d8a1-45ee-b939-e7c4df8cd666' \
   --form 'file=@"/Users/superuser-name/short_movie.mp4"'
   

4. The video upload and processing has been started. Check the status via CDN API service:

   curl --location 'http://localhost:8002/api/v1/tasks/119a5b2e-990e-4ae8-b666-aedacde78bc5'
   

   Once the status is done, go to the next step.
5. Get a video manifest file (.m3u8) via Stream API using your access token:

   curl --location 'http://localhost:8003/api/v1/hls/manifest/c1efb7fe-d8a1-45ee-b939-e7c4df8cd666' \
   --header 'Authorization: ACCESS_TOKEN'
   

How to run production version in docker?

1. copy cdn_api, stream_api, video_converter .env.prod.example into .env.prod in the same folders
2. copy ./docker/.env.prod.example into ./docker/.env.prod
3. execute set -a && source ./docker/.env.prod
4. execute ./scripts/prod.sh up
5. go to localhost:9001 and login with minio credentials from env file and generate new minio access key
6. replace minio keys in .env.prod files in cdn_api, stream_api, video_converter
7. down the server ./scripts/prod.sh down
8. restart the server ./scripts/prod.sh up
9. connect to auth container - run migrations, create superuser. (instruction can be found in docs for auth service)
10. Now everything is ready to consume api. Learn docs and have fun :)