docs: ci: Simplify versioning, add entrypoint

The painpoint of the runner name now resolves internally, and the
entrypoint defaults to bash (most users usage), then append to the
systemd run command.

Signed-off-by: Jorge Marques <jorge.marques@analog.com>

Author: gastmaier

docs/ci.rst

@@ -303,7 +303,7 @@ To build the container image, use your favorite container engine from the
     * ci
       main
    $alias container=podman # or docker, ...
-   $container build --tag adi/linux:v4 container
+   $container build --tag adi/linux:latest container
 
 You may want to build the container in a host, where you have all your tools installed,
 and then deploy to a server.
@@ -315,7 +315,7 @@ In this case, export the image and then import on the server:
    :group: host
 
    ~/linux
-   $container save -o adi-linux.tar adi/linux:v4
+   $container save -o adi-linux.tar adi/linux:latest
    $scp adi-linux.tar server:/tmp/
 
 .. shell::
@@ -334,7 +334,7 @@ Or if you are feeling adventurous:
    :group: host
 
    ~/linux
-   $container save adi/linux:v4 | ssh server "cat - | podman load"
+   $container save adi/linux:latest | ssh server "cat - | podman load"
 
 .. _interactive-run:
 
@@ -351,7 +351,7 @@ You can use it to compile/runs checks using persistent cache, for example:
 .. shell::
 
    ~/linux
-   $cr adi/linux:v4
+   $cr adi/linux:latest
    $set_arch gcc_aarch64
     ARCH=arm64
     CXX=gcc-14
@@ -379,7 +379,7 @@ Or:
 .. shell::
 
    ~/linux
-   $cr adi/linux:v4
+   $cr adi/linux:latest
    $base_sha=@~2
    $check_checkpatch
     checkpatch on range @~6..@
@@ -398,7 +398,7 @@ Remember to replace ``container_engine`` variable with your preferred container
    .. shell::
 
       ~/linux
-      $cr adi/linux:v4
+      $cr adi/linux
        Remote 'public' matches 'analogdevicesinc', and has branch 'ci'.
        Fetch (y/n)? y
        Fetching branch 'ci'...
@@ -487,7 +487,7 @@ is ignored and a new one is requested.
    $    --secret public_linux_org_repository,type=env,target=org_repository \
    $    --secret public_linux_runner_token,type=env,target=runner_token \
    $    --env runner_labels=v1,big_cpu \
-   $    adi/linux:v4
+   $    adi/linux
 
 .. collapsible:: Docker alternative
 
@@ -502,7 +502,7 @@ is ignored and a new one is requested.
       $    --env public_linux_org_repository=$(gpg --quiet --batch --decrypt /run/secrets/public_linux_org_repository.gpg) \
       $    --env public_linux_runner_token=$(gpg --quiet --batch --decrypt /run/secrets/public_linux_runner_token.gpg) \
       $    --env runner_labels=v1,big_cpu \
-      $    localhost/adi/linux:v4
+      $    localhost/adi/linux
 
 The environment variable runner_labels (comma-separated), set the runner labels.
 If not provided on the Containerfile as ``ENV runner_labels=<labels,>`` or as argument
@@ -541,12 +541,10 @@ Below is a suggested systemd service at *~/.config/systemd/user/container-public
              --secret public_linux_org_repository,type=env,target=org_repository \
              --secret public_linux_runner_token,type=env,target=runner_token \
              --conmon-pidfile %t/%n-pid --cidfile %t/%n-cid \
+             --entrypoint="/usr/local/bin/entrypoint.sh" \
              --label "io.containers.autoupdate=local" \
              --name=public_linux_%i \
-             --memory-swap=20g \
-             --memory=16g \
-             --cpus=4 \
-             -d adi/linux:v4 top
+             -d adi/linux:latest top
    ExecStop=/bin/sh -c "/bin/podman stop -t 300 $(cat %t/%n-cid) && /bin/podman rm $(cat %t/%n-cid)"
    ExecStopPost=/bin/rm %t/%n-pid %t/%n-cid
    TimeoutStopSec=600
@@ -556,6 +554,12 @@ Below is a suggested systemd service at *~/.config/systemd/user/container-public
    [Install]
    WantedBy=multi-user.target
 
+Other tuning options include:
+
+* `--memory-swap=20g`: Limit SWAP usage.
+* `--memory=16g`: Limit RAM usage.
+* `--cpus=4`: Limit number of CPUs.
+
 .. collapsible:: Docker alternative
 
    .. code:: systemd
@@ -573,13 +577,14 @@ Below is a suggested systemd service at *~/.config/systemd/user/container-public
                 --env org_repository=$(gpg --quiet --batch --decrypt /run/secrets/public_linux_org_repository.gpg) \
                 --env runner_token=$(gpg --quiet --batch --decrypt /run/secrets/public_linux_runner_token.gpg) \
                 --cidfile %t/%n-cid \
+                --entrypoint="/usr/local/bin/entrypoint.sh" \
                 --label "io.containers.autoupdate=local" \
                 --name=public_linux_%i \
                 --memory-swap=20g \
                 --memory=16g \
                 --cpus=4 \
                 --log-driver=journald \
-                -d localhost/adi/linux:v4 top"
+                -d localhost/adi/linux:latest top"
       RemainAfterExit=yes
       ExecStop=/bin/sh -c "/bin/docker stop -t 300 $(cat %t/%n-cid) && /bin/docker rm $(cat %t/%n-cid)"
       ExecStopPost=/bin/rm %t/%n-cid