## @section Act Runner

## @param gitea_runner_config_file Path to the gitea_runner configuration file
gitea_runner_config_file: /etc/gitea_runner/config.yaml

gitea_runner_config:
  log:
    ## @param gitea_runner_config.log.level The level of logging, can be trace, debug, info, warn, error, fatal
    level: info

  runner:
    ## @param gitea_runner_config.runner.file Where to store the registration result
    file: .runner
    ## @param gitea_runner_config.runner.capacity Execute how many tasks concurrently at the same time
    capacity: 1
    ## @param gitea_runner_config.runner.envs Extra environment variables to run jobs
    envs: {}
    #  A_TEST_ENV_NAME_1: a_test_env_value_1
    #  A_TEST_ENV_NAME_2: a_test_env_value_2
    ## @param gitea_runner_config.runner.env_file Extra environment variables to run jobs from a file
    env_file: .env
    ## @param gitea_runner_config.runner.timeout The timeout for a job to be finished
    timeout: 3h
    ## @param gitea_runner_config.runner.shutdown_timeout The timeout for the runner to wait for running jobs to finish when shutting down
    shutdown_timeout: 0s
    ## @param gitea_runner_config.runner.insecure Whether skip verifying the TLS certificate of the Gitea instance
    insecure: false
    ## @param gitea_runner_config.runner.fetch_timeout The timeout for fetching the job from the Gitea instance
    fetch_timeout: 5s
    ## @param gitea_runner_config.runner.fetch_interval The interval for fetching the job from the Gitea instance
    fetch_interval: 2s
    ## @param gitea_runner_config.runner.fetch_interval_max The maximum interval for fetching the job from the Gitea instance.
    fetch_interval_max: 5s
    ## @param gitea_runner_config.runner.workdir_cleanup_age The maximum interval for fetching the job from the Gitea instance.
    workdir_cleanup_age: 24h
    ## @param gitea_runner_config.runner.idle_cleanup_interval Cadence for the idle stale bind-workdir cleanup pass.
    idle_cleanup_interval: 10m
    ## @param gitea_runner_config.runner.log_report_interval The base interval for periodic log flush to the Gitea instance.
    log_report_interval: 5s
    ## @param gitea_runner_config.runner.log_report_max_latency The maximum time a log row can wait before being sent.
    log_report_max_latency: 3s
    ## @param gitea_runner_config.runner.log_report_batch_size Flush logs immediately when the buffer reaches this many rows.
    log_report_batch_size: 100
    ## @param gitea_runner_config.runner.state_report_interval The interval for reporting task state (step status, timing) to the Gitea instance.
    state_report_interval: 5s
    ## @param gitea_runner_config.runner.github_mirror The mirror address of the github that pulls the action repository
    github_mirror: ''
    ## @param gitea_runner_config.runner.labels The labels of a runner are used to determine which jobs the runner can run
    labels:
    - "ubuntu-latest:docker://docker.gitea.com/runner-images:ubuntu-latest"
    - "ubuntu-22.04:docker://docker.gitea.com/runner-images:ubuntu-22.04"
    - "ubuntu-20.04:docker://docker.gitea.com/runner-images:ubuntu-20.04"
    ## @param gitea_runner_config.runner.allocate_pty TODO
    allocate_pty: false

  cache:
    ## @param gitea_runner_config.cache.enabled Enable cache server to use actions/cache
    enabled: true
    ## @param gitea_runner_config.cache.dir The directory to store the cache data
    dir: ""
    ## @param gitea_runner_config.cache.host The host of the cache server
    host: ""
    ## @param gitea_runner_config.cache.port The port of the cache server
    port: 0
    ## @param gitea_runner_config.cache.external_server The external cache server URL
    external_server: ""
    ## @param gitea_runner_config.cache.external_secret Shared secret between this runner and the external `gitea-runner cache-server`.
    external_secret: ""
    ## @param gitea_runner_config.cache.offline_mode When true, reuse a cached action instead of fetching from the remote on every job.
    offline_mode: false

  container:
    ## @param gitea_runner_config.container.network Specifies the network to which the container will connect
    network: ""
    ## @param gitea_runner_config.container.privileged Whether to use privileged mode when launching task containers
    privileged: false
    ## @param gitea_runner_config.container.options Other options to be used when the container is started
    options:
    ## @param gitea_runner_config.container.workdir_parent The parent directory of a job's working directory
    workdir_parent:
    ## @param gitea_runner_config.container.valid_volumes Volumes that can be mounted to containers
    valid_volumes: []
    ## @param gitea_runner_config.container.docker_host Overrides the docker client host with the specified one
    docker_host: ""
    ## @param gitea_runner_config.container.force_pull Pull docker image(s) even if already present
    force_pull: true
    ## @param gitea_runner_config.container.force_rebuild Rebuild docker image(s) even if already present
    force_rebuild: false
    ## @param gitea_runner_config.container.require_docker Always require a reachable docker daemon
    require_docker: false
    ## @param gitea_runner_config.container.docker_timeout Timeout to wait for the docker daemon to be reachable
    docker_timeout: 0s

    ## @param gitea_runner_config.container.bind_workdir Bind the workspace to the host filesystem instead of using Docker volumes. This is required for Docker-in-Docker (DinD) setups when jobs use docker compose with bind mounts (e.g., ".:/app"), as volume-based workspaces are not accessible from the DinD daemon's filesystem.
    bind_workdir: false

  host:
    ## @param gitea_runner_config.host.workdir_parent The parent directory of a job's working directory
    workdir_parent:

  metrics:
    ## @param gitea_runner_config.metrics.enabled Enable exposing metrics at http://<addr>/metrics and a liveness check at /healthz.
    enabled: false
    ## @param gitea_runner_config.metrics.addr The address for the metrics HTTP server.
    addr: "127.0.0.1:9101"

## @param gitea_runner_unix_extra_groups List of additional unix groups to append the executing gitea-runner user to.
gitea_runner_unix_extra_groups: []
# - docker

## @param gitea_runner_gitea_url The URL of the Gitea instance
gitea_runner_gitea_url: ""

## @param gitea_runner_token The registration token for the gitea_runner
gitea_runner_token: ""

## @section Package Management

## @param gitea_runner_update_cache Whether to update package cache before installing packages
gitea_runner_update_cache: true