文档会持续更新,以下是部署k8s二进制安装方法
版本环境:kubernetes1.10.6
Docker1.13
kubernetes?系统的各组件需要使用?TLS?证书对通信进行加密,本文档使用?CloudFlare?的 PKI 工具集cfssl?来生成 Certificate Authority (CA) 和其它证书;
生成的 CA 证书和秘钥文件如下:
ca-key.pem
ca.pem
kubernetes-key.pem
kubernetes.pem
kube-proxy.pem
kube-proxy-key.pem
admin.pem
admin-key.pem
使用证书的组件如下:
etcd:使用 ca.pem、kubernetes-key.pem、kubernetes.pem;
kube-apiserver:使用 ca.pem、kubernetes-key.pem、kubernetes.pem;
kubelet:使用 ca.pem;
kube-proxy:使用 ca.pem、kube-proxy-key.pem、kube-proxy.pem;
kubectl:使用 ca.pem、admin-key.pem、admin.pem;
kube-controller-manager:使用 ca-key.pem、ca.pem
准备环境
1.关掉防火墙与selinux
2.更改主机名
3.Ntpdate时间同步
4.Centos7系统
5.内核大于或等于3.10
6.网卡能连接外网
7.Yum -y install gcc pcre zlib* unzip wget net-tools vim lrzsz ntpdate
以上步骤为基础环境准备 不做过多操作描述 下面是k8s安装步骤
一:安装cfssl证书(master及node都需要进行安装)
wget https://pkg.cfssl.org/R1.2/cfssl_linux-amd64
chmod +x cfssl_linux-amd64mv cfssl_linux-amd64 /usr/local/bin/cfssl
wget https://pkg.cfssl.org/R1.2/cfssljson_linux-amd64
chmod +x cfssljson_linux-amd64mv cfssljson_linux-amd64 /usr/local/bin/cfssljson
wget https://pkg.cfssl.org/R1.2/cfssl-certinfo_linux-amd64
chmod +x cfssl-certinfo_linux-amd64
mv cfssl-certinfo_linux-amd64 /usr/local/bin/cfssl-certinfo
export PATH=/usr/local/bin:$PATH
创建CA配置文件
mkdir /etc/kubernetes
Cd /etc/kubernetes
cfssl print-defaults config > config.json
cfssl print-defaults csr > csr.json# 根据config.json文件的格式创建如下的ca-config.json文件# 过期时间设置成了 87600h
cat > ca-config.json <<EOF
{
"signing": {
"default": {
"expiry": "87600h"
},
"profiles": {
"kubernetes": {
"usages": [
"signing",
"key encipherment",
"server auth",
"client auth"
],
"expiry": "87600h"
}
}
}
}
EOF
字段说明:
ca-config.json:可以定义多个 profiles,分别指定不同的过期时间、使用场景等参数;后续在签名证书时使用某个 profile;
signing:表示该证书可用于签名其它证书;生成的 ca.pem 证书中?CA=TRUE;
server auth:表示client可以用该 CA 对server提供的证书进行验证;
client auth:表示server可以用该CA对client提供的证书进行验证;
创建ca-csr.json证书
cat > ca-csr.json << EOF
{
"CN": "kubernetes",
"key": {
"algo": "rsa",
"size": 2048
},
"names": [
{
"C": "CN",
"ST": "BeiJing",
"L": "BeiJing",
"O": "k8s",
"OU": "System"
}
],
"ca": {
"expiry": "87600h"
}
}
EOF
生成CA证书和秘钥
cfssl gencert -initca ca-csr.json | cfssljson -bare ca
ls ca
ca-config.json ca.csr ca-csr.json ca-key.pem ca.pem
创建kubernetes证书签名请求文件?kubernetes-csr.json
cat > kubernetes-csr.json << EOF
{
"CN": "kubernetes",
"hosts": [
"10.252.0.120",
"10.252.0.121",
"10.252.0.122",
"10.254.0.1",
"kubernetes",
"kubernetes.default",
"kubernetes.default.svc",
"kubernetes.default.svc.cluster",
"kubernetes.default.svc.cluster.local"
],
"key": {
"algo": "rsa",
"size": 2048
},
"names": [
{
"C": "CN",
"ST": "BeiJing",
"L": "BeiJing",
"O": "k8s",
"OU": "System"
}
]
}
EOF
如果 hosts 字段不为空则需要指定授权使用该证书的?IP 或域名列表,由于该证书后续被?etcd?集群和kubernetes master?集群使用,所以上面分别指定了?etcd?集群、kubernetes master?集群的主机 IP 和?kubernetes?服务的服务 IP(一般是?kube-apiserver?指定的?service-cluster-ip-range?网段的第一个IP,如 10.254.0.1)。
这是最小化安装的kubernetes集群,二个节点的kubernetes集群,其中一节点是私有仓库+node,以上物理节点的IP也可以更换为主机名。(如后续添加node或服务请及时 修改此文件)
生成 kubernetes 证书和私钥
cfssl gencert -ca=ca.pem -ca-key=ca-key.pem -config=ca-config.json -profile=kubernetes kubernetes-csr.json | cfssljson -bare kubernetes
ls kubernetes
kubernetes.csr kubernetes-csr.json kubernetes-key.pem kubernetes.pem
创建Admin证书签名请求文件admin-csr.json
cat > admin-csr.json << EOF
{
"CN": "admin",
"hosts": [],
"key": {
"algo": "rsa",
"size": 2048
},
"names": [
{
"C": "CN",
"ST": "BeiJing",
"L": "BeiJing",
"O": "system:masters",
"OU": "System"
}
]
}
EOF
后续?kube-apiserver?使用?RBAC?对客户端(如?kubelet、kube-proxy、Pod)请求进行授权;
kube-apiserver?预定义了一些?RBAC?使用的?RoleBindings,如?cluster-admin?将 Groupsystem:masters?与 Role?cluster-admin?绑定,该 Role 授予了调用kube-apiserver?的所有 API的权限;
O 指定该证书的 Group 为?system:masters,kubelet?使用该证书访问?kube-apiserver?时 ,由于证书被 CA 签名,所以认证通过,同时由于证书用户组为经过预授权的?system:masters,所以被授予访问所有 API 的权限;
注意:这个admin 证书,是将来生成管理员用的kube config 配置文件用的,现在我们一般建议使用RBAC 来对kubernetes 进行角色权限控制, kubernetes 将证书中的CN 字段 作为User, O 字段作为 Group.
生成admin证书及私钥:
cfssl gencert -ca=ca.pem -ca-key=ca-key.pem -config=ca-config.json -profile=kubernetes admin-csr.json | cfssljson -bare admin
ls admin*
admin.csr admin-csr.json admin-key.pem admin.pem
创建kube-proxy证书证书签名请求文件?kube-proxy-csr.json:
cat > kube-proxy-csr.json << EOF
{
"CN": "system:kube-proxy",
"hosts": [],
"key": {
"algo": "rsa",
"size": 2048
},
"names": [
{
"C": "CN",
"ST": "BeiJing",
"L": "BeiJing",
"O": "k8s",
"OU": "System"
}
]
}
EOF
CN 指定该证书的 User 为?system:kube-proxy;
kube-apiserver?预定义的 RoleBinding?cluster-admin?将User?system:kube-proxy?与 Rolesystem:node-proxier?绑定,该 Role 授予了调用?kube-apiserver?Proxy 相关 API 的权限;
生成 kube-proxy 客户端证书和私钥
cfssl gencert -ca=ca.pem -ca-key=ca-key.pem -config=ca-config.json -profile=kubernetes kube-proxy-csr.json | cfssljson -bare kube-proxy
ls kube-proxy*
kube-proxy.csr kube-proxy-csr.json kube-proxy-key.pem kube-proxy.pem
检验证书
使用openssl检验
Certificate:
Data:
Version: 3 (0x2)
Serial Number:
28:d6:4c:0b:e5:f7:7f:fd:8a:d7:8a:8b:97:33:62:41:9b:8a:d8:ff
Signature Algorithm: sha256WithRSAEncryption
Issuer: C=CN, ST=BeiJing, L=BeiJing, O=k8s, OU=System, CN=kubernetes
Validity
Not Before: Jul 30 09:13:00 2018 GMT
Not After : Jul 27 09:13:00 2028 GMT
Subject: C=CN, ST=BeiJing, L=BeiJing, O=k8s, OU=System, CN=kubernetes
Subject Public Key Info:
Public Key Algorithm: rsaEncryption
Public-Key: (2048 bit)
Modulus:
00:e0:a6:43:97:72:6b:2a:cd:74:69:79:2a:31:1a:
21:0a:03:ec:24:e5:91:5c:38:08:86:eb:0f:14:0b:
c3:6c:ca:74:09:db:20:ac:7f:1a:4e:e6:0a:7f:f6:
82:ea:8e:72:a8:b2:1d:cf:84:fb:10:9f:1f:a4:a0:
7b:e5:17:89:26:eb:3f:84:de:0e:30:b0:22:14:2f:
10:e4:5f:b5:3f:d9:04:19:a1:34:f9:31:11:79:8a:
3a:70:00:dd:8e:54:5a:01:8e:1f:10:d4:f9:fb:c7:
e0:dc:88:b9:6a:4c:d1:55:03:0c:7f:e0:55:89:12:
2c:56:a0:39:d3:51:6f:f4:20:b8:93:22:9e:f4:cd:
21:e8:e9:43:95:c3:6b:71:f1:a3:40:fb:2e:27:a6:
28:bf:84:b1:7f:63:2b:86:5f:77:93:2b:fc:ee:63:
2d:38:b7:53:c8:74:43:69:ec:59:a8:65:ae:32:b9:
b6:b8:9c:ca:40:7e:a4:c9:0f:75:9f:cf:80:66:2a:
69:d4:8f:d2:be:9a:03:56:f2:1a:4e:f3:02:68:6c:
13:5c:35:50:2e:de:33:b4:b1:5f:b3:2d:f5:d3:13:
f4:1e:7c:11:c3:e3:c0:34:e9:19:2e:44:7f:b0:fd:
1f:9e:bf:15:fb:f6:72:a5:2c:fb:fb:89:b4:02:40:
68:c5
Exponent: 65537 (0x10001)
X509v3 extensions:
X509v3 Key Usage: critical
Digital Signature, Key Encipherment
X509v3 Extended Key Usage:
TLS Web Server Authentication, TLS Web Client Authentication
X509v3 Basic Constraints: critical
CA:FALSE
X509v3 Subject Key Identifier:
A4:22:40:85:1D:23:68:F7:67:13:AE:8B:25:03:DD:0B:4C:FC:8C:98
X509v3 Authority Key Identifier:
keyid:EC:07:60:BA:5A:2F:92:D9:DC:7D:D1:53:2A:7C:64:BE:0F:8F:6D:39
X509v3 Subject Alternative Name:
DNS:kubernetes, DNS:kubernetes.default, DNS:kubernetes.default.svc, DNS:kubernetes.default.svc.cluster, DNS:kubernetes.default.svc.cluster.local, IP Address:10.252.0.120, IP Address:10.252.0.121, IP Address:10.252.0.122, IP Address:10.254.0.1
Signature Algorithm: sha256WithRSAEncryption
bc:d8:00:9c:cc:fe:2f:31:48:a3:f8:ea:2e:a8:6a:35:dd:03:
f3:a1:bc:b9:67:92:64:47:f6:83:8a:b7:37:d7:04:95:04:a3:
f1:4c:b5:18:94:58:30:e5:e5:23:83:f8:e8:09:95:6d:78:5c:
90:39:20:a0:6f:5a:89:f8:d9:b9:66:04:e2:ea:46:c8:33:61:
e0:70:fb:cb:ea:79:26:37:80:62:d4:6e:10:72:c7:b2:2b:71:
16:a4:cf:b9:7f:69:91:a2:e7:5c:96:0f:6a:a3:3e:67:14:66:
21:12:1a:5b:d8:dc:0a:9d:b2:70:10:29:ab:d7:a2:57:b5:70:
9e:ae:be:6d:8f:e6:6c:5a:08:d8:e5:90:0c:70:06:1f:af:3e:
57:8b:fa:cb:ea:b0:d3:fa:1c:16:08:37:46:e1:99:9c:b0:7b:
d9:ff:ba:80:f7:03:7e:44:4c:f0:30:85:c4:6a:e5:13:69:75:
bd:ab:df:a4:30:38:f5:73:02:c2:7a:b9:99:62:21:e8:ee:60:
fc:e0:cc:00:73:15:93:5d:05:2e:27:e1:76:6a:45:de:49:1d:
50:92:8f:27:d9:90:e2:6e:ea:7d:f9:fd:0c:99:d1:22:0a:3f:
3d:bd:e5:8a:13:ae:88:7d:15:74:4a:25:5a:3c:66:fd:06:8b:
17:9a:6a:ec
确认?Issuer?字段的内容和?ca-csr.json?一致;
确认?Subject?字段的内容和?kubernetes-csr.json?一致;
确认?X509v3 Subject Alternative Name?字段的内容和?kubernetes-csr.json?一致;
确认?X509v3 Key Usage、Extended Key Usage?字段的内容和?ca-config.json?中?kubernetes?profile 一致;
分发证书
mkdir -p /etc/kubernetes/ssl
cp .pem /etc/kubernetes/ssl
Scp -r /etc/kubernetes [email protected]:/etc/kubernetes
二:安装kubectl命令
链接:https://pan.baidu.com/s/1sB_6fYXgV4B_Kia5HV3jzg 密码:orbr
tar -xzvf kubernetes-client-linux-amd64.tar.gz
cp kubernetes/client/bin/kube /usr/bin/
chmod a+x /usr/bin/kube*
创建 kubectl kubeconfig 文件
export KUBE_APISERVER="https://10.252.0.120:6443"# 设置集群参数
kubectl config set-cluster kubernetes \
--certificate-authority=/etc/kubernetes/ssl/ca.pem \
--embed-certs=true \
--server=${KUBE_APISERVER}# 设置客户端认证参数
kubectl config set-credentials admin \
--client-certificate=/etc/kubernetes/ssl/admin.pem \
--embed-certs=true \
--client-key=/etc/kubernetes/ssl/admin-key.pem# 设置上下文参数
kubectl config set-context kubernetes \
--cluster=kubernetes \
--user=admin# 设置默认上下文
kubectl config use-context kubernetes
admin.pem?证书 OU 字段值为?system:masters,kube-apiserver?预定义的 RoleBinding?cluster-admin?将 Group?system:masters?与 Role?cluster-admin?绑定,该 Role 授予了调用kube-apiserver?相关 API 的权限;
生成的 kubeconfig 被保存到?~/.kube/config?文件;
注意:~/.kube/config文件拥有对该集群的最高权限,请妥善保管。
创建 TLS Bootstrapping Token
export BOOTSTRAP_TOKEN=$(head -c 16 /dev/urandom | od -An -t x | tr -d ‘ ‘)
cat > token.csv <<EOF${BOOTSTRAP_TOKEN},kubelet-bootstrap,10001,"system:kubelet-bootstrap"
EOF
注意:在进行后续操作前请检查?token.csv?文件,确认其中的?${BOOTSTRAP_TOKEN}?环境变量已经被真实的值替换。
BOOTSTRAP_TOKEN?将被写入到 kube-apiserver 使用的 token.csv 文件和 kubelet 使用的bootstrap.kubeconfig?文件,如果后续重新生成了 BOOTSTRAP_TOKEN,则需要:
更新 token.csv 文件,分发到所有机器 (master 和 node)的 /etc/kubernetes/ 目录下,分发到node节点上非必需;
重新生成 bootstrap.kubeconfig 文件,分发到所有 node 机器的 /etc/kubernetes/ 目录下;
重启 kube-apiserver 和 kubelet 进程;
重新 approve kubelet 的 csr 请求;
创建 kubelet bootstrapping kubeconfig 文件
cd /etc/kubernetes
export KUBE_APISERVER="https://10.252.0.120:6443"
设置集群参数
kubectl config set-cluster kubernetes \
--certificate-authority=/etc/kubernetes/ssl/ca.pem \
--embed-certs=true \
--server=${KUBE_APISERVER} \
--kubeconfig=bootstrap.kubeconfig
设置客户端认证参数
kubectl config set-credentials kubelet-bootstrap \
--token=${BOOTSTRAP_TOKEN} \
--kubeconfig=bootstrap.kubeconfig
设置上下文参数
kubectl config set-context default \
--cluster=kubernetes \
--user=kubelet-bootstrap \
--kubeconfig=bootstrap.kubeconfig
设置默认上下文
kubectl config use-context default --kubeconfig=bootstrap.kubeconfig
--embed-certs?为?true?时表示将?certificate-authority?证书写入到生成的bootstrap.kubeconfig?文件中;
设置客户端认证参数时没有指定秘钥和证书,后续由?kube-apiserver?自动生成;
创建 kube-proxy kubeconfig 文件
export KUBE_APISERVER="https://10.252.0.120:6443"
设置集群参数
kubectl config set-cluster kubernetes \
--certificate-authority=/etc/kubernetes/ssl/ca.pem \
--embed-certs=true \
--server=${KUBE_APISERVER} \
--kubeconfig=kube-proxy.kubeconfig# 设置客户端认证参数
kubectl config set-credentials kube-proxy \
--client-certificate=/etc/kubernetes/ssl/kube-proxy.pem \
--client-key=/etc/kubernetes/ssl/kube-proxy-key.pem \
--embed-certs=true \
--kubeconfig=kube-proxy.kubeconfig# 设置上下文参数
kubectl config set-context default \
--cluster=kubernetes \
--user=kube-proxy \
--kubeconfig=kube-proxy.kubeconfig# 设置默认上下文
kubectl config use-context default --kubeconfig=kube-proxy.kubeconfig
设置集群参数和客户端认证参数时?--embed-certs?都为?true,这会将?certificate-authority、client-certificate?和?client-key?指向的证书文件内容写入到生成的?kube-proxy.kubeconfig?文件中;
kube-proxy.pem?证书中 CN 为?system:kube-proxy,kube-apiserver?预定义的 RoleBindingcluster-admin?将User?system:kube-proxy?与 Role?system:node-proxier?绑定,该 Role 授予了调用?kube-apiserver?Proxy 相关 API 的权限;
分发kubeconfig文件
将两个 kubeconfig 文件分发到所有 Node 机器的?/etc/kubernetes/?目录
scp bootstrap.kubeconfig kube-proxy.kubeconfig nodeip:/etc/kubernetes/
三 创建高可用etcd集群
文件链接:https://pan.baidu.com/s/12bvZu296qiX6N4O5acEzUg 密码:tux2
tar -xvf etcd-v3.1.5-linux-amd64.tar.gz
mv etcd-v3.1.5-linux-amd64/etcd* /usr/local/bin
TLS 认证文件
需要为 etcd 集群创建加密通信的 TLS 证书,这里复用以前创建的 kubernetes 证书
cp ca.pem kubernetes-key.pem kubernetes.pem /etc/kubernetes/ssl
kubernetes 证书的?hosts?字段列表中包含上面三台机器的 IP,否则后续证书校验会失败;
创建 etcd 的 systemd unit 文件
在/usr/lib/systemd/system/目录下创建文件etcd.service,内容如下。注意替换IP地址为你自己的etcd集群的主机IP。
[Unit]
Description=Etcd Server
After=network.target
After=network-online.target
Wants=network-online.target
Documentation=https://github.com/coreos
[Service]
Type=notify
WorkingDirectory=/var/lib/etcd/
EnvironmentFile=-/etc/etcd/etcd.conf
ExecStart=/usr/local/bin/etcd \
--name ${ETCD_NAME} \
--cert-file=/etc/kubernetes/ssl/kubernetes.pem \
--key-file=/etc/kubernetes/ssl/kubernetes-key.pem \
--peer-cert-file=/etc/kubernetes/ssl/kubernetes.pem \
--peer-key-file=/etc/kubernetes/ssl/kubernetes-key.pem \
--trusted-ca-file=/etc/kubernetes/ssl/ca.pem \
--peer-trusted-ca-file=/etc/kubernetes/ssl/ca.pem \
--initial-advertise-peer-urls ${ETCD_INITIAL_ADVERTISE_PEER_URLS} \
--listen-peer-urls ${ETCD_LISTEN_PEER_URLS} \
--listen-client-urls ${ETCD_LISTEN_CLIENT_URLS},http://127.0.0.1:2379 \
--advertise-client-urls ${ETCD_ADVERTISE_CLIENT_URLS} \
--initial-cluster-token ${ETCD_INITIAL_CLUSTER_TOKEN} \
--initial-cluster infra1=https://10.252.0.120:2380,infra2=https://10.252.0.121:2380, \
--initial-cluster-state new \
--data-dir=${ETCD_DATA_DIR}
Restart=on-failure
RestartSec=5
LimitNOFILE=65536
[Install]
WantedBy=multi-user.target
#创建目录
mkdir /var/lib/etcd
指定?etcd?的工作目录为?/var/lib/etcd,数据目录为?/var/lib/etcd,需在启动服务前创建这个目录,否则启动服务的时候会报错“Failed at step CHDIR spawning /usr/bin/etcd: No such file or directory”;
为了保证通信安全,需要指定 etcd 的公私钥(cert-file和key-file)、Peers 通信的公私钥和 CA 证书(peer-cert-file、peer-key-file、peer-trusted-ca-file)、客户端的CA证书(trusted-ca-file);
创建?kubernetes.pem?证书时使用的?kubernetes-csr.json?文件的?hosts?字段包含所有 etcd 节点的IP,否则证书校验会出错;
--initial-cluster-state?值为?new?时,--name?的参数值必须位于?--initial-cluster?列表中;
环境变量/etc/etcd/etcd.conf
[member]
ETCD_NAME=infra1
ETCD_DATA_DIR="/var/lib/etcd"
ETCD_LISTEN_PEER_URLS="https://10.252.0.120:2380"
ETCD_LISTEN_CLIENT_URLS="https://10.252.0.120:2379"
#[cluster]
ETCD_INITIAL_ADVERTISE_PEER_URLS="https://10.252.0.120:2380"
ETCD_INITIAL_CLUSTER_TOKEN="etcd-cluster"
ETCD_ADVERTISE_CLIENT_URLS="https://10.252.0.120:2379"
这是10.252.0.120节点的配置,其他etcd节点只要将上面的IP地址改成相应节点的IP地址即可。ETCD_NAME换成对应节点的infra1/2/3。
#注意: 如果是ectd集群 要俩边同时start 不然会卡主 ectd.service找不到别的节点的地址就会报错。
systemctl daemon-reload
systemctl enable etcd
systemctl start etcd
systemctl status etcd
#在所有的 kubernetes master 节点重复上面的步骤,直到所有机器的 etcd 服务都已启动。
验证服务
在任一 kubernetes master 机器上执行如下命令:
etcdctl \
--ca-file=/etc/kubernetes/ssl/ca.pem \
--cert-file=/etc/kubernetes/ssl/kubernetes.pem \
--key-file=/etc/kubernetes/ssl/kubernetes-key.pem \
cluster-health
member 8fe944b322ea3fbd is healthy: got healthy result from https://10.252.0.121:2379
member ef99903f6a48c491 is healthy: got healthy result from https://10.252.0.120:2379
cluster is healthy
四:部署master节点
五:部署master节点
kubernetes master 节点包含的组件:
?kube-apiserver
?kube-scheduler
?kube-controller-manager
目前这三个组件需要部署在同一台机器上。
?kube-scheduler、kube-controller-manager?和?kube-apiserver?三者的功能紧密相关;
?同时只能有一个?kube-scheduler、kube-controller-manager?进程处于工作状态,如果运行多个,则需要通过选举产生一个 leader;
文件链接:https://pan.baidu.com/s/1N_ikO16H7G_WHp6yz4Huog 密码:un2k
mkdir /etc/kubernetes/test
tar -xzvf kubernetes-server-linux-amd64.tar.gz
cd kubernetes
tar -xzvf kubernetes-src.tar.gz
cp -r server/bin/{kube-apiserver,kube-controller-manager,kube-scheduler,kubectl,kube-proxy,kubelet} /usr/local/bin/
配置和启动 kube-apiserver
service配置文件/usr/lib/systemd/system/kube-apiserver.service内容:
[Unit]
Description=Kubernetes API Service
Documentation=https://github.com/GoogleCloudPlatform/kubernetes
After=network.target
After=etcd.service
[Service]
EnvironmentFile=-/etc/kubernetes/config
EnvironmentFile=-/etc/kubernetes/apiserver
ExecStart=/usr/local/bin/kube-apiserver \
$KUBE_LOGTOSTDERR \
$KUBE_LOG_LEVEL \
$KUBE_ETCD_SERVERS \
$KUBE_API_ADDRESS \
$KUBE_API_PORT \
$KUBELET_PORT \
$KUBE_ALLOW_PRIV \
$KUBE_SERVICE_ADDRESSES \
$KUBE_ADMISSION_CONTROL \
$KUBE_API_ARGS
Restart=on-failure
Type=notify
LimitNOFILE=65536
[Install]
WantedBy=multi-user.target
/etc/kubernetes/config文件的内容为:
###
kubernetes system config
#
The following values are used to configure various aspects of all
kubernetes services, including
#
kube-apiserver.service
kube-controller-manager.service
kube-scheduler.service
kubelet.service
kube-proxy.service
logging to stderr means we get it in the systemd journal
KUBE_LOGTOSTDERR="--logtostderr=true"
journal message level, 0 is debug
KUBE_LOG_LEVEL="--v=0"
Should this cluster be allowed to run privileged docker containers
KUBE_ALLOW_PRIV="--allow-privileged=true"
How the controller-manager, scheduler, and proxy find the apiserver
#KUBE_MASTER="--master=http://test-001.jimmysong.io:8080"
KUBE_MASTER="--master=http://10.252.0.120:8080"
该配置文件同时被kube-apiserver、kube-controller-manager、kube-scheduler、kubelet、kube-proxy使用。
apiserver配置文件/etc/kubernetes/apiserver内容为:
#注意:一下文件使用于1.9版本以上的kubernetes 配置改了好多东西 如有不懂得地方 联系qq:459960461
###
kubernetes system config
##
The following values are used to configure the kube-apiserver
##
#
The address on the local server to listen to.
#KUBE_API_ADDRESS="--insecure-bind-address=test-001.jimmysong.io"
KUBE_API_ADDRESS="--advertise-address=10.252.0.120 --bind-address=10.252.0.120 --insecure-bind-address=10.252.0.120"
#
The port on the local server to listen on.
#KUBE_API_PORT="--port=8080"
#
Port minions listen on
#KUBELET_PORT="--kubelet-port=10250"
#
Comma separated list of nodes in the etcd cluster
KUBE_ETCD_SERVERS="--etcd-servers=https://10.252.0.120:2379,https://10.252.0.121:2379"
#
Address range to use for services
KUBE_SERVICE_ADDRESSES="--service-cluster-ip-range=10.254.0.0/16"
#
default admission control policies
KUBE_ADMISSION_CONTROL="--admission-control=ServiceAccount,NamespaceLifecycle,NamespaceExists,LimitRanger,ResourceQuota"
#
Add your own!
KUBE_API_ARGS="--authorization-mode=Node,RBAC --runtime-config=rbac.authorization.k8s.io/v1beta1 --kubelet-https=true --enable-bootstrap-token-auth --token-auth-file=/etc/kubernetes/token.csv --service-node-port-range=30000-32767 --tls-cert-file=/etc/kubernetes/ssl/kubernetes.pem --tls-private-key-file=/etc/kubernetes/ssl/kubernetes-key.pem --client-ca-file=/etc/kubernetes/ssl/ca.pem --service-account-key-file=/etc/kubernetes/ssl/ca-key.pem --etcd-cafile=/etc/kubernetes/ssl/ca.pem --etcd-certfile=/etc/kubernetes/ssl/kubernetes.pem --etcd-keyfile=/etc/kubernetes/ssl/kubernetes-key.pem --enable-swagger-ui=true --apiserver-count=3 --audit-log-maxage=30 --audit-log-maxbackup=3 --audit-log-maxsize=100 --audit-log-path=/var/lib/audit.log --event-ttl=1h"
?--experimental-bootstrap-token-auth?Bootstrap Token Authentication在1.9版本已经变成了正式feature,参数名称改为--enable-bootstrap-token-auth
?如果中途修改过--service-cluster-ip-range地址,则必须将default命名空间的kubernetes的service给删除,使用命令:kubectl delete service kubernetes,然后系统会自动用新的ip重建这个service,不然apiserver的log有报错the cluster IP x.x.x.x for service kubernetes/default is not within the service CIDR x.x.x.x/16; please recreate
?--authorization-mode=RBAC?指定在安全端口使用 RBAC 授权模式,拒绝未通过授权的请求;
?kube-scheduler、kube-controller-manager 一般和 kube-apiserver 部署在同一台机器上,它们使用非安全端口和 kube-apiserver通信;
?kubelet、kube-proxy、kubectl 部署在其它 Node 节点上,如果通过安全端口访问 kube-apiserver,则必须先通过 TLS 证书认证,再通过 RBAC 授权;
?kube-proxy、kubectl 通过在使用的证书里指定相关的 User、Group 来达到通过 RBAC 授权的目的;
?如果使用了 kubelet TLS Boostrap 机制,则不能再指定?--kubelet-certificate-authority、--kubelet-client-certificate?和?--kubelet-client-key?选项,否则后续 kube-apiserver 校验 kubelet 证书时出现 ”x509: certificate signed by unknown authority“ 错误;
?--admission-control?值必须包含?ServiceAccount;
?--bind-address?不能为?127.0.0.1;
?runtime-config配置为rbac.authorization.k8s.io/v1beta1,表示运行时的apiVersion;
?--service-cluster-ip-range?指定 Service Cluster IP 地址段,该地址段不能路由可达;
?缺省情况下 kubernetes 对象保存在 etcd?/registry?路径下,可以通过?--etcd-prefix?参数进行调整;
?如果需要开通http的无认证的接口,则可以增加以下两个参数:--insecure-port=8080 --insecure-bind-address=127.0.0.1。注意,生产上不要绑定到非127.0.0.1的地址上
Kubernetes 1.9
?对于Kubernetes1.9集群,需要注意配置KUBE_API_ARGS环境变量中的--authorization-mode=Node,RBAC,增加对Node授权的模式,否则将无法注册node。
?--experimental-bootstrap-token-auth?Bootstrap Token Authentication在kubernetes 1.9版本已经废弃,参数名称改为--enable-bootstrap-token-auth
启动kube-apiserver
systemctl daemon-reload
systemctl enable kube-apiserver
systemctl start kube-apiserver
systemctl status kube-apiserver
配置和启动 kube-controller-manager
创建 kube-controller-manager的serivce配置文件
文件路径/usr/lib/systemd/system/kube-controller-manager.service
[Unit]
Description=Kubernetes Controller Manager
Documentation=https://github.com/GoogleCloudPlatform/kubernetes
[Service]
EnvironmentFile=-/etc/kubernetes/config
EnvironmentFile=-/etc/kubernetes/controller-manager
ExecStart=/usr/local/bin/kube-controller-manager \
$KUBE_LOGTOSTDERR \
$KUBE_LOG_LEVEL \
$KUBE_MASTER \
$KUBE_CONTROLLER_MANAGER_ARGS
Restart=on-failure
LimitNOFILE=65536
[Install]
WantedBy=multi-user.target
配置文件/etc/kubernetes/controller-manager。
###
The following values are used to configure the kubernetes controller-manager
defaults from config and apiserver should be adequate
Add your own!
KUBE_CONTROLLER_MANAGER_ARGS="--address=127.0.0.1 --service-cluster-ip-range=10.254.0.0/16 --cluster-name=kubernetes --cluster-signing-cert-file=/etc/kubernetes/ssl/ca.pem --cluster-signing-key-file=/etc/kubernetes/ssl/ca-key.pem --service-account-private-key-file=/etc/kubernetes/ssl/ca-key.pem --root-ca-file=/etc/kubernetes/ssl/ca.pem --leader-elect=true"
?--service-cluster-ip-range?参数指定 Cluster 中 Service 的CIDR范围,该网络在各 Node 间必须路由不可达,必须和 kube-apiserver 中的参数一致;
?--cluster-signing-*?指定的证书和私钥文件用来签名为 TLS BootStrap 创建的证书和私钥;
?--root-ca-file?用来对 kube-apiserver 证书进行校验,指定该参数后,才会在Pod 容器的 ServiceAccount 中放置该 CA 证书文件;
?--address?值必须为?127.0.0.1,kube-apiserver 期望 scheduler 和 controller-manager 在同一台机器;
启动 kube-controller-manager
systemctl daemon-reload
systemctl enable kube-controller-manager
systemctl start kube-controller-manager
systemctl status kube-controller-manager
配置和启动 kube-scheduler
文件路径/usr/lib/systemd/system/kube-scheduler.service。
[Unit]Description=Kubernetes Scheduler Plugin
Documentation=https://github.com/GoogleCloudPlatform/kubernetes
[Service
]EnvironmentFile=-/etc/kubernetes/config
EnvironmentFile=-/etc/kubernetes/scheduler
ExecStart=/usr/local/bin/kube-scheduler \
$KUBE_LOGTOSTDERR \
$KUBE_LOG_LEVEL \
$KUBE_MASTER \
$KUBE_SCHEDULER_ARGS
Restart=on-failure
LimitNOFILE=65536
[Install]WantedBy=multi-user.target
配置文件/etc/kubernetes/scheduler。
###
kubernetes scheduler config
default config should be adequate
Add your own!
KUBE_SCHEDULER_ARGS="--leader-elect=true --address=127.0.0.1"
?--address?值必须为?127.0.0.1,因为当前 kube-apiserver 期望 scheduler 和 controller-manager 在同一台机器;
启动 kube-scheduler
systemctl daemon-reload
systemctl enable kube-scheduler
systemctl start kube-scheduler
systemctl status kube-scheduler
验证 master 节点功能
$ kubectl get componentstatuses
NAME STATUS MESSAGE ERROR
scheduler Healthy ok
controller-manager Healthy ok
etcd-0 Healthy {"health": "true"}
etcd-1 Healthy {"health": "true"}
etcd-2 Healthy {"health": "true"}
六:部署node节点
1.yum -y install docker
更改配置文件/etc/sysconfig/docker
--selinux-enabled 改成 --selinux-enabled=false
由于docker13默认用的是systemd模式 后续要改kubelet
systemctl daemon-reload
systemctl enable docker
systemctl start docker
systemctl status dpcler
下载最新的kubelet和kube-proxy二进制文件
文件链接:https://pan.baidu.com/s/1N_ikO16H7G_WHp6yz4Huog 密码:un2k
tar -xzvf kubernetes-server-linux-amd64.tar.gz
cd kubernetes
tar -xzvf kubernetes-src.tar.gz
cp -r ./server/bin/{kube-proxy,kubelet} /usr/local/bin/
创建kubelet的service配置文件
文件位置/usr/lib/systemd/system/kubelet.service。
[Unit]
Description=Kubernetes Kubelet Server
Documentation=https://github.com/GoogleCloudPlatform/kubernetes
After=docker.service
Requires=docker.service
[Service]
WorkingDirectory=/var/lib/kubelet
EnvironmentFile=-/etc/kubernetes/config
EnvironmentFile=-/etc/kubernetes/kubelet
ExecStart=/usr/local/bin/kubelet \
$KUBE_LOGTOSTDERR \
$KUBE_LOG_LEVEL \
$KUBELET_API_SERVER \
$KUBELET_ADDRESS \
$KUBELET_PORT \
$KUBELET_HOSTNAME \
$KUBE_ALLOW_PRIV \
$KUBELET_POD_INFRA_CONTAINER \
$KUBELET_ARGS
Restart=on-failure
[Install]
WantedBy=multi-user.target
#创建目录
mkdir /var/lib/kubelet
kubernetes1.8
相对于kubenrete1.6的配置变动:
?对于kuberentes1.8集群中的kubelet配置,取消了KUBELET_API_SERVER的配置,而改用kubeconfig文件来定义master地址,所以请注释掉KUBELET_API_SERVER配置。
###
kubernetes kubelet (minion) config
#
The address for the info server to serve on (set to 0.0.0.0 or "" for all interfaces)
KUBELET_ADDRESS="--address=10.252.0.121"
#
The port for the info server to serve on
#KUBELET_PORT="--port=10250"
#
You may leave this blank to use the actual hostname
KUBELET_HOSTNAME="--hostname-override=10.252.0.121"
#
location of the api-server
COMMENT THIS ON KUBERNETES 1.8+
#KUBELET_API_SERVER="--api-servers=http://172.20.0.113:8080"
#
pod infrastructure container
KUBELET_POD_INFRA_CONTAINER="--pod-infra-container-image=harbor-001.jimmysong.io/library/pod-infrastructure:rhel7"
#
Add your own!
KUBELET_ARGS="--cgroup-driver=systemd --cluster-dns=10.254.0.2 --bootstrap-kubeconfig=/etc/kubernetes/bootstrap.kubeconfig --kubeconfig=/etc/kubernetes/kubelet.kubeconfig --cert-dir=/etc/kubernetes/ssl --cluster-domain=cluster.local --hairpin-mode promiscuous-bridge --serialize-image-pulls=false --runtime-cgroups=/systemd/system.slice --kubelet-cgroups=/systemd/system.slice"
#下列注解来自蚂蚁金服宋静超先生 仓库也是他的。
#此配置文件使用docker1.13的systemd模式 我已经进行过改动 只需改变IP即可
#注意:kubeconfig这个文件在/root/.kube/config就是 只需要把它移动过来并重命名即可
#mv /root/.kube/config /etc/kubernetes/kubelet.kubeconfig
?如果使用systemd方式启动,则需要额外增加两个参数--runtime-cgroups=/systemd/system.slice --kubelet-cgroups=/systemd/system.slice
?--experimental-bootstrap-kubeconfig?在1.9版本已经变成了--bootstrap-kubeconfig
?--address?不能设置为?127.0.0.1,否则后续 Pods 访问 kubelet 的 API 接口时会失败,因为 Pods 访问的?127.0.0.1?指向自己而不是 kubelet;
?如果设置了?--hostname-override?选项,则?kube-proxy?也需要设置该选项,否则会出现找不到 Node 的情况;
?"--cgroup-driver?配置成?systemd,不要使用cgroup,否则在 CentOS 系统中 kubelet 将启动失败(保持docker和kubelet中的cgroup driver配置一致即可,不一定非使用systemd)。
?--experimental-bootstrap-kubeconfig?指向 bootstrap kubeconfig 文件,kubelet 使用该文件中的用户名和 token 向 kube-apiserver 发送 TLS Bootstrapping 请求;
?管理员通过了 CSR 请求后,kubelet 自动在?--cert-dir?目录创建证书和私钥文件(kubelet-client.crt?和?kubelet-client.key),然后写入?--kubeconfig?文件;
?建议在?--kubeconfig?配置文件中指定?kube-apiserver?地址,如果未指定?--api-servers?选项,则必须指定?--require-kubeconfig?选项后才从配置文件中读取 kube-apiserver 的地址,否则 kubelet 启动后将找不到 kube-apiserver (日志中提示未找到 API Server),kubectl get nodes?不会返回对应的 Node 信息;?--require-kubeconfig?在1.10版本被移除
?--cluster-dns?指定 kubedns 的 Service IP(可以先分配,后续创建 kubedns 服务时指定该 IP),--cluster-domain?指定域名后缀,这两个参数同时指定后才会生效;
?--cluster-domain?指定 pod 启动时?/etc/resolve.conf?文件中的?search domain?,起初我们将其配置成了?cluster.local.,这样在解析 service 的 DNS 名称时是正常的,可是在解析 headless service 中的 FQDN pod name 的时候却错误,因此我们将其修改为?cluster.local,去掉最后面的 ”点号“ 就可以解决该问题,关于 kubernetes 中的域名/服务名称解析请参见我的另一篇文章。
?--kubeconfig=/etc/kubernetes/kubelet.kubeconfig中指定的kubelet.kubeconfig文件在第一次启动kubelet之前并不存在,请看下文,当通过CSR请求后会自动生成kubelet.kubeconfig文件,如果你的节点上已经生成了~/.kube/config文件,你可以将该文件拷贝到该路径下,并重命名为kubelet.kubeconfig,所有node节点可以共用同一个kubelet.kubeconfig文件,这样新添加的节点就不需要再创建CSR请求就能自动添加到kubernetes集群中。同样,在任意能够访问到kubernetes集群的主机上使用kubectl --kubeconfig命令操作集群时,只要使用~/.kube/config文件就可以通过权限认证,因为这里面已经有认证信息并认为你是admin用户,对集群拥有所有权限。
?KUBELET_POD_INFRA_CONTAINER?是基础镜像容器,这里我用的是私有镜像仓库地址,大家部署的时候需要修改为自己的镜像。我上传了一个到时速云上,可以直接?docker pull index.tenxcloud.com/jimmy/pod-infrastructure?下载。pod-infrastructure镜像是Redhat制作的,大小接近80M,下载比较耗时,其实该镜像并不运行什么具体进程,可以使用Google的pause镜像gcr.io/google_containers/pause-amd64:3.0,这个镜像只有300多K,或者通过DockerHub下载jimmysong/pause-amd64:3.0。
假如你更新kubernetes的证书,只要没有更新token.csv,当重启kubelet后,该node就会自动加入到kuberentes集群中,而不会重新发送certificaterequest,也不需要在master节点上执行kubectl certificate approve操作。前提是不要删除node节点上的/etc/kubernetes/ssl/kubelet*和/etc/kubernetes/kubelet.kubeconfig文件。否则kubelet启动时会提示找不到证书而失败。
注意:如果启动kubelet的时候见到证书相关的报错,有个trick可以解决这个问题,可以将master节点上的~/.kube/config文件拷贝到node节点的/etc/kubernetes/kubelet.kubeconfig位置,这样就不需要通过CSR,当kubelet启动后就会自动加入的集群中。
启动kublet
systemctl daemon-reload
systemctl enable kubelet
systemctl start kubelet
systemctl status kubelet
配置 kube-proxy
安装conntrack
yum install -y conntrack-tools
创建 kube-proxy 的service配置文件
文件路径/usr/lib/systemd/system/kube-proxy.service。
[Unit]Description=Kubernetes Kube-Proxy Server
Documentation=https://github.com/GoogleCloudPlatform/kubernetes
After=network.target
[Service]
EnvironmentFile=-/etc/kubernetes/config
EnvironmentFile=-/etc/kubernetes/proxy
ExecStart=/usr/local/bin/kube-proxy \
$KUBE_LOGTOSTDERR \
$KUBE_LOG_LEVEL \
$KUBE_MASTER \
$KUBE_PROXY_ARGS
Restart=on-failure
LimitNOFILE=65536
[Install]WantedBy=multi-user.target
kube-proxy配置文件/etc/kubernetes/proxy。
kubernetes proxy config
default config should be adequate
Add your own!
KUBE_PROXY_ARGS="--bind-address=10.252.0.121 --hostname-override=10.252.0.121 --kubeconfig=/etc/kubernetes/kube-proxy.kubeconfig --cluster-cidr=10.254.0.0/16"
?--hostname-override?参数值必须与 kubelet 的值一致,否则 kube-proxy 启动后会找不到该 Node,从而不会创建任何 iptables 规则;
?kube-proxy 根据?--cluster-cidr?判断集群内部和外部流量,指定?--cluster-cidr?或?--masquerade-all?选项后 kube-proxy 才会对访问 Service IP 的请求做 SNAT;
?--kubeconfig?指定的配置文件嵌入了 kube-apiserver 的地址、用户名、证书、秘钥等请求和认证信息;
?预定义的 RoleBinding?cluster-admin?将User?system:kube-proxy?与 Role?system:node-proxier?绑定,该 Role 授予了调用?kube-apiserver?Proxy 相关 API 的权限
启动 kube-proxy
systemctl daemon-reload
systemctl enable kube-proxy
systemctl start kube-proxy
systemctl status kube-proxy
验证node节点
Kubectl get nodes
此文档后续还会更新,本人一些理解会写在这里,如有疑问,联系QQ:459960461
原文地址:http://blog.51cto.com/13859418/2152539