We've discontinued the registration of new Bundles

New Bundle registrations are no longer accepted. Existing bundles remain functional. We recommend using the Juju Terraform Provider for new deployments.

Kubernetes Core

Canonical Kubernetes Publisher | bundle

Platform:

Ubuntu
Channel Revision Published
latest/stable 1886 16 Apr 2026
latest/candidate 1847 13 Dec 2024
latest/beta 1884 13 Jan 2026
latest/edge 1893 09 Jun 2026
1.36/edge 1892 21 May 2026
1.35/stable 1889 16 Apr 2026
1.35/beta 1885 13 Jan 2026
1.35/edge 1890 01 May 2026
1.34/stable 1888 16 Apr 2026
1.34/beta 1880 07 Aug 2025
1.34/edge 1878 05 Aug 2025
1.33/stable 1877 23 Jun 2025
1.33/beta 1870 06 May 2025
1.33/edge 1868 05 May 2025
1.32/stable 1874 23 Jun 2025
1.32/beta 1865 29 Apr 2025
1.32/edge 1846 10 Sep 2024
1.31/stable 1844 04 Sep 2024
1.31/candidate 1848 13 Dec 2024
1.31/beta 1842 12 Aug 2024
1.31/edge 1840 02 Aug 2024
1.30/stable 1834 11 Jul 2024
1.30/beta 1831 18 Apr 2024
1.30/edge 1839 26 Jul 2024
1.29/stable 1823 12 Feb 2024
1.29/candidate 1827 16 Apr 2024
1.29/beta 1822 12 Feb 2024
1.29/edge 1818 13 Dec 2023
1.28/stable 1817 21 Aug 2023
1.28/candidate 1809 07 Jun 2023
1.28/beta 1816 21 Aug 2023
1.28/edge 1811 07 Aug 2023
1.27/stable 1805 21 Apr 2023
1.27/candidate 1807 17 May 2023
1.27/beta 1802 09 Apr 2023
1.27/edge 1799 23 Feb 2023
1.26/stable 1794 15 Dec 2022
1.26/candidate 1796 13 Jan 2023
1.26/beta 1801 08 Apr 2023
1.26/edge 1786 22 Nov 2022
1.25/stable 1779 01 Sep 2022
1.25/candidate 1780 09 Sep 2022
1.25/beta 1788 01 Dec 2022
1.25/edge 1775 17 Aug 2022
1.24/stable 1748 04 Aug 2022
1.24/candidate 1742 02 Aug 2022
1.24/beta 1605 06 May 2022
1.24/edge 1772 15 Aug 2022
1.23/edge 1542 16 Mar 2022
juju deploy kubernetes-core

Learn about configurations >

  • config_version | string

    Default: v2

    Containerd config version. Can be "v1" or "v2". DEPRECATED: config_version will be removed in a future release.

  • custom-registry-ca | string

    Base64 encoded Certificate Authority (CA) bundle. Setting this config allows container runtimes to pull images from registries with TLS certificates signed by an external CA.

  • custom_registries | string

    Default: []

    Registry endpoints and credentials. Setting this config allows Kubelet to pull images from registries where auth is required. The value for this config must be a JSON array of credential objects, like this: e.g.: [{"host": "my.registry:port", "username": "user", "password": "pass"}] Credential Object Parameters: `url: REQUIRED str` the URL to the registry, include the port if not it isn't implied from the schema. e.g: "url": "https://my.registry:8443" e.g: "url": "http://my.registry" host: OPTIONAL str - defaults to auto-generated from the url could be registry host address or a name e.g.: myregistry.io:9000, 10.10.10.10:5432 e.g.: myregistry.io, myregistry Note: It will be derived from `url` if not provided. e.g.: "url": "http://10.10.10.10:8000" --> "host": "10.10.10.10:8000" username: OPTIONAL str - default '' password: OPTIONAL str|dict - default '' Used by containerd for basic authentication to the registry. If a string, will be rendered wrapped as a double-quoted str (password = "my-strong-password") If a dictionary, will be rendered as a single-quoted json (password = '{"my": "json"}') e.g.: "password": '"$(jq -c . gce.json)"' ca_file: OPTIONAL str - default '' cert_file: OPTIONAL str - default '' key_file: OPTIONAL str - default '' For ssl/tls communication these should be a base64 encoded file e.g.: "ca_file": "'"$(base64 -w 0 < my.custom.registry.pem)"'" insecure_skip_verify: OPTIONAL bool - default false For situatations where the registry has self-signed or expired certs and a quick work-around is necessary. e.g.: "insecure_skip_verify": true example config) juju config containerd custom_registries='[{ "url": "https://registry.example.com", "ca_file": "'"$(base64 -w 0 < ~/my.custom.ca.pem)"'", "cert_file": "'"$(base64 -w 0 < ~/my.custom.cert.pem)"'", "key_file": "'"$(base64 -w 0 < ~/my.custom.key.pem)"'", }]'

  • disable-juju-proxy | boolean

    Ignore juju-http(s) proxy settings on this charm. If set to true, all juju https proxy settings will be ignored

  • enable-cgroups | boolean

    Enable GRUB cgroup overrides cgroup_enable=memory swapaccount=1. WARNING changing this option will reboot the host - use with caution on production services.

  • gpu_driver | string

    Default: auto

    Override GPU driver installation. Options are "auto", "nvidia", "none". Caution: setting this to nvidia will cause nvidia drivers to be installed on kubernetes-control-plane, even if a GPU is not present.

  • http_proxy | string

    URL to use for HTTP_PROXY to be used by Containerd. Useful in egress-filtered environments where a proxy is the only option for accessing the registry to pull images.

  • https_proxy | string

    URL to use for HTTPS_PROXY to be used by Containerd. Useful in egress-filtered environments where a proxy is the only option for accessing the registry to pull images.

  • kill_signal | string

    Default: SIGTERM

    Set containerd systemd KillSignal. Options are standard signals from https://man7.org/linux/man-pages/man7/signal.7.html

  • no_proxy | string

    Comma-separated list of destinations (either domain names or IP addresses) which should be accessed directly, rather than through the proxy defined in http_proxy or https_proxy. Must be less than 2023 characters long.

  • nvidia_apt_key_urls | string

    Default: https://nvidia.github.io/nvidia-container-runtime/gpgkey https://developer.download.nvidia.com/compute/cuda/repos/{id}{version_id_no_dot}/x86_64/3bf863cc.pub

    Space-separated list of APT GPG key URLs to add when using Nvidia GPUs. Supported template options: {id}: OS release ID, e.g. "ubuntu" {version_id}: OS release version ID, e.g. "20.04" {version_id_no_dot}: OS release version ID with no dot, e.g. "2004"

  • nvidia_apt_packages | string

    Default: cuda-drivers nvidia-container-runtime

    Space-separated list of APT packages to install when using Nvidia GPUs.

  • nvidia_apt_sources | string

    Default: deb https://nvidia.github.io/libnvidia-container/stable/deb/$(ARCH) / deb https://nvidia.github.io/nvidia-container-runtime/{id}{version_id}/$(ARCH) / deb https://developer.download.nvidia.com/compute/cuda/repos/{id}{version_id_no_dot}/x86_64 /

    Newline-separated list of APT sources to add when using Nvidia GPUs. Supported template options: {id}: OS release ID, e.g. "ubuntu" {version_id}: OS release version ID, e.g. "20.04" {version_id_no_dot}: OS release version ID with no dot, e.g. "2004"

  • runtime | string

    Default: auto

    Set a custom containerd runtime. Set "auto" to select based on hardware.

  • shim | string

    Default: containerd-shim

    Set a custom containerd shim.