feat: добавлена пометка типа операции (Build/Push) в истории сборок Dockerfile
- Добавлена колонка 'Тип' во все таблицы истории сборок - Для push операций отображается registry вместо платформ - Сохранение пользователя при создании push лога - Исправлена ошибка с logger в push_docker_image endpoint - Улучшено отображение истории сборок с визуальными индикаторами
This commit is contained in:
248
app/alembic/roles/devops/README.md
Normal file
248
app/alembic/roles/devops/README.md
Normal file
@@ -0,0 +1,248 @@
|
||||
# Роль devops
|
||||
|
||||
Универсальная роль для создания пользователя devops с SSH ключами и sudo правами на всех поддерживаемых операционных системах.
|
||||
|
||||
## Автор
|
||||
|
||||
**Сергей Антропов**
|
||||
Сайт: https://devops.org.ru
|
||||
|
||||
## Описание
|
||||
|
||||
Роль `devops` создает универсального пользователя для DevOps задач со следующими возможностями:
|
||||
|
||||
- ✅ Создание пользователя `devops` с настраиваемым UID/GID
|
||||
- ✅ Установка пароля длиной 30 символов из vault
|
||||
- ✅ Настройка sudo прав без ввода пароля
|
||||
- ✅ Добавление SSH публичного ключа для подключения
|
||||
- ✅ Поддержка всех ОС из dockerfiles/
|
||||
- ✅ Детальное логирование и проверки
|
||||
- ✅ Уведомления о статусе выполнения
|
||||
|
||||
## Поддерживаемые ОС
|
||||
|
||||
- **Red Hat семейство**: RHEL 7/8/9, CentOS 7/8/9, AlmaLinux 8, Rocky Linux 8
|
||||
- **Debian семейство**: Debian 9/10/11/12, Ubuntu 20.04/22.04/24.04
|
||||
- **SUSE**: SLES 15.x
|
||||
- **Alpine**: 3.15+
|
||||
- **Российские ОС**: Astra Linux 1.7, RED OS 7/9, ALT Linux 9/10
|
||||
|
||||
## Требования
|
||||
|
||||
- Ansible >= 2.9
|
||||
- Python >= 3.6
|
||||
- Доступ к vault с секретами
|
||||
- Права sudo/root на целевых хостах
|
||||
|
||||
## Переменные
|
||||
|
||||
### Основные переменные
|
||||
|
||||
| Переменная | По умолчанию | Описание |
|
||||
|------------|--------------|----------|
|
||||
| `devops_user` | `devops` | Имя пользователя |
|
||||
| `devops_group` | `devops` | Основная группа пользователя |
|
||||
| `devops_home` | `/home/devops` | Домашняя директория |
|
||||
| `devops_shell` | `/bin/bash` | Оболочка пользователя |
|
||||
| `devops_uid` | `1001` | UID пользователя |
|
||||
| `devops_gid` | `1001` | GID группы |
|
||||
|
||||
### Переменные из vault
|
||||
|
||||
| Переменная | Описание | Обязательная |
|
||||
|------------|----------|--------------|
|
||||
| `vault_devops_password` | Пароль пользователя (30 символов) | ✅ |
|
||||
| `vault_devops_ssh_public_key` | SSH публичный ключ | ✅ |
|
||||
|
||||
### Настройки sudo
|
||||
|
||||
| Переменная | По умолчанию | Описание |
|
||||
|------------|--------------|----------|
|
||||
| `devops_sudo_nopasswd` | `true` | Выполнение sudo без пароля |
|
||||
| `devops_sudo_commands` | `ALL` | Разрешенные команды |
|
||||
| `devops_sudoers_file` | `/etc/sudoers.d/devops` | Путь к файлу sudoers |
|
||||
|
||||
### Настройки SSH
|
||||
|
||||
| Переменная | По умолчанию | Описание |
|
||||
|------------|--------------|----------|
|
||||
| `devops_ssh_dir` | `/home/devops/.ssh` | SSH директория |
|
||||
| `devops_ssh_authorized_keys` | `/home/devops/.ssh/authorized_keys` | Файл с ключами |
|
||||
| `devops_ssh_dir_mode` | `0700` | Права на SSH директорию |
|
||||
| `devops_ssh_keys_mode` | `0600` | Права на файлы ключей |
|
||||
|
||||
### Дополнительные группы
|
||||
|
||||
| Переменная | По умолчанию | Описание |
|
||||
|------------|--------------|----------|
|
||||
| `devops_additional_groups` | `['sudo', 'wheel', 'docker', 'systemd-journal']` | Дополнительные группы |
|
||||
|
||||
## Примеры использования
|
||||
|
||||
### Базовое использование
|
||||
|
||||
```yaml
|
||||
- hosts: all
|
||||
become: yes
|
||||
roles:
|
||||
- devops
|
||||
vars:
|
||||
vault_devops_password: "your-30-char-password-here"
|
||||
vault_devops_ssh_public_key: "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQC..."
|
||||
```
|
||||
|
||||
### С кастомными настройками
|
||||
|
||||
```yaml
|
||||
- hosts: all
|
||||
become: yes
|
||||
roles:
|
||||
- devops
|
||||
vars:
|
||||
devops_user: "admin"
|
||||
devops_home: "/home/admin"
|
||||
devops_uid: 2000
|
||||
devops_gid: 2000
|
||||
devops_additional_groups:
|
||||
- "sudo"
|
||||
- "docker"
|
||||
- "kvm"
|
||||
vault_devops_password: "your-30-char-password-here"
|
||||
vault_devops_ssh_public_key: "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQC..."
|
||||
```
|
||||
|
||||
### С отключенными проверками
|
||||
|
||||
```yaml
|
||||
- hosts: all
|
||||
become: yes
|
||||
roles:
|
||||
- devops
|
||||
vars:
|
||||
devops_verify_user: false
|
||||
devops_verify_ssh: false
|
||||
devops_verify_sudo: false
|
||||
devops_notify_on_success: false
|
||||
vault_devops_password: "your-30-char-password-here"
|
||||
vault_devops_ssh_public_key: "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQC..."
|
||||
```
|
||||
|
||||
## Теги
|
||||
|
||||
Роль поддерживает следующие теги для выборочного выполнения:
|
||||
|
||||
- `devops` - все задачи роли
|
||||
- `validation` - проверка входных параметров
|
||||
- `packages` - установка пакетов
|
||||
- `group` - создание группы
|
||||
- `user` - создание пользователя
|
||||
- `password` - установка пароля
|
||||
- `ssh` - настройка SSH
|
||||
- `keys` - настройка SSH ключей
|
||||
- `sudo` - настройка sudo прав
|
||||
- `permissions` - настройка прав доступа
|
||||
- `config` - дополнительная конфигурация
|
||||
- `verification` - проверка настройки
|
||||
- `notification` - уведомления
|
||||
|
||||
### Примеры использования тегов
|
||||
|
||||
```bash
|
||||
# Только создание пользователя и группы
|
||||
ansible-playbook -i inventory converge.yml --tags "user,group"
|
||||
|
||||
# Только настройка SSH
|
||||
ansible-playbook -i inventory converge.yml --tags "ssh,keys"
|
||||
|
||||
# Только настройка sudo
|
||||
ansible-playbook -i inventory converge.yml --tags "sudo,permissions"
|
||||
|
||||
# Пропустить проверки
|
||||
ansible-playbook -i inventory converge.yml --skip-tags "verification"
|
||||
```
|
||||
|
||||
## Обработчики
|
||||
|
||||
Роль включает следующие обработчики:
|
||||
|
||||
- `restart ssh service` - перезапуск SSH сервиса
|
||||
- `check ssh config` - проверка конфигурации SSH
|
||||
- `log changes` - логирование изменений
|
||||
- `notify completion` - уведомления о завершении
|
||||
- `cleanup temp files` - очистка временных файлов
|
||||
- `security check` - проверка безопасности
|
||||
- `collect statistics` - сбор статистики
|
||||
|
||||
## Логирование
|
||||
|
||||
Роль поддерживает детальное логирование:
|
||||
|
||||
- Уровень логирования настраивается через `devops_log_level`
|
||||
- Логи записываются в `devops_log_file` (по умолчанию `/var/log/devops-setup.log`)
|
||||
- Поддерживается логирование в syslog
|
||||
- Все операции логируются с временными метками
|
||||
|
||||
## Безопасность
|
||||
|
||||
Роль следует лучшим практикам безопасности:
|
||||
|
||||
- SSH ключи имеют правильные права доступа (600)
|
||||
- SSH директория имеет права 700
|
||||
- Sudoers файл имеет права 440
|
||||
- Пароли хешируются с использованием SHA-512
|
||||
- Поддерживается строгая проверка SSH конфигурации
|
||||
- Логирование всех операций для аудита
|
||||
|
||||
## Тестирование
|
||||
|
||||
Роль протестирована на следующих ОС:
|
||||
|
||||
- Ubuntu 20.04/22.04/24.04
|
||||
- Debian 9/10/11/12
|
||||
- CentOS 7/8/9
|
||||
- RHEL 7/8/9
|
||||
- AlmaLinux 8
|
||||
- Rocky Linux 8
|
||||
- SLES 15.x
|
||||
- Alpine 3.15+
|
||||
- Astra Linux 1.7
|
||||
- RED OS 7/9
|
||||
- ALT Linux 9/10
|
||||
|
||||
## Устранение неполадок
|
||||
|
||||
### Проблемы с паролем
|
||||
|
||||
```bash
|
||||
# Проверка хеша пароля
|
||||
ansible all -m debug -a "msg={{ 'your-password' | password_hash('sha512') }}"
|
||||
```
|
||||
|
||||
### Проблемы с SSH
|
||||
|
||||
```bash
|
||||
# Проверка SSH конфигурации
|
||||
sudo sshd -t
|
||||
|
||||
# Проверка прав доступа
|
||||
ls -la /home/devops/.ssh/
|
||||
```
|
||||
|
||||
### Проблемы с sudo
|
||||
|
||||
```bash
|
||||
# Проверка sudoers файла
|
||||
sudo visudo -c -f /etc/sudoers.d/devops
|
||||
|
||||
# Тест sudo прав
|
||||
sudo -l -U devops
|
||||
```
|
||||
|
||||
## Лицензия
|
||||
|
||||
MIT
|
||||
|
||||
## Поддержка
|
||||
|
||||
- Сайт: https://devops.org.ru
|
||||
- Автор: Сергей Антропов
|
||||
Reference in New Issue
Block a user