---
# =============================================================================
# Gitea Act Runner - Role Default Variables
# =============================================================================
#
# This file defines configurable variables for the act_runner role.
# Override these in group_vars/all.yml or inventory host_vars as needed.
#
# REQUIRED VARIABLES (must be set in vault - not defined here):
#   - gitea_instance_url    : URL of your Gitea instance
#   - act_runner_token      : Registration token from Gitea
#   - gitea_packages_token  : PAT for package registry access
#   - gitea_registry        : Package registry hostname
#   - gitea_actions_user    : Service account username
#
# See group_vars/vault.yml.example for how to set these secrets.
# See: https://docs.gitea.com/usage/actions/act-runner
# =============================================================================

# -----------------------------------------------------------------------------
# Act Runner Binary Configuration
# -----------------------------------------------------------------------------

# Version of act_runner to install.
# Check available versions at: https://dl.gitea.com/act_runner/
# Format: semantic version string without 'v' prefix.
act_runner_version: "0.2.13"

# Target CPU architecture for the binary download.
# Valid values: "amd64" (x86_64), "arm64" (aarch64)
act_runner_arch: "amd64"

# Whether to verify SHA256 checksum after downloading the binary.
# STRONGLY RECOMMENDED: Leave as true for security.
act_runner_verify_checksum: true

# Filesystem path where the act_runner binary will be installed.
# /usr/local/bin is the standard FHS location for locally installed binaries.
act_runner_bin_path: "/usr/local/bin/act_runner"

# -----------------------------------------------------------------------------
# System User Configuration
# -----------------------------------------------------------------------------

# Unix username for running the act_runner service.
# Will be created as a system user if it doesn't exist.
act_runner_user: "act_runner"

# Unix group for the act_runner user.
act_runner_group: "act_runner"

# Home directory for the act_runner user.
# Stores: .runner file, cache, working directories.
act_runner_home: "/home/act_runner"

# Directory for act_runner configuration files.
# Stores: config.yaml
act_runner_config_dir: "/etc/act_runner"

# -----------------------------------------------------------------------------
# Node.js Configuration
# -----------------------------------------------------------------------------

# Node.js major version to install via NodeSource.
# Required for JavaScript-based GitHub Actions.
# Valid values: "18", "20", "22", "24"
# See: https://nodejs.org/en/about/previous-releases
act_runner_nodejs_version: "24"

# -----------------------------------------------------------------------------
# Runner Configuration
# -----------------------------------------------------------------------------

# Human-readable name for this runner instance.
# Displayed in Gitea UI under Actions > Runners.
# Default: server's hostname
act_runner_name: "{{ ansible_facts['hostname'] }}"

# Labels determine which jobs this runner can execute.
# Format: "label-name:executor"
# Executors:
#   - "host"           : Run directly on the host system
#   - "docker://image" : Run in Docker container
#
# Examples:
#   - "ubuntu-latest:host"
#   - "ubuntu-latest:docker://node:24"
#   - "self-hosted:host"
act_runner_labels:
  - "ubuntu-latest:host"

# -----------------------------------------------------------------------------
# Container Behavior
# -----------------------------------------------------------------------------

# Whether to always pull container images before running jobs.
# true:  Ensures latest image (recommended for CI/CD)
# false: Uses cached image if available (faster)
act_runner_container_force_pull: true