v5.0.3

v5.0.3

Enhancements & Fixes

• simplified way of getting a Docker API Client that works with Docker Contexts and DOCKER_* environment variable configuration (#829, @dragonflylee)
  • fix: didn't honor DOCKER_TLS environment variables before

Full Changelog: v5.0.2...v5.0.3

v5.0.2

v5.0.2

Enhancements

• CoreDNS Configmap is now edited in the auto-deploy manifest on disk instead of relying on kubectl patch command (#814)
• refactor: add cmd subcommands in a single function call (#819, @moeryomenko)
• handle ready-log-messages by type and intent & check them in single log streams instead of checking whole chunks every time (#818)

Fixes

• fix: config file check failing with env var expansion because unexpanded input file was checked

Misc

• cleanup: ensure that connections/streams are closed once unused (#818)
• cleanup: split type definitions across multiple files to increase readability (#818)
• docs: clarify node create help text about cluster reference (#808, @losinggeneration)
• refactor: move from io/ioutil (deprecated) to io and os packages (#827, @Juneezee)

Full Changelog: v5.0.1...v5.0.2

v5.0.2-rc.1

What's Changed

• chore(cmd): add subcommands in one call by @moeryomenko in #819
• [Cleanup] Types, ready-log-messages & closing connections by @iwilltry42 in #818

New Contributors

• @moeryomenko made their first contribution in #819

Full Changelog: v5.0.2-rc.0...v5.0.2-rc.1

v5.0.2-rc.0

What's Changed

• [Docs] Clarify node create help text about cluster reference by @losinggeneration in #808
• [Enhancement] Edit CoreDNS ConfigMap on disk for more reliability by @iwilltry42 in #814

New Contributors

• @losinggeneration made their first contribution in #808

Full Changelog: v5.0.1...v5.0.2-rc.0

v5.0.1

v5.0.1

Enhancement

• add HostFromClusterNetwork field to LocalRegistryHosting configmap as per KEP-1755 (#754)

Fixes

• fix: nilpointer exception on failed exec process with no returned logreader
• make post-create cluster preparation (DNS stuff mostly) more resilient (#780)
• fix v1alpha2 -> v1alpha3 config migration (and other related issues) (#799)

Misc

• docs: fix typo (#784)
• docs: fix usage of legacy --k3s-agent/server-arg flag

New Contributors

• @DarqueWarrior made their first contribution in #784
• @johnpoth made their first contribution in #754

Full Changelog: v5.0.0...v5.0.1

v5.0.1-rc.1

• #780 (more reliable CoreDNS patching)

v5.0.1-rc.0

Fixes

• fix: nil pointer exception when creating a cluster with --no-lb in combination with --verbose or --trace (#750, thanks @benjaminjb)

v5.0.0

v:five:.:zero:.:zero:

It's finally here! 🥳

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.

ℹ️ 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!

💬 Feedback welcome! ➡️ #770

❗ Breaking Changes

• new syntax for nodefilters
  • dropped the usage of square brackets [] for indexing, as it caused problems with some shells trying to interpret them
  • new syntax: @identifier[:index][:opt] (see #652)
    • example for a port-mapping: --port 8080:80@server:0:proxy
      • identifier = server, index = 0, opt = proxy
      • opt is an extra optional argument used for different purposes depending on the flag
        • currently, only the --port flag has opts, namely proxy and direct (see other breaking change)
• port-mapping now go via the loadbalancer (serverlb) by default
  • the --port flag has the proxy opt (see new nodefilter syntax above) set by default
  • to leverage the old behavior of direct port-mappings, use the direct opt on the port flag
  • the nodefilter loadbalancer will now do the same as servers:*;agents:* (proxied via the loadbalancer)
• flag --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

🧰 Fixes

• cleaned up and properly sorted the sanitization of existing resources used to create new nodes (#638)

🆕 Features & Enhancements

• new command: k3d node edit to edit existing nodes (#615)
  • currently only allows k3d node edit NODE --port-add HOSTPORT:CONTAINERPORT for the serverlb/loadbalancer to add new ports
  • pkg: new NodeEdit function
• new (hidden) command: k3d debug with some options for debugging k3d resources (#638)
  • e.g. k3d debug loadbalancer get-config to get the current loadbalancer configuration
• loadbalancer / k3d-proxy (#638)
  • updated fork of confd to make usage of the file backend including a file watcher for auto-reloads
    • this also checks the config before applying it, so the lb doesn't crash on a faulty config
  • updating the loadbalancer writes the new config file and also checks if everything's going fine afterwards
  • some settings of the loadbalancer can now be configured using --lb-config-override, see docs at https://k3d.io/v5.0.0/design/defaults/#k3d-loadbalancer
• helper images can now be set explicitly via environment variables: K3D_IMAGE_LOADBALANCER & K3D_IMAGE_TOOLS (#638)
• concurrently add new nodes to an existing cluster (remove some dumb code) (#640)
  • --wait is now the default for k3d node create
• normalized flag usage for k3s and runtime (#598, @ejose19)
  • rename k3d cluster create --label to k3d cluster create --runtime-label (as it's labelling the node on runtime level, e.g. docker)
    • config option moved to options.runtime.labels
  • add k3d cluster create --k3s-node-label to add Kubernetes node labels via k3s flag (#584, @developer-guy, @EJose, @Dentrax)
    • new config option options.k3s.nodeLabels
  • the same for k3d node create
• improved config file handling (#605)
  • new version v1alpha3
    • warning when using outdated version
    • validation dynamically based on provided config apiVersion
    • new default for k3d config init
  • new command k3d config migrate INPUT [OUTPUT] to migrate config files between versions
    • currently supported migration v1alpha2 -> v1alpha3
  • pkg: new Config interface type to support new generic FromViper config file parsing
• changed flags --k3s-server-arg & --k3s-agent-arg into --k3s-arg with nodefilter support (#605)
  • new config path options.k3s.extraArgs
• config file: environment variables ($VAR, ${VAR} will be expanded unconditionally) (#643)
• docker context support (#601, @developer-guy & #674)
• Feature flag using the environment variable 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 DNS

📎 Misc

• tests/e2e: timeouts everywhere to avoid killing DroneCI (#638)
• logs: really final output when creating/deleting nodes (so far, we were not outputting a final success message and the process was still doing stuff) (#640)
• tests/e2e: add tests for v1alpha2 to v1alpha3 migration
• docs: use v1alpha3 config version
• docs: update general appearance and cleanup

v5.0.0-rc.5

debug: add env var flag K3D_DEBUG_DISABLE_DOCKER_INIT to test k3s as …

v5.0.0-rc.4 - FIFTH Release Candidate

INFO

No notable changes compared to v5.0.0-rc.3, but that release was broken due to an issue with Alpine running on older versions of Docker (i.e. in our DroneCI pipeline).