1
1
libssh/doc
Jakub Jelen 2539d72b7c Add support for PKCS#11 provider in OpenSSL 3.0
The engine API in OpenSSL 3.0 is deprecated so we are in the progress of working
on a PKCS#11 provider for OpenSSL. This commit introduces a conditional build
with the pkcs11-provider support (instead of engines) with all the changes
required for the provider to work with existing code and tests.

The CI modification is only temporary before we will have the real package in
Fedora or somewhere to use.

Signed-off-by: Jakub Jelen <jjelen@redhat.com>
Reviewed-by: Anderson Toshiyuki Sasaki <ansasaki@redhat.com>
Reviewed-by: Norbert Pocs <npocs@redhat.com>
2023-03-01 11:35:28 +01:00
..
that_style doc: Update that_style 2018-08-31 08:04:24 +02:00
authentication.dox Adds documentation about the order of processing the IdentityFiles 2021-10-11 14:00:36 +02:00
CMakeLists.txt doc/CMakeLists.txt: Exclude non-wanted symbols 2023-02-01 15:26:02 +01:00
command.dox Documentation fix where unsigned is used where signed is expected 2015-06-24 17:13:26 +02:00
curve25519-sha256@libssh.org.txt Fix various spelling issues reported by codespell 2022-10-12 13:50:38 +02:00
forwarding.dox Avoid usage of deprecated functions and whitespace cleanup 2022-06-07 14:16:59 +02:00
guided_tour.dox Remove support for DSA Keys 2023-02-02 14:49:06 +01:00
introduction.dox doc: fix up various typos and trailing whitespace 2018-10-28 12:15:02 +01:00
linking.dox doc: Fix a doxygen warning 2020-03-27 12:10:07 +01:00
mainpage.dox Remove support for DSA Keys 2023-02-02 14:49:06 +01:00
pkcs11.dox Add support for PKCS#11 provider in OpenSSL 3.0 2023-03-01 11:35:28 +01:00
README.gitlab.freebsd.md doc: Add REAMDE how to setup a freebsd gitlab runner 2021-05-27 13:25:02 +02:00
scp.dox doc: fix up various typos and trailing whitespace 2018-10-28 12:15:02 +01:00
sftp.dox sftp_get_error returns int, not char *. 2019-03-25 18:51:15 +01:00
shell.dox examples: Add 'ssh X11 client' sample 2022-05-02 20:06:22 +02:00
tbd.dox doc: Fixed doc namespace to be able to install manpages. 2010-12-05 10:53:39 +01:00
threading.dox doc: fix up various typos and trailing whitespace 2018-10-28 12:15:02 +01:00

Install a FreeBSD CI instance

Install the following packages:

pkg install -y bash git gmake cmake cmocka openssl wget pkgconf ccache bash

Create gitlab-runner user:

pw group add -n gitlab-runner
pw user add -n gitlab-runner -g gitlab-runner -s /usr/local/bin/bash
mkdir /home/gitlab-runner
chown gitlab-runner:gitlab-runner /home/gitlab-runner

Get the gitlab-runner binary for freebsd:

wget -O /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-freebsd-amd64
chmod +x /usr/local/bin/gitlab-runner

Create a log file and allow access:

touch /var/log/gitlab_runner.log && chown gitlab-runner:gitlab-runner /var/log/gitlab_runner.log

We need a start script to run it on boot:

mkdir -p /usr/local/etc/rc.d
cat > /usr/local/etc/rc.d/gitlab_runner << EOF
#!/usr/local/bin/bash
# PROVIDE: gitlab_runner
# REQUIRE: DAEMON NETWORKING
# BEFORE:
# KEYWORD:

. /etc/rc.subr

name="gitlab_runner"
rcvar="gitlab_runner_enable"

load_rc_config $name

user="gitlab-runner"
user_home="/home/gitlab-runner"
command="/usr/local/bin/gitlab-runner run"
pidfile="/var/run/${name}.pid"

start_cmd="gitlab_runner_start"
stop_cmd="gitlab_runner_stop"
status_cmd="gitlab_runner_status"

gitlab_runner_start()
{
    export USER=${user}
    export HOME=${user_home}

    if checkyesno ${rcvar}; then
        cd ${user_home}
        /usr/sbin/daemon -u ${user} -p ${pidfile} ${command} > /var/log/gitlab_runner.log 2>&1
    fi
}

gitlab_runner_stop()
{
    if [ -f ${pidfile} ]; then
        kill `cat ${pidfile}`
    fi
}

gitlab_runner_status()
{
    if [ ! -f ${pidfile} ] || kill -0 `cat ${pidfile}`; then
        echo "Service ${name} is not running."
    else
        echo "${name} appears to be running."
    fi
}

run_rc_command $1
EOF
chmod +x /usr/local/etc/rc.d/gitlab_runner

Register your gitlab-runner with your gitlab project

su gitlab-runner -c 'gitlab-runner register'

Start the gitlab runner service:

sysrc -f /etc/rc.conf "gitlab_runner_enable=YES"
service gitlab_runner start