2017-08-29 00:19:25 +03:00
# Bootstrapping the Kubernetes Worker Nodes
2023-11-01 09:16:49 +03:00
In this lab you will bootstrap two Kubernetes worker nodes. The following components will be installed: [runc ](https://github.com/opencontainers/runc ), [container networking plugins ](https://github.com/containernetworking/cni ), [containerd ](https://github.com/containerd/containerd ), [kubelet ](https://kubernetes.io/docs/admin/kubelet ), and [kube-proxy ](https://kubernetes.io/docs/concepts/cluster-administration/proxies ).
2017-08-29 00:19:25 +03:00
## Prerequisites
2023-11-01 09:16:49 +03:00
Copy Kubernetes binaries and systemd unit files to each worker instance:
```bash
for host in node-0 node-1; do
SUBNET=$(grep $host machines.txt | cut -d " " -f 4)
sed "s|SUBNET|$SUBNET|g" \
configs/10-bridge.conf > 10-bridge.conf
sed "s|SUBNET|$SUBNET|g" \
configs/kubelet-config.yaml > kubelet-config.yaml
scp 10-bridge.conf kubelet-config.yaml \
root@$host:~/
done
```
```bash
for host in node-0 node-1; do
scp \
2024-04-10 14:23:03 +03:00
downloads/runc.amd64 \
downloads/crictl-v1.28.0-linux-amd.tar.gz \
downloads/cni-plugins-linux-amd64-v1.3.0.tgz \
downloads/containerd-1.7.8-linux-amd64.tar.gz \
2023-11-01 09:16:49 +03:00
downloads/kubectl \
downloads/kubelet \
downloads/kube-proxy \
configs/99-loopback.conf \
configs/containerd-config.toml \
configs/kubelet-config.yaml \
configs/kube-proxy-config.yaml \
units/containerd.service \
units/kubelet.service \
units/kube-proxy.service \
root@$host:~/
done
```
The commands in this lab must be run on each worker instance: `node-0` , `node-1` . Login to the worker instance using the `ssh` command. Example:
```bash
ssh root@node-0
2017-08-29 00:19:25 +03:00
```
## Provisioning a Kubernetes Worker Node
2017-10-02 06:37:09 +03:00
Install the OS dependencies:
2017-08-29 00:19:25 +03:00
2023-11-01 09:16:49 +03:00
```bash
2018-05-12 19:54:18 +03:00
{
2023-11-01 09:16:49 +03:00
apt-get update
apt-get -y install socat conntrack ipset
2018-05-12 19:54:18 +03:00
}
2017-08-29 00:19:25 +03:00
```
2017-10-02 06:37:09 +03:00
> The socat binary enables support for the `kubectl port-forward` command.
2017-08-29 00:19:25 +03:00
2019-09-14 21:41:56 +03:00
### Disable Swap
2023-11-01 09:16:49 +03:00
By default, the kubelet will fail to start if [swap ](https://help.ubuntu.com/community/SwapFaq ) is enabled. It is [recommended ](https://github.com/kubernetes/kubernetes/issues/7294 ) that swap be disabled to ensure Kubernetes can provide proper resource allocation and quality of service.
2019-09-14 21:41:56 +03:00
Verify if swap is enabled:
2023-11-01 09:16:49 +03:00
```bash
swapon --show
2019-09-14 21:41:56 +03:00
```
2023-11-01 09:16:49 +03:00
If output is empty then swap is not enabled. If swap is enabled run the following command to disable swap immediately:
2019-09-14 21:41:56 +03:00
2023-11-01 09:16:49 +03:00
```bash
swapoff -a
2019-09-14 21:41:56 +03:00
```
> To ensure swap remains off after reboot consult your Linux distro documentation.
2017-08-29 00:19:25 +03:00
Create the installation directories:
2023-11-01 09:16:49 +03:00
```bash
mkdir -p \
2017-08-29 00:19:25 +03:00
/etc/cni/net.d \
/opt/cni/bin \
/var/lib/kubelet \
/var/lib/kube-proxy \
/var/lib/kubernetes \
/var/run/kubernetes
```
Install the worker binaries:
2023-11-01 09:16:49 +03:00
```bash
2018-05-12 19:54:18 +03:00
{
2023-11-01 09:16:49 +03:00
mkdir -p containerd
2024-04-10 14:23:03 +03:00
tar -xvf crictl-v1.28.0-linux-amd.tar.gz
tar -xvf containerd-1.7.8-linux-amd64.tar.gz -C containerd
tar -xvf cni-plugins-linux-amd64-v1.3.0.tgz -C /opt/cni/bin/
mv runc.amd64 runc
2019-09-14 21:41:56 +03:00
chmod +x crictl kubectl kube-proxy kubelet runc
2023-11-01 09:16:49 +03:00
mv crictl kubectl kube-proxy kubelet runc /usr/local/bin/
mv containerd/bin/* /bin/
2018-05-12 19:54:18 +03:00
}
2017-08-29 00:19:25 +03:00
```
### Configure CNI Networking
Create the `bridge` network configuration file:
2023-11-01 09:16:49 +03:00
```bash
mv 10-bridge.conf 99-loopback.conf /etc/cni/net.d/
2017-08-29 00:19:25 +03:00
```
2018-05-12 19:54:18 +03:00
### Configure containerd
2023-11-01 09:16:49 +03:00
Install the `containerd` configuration files:
2018-05-12 19:54:18 +03:00
2023-11-01 09:16:49 +03:00
```bash
2018-05-12 19:54:18 +03:00
{
2023-11-01 09:16:49 +03:00
mkdir -p /etc/containerd/
mv containerd-config.toml /etc/containerd/config.toml
mv containerd.service /etc/systemd/system/
2018-05-12 19:54:18 +03:00
}
```
2023-11-01 09:16:49 +03:00
### Configure the Kubelet
2018-09-30 22:35:05 +03:00
2023-11-01 09:16:49 +03:00
Create the `kubelet-config.yaml` configuration file:
2017-08-29 00:19:25 +03:00
2023-11-01 09:16:49 +03:00
```bash
{
mv kubelet-config.yaml /var/lib/kubelet/
mv kubelet.service /etc/systemd/system/
}
2017-08-29 00:19:25 +03:00
```
### Configure the Kubernetes Proxy
2023-11-01 09:16:49 +03:00
```bash
{
mv kube-proxy-config.yaml /var/lib/kube-proxy/
mv kube-proxy.service /etc/systemd/system/
}
2017-08-29 00:19:25 +03:00
```
### Start the Worker Services
2023-11-01 09:16:49 +03:00
```bash
2018-05-12 19:54:18 +03:00
{
2023-11-01 09:16:49 +03:00
systemctl daemon-reload
systemctl enable containerd kubelet kube-proxy
systemctl start containerd kubelet kube-proxy
2018-05-12 19:54:18 +03:00
}
2017-08-29 00:19:25 +03:00
```
## Verification
2023-11-01 09:16:49 +03:00
The compute instances created in this tutorial will not have permission to complete this section. Run the following commands from the `jumpbox` machine.
2017-08-29 00:19:25 +03:00
List the registered Kubernetes nodes:
2023-11-01 09:16:49 +03:00
```bash
ssh root@server \
"kubectl get nodes \
--kubeconfig admin.kubeconfig"
2017-08-29 00:19:25 +03:00
```
```
2023-11-01 09:16:49 +03:00
NAME STATUS ROLES AGE VERSION
node-0 Ready < none > 1m v1.28.3
node-1 Ready < none > 10s v1.28.3
2017-08-29 00:19:25 +03:00
```
Next: [Configuring kubectl for Remote Access ](10-configuring-kubectl.md )