This merge request aims to enhance the usability and standardization of the rcssserver by introducing the automatic build and release of its latest AppImage and DockerImage versions on GitHub. This will simplify the process for RoboCup users to download and run the rcssserver, while also providing an official version to standardize tournament runs on Docker.
This merge request includes the following files for the automatic AppImage release:
.github/workflows/main.yml : This is the GitHub action pipeline designed to build the AppImage and publish the release.
utils/appimage/*: This directory contains all files related to the AppImage building, including:
utils/appimage
├── build_appimage.sh -> Bash script for building the AppImage.
├── build_code.sh -> Bash script for building the code.
├── Dockerfile.builder-1804 -> Docker image for building the AppImage, based on Ubuntu 18.04.
├── Dockerfile.builder-2004 -> Docker image for building the AppImage, based on Ubuntu 20.04.
├── Dockerfile.builder-2404 -> Docker image for building the AppImage, based on Ubuntu 24.04.
├── rcssmonitor.desktop -> Desktop file of rcssserver.
└── rcssmonitor.png -> Image of rcssmonitor.
This merge request also includes the following files for the automatic Docker release:
.github/workflows/main.yml : This is the GitHub action pipeline designed to build the Docker image and publish the release.
utils/docker/*: This directory contains all files related to the Docker image building, including:
utils/docker
├── docker-entrypoint.sh -> Main script that runs when the rcssserver Docker image is executed.
├── Dockerfile -> Blueprint for building the Docker image of rcssserver.
└── README.md -> Readme file to be published along with the release on the Docker Hub website.
Release Pipeline Usage
The automatic pipeline will skip creating a release if the release name already exists in the GitHub releases. To create a new release:
Update the application version in the CMakeLists.txt file.
Push your changes, which will trigger the release creation.
You can use the AppImage after each push to the registry to verify the correctness of your proposed changes.
Prerequisites for Pipeline Functionality
An official DockerHub account is needed for pushing our Docker file.
The following secrets need to be added to the GitHub project secrets:
DOCKERHUB_USERNAME -> Docker Hub username.
DOCKERHUB_TOKEN -> Token from Docker Hub.
BASE_IMAGE inside the .github/workflows should be updated to the DockerHub project path of the new image.
Manual Docker Image Build Instructions
Clone the project and navigate to the project directory.
Run the following command to build the Docker image:
docker build -f utils/docker/Dockerfile -t rcssserver:latest .
# You can replace `rcssserver:latest` with your preferred image name.
# For example, to publish it on my own Docker Hub, I can change it to `sadraiiali/rcssserver:latest`.
After building the image, you can publish it to Docker Hub using the following commands:
# First, login to Docker Hub.
docker login
# Then, push the image to Docker Hub.
docker push sadraiiali/rcssserver:latest
If you want to run the Docker image, use the following command:
docker run -it --rm --network host rcssserver:latest
Manual AppImage Build Instructions
Clone the project and navigate to the project directory.
Overview
This merge request aims to enhance the usability and standardization of the rcssserver by introducing the automatic build and release of its latest AppImage and DockerImage versions on GitHub. This will simplify the process for RoboCup users to download and run the rcssserver, while also providing an official version to standardize tournament runs on Docker.
AppImage Release Details
https://github.com/rcsoccersim/rcssserver/assets/23504332/13e02c5f-b671-4ef0-8d1f-23a99a00884e
This merge request includes the following files for the automatic AppImage release:
.github/workflows/main.yml: This is the GitHub action pipeline designed to build the AppImage and publish the release.utils/appimage/*: This directory contains all files related to the AppImage building, including:Docker Release Details
https://github.com/rcsoccersim/rcssserver/assets/23504332/fb3506eb-af36-4dbe-b239-fab95495f179
This merge request also includes the following files for the automatic Docker release:
.github/workflows/main.yml: This is the GitHub action pipeline designed to build the Docker image and publish the release.utils/docker/*: This directory contains all files related to the Docker image building, including:Release Pipeline Usage
The automatic pipeline will skip creating a release if the release name already exists in the GitHub releases. To create a new release:
CMakeLists.txtfile.You can use the AppImage after each push to the registry to verify the correctness of your proposed changes.
Prerequisites for Pipeline Functionality
DOCKERHUB_USERNAME-> Docker Hub username.DOCKERHUB_TOKEN-> Token from Docker Hub.BASE_IMAGEinside the.github/workflowsshould be updated to the DockerHub project path of the new image.Manual Docker Image Build Instructions
Manual AppImage Build Instructions
buildfolder.Additional Resources