raspberry-pi.yaml

name: Build and test on Virtualized Raspberry Pi OS

on:
  push:
    branches: [ master, develop ]
  pull_request:
    branches: [ master, develop ]

jobs:
  build:
    runs-on: ubuntu-22.04
    timeout-minutes: 30
    permissions:
      id-token: write
      contents: read
    strategy:
      matrix:
        include:
          # Debian 11
          - os: bullseye
            image: ghcr.io/dtcooper/raspberrypi-os:python3.12-bullseye@sha256:72311cfece0656c91407b4fd982f5aaf0eded0fee477de58281e82ab67f4478f
          # Debian 12
          - os: bookworm
            image: ghcr.io/dtcooper/raspberrypi-os:python3.12-bookworm@sha256:0632946b7dc03ec3d9f7aeef9df4287affb3d6fe413f0e5dfd11c2b73466a845
      fail-fast: false

    name: Build on ${{ matrix.os }}
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Set up QEMU
        uses: docker/setup-qemu-action@v3
        with:
          image: tonistiigi/binfmt:qemu-v7.0.0-28

      - name: Set up Docker Buildx
        uses: docker/setup-buildx-action@v3

      - name: Configure AWS Credentials
        uses: aws-actions/configure-aws-credentials@v4
        with:
          role-to-assume: ${{ secrets.AWS_ROLE_TO_ASSUME }}
          role-session-name: ${{ secrets.AWS_ROLE_SESSION_NAME }}
          aws-region: ${{ secrets.AWS_REGION }}
          role-duration-seconds: 10800

      - name: Build and Test
        env:
          AWS_KVS_LOG_LEVEL: 2
        run: |
          docker run --rm -v ${{ github.workspace }}:/workspace -w /workspace \
            -e AWS_ACCESS_KEY_ID -e AWS_SECRET_ACCESS_KEY \
            -e AWS_SESSION_TOKEN -e AWS_REGION -e AWS_KVS_LOG_LEVEL \
            --platform linux/arm64 \
            ${{ matrix.image }} \
            /bin/bash -c '
              set -ex
              apt-get update
              apt-get install -y automake build-essential cmake git \
                gstreamer1.0-plugins-base-apps gstreamer1.0-plugins-bad \
                gstreamer1.0-plugins-good gstreamer1.0-plugins-ugly \
                gstreamer1.0-tools gstreamer1.0-omx-generic \
                libcurl4-openssl-dev libgstreamer1.0-dev \
                libgstreamer-plugins-base1.0-dev liblog4cplus-dev \
                libssl-dev pkg-config

              mkdir -p build
              cd build

              cmake .. -DBUILD_GSTREAMER_PLUGIN=ON -DBUILD_DEPENDENCIES=OFF -DALIGNED_MEMORY_MODEL=ON
              if [ $? -ne 0 ]; then
                echo "CMake configuration failed!"
                exit 1
              fi

              echo "Listing contents of build directory:"
              ls -l
          
              # Running 'make' under QEMU inside GitHub Actions has shown instability,
              # with random segmentation faults occurring sporadically. This could be 
              # due to QEMU's emulation overhead, memory constraints, or transient 
              # issues in the GitHub-hosted environment. To mitigate these failures, 
              # we retry the build up to 5 times before considering it a hard failure.

              max_retries=5
              attempt=0
              while [ $attempt -lt $max_retries ]; do
                attempt=$((attempt + 1))
                echo "Attempt $attempt of $max_retries..."

                set +e  # Temporarily disable exit on error
                make
                exit_code=$?
                set -e  # Re-enable exit on error
              
                if [ $exit_code -eq 0 ]; then
                  break
                fi
              
                echo "Build failed with exit code $exit_code - retrying..."
                sleep 5
              done
              
              if [ $exit_code -ne 0 ]; then
                echo "Build failed after $max_retries attempts."
                exit 1
              fi

              export GST_PLUGIN_PATH=$(pwd)

              set +e  # Disable exit on error for the timeout command
              timeout --preserve-status --signal=SIGINT --kill-after=15s 30s \
                gst-launch-1.0 -v videotestsrc is-live=true \
                ! video/x-raw,framerate=10/1,width=640,height=480 \
                ! clockoverlay time-format="%a %B %d, %Y %I:%M:%S %p" \
                ! x264enc bframes=0 key-int-max=10 tune=zerolatency \
                ! h264parse \
                ! kvssink stream-name="cpp-producer-rpi-${{ matrix.os }}"
              EXIT_CODE=$?
              set -e  # Re-enable exit on error

              # 0: Process exited after interrupt with code 0
              # 1: Process exited with error code 1
              # 137: Process killed by SIGKILL (if the --kill-after timeout is reached)
              echo "Command exited with code: $EXIT_CODE"
              if [ $EXIT_CODE -ne 0 ]; then
                echo "Command did not exit gracefully after interrupt."
                exit 1
              fi
            '