Skip to content
This repository has been archived by the owner on May 6, 2020. It is now read-only.

kernel: Create tool to check for new LTS kernel releases #253

Merged
merged 1 commit into from
Jan 31, 2018
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 40 additions & 0 deletions scripts/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,3 +41,43 @@ Usage:
$ ./get-image-changes.sh VERSION-TO-UPDATE > changes
$ cat changes
```

## `kernel_monitor/kernel_monitor.py`

This script fetches the latest kernel information and looks for new LTS releases.
If it finds a new LTS release it sends an email to the selected recipients.

Requirements:

* python3
* python dependencies (see the [requirements file](https://github.com/clearcontainers/packaging/scripts/kernel_monitor/requirements))
* pip
* postfix

Usage:

NOTE: The following commands can be executed if you have a Fedora 27 system that meets all requirements,
and a postfix server running on 127.0.0.1 or localhost.

Install python dependencies:

NOTE: It is strongly recommended to run this script in a Python virtual environment with `virtualenv`.
```
$ cd kernel_monitor
$ virtualenv km
$ source km/bin/activate
$ pip install -r requirements
```

Execute the following script:
```
$ chmod +x kernel_monitor.py
$ ./kernel_monitor.py
```

This sends an email if there is a new LTS release and logs the events to a file.
For more information about how to change the email recipients, the log file name or the
postfix server address, execute the script with `--help` to see the options:
```
$ ./kernel_monitor.py --help
```
164 changes: 164 additions & 0 deletions scripts/kernel_monitor/kernel_monitor.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,164 @@
#!/usr/bin/env python3
#
# Copyright (c) 2018 Intel Corporation
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

"""Linux Kernel LTS monitor script.

Usage: kernel_monitor.py [--server=HOSTNAME] [--log-file=PATH]
[--sender=ADDRESS] [--recipient=ADDRESS]
[--recipient=ADDRESS] [--recipient=ADDRESS]
[--recipient=ADDRESS] [--recipient=ADDRESS]
kernel_monitor.py (-h | --help)



Options:
-h --help Show this screen.
--log-file=PATH Path of a file to dump logs [default: ./kernel_monitor.log]
--server=HOSTNAME SMTP server ip or hostname [default: 127.0.0.1]
--sender=ADDRESS e-mail sender [default: [email protected]]
--recipient=ADDRESS e-mail recipients [default: root@localhost]

"""

import os
import sys
import logging
import re
import fileinput
import feedparser
import smtplib
import semver
import json
import urllib3

from docopt import docopt
from email.mime.text import MIMEText
from tempfile import mkstemp
from shutil import move
from os import fdopen, remove
from pathlib import Path

# Parent directory of this script
script_path = os.path.dirname(os.path.realpath(__file__))
versions_file=script_path + "/../../versions.txt"

# The folowing xml file is used to fetch the latest Linux kernel info
kernel_xml_url = "https://www.kernel.org/feeds/kdist.xml"

def get_current_lts():
lts_string=''
f = open(versions_file, 'r')
for line in f:
if re.match('current_lts_linux', line):
lts_string=line.split("=")[1]
f.close()
return lts_string

def update_versions_file(new_lts, current_lts):
temp_file, abs_path = mkstemp()
with fdopen(temp_file,'w') as new_file:
with open(versions_file) as old_file:
for line in old_file:
new_file.write(line.replace("current_lts_linux=" + current_lts, "current_lts_linux=" + new_lts + '\n'))
remove(versions_file)
move(abs_path, versions_file)
logging.info("Updated versions.txt file")

def discover_certs():
cert_files = [
"/etc/ssl/certs/ca-certificates.crt", # Debian/Ubuntu/Gentoo etc.
"/etc/pki/tls/certs/ca-bundle.crt", # Fedora/RHEL 6
"/etc/ssl/ca-bundle.pem", # OpenSUSE
"/etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem", # CentOS/RHEL 7
"/var/cache/ca-certs/anchors", # Clear Linux certs directory
"/etc/pki/tls/cacert.pem", # Others
]
cert_bundle=''
for file in cert_files:
abs_path=Path(file).resolve()
if abs_path.exists():
logging.info("Certificates bundle: " + file)
cert_bundle = abs_path
break

if cert_bundle == '':
logging.error("No certificates found.")
sys.exit(1)

return cert_bundle

class email(object):
def __init__(self, sender, recipients, smtp_server):
self.sender = sender
self.recipients = recipients
self.smtp_server = smtp_server

def send(self, new_lts, current_lts):
email_body="A new LTS version of the Linux kernel is out: " + new_lts + "\n" \
"Current version: " + current_lts
msg = MIMEText(email_body)

try:
s = smtplib.SMTP(self.smtp_server)
logging.info("SMTP server: " + self.smtp_server)
logging.info("Sender: " + self.sender)
logging.info("Recipients: " + ','.join(self.recipients))

msg['Subject'] = 'New LTS Kernel available'
msg['From'] = self.sender
msg['To'] = ', '.join(self.recipients)
s.sendmail(self.sender, self.recipients, msg.as_string())
logging.info("Email sent!")
s.quit()
except smtplib.SMTPException:
logging.error("Error: unable to send email")

if __name__ == '__main__':
arguments = docopt(__doc__)
logging.basicConfig(filename=arguments['--log-file'],
level=logging.DEBUG,
format='%(asctime)s %(message)s',
datefmt='%m/%d/%Y %I:%M:%S %p')

logging.info("*** Linux LTS Monitor Tool ***")
distro_certs = discover_certs()
if Path(distro_certs).is_file():
http = urllib3.proxy_from_url(os.environ['https_proxy'],
cert_reqs='REQUIRED',
ca_certs=distro_certs)
elif Path(distro_certs).is_dir():
http = urllib3.proxy_from_url(os.environ['https_proxy'],
cert_reqs='REQUIRED',
ca_cert_dir=distro_certs)

request = http.request('GET', kernel_xml_url)
feed_data = feedparser.parse(request.data)

current_lts_kernel = get_current_lts()
for entry in feed_data['entries']:
version = entry['title'].split(':')[0]
build_type = entry['title'].split(' ')[1]
if build_type == "longterm" and semver.match(version, '>' + current_lts_kernel):
logging.info("New LTS Kernel available: " + version)
# email setup
new_email = email(arguments['--sender'],
arguments['--recipient'],
arguments['--server'])
new_email.send(version, current_lts_kernel)
update_versions_file(version, current_lts_kernel)
break
elif build_type == "longterm" and semver.match(version, '==' + current_lts_kernel):
logging.info("Linux LTS Kernel is up to date: " + current_lts_kernel)
4 changes: 4 additions & 0 deletions scripts/kernel_monitor/requirements
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
docopt==0.6.2
feedparser==5.2.1
semver==2.7.9
urllib3==1.22
3 changes: 3 additions & 0 deletions versions.txt
Original file line number Diff line number Diff line change
Expand Up @@ -35,3 +35,6 @@ shim_obs_ubuntu_version=3.0.14+git.3b5e854-19
image_obs_ubuntu_version=19350-44
linux_container_obs_ubuntu_version=4.9.60-84
qemu_lite_obs_ubuntu_version=2.7.1+git.d4a337fe91-11

# Current LTS Linux Kernel Version
current_lts_linux=4.9.78