nephelaiio.kind
nephelaiio.kind
一个用于安装和销毁 Kind 集群的 ansible 角色
角色变量
使用默认值角色将创建一个使用最新的 kind 发行版和镜像的 4 节点集群。以下是用户可配置的变量列表
参数 | 默认值 | 类型 | 是否必需 | 描述 |
---|---|---|---|---|
kind_release_tag | latest | 字符串 | 否 | 从 Kind 的 发布页面 获取 |
kind_image_tag | latest | 字符串 | 否 | 从 docker hub 获取 |
kind_cluster_state | present | 字符串 | 否 | 是否创建('present')或销毁('absent')目标集群 |
kind_cluster_name | kind | 字符串 | 否 | 要创建/销毁的集群名称 |
kind_network_addr | 172.160.0/16 | 字符串 | 否 | kind docker 网络的子网 |
kind_kubeconfig | ~/.kube/config | 字符串 | 否 | 用于存储集群 kubeconfig 文件的路径 |
kind_bin | undefined | 字符串 | 否 | 用于部署集群的 kind 可执行文件的路径 |
kind_registry_deploy | false | 布尔值 | 否 | 创建本地注册表容器 |
kind_registry_hostname | localhost | 字符串 | 否 | 本地 docker 注册表的主机名 |
kind_registry_cleanup | true | 字符串 | 否 | 随集群销毁本地注册表容器 |
kind_registry_port | 49153 | 整数 | 否 | 本地 docker 注册表的主机绑定端口 |
kind_proxy_deploy | false | 布尔值 | 否 | 部署代理注册表容器 |
kind_proxy_hostname | localhost | 字符串 | 否 | 代理注册表的主机名 |
kind_proxy_cleanup | true | 字符串 | 否 | 将代理注册表容器添加到集群配置 |
kind_nodes | 4 | 整数 | 否 | 集群大小 |
依赖
系统
执行此模块的主机需要满足以下要求:
- 64 位的 Linux 或 Darwin 操作系统
- kubectl 可执行文件在路径中可用
该角色与 arm64 和 darwin 发行版兼容。运行此角色之前,您必须收集系统信息。
要在苹果硅设备上运行此角色,您 必须 将环境变量 DOCKER_HOST
导出为 unix:///$HOME/.docker/run/docker.sock
。默认的 unix:///var/run/docker.sock
在 MacOS 上不可用。
Ansible
执行此模块的主机需要以下 python 集合:
- ansible.utils
示例剧本
---
- name: converge
hosts: all
roles:
- nephelaiio.kind
测试
请确保您的环境中已安装 docker;然后使用以下命令从项目根目录测试该角色
poetry install
poetry run molecule test
许可证
该项目根据 MIT 许可证 授权。