安装与使用Ansible角色k3s部署指南

1. 项目目录结构及介绍

本指南基于PyratLabs/ansible-role-k3s这一GitHub仓库，它提供了一个用于通过Ansible自动化部署K3s（轻量级的Kubernetes发行版）的角色。以下是对该项目基本目录结构的概览：

• roles/xanmanning.k3s: 这是核心角色所在位置，包含了任务(tasks)、默认变量(defaults)、 handlers、模板(templates)等子目录。
  • main.yml: 包含了该角色的主要任务集。
  • vars/main.yml: 存储默认的变量配置。
• tests: 包含示例Playbook，用于测试角色的功能。
• meta: 包含关于角色的元数据。
• README.md: 提供了安装和配置的基本说明。

2. 项目的启动文件介绍

在Ansible中，并没有传统意义上的单一“启动文件”，而是通过Playbook来定义和执行任务序列。对于这个特定的角色，你可以创建一个Playbook文件，比如install_k3s.yml，并调用xanmanning.k3s角色来实现K3s的安装。一个简单的Playbook示例如下：

---
- name: Deploy K3s Cluster
  hosts: servers
  become: yes
  roles:
    - role: xanmanning.k3s
      k3s_state: installed
      k3s_server: true

这里，“servers”应该替换为你想要部署K3s的主机组名称，k3s_state: installed表示要安装K3s，而k3s_server: true表明这是控制节点的设置。

3. 项目的配置文件介绍

自K3s v1.19.1+k3s1起，推荐使用配置文件而非环境变量或命令行参数来配置K3s。此Ansible角色支持两种配置模式：服务器（控制平面）和代理（工作节点）。主要配置通过以下方式指定：

• 服务器配置 (k3s_server): 可以通过设定特定的YAML配置文件路径到k3s_config_file变量来定制K3s服务器的配置。

• 代理节点配置 (k3s_agent): 对于集群中的节点，则可以通过相似的方法但适用agent场景的配置进行调整。

重要的是，这些配置内容不直接硬编码进入Playbook，而是通过Ansible变量传递给角色，这些变量进一步指导如何生成或修改K3s的配置文件或者执行相应的配置任务。变量如k3s_server, k3s_agent, 和其他全局或集群级别的变量，都允许精细地控制K3s的部署细节。

确保在你的Ansible Playbook中正确设置这些变量，以便根据需要定制您的K3s部署。例如，您可以调整版本(k3s_release_version)、是否启用空气间隙安装(k3s_airgap)等关键配置项。

请注意，详细了解每个变量的作用和如何自定义，应参考角色的最新文档部分，特别是defaults/main.yml和docs（如果仓库中有提供详细文档的话），以获取最新的配置选项和最佳实践。