Added README.md

k8s/README.md

@@ -1,6 +1,43 @@
-----------
+# Kubernetes Cluster Initialization Playbook
-# В данном плейбуке происходит инициализация кластера K8s.
-## В каждой таске есть свой тэг, поэтому, если необходимо исключительно присоединить новый воркер к ноде, то можно выполнить команду:
-### ansible-playbook -i inventory.ini playbook.yml --tags join так это делается?
 
-----------
+Этот плейбук предназначен для автоматизации настройки и инициализации Kubernetes-кластера. Он включает в себя роли для базовой настройки узлов, инициализации мастер-узла и присоединения worker-узлов к кластеру.
+
+---
+
+## Структура плейбука
+
+Плейбук состоит из следующих ролей:
+
+1. **Базовая настройка (`common-kubernetes`):**
+   - Обновление системы.
+   - Отключение swap.
+   - Настройка ядра (модули `overlay` и `br_netfilter`).
+   - Установка необходимых пакетов (kubeadm, kubelet, kubectl, cri-o).
+
+2. **Инициализация мастер-узла (`master-kubernetes`):**
+   - Инициализация кластера с помощью `kubeadm init`.
+   - Установка сетевого плагина (Flannel).
+
+3. **Присоединение worker-узлов (`worker-kubernetes`):**
+   - Генерация токена для присоединения на мастер-узле.
+   - Присоединение worker-узлов к кластеру.
+
+---
+
+## Использование
+
+### Запуск всего плейбука
+
+Чтобы выполнить все задачи (базовая настройка, инициализация мастер-узла и присоединение worker-узлов), выполните команду:
+
+```bash
+ansible-playbook -i inventory.ini k8s.yml
+```
+--- 
+### Запуск определённой задачи
+Если необходимо только подключение новой ноды, то необходимо выполнить следующую команду:
+
+```bash
+ansible-playbook -i inventory.ini k8s.yml --tags join
+```
+И эта команда присоединит все worker ноды

k8s/roles/common-kubernetes/README.md

@@ -1,43 +1,20 @@
-# Kubernetes Cluster Initialization Playbook
+Role Name
+=========
 
-Этот плейбук предназначен для автоматизации настройки и инициализации Kubernetes-кластера. Он включает в себя роли для базовой настройки узлов, инициализации мастер-узла и присоединения worker-узлов к кластеру.
+Это базовый набор, необходимый для инициализации кластера.
+Тут происходит установка всех модулей, необходимых для настройки кластера K8s
 
----
+Requirements
+------------
 
-## Структура плейбука
+Any pre-requisites that may not be covered by Ansible itself or the role should be mentioned here. For instance, if the role uses the EC2 module, it may be a good idea to mention in this section that the boto package is required.
 
-Плейбук состоит из следующих ролей:
+Role Variables
+--------------
 
-1. **Базовая настройка (`common-kubernetes`):**
+A description of the settable variables for this role should go here, including any variables that are in defaults/main.yml, vars/main.yml, and any variables that can/should be set via parameters to the role. Any variables that are read from other roles and/or the global scope (ie. hostvars, group vars, etc.) should be mentioned here as well.
-   - Обновление системы.
-   - Отключение swap.
-   - Настройка ядра (модули `overlay` и `br_netfilter`).
-   - Установка необходимых пакетов (kubeadm, kubelet, kubectl, cri-o).
 
-2. **Инициализация мастер-узла (`master-kubernetes`):**
+Dependencies
-   - Инициализация кластера с помощью `kubeadm init`.
+------------
-   - Установка сетевого плагина (Flannel).
 
-3. **Присоединение worker-узлов (`worker-kubernetes`):**
+A list of other roles hosted on Galaxy should go here, plus any details in regards to parameters that may need to be set for other roles, or variables that are used from other roles.
-   - Генерация токена для присоединения на мастер-узле.
-   - Присоединение worker-узлов к кластеру.
-
----
-
-## Использование
-
-### Запуск всего плейбука
-
-Чтобы выполнить все задачи (базовая настройка, инициализация мастер-узла и присоединение worker-узлов), выполните команду:
-
-```bash
-ansible-playbook -i inventory.ini k8s.yml
-```
---- 
-### Запуск определённой задачи
-Если необходимо только подключение новой ноды, то необходимо выполнить следующую команду:
-
-```bash
-ansible-playbook -i inventory.ini k8s.yml --tags join
-```
-И эта команда присоединит все worker ноды