This page describes the node images available for Google Kubernetes Engine nodes. To learn how to choose a node image, refer to Specifying a Node Image.
When you create a GKE cluster or node pool, you can choose the operating system image that runs on each node. You can also upgrade an existing cluster to use a different node image type.
Available node images
GKE offers the following node image options for your cluster:
- Container-Optimized OS from Google
- Container-Optimized OS with containerd (
- Ubuntu with containerd (
The Container-Optimized OS node image is based on a recent version of the Linux kernel and is optimized to enhance node security. It is backed by a team at Google that can quickly patch it for security and iterate on features. The Container-Optimized OS image provides better support, security, and stability than other images.
The Ubuntu node image has been validated against GKE's node image requirements. You should use the Ubuntu node image if your nodes require support for XFS, CephFS, or Debian packages.
containerd node images
containerd is an important building block and the core runtime component of Docker.
There are two OS images using containerd
as the main container runtime directly integrated with Kubernetes:
For debugging or troubleshooting on the node, you can interact with containerd
using the portable command-line tool built for Kubernetes container runtimes:
crictl supports common functionalities to view containers and images,
read logs, and execute commands in the containers. Refer to the
crictl user guide
for the complete set of supported features and usage information.
containerd on Container-Optimized OS (
cos_containerd is a variant of the Container-Optimized OS image with containerd as the container runtime directly integrated with Kubernetes.
cos_containerd requires Kubernetes version 1.14.3 or higher.
For more information, visit Using Container-Optimized OS with containerd.
containerd on Ubuntu (
ubuntu_containerd is a variant of the Ubuntu image that uses containerd as the container runtime.
ubuntu_containerd requires Kubernetes version 1.14.3 or higher.
Node image comparison
The following sections compare the operational aspects of the Container-Optimized OS and Ubuntu node images, including:
- Software package management
- System initialization
- Logs collection
- File system layout
- Storage driver support
Software package manager
cos_containerd node images use a minimal root file system with built-in support for
the Docker (containerd) container runtime, which also serves as the software package manager
for installing software on the host. The Ubuntu image uses the
Aptitude package manager.
Managing software on Container-Optimized OS
The Container-Optimized OS image does not provide package management software
apt-get. You can't install arbitrary software onto the nodes using
conventional mechanisms. Instead, create a container image that contains the
software you need.
For debugging purposes only, Container-Optimized OS includes the
CoreOS Toolbox for installing
and running common debugging tools such as
For more information about debugging Container-Optimized OS nodes, see the Container-Optimized OS how-to guides.
Managing software on Ubuntu
The Ubuntu image has the Aptitude package manager pre-installed. You can use
apt-get command to install packages on these images. For example, to
sudo apt-get update sudo apt-get install ceph
Both the Container-Optimized OS and Ubuntu node image use
systemd to manage
system resources and services during the system initialization process.
The Container-Optimized OS and Ubuntu node images use
for collecting system-wide logs.
Viewing logs on Container-Optimized OS and Ubuntu
To view logs on a node with the Container-Optimized OS or Ubuntu node image, you
must use the
command. For example, to view Docker daemon logs:
sudo journalctl -u docker
To view kubelet logs:
sudo journalctl -u kubelet
File system layout
The Ubuntu node image uses the standard Linux file system layout.
The Container-Optimized OS node image file system layout is optimized to enhance node security. The boot disk space is split into three types of partitions:
- Root partition, which is mounted as read-only
- Stateful partitions, which are writable and stateful
- Stateless partitions, which are writable but the contents do not persist across reboots
When using Container-Optimized OS, be aware of the partitioning if you run your own services that have certain expectations about the filesystem layout outside of containers.
Working with the Container-Optimized OS file system
The following is a list of paths in the Container-Optimized OS node image file system, along with their properties and recommended usage:
||The root filesystem is mounted as read-only to maintain integrity. The kernel verifies integrity root filesystem during boot up, and refuses to boot in case of errors.|
||These paths are meant for storing data that persists for the lifetime of the boot disk. They are mounted from /mnt/stateful_partition.|
||These paths are working directories for Compute Engine packages (for example, the accounts manager service), cloud-init, Docker, Kubelet, and Toolbox respectively.|
||/etc typically holds your configuration (for example,
||/tmp is typically used as a scratch space and should not be used to store persistent data.|
||You can mount Persistent Disks at directories under /mnt/disks.|
Storage driver support
Each node image differs in the kinds of storage plugins it supports. The following terms apply when describing a node image's support for a particular storage driver:
- Yes - Fully Tested/Supported: This storage plugin is fully supported and tested with the specified node image.
- Yes - Limited Testing: This storage plugin works with the specified node image, but have been tested only in a limited fashion; you might encounter unexpected behavior. For Container-Optimized OS, these plugins will eventually be fully tested and supported.
- Unsupported: This storage plugin has not been tested or used with the specified node image and GKE cannot provide any guarantee of functionality. There are no plans to test this storage plugin.
- No: This storage plugin does not work with the specified node image due to a limitation inherent to the node OS or Google Cloud Platform.
The following matrix describes how each GKE node image supports some common storage plugins.
|Volume Type||Does it work on Container-Optimized OS (
||Does it work on Ubuntu?|
|Google Compute Engine
Persistent Disk (EXT4 or XFS)
|Yes - Fully Tested/Supported
(XFS is not supported.)
|Yes - Fully Tested/Supported|
|NFSv3||Yes - Fully Tested/Supported||Yes - Fully Tested/Supported|
|NFSv4||Yes - Fully Tested/Supported||Yes - Fully Tested/Supported|
|CephFS||No||Yes - Limited Testing
(Driver is not installed by default. You must install the
Node VM modifications
Modifications on the boot disk of a node VM do not persist across node re-creations. Nodes are re-created during manual upgrade, auto-upgrade, auto-repair, and auto-scaling. In addition, nodes are re-created when you enable a feature that requires node re-creation, such as GKE sandbox, intranode visibility, and shielded nodes.
To preserve modifications across node re-creation, use a DaemonSet.
It's not recommended to manage critical software provided by a node image, such
as the kernel or container runtime (whether
images are tested extensively, and modifying critical software provided in the
node image puts the node into an unknown and untestable state.
Node images release notes
Google provides comprehensive documentation for Container-Optimized OS:
Periodically, Google updates the Ubuntu images that are available for use on your cluster's Nodes. Refer to the GKE release notes for information about these updates, including a link to a manifest listing the packages that are installed by default.