From b86d3fc772682a91a1129f1852dce8a48f27a897 Mon Sep 17 00:00:00 2001 From: Markus Pesch Date: Sat, 26 Feb 2022 18:46:02 +0100 Subject: [PATCH] Initial Commit --- .ansible-lint | 3 + .drone.yml | 94 ++++++++++++ .editorconfig | 12 ++ .markdownlint.yaml | 144 ++++++++++++++++++ LICENSE | 20 +++ README.md | 22 +++ defaults/main.yml | 7 + handlers/main.yml | 1 + meta/main.yml | 22 +++ renovate.json | 17 +++ tasks/main.yml | 55 +++++++ .../etc/modules-load.d/10-amd-sve.conf.j2 | 5 + vars/Archlinux.yml | 18 +++ vars/Debian.yml | 19 +++ vars/RedHat.yml | 22 +++ 15 files changed, 461 insertions(+) create mode 100644 .ansible-lint create mode 100644 .drone.yml create mode 100644 .editorconfig create mode 100644 .markdownlint.yaml create mode 100644 LICENSE create mode 100644 README.md create mode 100644 defaults/main.yml create mode 100644 handlers/main.yml create mode 100644 meta/main.yml create mode 100644 renovate.json create mode 100644 tasks/main.yml create mode 100644 templates/etc/modules-load.d/10-amd-sve.conf.j2 create mode 100644 vars/Archlinux.yml create mode 100644 vars/Debian.yml create mode 100644 vars/RedHat.yml diff --git a/.ansible-lint b/.ansible-lint new file mode 100644 index 0000000..dff231b --- /dev/null +++ b/.ansible-lint @@ -0,0 +1,3 @@ +--- + +skip_list: [] \ No newline at end of file diff --git a/.drone.yml b/.drone.yml new file mode 100644 index 0000000..52df20d --- /dev/null +++ b/.drone.yml @@ -0,0 +1,94 @@ +--- +kind: pipeline +type: kubernetes +name: linter + +platform: + os: linux + +steps: +- name: markdown lint + commands: + - markdownlint *.md + image: docker.io/volkerraschek/markdownlint:0.31.1 + resources: + limits: + cpu: 50 + memory: 50M + +- name: email-notification + environment: + PLUGIN_HOST: + from_secret: smtp_host + PLUGIN_USERNAME: + from_secret: smtp_username + PLUGIN_PASSWORD: + from_secret: smtp_password + PLUGIN_FROM: + from_secret: smtp_mail_address + image: docker.io/drillster/drone-email:latest + resources: + limits: + cpu: 50 + memory: 25M + when: + status: + - changed + - failure + +trigger: + event: + exclude: + - tag + +--- +kind: pipeline +type: kubernetes +name: sync + +platform: + os: linux + arch: amd64 + +steps: +- name: github + image: docker.io/appleboy/drone-git-push:latest + resources: + limits: + cpu: 50 + memory: 25M + settings: + branch: master + remote: ssh://git@github.com/volker-raschek/kvm-role.git + force: true + ssh_key: + from_secret: ssh_key + +- name: email-notification + environment: + PLUGIN_HOST: + from_secret: smtp_host + PLUGIN_USERNAME: + from_secret: smtp_username + PLUGIN_PASSWORD: + from_secret: smtp_password + PLUGIN_FROM: + from_secret: smtp_mail_address + image: docker.io/drillster/drone-email:latest + resources: + limits: + cpu: 50 + memory: 25M + when: + status: + - changed + - failure + +trigger: + branch: + - master + event: + - cron + - push + repo: + - volker.raschek/kvm-role diff --git a/.editorconfig b/.editorconfig new file mode 100644 index 0000000..1166a4a --- /dev/null +++ b/.editorconfig @@ -0,0 +1,12 @@ +# EditorConfig is awesome: https://EditorConfig.org + +# top-most EditorConfig file +root = true + +[*] +indent_style = space +indent_size = 2 +end_of_line = lf +charset = utf-8 +trim_trailing_whitespace = true +insert_final_newline = false \ No newline at end of file diff --git a/.markdownlint.yaml b/.markdownlint.yaml new file mode 100644 index 0000000..3406b43 --- /dev/null +++ b/.markdownlint.yaml @@ -0,0 +1,144 @@ +# markdownlint YAML configuration +# https://github.com/DavidAnson/markdownlint/blob/main/schema/.markdownlint.yaml + +# Default state for all rules +default: true + +# Path to configuration file to extend +extends: null + +# MD003/heading-style/header-style - Heading style +MD003: + # Heading style + style: "atx" + +# MD004/ul-style - Unordered list style +MD004: + style: "dash" + +# MD007/ul-indent - Unordered list indentation +MD007: + # Spaces for indent + indent: 2 + # Whether to indent the first level of the list + start_indented: false + +# MD009/no-trailing-spaces - Trailing spaces +MD009: + # Spaces for line break + br_spaces: 2 + # Allow spaces for empty lines in list items + list_item_empty_lines: false + # Include unnecessary breaks + strict: false + +# MD010/no-hard-tabs - Hard tabs +MD010: + # Include code blocks + code_blocks: true + +# MD012/no-multiple-blanks - Multiple consecutive blank lines +MD012: + # Consecutive blank lines + maximum: 1 + +# MD013/line-length - Line length +MD013: + # Number of characters + line_length: 80 + # Number of characters for headings + heading_line_length: 80 + # Number of characters for code blocks + code_block_line_length: 80 + # Include code blocks + code_blocks: false + # Include tables + tables: false + # Include headings + headings: true + # Include headings + headers: true + # Strict length checking + strict: false + # Stern length checking + stern: false + +# MD022/blanks-around-headings/blanks-around-headers - Headings should be surrounded by blank lines +MD022: + # Blank lines above heading + lines_above: 1 + # Blank lines below heading + lines_below: 1 + +# MD024/no-duplicate-heading/no-duplicate-header - Multiple headings with the same content +MD024: + # Only check sibling headings + allow_different_nesting: true + +# MD025/single-title/single-h1 - Multiple top-level headings in the same document +MD025: + # Heading level + level: 1 + # RegExp for matching title in front matter + front_matter_title: "^\\s*title\\s*[:=]" + +# MD026/no-trailing-punctuation - Trailing punctuation in heading +MD026: + # Punctuation characters + punctuation: ".,;:!。，；：！" + +# MD029/ol-prefix - Ordered list item prefix +MD029: + # List style + style: "one_or_ordered" + +# MD030/list-marker-space - Spaces after list markers +MD030: + # Spaces for single-line unordered list items + ul_single: 1 + # Spaces for single-line ordered list items + ol_single: 1 + # Spaces for multi-line unordered list items + ul_multi: 1 + # Spaces for multi-line ordered list items + ol_multi: 1 + +# MD033/no-inline-html - Inline HTML +MD033: + # Allowed elements + allowed_elements: [] + +# MD035/hr-style - Horizontal rule style +MD035: + # Horizontal rule style + style: "---" + +# MD036/no-emphasis-as-heading/no-emphasis-as-header - Emphasis used instead of a heading +MD036: + # Punctuation characters + punctuation: ".,;:!?。，；：！？" + +# MD041/first-line-heading/first-line-h1 - First line in a file should be a top-level heading +MD041: + # Heading level + level: 1 + # RegExp for matching title in front matter + front_matter_title: "^\\s*title\\s*[:=]" + +# MD044/proper-names - Proper names should have the correct capitalization +MD044: + # List of proper names + names: + - gitea + # Include code blocks + code_blocks: false + +# MD046/code-block-style - Code block style +MD046: + # Block style + style: "fenced" + +# MD048/code-fence-style - Code fence style +MD048: + # Code fence syle + style: "backtick" \ No newline at end of file diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..51ff935 --- /dev/null +++ b/LICENSE @@ -0,0 +1,20 @@ +Copyright (c) 2022 Markus Pesch + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +"Software"), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND +NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE +LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION +OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION +WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/README.md b/README.md new file mode 100644 index 0000000..1e51548 --- /dev/null +++ b/README.md @@ -0,0 +1,22 @@ +# kvm + +[![Build Status](https://drone.cryptic.systems/api/badges/volker.raschek/kvm-role/status.svg)](https://drone.cryptic.systems/volker.raschek/kvm-role) +[![Ansible Role](https://img.shields.io/ansible/role/d/58218)](https://galaxy.ansible.com/volker_raschek/kvm_role) + +With following role can be kvm installed and configured. + +## Supported distributions + +- Arch Linux +- Rocky Linux 8 +- Ubuntu 20.04 + +## Features + +- Installing kvm +- Configuring kvm + +## Configuring + +In the default directory are examples how to configure `kvm`. Copy the +defaults into your `host_vars` or `group_vars` and adapt the examples. diff --git a/defaults/main.yml b/defaults/main.yml new file mode 100644 index 0000000..03a3df2 --- /dev/null +++ b/defaults/main.yml @@ -0,0 +1,7 @@ +--- + +# Users added to required Unix groups to interact with qemu/kvm. +kvm_users: [] +# - name: markus + +kvm_virtual_machine_manager: false \ No newline at end of file diff --git a/handlers/main.yml b/handlers/main.yml new file mode 100644 index 0000000..73b314f --- /dev/null +++ b/handlers/main.yml @@ -0,0 +1 @@ +--- \ No newline at end of file diff --git a/meta/main.yml b/meta/main.yml new file mode 100644 index 0000000..6694264 --- /dev/null +++ b/meta/main.yml @@ -0,0 +1,22 @@ +galaxy_info: + author: Markus Pesch + description: Role to install and configure kvm on different distributions + company: Cryptic Systems + license: MIT + min_ansible_version: 2.1 + platforms: + - name: Archlinux + versions: + - all + - name: Ubuntu + versions: + - 20.04 + - name: RockyLinux + versions: + - 8.5 + + galaxy_tags: + - kvm + - virtualization + +dependencies: [] diff --git a/renovate.json b/renovate.json new file mode 100644 index 0000000..0eb214c --- /dev/null +++ b/renovate.json @@ -0,0 +1,17 @@ +{ + "$schema": "https://docs.renovatebot.com/renovate-schema.json", + "assignees": [ "volker.raschek" ], + "automergeStrategy": "merge-commit", + "automergeType": "pr", + "labels": [ "renovate" ], + "packageRules": [ + { + "addLabels": [ "renovate/droneci", "renovate/automerge" ], + "automerge": true, + "matchManagers": "droneci", + "matchUpdateTypes": [ "minor", "patch"] + } + ], + "rebaseLabel": "renovate/rebase", + "rebaseWhen": "behind-base-branch" +} diff --git a/tasks/main.yml b/tasks/main.yml new file mode 100644 index 0000000..b29e2d9 --- /dev/null +++ b/tasks/main.yml @@ -0,0 +1,55 @@ +--- + +- name: Read cpuinfo from kernel + shell: cat /proc/cpuinfo + register: cpu_info + changed_when: false + +# - name: Verify if Intel VMX or AMD SVM is enabled +# fail: +# msg: "Intel VMX or AMD SVE not enabled" +# when: "'vmx' not in cpu_info.stdout and 'svm' not in cpu_info.stdout" + +- name: Load variables + include_vars: "{{ ansible_os_family }}.yml" + +- name: Add Virt-Manager programs + set_fact: + kvm_package_names: "{{ kvm_package_names + kvm_vm_manager_package_names }}" + when: kvm_virtual_machine_manager + +- name: Install qemu with dependencies + package: + name: "{{ item }}" + state: present + with_items: + - "{{ kvm_package_names }}" + +- name: Load and persist kernel module "kvm_amd" + when: cpu_info.stdout.find('sev') != -1 + block: + - name: Load kernel module "kvm_amd" temporarily + modprobe: + name: "kvm_amd" + params: "sev=1" + state: present + - name: Load kernel module "kvm_amd" persistently + template: + src: "etc/modules-load.d/10-amd-sve.conf.j2" + dest: "/etc/modules-load.d/10-amd-sve.conf" + owner: root + group: root + mode: 0644 + +- name: Append Unix user to Unix groups to interact with qemu/kvm + user: + name: "{{ item.name }}" + append: yes + groups: "{{ kvm_unix_groups }}" + with_items: "{{ kvm_users }}" + +- name: Start and enable {{ kvm_service_name }} + systemd: + name: "{{ kvm_service_name }}" + state: started + enabled: yes \ No newline at end of file diff --git a/templates/etc/modules-load.d/10-amd-sve.conf.j2 b/templates/etc/modules-load.d/10-amd-sve.conf.j2 new file mode 100644 index 0000000..bf6cb85 --- /dev/null +++ b/templates/etc/modules-load.d/10-amd-sve.conf.j2 @@ -0,0 +1,5 @@ +# +# {{ ansible_managed }} +# + +options kvm_amd sev=1 diff --git a/vars/Archlinux.yml b/vars/Archlinux.yml new file mode 100644 index 0000000..a6aeca2 --- /dev/null +++ b/vars/Archlinux.yml @@ -0,0 +1,18 @@ +--- + +kvm_package_names: +- libvirt +- qemu +- qemu-arch-extra +- qemu-block-gluster +- qemu-block-iscsi +- qemu-block-rbd + +kvm_service_name: libvirtd + +kvm_vm_manager_package_names: +- virt-manager +- virt-viewer + +kvm_unix_groups: +- libvirt diff --git a/vars/Debian.yml b/vars/Debian.yml new file mode 100644 index 0000000..a18044f --- /dev/null +++ b/vars/Debian.yml @@ -0,0 +1,19 @@ +--- + +kvm_package_names: +- libvirt-clients +- libvirt-daemon +- libvirt-daemon-driver-qemu +- libvirt-daemon-driver-storage-gluster +- libvirt-daemon-driver-storage-rbd +- libvirt-daemon-system-systemd +- libvirt-dbus + +kvm_service_name: libvirtd + +kvm_vm_manager_package_names: +- virtinst +- virt-manager + +kvm_unix_groups: +- libvirt diff --git a/vars/RedHat.yml b/vars/RedHat.yml new file mode 100644 index 0000000..7025f77 --- /dev/null +++ b/vars/RedHat.yml @@ -0,0 +1,22 @@ +--- + +kvm_package_names: +- libvirt-admin +- libvirt-client +- libvirt-daemon-driver-qemu +- libvirt-daemon-driver-secret +- libvirt-daemon-driver-storage-gluster +- libvirt-daemon-driver-storage-iscsi +- libvirt-daemon-driver-storage-rbd +- qemu-kvm +- qemu-kvm-block-iscsi +- qemu-kvm-block-rbd + +kvm_service_name: libvirtd + +kvm_vm_manager_package_names: +- virt-manager +- virt-viewer + +kvm_unix_groups: +- libvirt