main.yml

name: build-and-deploy

# Controls when the workflow will run
on:
  # Triggers the workflow on push events but only for the default branch
  push:
    branches: [ main ]

  # Allows you to run this workflow manually from the Actions tab
  workflow_dispatch:

# A workflow run is made up of one or more jobs that can run sequentially or in parallel
jobs:
  # This workflow contains a single job called "build"
  build_and_deploy_s3:
    # The type of runner that the job will run on
    runs-on: ubuntu-24.04-arm

    # Required so the workflow can push changes back to the repo
    permissions:
      contents: write

    # Steps represent a sequence of tasks that will be executed as part of the job
    steps:
      # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
      - uses: actions/checkout@v4
        with:
          submodules: true  # Fetch Hugo Themes
          fetch-depth: 0 

      # Sets up Git author so commits from Actions are attributed correctly
      - name: Set up Git author
        run: |
          git config user.name "github-actions[bot]"
          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"

      # Sets Up Hugo
      - name: Setup Hugo
        uses: peaceiris/actions-hugo@v3
        with:
          hugo-version: '0.130.0'
          extended: true

      # Runs pre-processing Python scripts to ensure:
      # (1) date accuracy,
      # (2) category descriptions are always up-to-date,
      # (3) the packages have valid categories
      - name: Python pre-processing
        run: |
          python --version
          python ./build_steps/update_category_mappings.py
          python ./build_steps/update_recently_added_json.py
          python ./build_steps/validate_package_catagories.py

      # Debug step to confirm Windows category data is generated correctly
      - name: Debug Windows file after generation
        run: |
          echo "---- ls data ----"
          ls -l ./data
          echo "---- windows file ----"
          cat ./data/category_data_windows.yml || true
          echo "---- git status ----"
          git status --short
          echo "---- git diff for windows file ----"
          git diff -- data/category_data_windows.yml || true

      # Builds arm-software-developer repo
      - name: Build
        run: hugo --minify --config config.toml,config.cloudfront.toml

      # Deploys website to AWS S3
      - name: Deploy to S3
        run: hugo deploy --force --maxDeletes -1 --invalidateCDN --config config.toml,config.cloudfront.toml
        env:
          AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
          AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}

      # Commits only the Windows category data file back to the repository if it has changed
      - name: Commit Windows category data only
        run: |
          git add data/category_data_windows.yml

          git diff --cached --quiet && echo "No changes to commit" && exit 0

          git commit -m "Update Windows category data [skip ci]"
          git push