Implement __jool type.
This commit is contained in:
parent
f181b5ddb4
commit
272e4669fe
5 changed files with 156 additions and 0 deletions
76
type/__jool/man.rst
Normal file
76
type/__jool/man.rst
Normal file
|
@ -0,0 +1,76 @@
|
|||
cdist-type__jool(7)
|
||||
===================
|
||||
|
||||
NAME
|
||||
----
|
||||
cdist-type__jool - Configures a NAT64 instance using jool.
|
||||
|
||||
|
||||
DESCRIPTION
|
||||
-----------
|
||||
This type configures an instance of a NAT64 using jool. This type **does not**
|
||||
configure anything related to the other capacities of the jool project, such as
|
||||
SIIT (see the `jool_siit` daemon / `__jool_siit` type - unimplemented at this
|
||||
time). See https://jool.mx
|
||||
|
||||
Note that this type is only implemented for the Alpine Linux operating system.
|
||||
|
||||
Note that this type currently does not implement running several parallel
|
||||
instances of jool NAT64. Please contribute your implementation if you do so.
|
||||
|
||||
|
||||
REQUIRED PARAMETERS
|
||||
-------------------
|
||||
None.
|
||||
|
||||
|
||||
OPTIONAL PARAMETERS
|
||||
-------------------
|
||||
instance
|
||||
The instance name, `default` if unspecified.
|
||||
|
||||
framework
|
||||
The used translation framework, `netfilter` if unspecified.
|
||||
|
||||
pool6
|
||||
The IPv6 prefix used to map IPv4 addresses, `64:ff9b::/96` if unspecified.
|
||||
|
||||
|
||||
BOOLEAN PARAMETERS
|
||||
------------------
|
||||
vm
|
||||
Wether this instance is running in a VM or not: configures the kernel
|
||||
modules that will be installed.
|
||||
|
||||
|
||||
EXAMPLES
|
||||
--------
|
||||
|
||||
.. code-block:: sh
|
||||
|
||||
__jool # Everything default
|
||||
|
||||
# or, if you're feeling contrary
|
||||
|
||||
__jool --instance "prettysoup" \
|
||||
--framework "iptables" \
|
||||
--pool6 "2001:DB8:dead:beef::/96"
|
||||
|
||||
|
||||
SEE ALSO
|
||||
--------
|
||||
`cdist-type__jool_siit(7)` - yet to be written
|
||||
`cdist-type__joold(7)` - yet to be written
|
||||
|
||||
|
||||
AUTHORS
|
||||
-------
|
||||
Joachim Desroches <joachim.desroches@epfl.ch>
|
||||
|
||||
|
||||
COPYING
|
||||
-------
|
||||
Copyright \(C) 2021 Joachim Desroches. You can redistribute it
|
||||
and/or modify it under the terms of the GNU General Public License as
|
||||
published by the Free Software Foundation, either version 3 of the
|
||||
License, or (at your option) any later version.
|
76
type/__jool/manifest
Executable file
76
type/__jool/manifest
Executable file
|
@ -0,0 +1,76 @@
|
|||
#!/bin/sh -e
|
||||
#
|
||||
# 2021 Joachim Desroches (joachim.desroches@epfl.ch)
|
||||
#
|
||||
# This file is part of cdist.
|
||||
#
|
||||
# cdist is free software: you can redistribute it and/or modify
|
||||
# it under the terms of the GNU General Public License as published by
|
||||
# the Free Software Foundation, either version 3 of the License, or
|
||||
# (at your option) any later version.
|
||||
#
|
||||
# cdist is distributed in the hope that it will be useful,
|
||||
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
# GNU General Public License for more details.
|
||||
#
|
||||
# You should have received a copy of the GNU General Public License
|
||||
# along with cdist. If not, see <http://www.gnu.org/licenses/>.
|
||||
#
|
||||
|
||||
|
||||
os=$(cat "${__global:?}/explorer/os")
|
||||
|
||||
case "$os" in
|
||||
'alpine')
|
||||
:
|
||||
;;
|
||||
*)
|
||||
printf "This type has no implementation for %s. Please contribute one if you can.\n" "$os"
|
||||
exit 1
|
||||
;;
|
||||
esac
|
||||
|
||||
|
||||
if [ -f "${__object:?}/parameter/vm" ];
|
||||
then
|
||||
kernel_modules="jool-modules-virt"
|
||||
else
|
||||
kernel_modules="jool-modules-lts"
|
||||
fi
|
||||
|
||||
for pkg in jool-tools jool-tools-openrc "$kernel_modules";
|
||||
do
|
||||
__package "$pkg"
|
||||
done
|
||||
|
||||
instance="default"
|
||||
if [ -f "${__object:?}/parameter/instance" ];
|
||||
then
|
||||
instance="$(cat "${__object:?}/parameter/instance")"
|
||||
fi
|
||||
|
||||
framework="netfilter"
|
||||
if [ -f "${__object:?}/parameter/framework" ];
|
||||
then
|
||||
framework="$(cat "${__object:?}/parameter/framework")"
|
||||
fi
|
||||
|
||||
pool6="64:ff9b::/96"
|
||||
if [ -f "${__object:?}/parameter/pool6" ];
|
||||
then
|
||||
pool6="$(cat "${__object:?}/parameter/pool6")"
|
||||
fi
|
||||
|
||||
require='__package/jool-tools' __file /etc/jool/jool.conf \
|
||||
--source - <<- EOF
|
||||
{
|
||||
"instance": "$instance",
|
||||
"framework": "$framework",
|
||||
"global": {
|
||||
"pool6": "$pool6"
|
||||
}
|
||||
}
|
||||
EOF
|
||||
|
||||
__start_on_boot 'jool'
|
1
type/__jool/parameter/boolean
Normal file
1
type/__jool/parameter/boolean
Normal file
|
@ -0,0 +1 @@
|
|||
vm
|
3
type/__jool/parameter/optional
Normal file
3
type/__jool/parameter/optional
Normal file
|
@ -0,0 +1,3 @@
|
|||
instance
|
||||
framework
|
||||
pool6
|
0
type/__jool/singleton
Normal file
0
type/__jool/singleton
Normal file
Loading…
Reference in a new issue