The kubelet is the orchestrator of containers on each host in the Kubernetes cluster — it starts and stops containers, configures pod mounts, and other low-level, essential tasks. In order to accomplish these tasks, the kubelet requires special permissions on the host.
CoreOS recommends running the kubelet using the rkt container engine, because it has the correct set of features to enable these special permissions, while taking advantage of all that container packaging has to offer: image discovery, signing/verification, and simplified management.
CoreOS ships a wrapper script, /usr/lib/coreos/kubelet-wrapper
, which makes it very easy to run the kubelet under rkt. This script accomplishes two things:
This script is currently shipping in CoreOS 962.0.0+ and will be included in all channels in the near future.
An example systemd kubelet.service file which takes advantage of the kubelet-wrapper script:
/etc/systemd/system/kubelet.service
[Service]
Environment=KUBELET_VERSION=v1.2.3_coreos.0
ExecStart=/usr/lib/coreos/kubelet-wrapper \
--api-servers=http://127.0.0.1:8080 \
--config=/etc/kubernetes/manifests
In the example above we set the KUBELET_VERSION
and the kubelet-wrapper script takes care of running the correct container image with our desired API server address and manifest location.
Passing customized options or flags to rkt can be accomplished with the RKT_OPTS environment variable. Referencing it in a unit file is straightforward. Example below mounts host's /etc/resolv.conf
file directly into the container:
[Service]
Environment="RKT_OPTS=--volume resolv,kind=host,source=/etc/resolv.conf --mount volume=resolv,target=/etc/resolv.conf"
Environment=KUBELET_VERSION=v1.2.3_coreos.0
ExecStart=/usr/lib/coreos/kubelet-wrapper \
--api-servers=http://127.0.0.1:8080 \
--config=/etc/kubernetes/manifests
If you wish to use the kubelet-wrapper on a CoreOS version prior to 962.0.0, you can manually place the script on the host. Please note that this requires rkt version 0.15.0+.
For example:
/opt/bin/kubelet-wrapper
chmod +x /opt/bin/kubelet-wrapper
[Service]
Environment=KUBELET_VERSION=v1.2.3_coreos.0
ExecStart=/opt/bin/kubelet-wrapper \
--api-servers=http://127.0.0.1:8080 \
--config=/etc/kubernetes/manifests