feat(extras/scripts): update Transmission peer port

[juanlufont]

The script transmission-port-update.sh updates the peer port used by the torrent client Transmission using its API. The peer port is the port used and announced by Transmission to accept incoming connections. You can use this script to set a VPN forwarded port as the current listening port for Transmission.

The script uses only shell scripting and can run out of the box within the current gluetun docker image, it only relies on the command wget, which is already included by default in the image.

[ku1ik]

I've used this script and it worked on the first try. Thank you!

[ku1ik]

Just reporting that I've been using this for over a month and it's been working flawlessly 👌

[qdm12]

Thanks for the review of the PR (and the wiki PR 👍 ) Just a few minor things to do if possible 🙏 thanks!

[qdm12]

no need for the final exit 😉 (afaik)

Suggested change

exit 0

[iridial]

I did some tests in k3s with gluetun v3.40 running as initContainer for transmission, and using VPN_PORT_FORWARDING_UP_COMMAND as trigger to call the script using: '/bin/sh -c "/scripts/transmission-port-update.sh --port {{PORTS}}"'.
The transmission container takes more time to be available to receive the port forward update request, and this leads the initial call of the script to fail.
I suggest to include an initial check if transmission api service is available, and if not, retry once more after configurable timeout with /bin/sleep <value>.

[qdm12]

The transmission container takes more time to be available to receive the port forward update request, and this leads the initial call of the script to fail.

Let's add --retry-connrefused -t 3 to the wget command

[iridial]

consider wrapping this in a loop, which fails after some retries:

i=1
while [ "$i" -le $MAX_RETRIES ]; do
    # get the X-Transmission-Session-Id
    # shellcheck disable=SC2086
    SESSION_ID=$(
        wget \
            --quiet \
            ${WGET_OPTS} \
            --server-response \
            "$RPC_URL" 2>&1 |
            grep 'X-Transmission-Session-Id:' |
            awk '{print $2}'
    )
    
    if [ -n "$SESSION_ID" ]; then
        echo "Transmission available. SESSION_ID: $SESSION_ID"
        break
    else
        echo "Attempt $i of $MAX_RETRIES failed, waiting for next attempt..."
        sleep 5
    fi

    i=$(( i + 1 ))
done

[qdm12]

nit

Suggested change

	echo "Success! Transmission peer-port updated to ${PORT}"
	echo "Transmission peer-port updated to ${PORT}"