如何在Debian 9上使用Kubeadm创建Kubernetes集群

Kubeadm自动安装和配置Kubernetes组件,例如API服务器,Controller Manager和Kube DNS。在本指南中,您将使用Ansible和Kubeadm从头开始设置Kubernetes集群,然后将容器化的Nginx应用程序部署到它。

作者选择了自由和开源基金作为Write for DOnations计划的一部分进行捐赠。

介绍

Kubernetes是一个容器编排系统,可以大规模管理容器。 Kubernetes最初由谷歌根据其在生产中运行容器的经验开发而成,是一个开源的,并由世界各地的社区积极开发。

注意:本教程使用的是Kubernetes 1.14版,这是本文发布时的官方支持版本。 有关最新版本的最新信息,请参阅官方Kubernetes文档中的当前发行说明

Kubeadm自动安装和配置Kubernetes组件,例如API服务器,Controller Manager和Kube DNS。 但是,它不会创建用户或处理操作系统级依赖关系及其配置的安装。 对于这些初步任务,可以使用AnsibleSaltStack等配置管理工具。 使用这些工具可以更加简单地创建其他集群或重新创建现有集群,并且不易出错。

在本指南中,您将使用Ansible和Kubeadm从头开始设置Kubernetes集群,然后将容器化的Nginx应用程序部署到它。

目标

您的群集将包含以下物理资源:

  • 一个主节点

主节点(Kubernetes中的节点指服务器)负责管理集群的状态。 它运行Etcd ,它在将工作负载调度到工作节点的组件之间存储集群数据。

  • 两个工人节点

工作节点是运行工作负载 (即容器化应用程序和服务)的服务器。 一旦工作人员分配了工作负载,工作人员将继续运行您的工作负载,即使主计划在调度完成后停止工作也是如此。 通过添加工作人员可以增加群集的容量。

完成本指南后,如果群集中的服务器具有足够的CPU和RAM资源供应用程序使用,您将拥有一个可以运行容器化应用程序的集群。 几乎任何传统的Unix应用程序(包括Web应用程序,数据库,守护程序和命令行工具)都可以进行容器化,并在集群上运行。 群集本身将在每个节点上消耗大约300-500MB的内存和10%的CPU。

设置群集后,您将向其部署Web服务器Nginx ,以确保它正确运行工作负载。

先决条件

第1步 - 设置工作区目录和Ansible清单文件

在本节中,您将在本地计算机上创建一个用作工作区的目录。 您将在本地配置Ansible,以便它可以与远程服务器上的命令通信并执行命令。 完成后,您将创建一个包含库存信息的hosts文件,例如服务器的IP地址和每个服务器所属的组。

在三台服务器中,一台服务器将成为主服务器,其IP显示为master_ip 其他两个服务器将是worker,并且将具有IP worker_1_ipworker_2_ip

在本地计算机的主目录中创建一个名为~/kube-cluster的目录并将其cd入其中:

mkdir ~/kube-cluster
cd ~/kube-cluster

该目录将成为本教程其余部分的工作区,并包含所有Ansible Playbook。 它也将是您将在其中运行所有本地命令的目录。

使用nano或您喜欢的文本编辑器创建名为~/kube-cluster/hosts文件:

nano ~/kube-cluster/hosts

将以下文本添加到文件中,该文件将指定有关群集逻辑结构的信息:

〜/ KUBE群集/主机
[masters]
master ansible_host=master_ip ansible_user=root

[workers]
worker1 ansible_host=worker_1_ip ansible_user=root
worker2 ansible_host=worker_2_ip ansible_user=root

[all:vars]
ansible_python_interpreter=/usr/bin/python3

您可能还记得Ansible中的库存文件用于指定服务器信息,例如IP地址,远程用户和服务器分组,以作为执行命令的单个单元进行目标。 ~/kube-cluster/hosts将是您的库存文件,并且您已向其添加了两个Ansible组( 主服务器工作者 ),用于指定集群的逻辑结构。

服务器组中,有一个名为“master”的服务器条目,列出主节点的IP( master_ip ),并指定Ansible应以root用户身份运行远程命令。

同样,在workers组中,有两个工作服务器条目( worker_1_ipworker_2_ip ),它们也将ansible_user指定为root。

该文件的最后一行告诉Ansible使用远程服务器的Python 3解释器进行管理操作。

添加文本后保存并关闭文件。

使用组设置服务器清单后,我们继续安装操作系统级依赖关系并创建配置设置。

第2步 - 在所有远程服务器上创建非root用户

在本节中,您将在所有服务器上创建一个具有sudo权限的非root用户,以便您可以作为非特权用户手动SSH连接到这些用户。 例如,如果您希望使用top/htop等命令查看系统信息,查看正在运行的容器列表或更改root拥有的配置文件,这将非常有用。 这些操作通常在维护群集期间执行,并且使用非root用户执行此类任务可以最大程度地降低修改或删除重要文件或无意中执行其他危险操作的风险。

在工作区中创建名为~/kube-cluster/initial.yml的文件:

nano ~/kube-cluster/initial.yml

接下来,将以下播放添加到该文件以创建在所有服务器上具有sudo权限的非root用户。 Ansible中的游戏是针对特定服务器和组执行的一系列步骤。 以下播放将创建一个非root sudo用户:

〜/ KUBE群集/ initial.yml
- hosts: all
  become: yes
  tasks:
    - name: create the 'sammy' user
      user: name=sammy append=yes state=present createhome=yes shell=/bin/bash

    - name: allow 'sammy' to have passwordless sudo
      lineinfile:
        dest: /etc/sudoers
        line: 'sammy ALL=(ALL) NOPASSWD: ALL'
        validate: 'visudo -cf %s'

    - name: set up authorized keys for the sammy user
      authorized_key: user=sammy key="{{item}}"
      with_file:
        - ~/.ssh/id_rsa.pub

这是这个剧本的作用细分:

  • 创建非root用户sammy

  • 配置sudoers文件以允许sammy用户在没有密码提示的情况下运行sudo命令。

  • 将本地计算机中的~/.ssh/id_rsa.pub (通常为~/.ssh/id_rsa.pub )添加到远程sammy用户的授权密钥列表中。 这将允许您以sammy用户身份SSH到每个服务器。

添加文本后保存并关闭文件。

接下来,通过本地运行执行playbook:

ansible-playbook -i hosts ~/kube-cluster/initial.yml

该命令将在两到五分钟内完成。 完成后,您将看到类似于以下内容的输出:

PLAY [all] ****

TASK [Gathering Facts] ****
ok: [master]
ok: [worker1]
ok: [worker2]

TASK [create the 'sammy' user] ****
changed: [master]
changed: [worker1]
changed: [worker2]

TASK [allow 'sammy' user to have passwordless sudo] ****
changed: [master]
changed: [worker1]
changed: [worker2]

TASK [set up authorized keys for the sammy user] ****
changed: [worker1] => (item=ssh-rsa AAAAB3...)
changed: [worker2] => (item=ssh-rsa AAAAB3...)
changed: [master] => (item=ssh-rsa AAAAB3...)

PLAY RECAP ****
master                     : ok=5    changed=4    unreachable=0    failed=0   
worker1                    : ok=5    changed=4    unreachable=0    failed=0   
worker2                    : ok=5    changed=4    unreachable=0    failed=0   

现在初步设置已完成,您可以继续安装特定于Kubernetes的依赖项。

第3步 - 安装Kubernetes依赖项

在本节中,您将使用Debian的软件包管理器安装Kubernetes所需的操作系统级软件包。 这些包是:

  • Docker - 容器运行时。 它是运行容器的组件。 Kubernetes正在积极开发对rkt等其他运行时的支持。

  • kubeadm - 一个CLI工具,它将以标准方式安装和配置集群的各个组件。

  • kubelet - 一个在所有节点上运行并处理节点级操作的系统服务/程序。

  • kubectl - 一种CLI工具,用于通过其API服务器向集群发出命令。

在工作区中创建一个名为~/kube-cluster/kube-dependencies.yml的文件:

nano ~/kube-cluster/kube-dependencies.yml

将以下播放添加到文件以将这些包安装到您的服务器:

〜/ KUBE群集/ KUBE-dependencies.yml
- hosts: all
  become: yes
  tasks:
   - name: install remote apt deps
     apt:
       name: "{{ item }}"
       state: present
     with_items:
       - apt-transport-https
       - ca-certificates
       - gnupg2
       - software-properties-common

   - name: add Docker apt-key
     apt_key:
       url: https://download.docker.com/linux/debian/gpg
       state: present

   - name: add Docker's APT repository
     apt_repository:
      repo: deb https://download.docker.com/linux/debian stretch stable
      state: present
      filename: 'docker'

   - name: install Docker
     apt:
       name: docker-ce
       state: present
       update_cache: true

   - name: add Kubernetes apt-key
     apt_key:
       url: https://packages.cloud.google.com/apt/doc/apt-key.gpg
       state: present

   - name: add Kubernetes' APT repository
     apt_repository:
      repo: deb http://apt.kubernetes.io/ kubernetes-xenial main
      state: present
      filename: 'kubernetes'

   - name: install kubelet
     apt:
       name: kubelet=1.14.0-00
       state: present
       update_cache: true

   - name: install kubeadm
     apt:
       name: kubeadm=1.14.0-00
       state: present

- hosts: master
  become: yes
  tasks:
   - name: install kubectl
     apt:
       name: kubectl=1.14.0-00
       state: present
       force: yes

剧本中的第一部戏剧如下:

  • 添加依赖项以添加,验证和安装远程存储库中的包。

  • 添加Docker APT存储库的apt-key以进行密钥验证。

  • 安装Docker,容器运行时。

  • 添加Kubernetes APT存储库的apt-key进行密钥验证。

  • 将Kubernetes APT存储库添加到远程服务器的APT源列表中。

  • 安装kubeletkubeadm

第二个游戏包含一个在主节点上安装kubectl任务。

注意:虽然Kubernetes文档建议您为您的环境使用最新的Kubernetes稳定版本,但本教程使用特定版本。 这将确保您可以成功地执行这些步骤,因为Kubernetes快速更改,并且最新版本可能无法与本教程一起使用。

完成后保存并关闭文件。

接下来,通过本地运行执行playbook:

ansible-playbook -i hosts ~/kube-cluster/kube-dependencies.yml

完成后,您将看到类似于以下内容的输出:

PLAY [all] ****

TASK [Gathering Facts] ****
ok: [worker1]
ok: [worker2]
ok: [master]

TASK [install Docker] ****
changed: [master]
changed: [worker1]
changed: [worker2]

TASK [install APT Transport HTTPS] *****
ok: [master]
ok: [worker1]
changed: [worker2]

TASK [add Kubernetes apt-key] *****
changed: [master]
changed: [worker1]
changed: [worker2]

TASK [add Kubernetes' APT repository] *****
changed: [master]
changed: [worker1]
changed: [worker2]

TASK [install kubelet] *****
changed: [master]
changed: [worker1]
changed: [worker2]

TASK [install kubeadm] *****
changed: [master]
changed: [worker1]
changed: [worker2]

PLAY [master] *****

TASK [Gathering Facts] *****
ok: [master]

TASK [install kubectl] ******
ok: [master]

PLAY RECAP ****
master                     : ok=9    changed=5    unreachable=0    failed=0   
worker1                    : ok=7    changed=5    unreachable=0    failed=0  
worker2                    : ok=7    changed=5    unreachable=0    failed=0  

执行后,Docker, kubeadmkubelet将安装在所有远程服务器上。 kubectl不是必需组件,仅用于执行集群命令。 在此上下文中仅在主节点上安装它是有意义的,因为您将kubectl主服务器运行kubectl命令。 但是,请注意, kubectl命令可以从任何工作节点运行,也可以从可以安装和配置为指向集群的任何计算机运行。

现在已安装所有系统依赖项。 让我们设置主节点并初始化集群。

第4步 - 设置主节点

在本节中,您将设置主节点。 但是,在创建任何Playbooks之前,值得介绍一些概念,例如PodPod网络插件 ,因为您的群集将同时包含这两个概念。

pod是运行一个或多个容器的原子单元。 这些容器共享资源,例如文件卷和网络接口。 Pod是Kubernetes中的基本调度单元:pod中的所有容器都保证在调度pod的同一节点上运行。

每个pod都有自己的IP地址,一个节点上的pod应该能够使用pod的IP访问另一个节点上的pod。 单个节点上的容器可以通过本地接口轻松进行通信。 然而,pod之间的通信更复杂,并且需要单独的网络组件,该组件可以透明地将来自一个节点上的pod的流量路由到另一个节点上的pod。

此功能由pod网络插件提供。 对于这个群集,您将使用Flannel ,一个稳定且高性能的选项。

在本地计算机上创建一个名为master.yml的Ansible playbook:

nano ~/kube-cluster/master.yml

将以下播放添加到文件以初始化集群并安装Flannel:

〜/ KUBE群集/ master.yml
- hosts: master
  become: yes
  tasks:
    - name: initialize the cluster
      shell: kubeadm init --pod-network-cidr=10.244.0.0/16 >> cluster_initialized.txt
      args:
        chdir: $HOME
        creates: cluster_initialized.txt

    - name: create .kube directory
      become: yes
      become_user: sammy
      file:
        path: $HOME/.kube
        state: directory
        mode: 0755

    - name: copy admin.conf to user's kube config
      copy:
        src: /etc/kubernetes/admin.conf
        dest: /home/sammy/.kube/config
        remote_src: yes
        owner: sammy

    - name: install Pod network
      become: yes
      become_user: sammy
      shell: kubectl apply -f https://raw.githubusercontent.com/coreos/flannel/a70459be0084506e4ec919aa1c114638878db11b/Documentation/kube-flannel.yml >> pod_network_setup.txt
      args:
        chdir: $HOME
        creates: pod_network_setup.txt

这是这个戏剧的细分:

  • 第一个任务是通过运行kubeadm init初始化集群。 传递参数--pod-network-cidr=10.244.0.0/16指定将从中分配pod IP的私有子网。 法兰绒默认使用上述子网; 我们告诉kubeadm使用相同的子网。

  • 第二个任务在/home/sammy创建一个.kube目录。 此目录将保存配置信息,例如连接到群集所需的管理密钥文件以及群集的API地址。

  • 第三个任务将从kubeadm init生成的/etc/kubernetes/admin.conf文件复制到非root用户的主目录。 这将允许您使用kubectl访问新创建的集群。

  • 最后一个任务运行kubectl apply安装Flannel kubectl apply -f descriptor.[yml|json]是告诉kubectl创建描述descriptor.[yml|json]文件中descriptor.[yml|json]的对象的语法。 kube-flannel.yml文件包含在集群中设置Flannel所需的对象的描述。

完成后保存并关闭文件。

通过运行本地执行Playbook:

ansible-playbook -i hosts ~/kube-cluster/master.yml

完成后,您将看到类似于以下内容的输出:


PLAY [master] ****

TASK [Gathering Facts] ****
ok: [master]

TASK [initialize the cluster] ****
changed: [master]

TASK [create .kube directory] ****
changed: [master]

TASK [copy admin.conf to user's kube config] *****
changed: [master]

TASK [install Pod network] *****
changed: [master]

PLAY RECAP ****
master                     : ok=5    changed=4    unreachable=0    failed=0  

要检查主节点的状态,请使用以下命令通过SSH连接到该节点:

ssh sammy@master_ip

进入主节点后,执行:

kubectl get nodes

您现在将看到以下输出:

NAME      STATUS    ROLES     AGE       VERSION
master    Ready     master    1d        v1.14.0

输出指出master节点已完成所有初始化任务并处于Ready状态,从该状态开始,它可以开始接受工作节点并执行发送到API服务器的任务。 您现在可以从本地计算机添加工作程序。

第5步 - 设置工作节点

将工作程序添加到集群涉及在每个集群上执行单个命令。 此命令包括必要的群集信息,例如主服务器API服务器的IP地址和端口以及安全令牌。 只有传入安全令牌的节点才能加入群集。

导航回您的工作区并创建一个名为workers.yml的剧本:

nano ~/kube-cluster/workers.yml

将以下文本添加到文件中以将工作程序添加到集群:

〜/ KUBE群集/ workers.yml
- hosts: master
  become: yes
  gather_facts: false
  tasks:
    - name: get join command
      shell: kubeadm token create --print-join-command
      register: join_command_raw

    - name: set join command
      set_fact:
        join_command: "{{ join_command_raw.stdout_lines[0] }}"


- hosts: workers
  become: yes
  tasks:
    - name: join cluster
      shell: "{{ hostvars['master'].join_command }} >> node_joined.txt"
      args:
        chdir: $HOME
        creates: node_joined.txt

这是剧本的作用:

  • 第一个play获取需要在worker节点上运行的join命令。 此命令将采用以下格式: kubeadm join --token <token> <master-ip>:<master-port> --discovery-token-ca-cert-hash sha256:<hash> 一旦它获得具有适当的令牌哈希值的实际命令,该任务就将其设置为事实,以便下一个游戏将能够访问该信息。

  • 第二个游戏有一个任务,它在所有工作节点上运行join命令。 完成此任务后,两个工作节点将成为群集的一部分。

完成后保存并关闭文件。

通过本地运行执行playbook:

ansible-playbook -i hosts ~/kube-cluster/workers.yml

完成后,您将看到类似于以下内容的输出:

PLAY [master] ****

TASK [get join command] ****
changed: [master]

TASK [set join command] *****
ok: [master]

PLAY [workers] *****

TASK [Gathering Facts] *****
ok: [worker1]
ok: [worker2]

TASK [join cluster] *****
changed: [worker1]
changed: [worker2]

PLAY RECAP *****
master                     : ok=2    changed=1    unreachable=0    failed=0   
worker1                    : ok=2    changed=1    unreachable=0    failed=0  
worker2                    : ok=2    changed=1    unreachable=0    failed=0  

通过添加工作节点,您的群集现在已完全设置并正常运行,工作人员可以准备好运行工作负载。 在安排应用程序之前,让我们验证群集是否按预期工作。

第6步 - 验证群集

集群有时可能在安装过​​程中失败,因为节点已关闭或主服务器与工作服务器之间的网络连接无法正常工作。 让我们验证集群并确保节点正常运行。

您需要从主节点检查群集的当前状态,以确保节点已准备就绪。 如果从主节点断开连接,则可以使用以下命令通过SSH将其重新连接到主节点:

ssh sammy@master_ip

然后执行以下命令以获取集群的状态:

kubectl get nodes

您将看到类似于以下内容的输出:

NAME      STATUS    ROLES     AGE       VERSION
master    Ready     master    1d        v1.14.0
worker1   Ready     <none>    1d        v1.14.0
worker2   Ready     <none>    1d        v1.14.0

如果所有节点都具有Ready for STATUS值,则表示它们是群集的一部分并准备好运行工作负载。

但是,如果一些节点将NotReady作为STATUS ,则可能意味着工作节点尚未完成其设置。 等待大约五到十分钟,然后重新运行kubectl get nodes并检查新输出。 如果少数节点仍具有NotReady作为状态,则可能必须验证并重新运行前面步骤中的命令。

现在您的集群已成功验证,让我们在集群上安排一个示例Nginx应用程序。

第7步 - 在群集上运行应用程序

您现在可以将任何容器化应用程序部署到您的群集。 为了保持熟悉,让我们使用部署服务部署Nginx,以了解如何将此应用程序部署到集群。 如果更改Docker映像名称和任何相关标志(如portsvolumes ),也可以将以下命令用于其他容器化应用程序。

仍在主节点内,执行以下命令以创建名为nginx的部署:

kubectl create deployment nginx --image=nginx

部署是一种Kubernetes对象,可确保始终根据已定义的模板运行指定数量的pod,即使pod在群集生命周期内崩溃也是如此。 上面的部署将使用Docker注册表的Nginx Docker Image创建一个包含一个容器的pod。

接下来,运行以下命令以创建名为nginx的服务,该服务将公开公开该应用程序。 它将通过NodePort实现 ,该方案将通过在群集的每个节点上打开的任意端口访问pod:

kubectl expose deploy nginx --port 80 --target-port 80 --type NodePort

服务是另一种类型的Kubernetes对象,它向内部和外部客户端公开集群内部服务。 它们还能够对多个pod进行负载均衡请求,并且是Kubernetes中不可或缺的组件,经常与其他组件交互。

运行以下命令:

kubectl get services

这将输出类似于以下内容的文本:

NAME         TYPE        CLUSTER-IP       EXTERNAL-IP           PORT(S)             AGE
kubernetes   ClusterIP   10.96.0.1        <none>                443/TCP             1d
nginx        NodePort    10.109.228.209   <none>                80:nginx_port/TCP   40m

从上面输出的第三行,您可以检索运行Nginx的端口。 Kubernetes将自动分配一个大于30000的随机端口,同时确保该端口尚未受到其他服务的约束。

要测试一切是否正常,请通过本地计算机上的浏览器访问http:// worker_1_ip : nginx_porthttp:// worker_2_ip : nginx_port 您将看到Nginx熟悉的欢迎页面。

如果要删除Nginx应用程序,请先从主节点删除nginx服务:

kubectl delete service nginx

运行以下命令以确保已删除该服务:

kubectl get services

您将看到以下输出:

NAME         TYPE        CLUSTER-IP       EXTERNAL-IP           PORT(S)        AGE
kubernetes   ClusterIP   10.96.0.1        <none>                443/TCP        1d

然后删除部署:

kubectl delete deployment nginx

运行以下命令以确认这是否有效:

kubectl get deployments
No resources found.

结论

在本指南中,您已使用Kubeadm和Ansible成功在Debian 9上设置Kubernetes集群以实现自动化。

如果您想知道如何在群集设置的情况下对群集进行操作,那么下一步就是将自己的应用程序和服务部署到群集上。 这是一个链接列表,其中包含可以指导您完成此过程的更多信息:

  • Dockerizing应用程序 - 列出了详细说明如何使用Docker对应用程序进行容器化的示例。

  • Pod概述 - 详细描述了Pod如何工作以及它们与其他Kubernetes对象的关系。 豆荚在Kubernetes中无处不在,因此了解它们将有助于您的工作。

  • 部署概述 - 提供部署概述 了解部署控制器如何工作非常有用,因为它们在无状态应用程序中经常用于扩展和不健康应用程序的自动修复。

  • 服务概述 - 涵盖服务,Kubernetes集群中另一个常用对象。 了解服务类型及其选项对于运行无状态和有状态应用程序至关重要。

您可以研究的其他重要概念是VolumesIngressesSecrets ,所有这些在部署生产应用程序时都会派上用场。

Kubernetes提供了许多功能和特性。 Kubernetes官方文档是了解概念,查找特定于任务的指南以及查找各种对象的API参考的最佳位置。