Network

Networkd

Service: network-setup.service

This service is responsible for managing the different network interfaces attached to the gateway, and automatically attach them to one of the following networks:

  • Public: NICs connected to the rest of the world * Criteria: Ethernet NICs that already have an IP address set

  • Private (bridge): NICs connected to the test machines * Criteria: Ethernet NICs that do not have an IP address set

  • Management (bridge): NICs connected to support hardware (such as PDUs), and administrators (wireguard) * Criteria: WiFi NICs, and user-configured NICs

Configuration

It is possible to override some of networkd’s automatic decisions by setting the following environment variables in /config/config.env:

  • NET_MGMT_STATIC_ALLOC=: A comma-separated list of the MAC addresses of NICs that should be attached to the management network

Ddclient: dynamic DNS

Service: ddclient.service

Most CI-tron instances are likely to be hosted on dynamic IP addresses. This service allows users to setup dynamic DNS, so as to always be able to connect back to their gateway.

Configuration

The configuration file for the service is located at /config/ddclient/ddclient.conf.

You may base its content on the upstream sample configuration file located at /etc/ddclient.conf, then refer to the official documentation for more details.

Once you are done editing the configuration, restart the service systemctl restart ddclient.

WireGuard VPN

Service: wg-quick@wg0

CI-Tron provides built-in support for the WireGuard VPN access to the gateway. The /config/wireguard/wg0.conf file provides configuration for the service. By default it uses port 51820 and a keypair which is generated per machine and stored under the same directory.

In order to enable access to the gateway, add the Peer section to the mentioned config file:

[Peer]
PublicKey = your-public-key-in-base64-format============
AllowedIPs = 10.42.100.2/32

After that restart the service by running systemctl restart wg-quick@wg0.