diff --git a/README.en.md b/README.en.md index da4f5aa..011a787 100644 --- a/README.en.md +++ b/README.en.md @@ -1,22 +1,18 @@ # mom #### Description -{**When you're done, you can delete the content in this README and update the file with details for others getting started with your repository**} - -#### Software Architecture -Software architecture description - -#### Installation - -1. xxxx -2. xxxx -3. xxxx - -#### Instructions - -1. xxxx -2. xxxx -3. xxxx +MOM is a policy-driven tool that can be used to manage overcommitment on KVM +hosts. Using a connection to the hypervisor software (either libvirt or oVirt +vdsm), MOM keeps track of active virtual machines on a host. At a regular +collection interval, data is gathered about the host and guests. Data can come +from multiple sources (eg. the /proc interface, libvirt API calls, a client +program connected to a guest, etc). Once collected, the data is organized for +use by the policy evaluation engine. If configured, MOM regularly evaluates a +user-supplied management policy using the collected data as input. In response +to certain conditions, the policy may trigger reconfiguration of the system’s +overcommitment mechanisms. Currently MOM supports control of memory ballooning +and KSM but the architecture is designed to accommodate new mechanisms such as +cgroups. #### Contribution @@ -24,13 +20,3 @@ Software architecture description 2. Create Feat_xxx branch 3. Commit your code 4. Create Pull Request - - -#### Gitee Feature - -1. You can use Readme\_XXX.md to support different languages, such as Readme\_en.md, Readme\_zh.md -2. Gitee blog [blog.gitee.com](https://blog.gitee.com) -3. Explore open source project [https://gitee.com/explore](https://gitee.com/explore) -4. The most valuable open source project [GVP](https://gitee.com/gvp) -5. The manual of Gitee [https://gitee.com/help](https://gitee.com/help) -6. The most popular members [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/) diff --git a/README.md b/README.md index cf171c5..4e48524 100644 --- a/README.md +++ b/README.md @@ -1,25 +1,7 @@ # mom #### 介绍 -{**以下是码云平台说明,您可以替换此简介** -码云是 OSCHINA 推出的基于 Git 的代码托管平台(同时支持 SVN)。专为开发者提供稳定、高效、安全的云端软件开发协作平台 -无论是个人、团队、或是企业,都能够用码云实现代码托管、项目管理、协作开发。企业项目请看 [https://gitee.com/enterprises](https://gitee.com/enterprises)} - -#### 软件架构 -软件架构说明 - - -#### 安装教程 - -1. xxxx -2. xxxx -3. xxxx - -#### 使用说明 - -1. xxxx -2. xxxx -3. xxxx +Mom是一个策略驱动工具,可用于管理KVM的内存过量分配。使用连接到虚拟机管理程序软件(libvirt 或 oVirt vdsm),Mom跟踪主机上的活动虚拟机。定期收集主机与客户机的数据。这些数据可能会来自不同的源(例如/proc接口、libvirt API调用、客户端程序连接客户机等)。数据一旦被收集,这些数据将会被组织用于策略评估引擎。如果配置,Mom会使用收集到的数据作为输入,定期评估用户提供的管理策略。作为回应,在某些情况下,该策略在系统内存过量分配时可能会触发的重新配置机制。当前,Mom支持控制内存膨胀和KSM,但该架构旨在容纳新的机制,例如cgroups。 #### 参与贡献 @@ -27,13 +9,3 @@ 2. 新建 Feat_xxx 分支 3. 提交代码 4. 新建 Pull Request - - -#### 码云特技 - -1. 使用 Readme\_XXX.md 来支持不同的语言,例如 Readme\_en.md, Readme\_zh.md -2. 码云官方博客 [blog.gitee.com](https://blog.gitee.com) -3. 你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解码云上的优秀开源项目 -4. [GVP](https://gitee.com/gvp) 全称是码云最有价值开源项目,是码云综合评定出的优秀开源项目 -5. 码云官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help) -6. 码云封面人物是一档用来展示码云会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/) diff --git a/mom-0.5.12.tar.gz b/mom-0.5.12.tar.gz new file mode 100644 index 0000000..886c03f Binary files /dev/null and b/mom-0.5.12.tar.gz differ diff --git a/mom.spec b/mom.spec new file mode 100644 index 0000000..d62f44a --- /dev/null +++ b/mom.spec @@ -0,0 +1,91 @@ +%{!?python_sitelib: %global python_sitelib %(%{__python} -c "from distutils.sysconfig import get_python_lib; print(get_python_lib())")} +%{!?_pkgdocdir: %global _pkgdocdir %{_docdir}/%{name}-%{version}} +%{!?with_check: %global with_check 0} + +%global package_version 0.5.12 +%global package_name mom + +Name: %{package_name} +Version: 0.5.12 +Release: 1%{?release_suffix}%{?dist} +Summary: Dynamically manage system resources on virtualization hosts + +Group: Applications/System +License: GPLv2 +URL: http://www.ovirt.org +Source: %{package_name}-%{package_version}.tar.gz +BuildRoot: %{_tmppath}/%{name}-%{version}-%{release} +BuildArch: noarch +BuildRequires: python-devel +BuildRequires: python-nose +BuildRequires: python-mock + +Requires(post): systemd +Requires(preun): systemd +Requires(postun): systemd +BuildRequires: systemd + +# MOM makes use of libvirt by way of the python bindings to monitor and +# interact with virtual machines. +%if 0%{?fedora} >= 18 || 0%{?rhel} >= 7 +Requires: libvirt-daemon-driver-qemu +%else +Requires: libvirt +%endif +Requires: libvirt-python +Requires: procps + + +%description +MOM is a policy-driven tool that can be used to manage overcommitment on KVM +hosts. Using libvirt, MOM keeps track of active virtual machines on a host. At +a regular collection interval, data is gathered about the host and guests. Data +can come from multiple sources (eg. the /proc interface, libvirt API calls, a +client program connected to a guest, etc). Once collected, the data is +organized for use by the policy evaluation engine. When started, MOM accepts a +user-supplied overcommitment policy. This policy is regularly evaluated using +the latest collected data. In response to certain conditions, the policy may +trigger reconfiguration of the system’s overcommitment mechanisms. Currently +MOM supports control of memory ballooning and KSM but the architecture is +designed to accommodate new mechanisms such as cgroups. + +%prep +%setup -q -n %{package_name}-%{package_version} + +%build +%configure --docdir="%{_pkgdocdir}" +make %{?_smp_mflags} + +%install +rm -rf "%{buildroot}" +make DESTDIR="%{buildroot}" install + +install -dm 755 %{buildroot}%{_unitdir} +mv contrib/momd.service %{buildroot}%{_unitdir} +install -d -m 0755 "%{buildroot}/%{_sysconfdir}" +install -m 0644 doc/mom-balloon+ksm.conf "%{buildroot}/%{_sysconfdir}/momd.conf" + +%check +%if 0%{with_check} +make check %{?_smp_mflags} +%endif + +%post +%systemd_post momd.service + +%preun +%systemd_preun momd.service + +%postun +%systemd_postun_with_restart momd.service + +%files +%config(noreplace) %{_sysconfdir}/momd.conf +%{_unitdir}/momd.service +%{_sbindir}/momd +%{python_sitelib}/mom/ +%{_pkgdocdir}/* + +%changelog +* Wed Mar 04 2020 Huihui Fu - 0.5.12-1 +- Initial package