setup-forgejo/action.yml

# SPDX-License-Identifier: MIT
name: 'Setup Forgejo'
author: 'Forgejo authors'
description: |
  Setup Forgejo and a runner.

  The forgejo-test-helper.sh script is available to help test and debug actions.

  `forgejo=http://root:admin1234@${{ steps.forgejo.outputs.host-port }}`

  * `forgejo-test-helper.sh push_self_action $forgejo root myaction vTest`
    Creates the repository `$forgejo/root/myaction` and populates it with the
    content of the repository under test, except for the `.forgejo` directory
    (it would otherwise create an infinite loop). The tag `vTest` is
    set to the SHA under test.
  * `forgejo-test-helper.sh run_workflow testrepo $forgejo root testrepo myaction`
    Creates the repository `$forgejo/root/testrepo` and populates it with the
    content of the `testrepo` directory. All occurrences of `SELF` in
    `testrepo/.forgejo/workflows/*.yml` are replaced with `$forgejo/root/myaction`.
  * `forgejo-test-helper.sh push testrepo $forgejo root testrepo`
    Creates the repository `$forgejo/root/testrepo` and populates it with the
    content of the `testrepo` directory. The SHA of the tip of the repository
    is in the output, on a line starting with `sha=`.
  * `forgejo-test-helper.sh build_runner $forgejo/forgejo/runner v3.0.0`
    Builds the forgejo runner from source in `./forgejo-runner/forgejo-runner`.
    `export PATH=$(pwd)/forgejo-runner:$PATH` will ensure that calling `forgejo-runner.sh`
    will use this binary instead of downloading a released version of the runner.
    If the version is not specified, build from the main branch.

  The combination of `push_self_action` and `run_workflow` allows to
  run Forgejo Actions workflows from `testrepo` that use the action
  under test (`myaction`) to verify it works as intended.

  The [forgejo-curl.sh](https://code.forgejo.org/forgejo/forgejo-curl#forgejo-curlsh)
  script is logged in the instance and ready to be used with web or api endpoints.

inputs:
  image:
    description: 'Container image'
    default: 'codeberg.org/forgejo/forgejo'
  image-version:
    description: 'Container image version'
    default: '1.20'
  user:
    description: 'Administrator user name'
    default: 'root'
  password:
    description: 'Administrator password'
    default: 'admin1234'
  runner:
    description: 'Runner git repository'
    default: 'https://code.forgejo.org/forgejo/runner'
  runner-version:
    description: 'Runner version'
    default: 'v2.5.0'
  container:
    description: 'Name of the container running the Forgejo instance'
    default: 'forgejo'
  lxc-ip-prefix:
    description: 'Class C IP prefix used by LXC'
    default: '10.0.23'
outputs:
  url:
    description: "URL of the Forgejo instance"
    value: "${{ steps.forgejo.outputs.url }}"
  host-port:
    description: "Host and port of the Forgejo instance, e.g 172.0.17.2:3000"
    value: "${{ steps.forgejo.outputs.host-port }}"
  token:
    description: "Administrator application token with all,sudo scopes"
    value: "${{ steps.forgejo.outputs.token }}"
  runner-logs:
    description: "Filename of the Forgejo runner logs"
    value: "${{ steps.forgejo.outputs.runner-logs }}"
  runner-file:
    description: "Path to the runner file"
    value: "${{ steps.forgejo.outputs.runner-file }}"

runs:
  using: "composite"
  steps:
    - run: echo "${{ github.action_path }}" >> $GITHUB_PATH
      shell: bash
    - uses: actions/checkout@v3
    - id: forgejo
      run: |
        cd $(mktemp -d)
        cp ${{ github.action_path }}/runner-config.yaml .
        LXC_IP_PREFIX=${{ inputs.lxc-ip-prefix }} forgejo-dependencies.sh
        export CONTAINER=${{ inputs.container }}
        forgejo.sh setup ${{ inputs.user }} "${{ inputs.password }}" ${{ inputs.image }} ${{ inputs.image-version }}
        forgejo-runner.sh setup ${{ inputs.runner }} ${{ inputs.runner-version }} http://$(cat forgejo-ip):3000/
        echo url="http://$(cat forgejo-ip):3000" >> $GITHUB_OUTPUT
        echo host-port="$(cat forgejo-ip):3000" >> $GITHUB_OUTPUT
        echo token=$(cat forgejo-token) >> $GITHUB_OUTPUT
        echo runner-logs="$(pwd)/forgejo-runner.log" >> $GITHUB_OUTPUT
        echo runner-file="$(pwd)/.runner" >> $GITHUB_OUTPUT
      shell: bash