Little helper to run CNCF's k3s in Docker
--no-lb
in combination with --verbose
or --trace
(https://github.com/rancher/k3d/issues/750, thanks @benjaminjb)This release contains a whole lot of new features, breaking changes as well as smaller fixes and improvements. The changelog shown here is likely not complete but gives a broad overview over the changes. For more details, please check the v5 milestone (https://github.com/rancher/k3d/milestone/27) or even the commit history. The docs have been updated, so you should also find the information you need there, with more to come!
The demo repository has also been updated to work with k3d v5: https://github.com/iwilltry42/k3d-demo.
:information_source: https://k3d.io is now versioned, so you can checkout different versions of the documentation by using the dropdown menu in the page title bar!
:speech_balloon: Feedback welcome! :arrow_right: https://github.com/rancher/k3d/discussions/770
[]
for indexing, as it caused problems with some shells trying to interpret them@identifier[:index][:opt]
(see https://github.com/rancher/k3d/discussions/652)
--port 8080:80@server:0:proxy
server
, index = 0
, opt = proxy
opt
is an extra optional argument used for different purposes depending on the flag
--port
flag has opt
s, namely proxy
and direct
(see other breaking change)--port
flag has the proxy
opt (see new nodefilter syntax above) set by defaultdirect
opt on the port flagloadbalancer
will now do the same as servers:*;agents:*
(proxied via the loadbalancer)--registries-create
transformed from bool flag to string flag: let's you define the name and port-binding of the newly created registry, e.g. --registry-create myregistry.localhost:5001
k3d node edit
to edit existing nodes (#615)
k3d node edit NODE --port-add HOSTPORT:CONTAINERPORT
for the serverlb/loadbalancer to add new portsNodeEdit
functionk3d debug
with some options for debugging k3d resources (#638)
k3d debug loadbalancer get-config
to get the current loadbalancer configurationconfd
to make usage of the file backend including a file watcher for auto-reloads
--lb-config-override
, see docs at https://k3d.io/v5.0.0/design/defaults/#k3d-loadbalancer
K3D_IMAGE_LOADBALANCER
& K3D_IMAGE_TOOLS
(#638)--wait
is now the default for k3d node create
k3d cluster create --label
to k3d cluster create --runtime-label
(as it's labelling the node on runtime level, e.g. docker)
options.runtime.labels
k3d cluster create --k3s-node-label
to add Kubernetes node labels via k3s flag (#584, @developer-guy, @ejose, @dentrax)
options.k3s.nodeLabels
k3d node create
v1alpha3
k3d config init
k3d config migrate INPUT [OUTPUT]
to migrate config files between versions
v1alpha2
-> v1alpha3
Config
interface type to support new generic FromViper
config file parsing--k3s-server-arg
& --k3s-agent-arg
into --k3s-arg
with nodefilter support (#605)
options.k3s.extraArgs
$VAR
, ${VAR}
will be expanded unconditionally) (#643)K3D_FIX_DNS
and setting it to a true value (e.g. export K3D_FIX_DNS=1
) to forward DNS queries to your local machine, e.g. to use your local company DNSPlease test cluster creation with the environment variable K3D_FIX_DNS=1
set! (#209 & #758)
This will hopefully be the last release before the final v5.0.0 release :partying_face:
Already on the new module version... getting there!