xhs / oci-vnic-profile-initializer

Automatically generate profiles for newly added VNICs on Oracle Cloud Infrastructure (OCI)

Why

It is a shame that OCI does not automatically generate profiles for newly added VNICs.

How

Events are fired by udev when VNICs are attached.

SUBSYSTEM=="net", ACTION=="add", NAME!="", RUN+="/usr/local/bin/vnic-initializer.sh %k"
# if net.ifnames=0
SUBSYSTEM=="net", ACTION=="add", NAME=="", RUN+="/usr/local/bin/vnic-initializer.sh eth%n"

As defined in /etc/udev/rules.d/90-oci-vnic-config.rules, script vnic-initializer.sh is called accordingly with network adapter's correct name.

#!/usr/bin/env bash

# do not block udev
/usr/bin/nohup /usr/local/bin/oci-vnic-profile-initializer $1 >> /tmp/oci-vnic.log

Program oci-vnic-profile-initializer will then generate a new profile, if not already exists, according to template /etc/oci-vnic/profile.tpl.

BOOTPROTO="dhcp"
DEFROUTE="yes"
PEERDNS="yes"
PEERROUTES="yes"
IPV4_FAILURE_FATAL="no"
IPV6INIT="yes"
IPV6_AUTOCONF="yes"
IPV6_DEFROUTE="yes"
IPV6_PEERDNS="yes"
IPV6_PEERROUTES="yes"
IPV6_FAILURE_FATAL="no"
IPV6_ADDR_GEN_MODE="stable-privacy"
NAME="{{.Name}}"
UUID="{{.RandomID}}"
DEVICE="{{.Name}}"
ONBOOT="yes"

Modify this template as needed.

// Available variables in template
type VnicMetadata struct {
	VnicIndex            int
	Name                 string
	MacAddr              string
	PrivateIp            string
	SubnetMaskLength     string
	VirtualRouterIp      string
	IPv6Addresses        []string
	IPv6SubnetMaskLength string
	IPv6VirtualRouterIp  string
}

func (m *VnicMetadata) RandomID() string {
	return uuid.NewString()
}

Logs can be found in /tmp/oci-vnic.log.