Merge pull request #301 from squat/check_docs_in_ci

.github: ensure docs are up to date in CI
This commit is contained in:
Lucas Servén Marín 2022-04-21 20:40:50 +02:00 committed by GitHub
commit fc741bf444
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 54 additions and 23 deletions

View File

@ -36,6 +36,19 @@ jobs:
- name: Build - name: Build
run: make run: make
docs:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: Set up Go
uses: actions/setup-go@v2
with:
go-version: 1.17.1
- name: Build docs
run: |
make gen-docs
git diff --exit-code
linux: linux:
runs-on: ubuntu-latest runs-on: ubuntu-latest
steps: steps:

View File

@ -139,7 +139,7 @@ pkg/k8s/listers/kilo/v1alpha1/peer.go: .header pkg/k8s/apis/kilo/v1alpha1/types.
rm -r github.com || true rm -r github.com || true
go fmt ./pkg/k8s/listers/... go fmt ./pkg/k8s/listers/...
gen-docs: generate docs/api.md gen-docs: generate docs/api.md docs/kg.md
docs/api.md: pkg/k8s/apis/kilo/v1alpha1/types.go $(DOCS_GEN_BINARY) docs/api.md: pkg/k8s/apis/kilo/v1alpha1/types.go $(DOCS_GEN_BINARY)
$(DOCS_GEN_BINARY) $< > $@ $(DOCS_GEN_BINARY) $< > $@

View File

@ -16,26 +16,44 @@ The behavior of `kg` can be configured using the command line flags listed below
[embedmd]:# (../tmp/help.txt) [embedmd]:# (../tmp/help.txt)
```txt ```txt
Usage of bin//linux/amd64/kg: kg is the Kilo agent.
--backend string The backend for the mesh. Possible values: kubernetes (default "kubernetes") It runs on every node of a cluster,
--clean-up-interface Should Kilo delete its interface when it shuts down? setting up the public and private keys for the VPN
--cni Should Kilo manage the node's CNI configuration? (default true) as well as the necessary rules to route packets between locations.
--cni-path string Path to CNI config. (default "/etc/cni/net.d/10-kilo.conflist")
--compatibility string Should Kilo run in compatibility mode? Possible values: flannel Usage:
--create-interface Should kilo create an interface on startup? (default true) kg [flags]
--encapsulate string When should Kilo encapsulate packets within a location? Possible values: never, crosssubnet, always (default "always") kg [command]
--hostname string Hostname of the node on which this process is running.
--interface string Name of the Kilo interface to use; if it does not exist, it will be created. (default "kilo0") Available Commands:
--kubeconfig string Path to kubeconfig. help Help about any command
--listen string The address at which to listen for health and metrics. (default ":1107") version Print the version and exit.
--local Should Kilo manage routes within a location? (default true) webhook webhook starts a HTTPS server to validate updates and creations of Kilo peers.
--log-level string Log level to use. Possible values: all, debug, info, warn, error, none (default "info")
--master string The address of the Kubernetes API server (overrides any value in kubeconfig). Flags:
--mesh-granularity string The granularity of the network mesh to create. Possible values: location, full (default "location") --backend string The backend for the mesh. Possible values: kubernetes (default "kubernetes")
--mtu uint The MTU of the WireGuard interface created by Kilo. (default 1420) --clean-up-interface Should Kilo delete its interface when it shuts down?
--port uint The port over which WireGuard peers should communicate. (default 51820) --cni Should Kilo manage the node's CNI configuration? (default true)
--resync-period duration How often should the Kilo controllers reconcile? (default 30s) --cni-path string Path to CNI config. (default "/etc/cni/net.d/10-kilo.conflist")
--subnet string CIDR from which to allocate addresses for WireGuard interfaces. (default "10.4.0.0/16") --compatibility string Should Kilo run in compatibility mode? Possible values: flannel
--topology-label string Kubernetes node label used to group nodes into logical locations. (default "topology.kubernetes.io/region") --create-interface Should kilo create an interface on startup? (default true)
--version Print version and exit --encapsulate string When should Kilo encapsulate packets within a location? Possible values: never, crosssubnet, always (default "always")
-h, --help help for kg
--hostname string Hostname of the node on which this process is running.
--interface string Name of the Kilo interface to use; if it does not exist, it will be created. (default "kilo0")
--iptables-forward-rules Add default accept rules to the FORWARD chain in iptables. Warning: this may break firewalls with a deny all policy and is potentially insecure!
--kubeconfig string Path to kubeconfig.
--listen string The address at which to listen for health and metrics. (default ":1107")
--local Should Kilo manage routes within a location? (default true)
--log-level string Log level to use. Possible values: all, debug, info, warn, error, none (default "info")
--master string The address of the Kubernetes API server (overrides any value in kubeconfig).
--mesh-granularity string The granularity of the network mesh to create. Possible values: location, full (default "location")
--mtu uint The MTU of the WireGuard interface created by Kilo. (default 1420)
--port int The port over which WireGuard peers should communicate. (default 51820)
--prioritise-private-addresses Prefer to assign a private IP address to the node's endpoint.
--resync-period duration How often should the Kilo controllers reconcile? (default 30s)
--subnet string CIDR from which to allocate addresses for WireGuard interfaces. (default "10.4.0.0/16")
--topology-label string Kubernetes node label used to group nodes into logical locations. (default "topology.kubernetes.io/region")
--version Print version and exit
``` ```