Initial Load of Nova PowerVM Project
Initial work to enable the Nova PowerVM project in git.
The work done here provides:
- .gitignore - Indicate which files not to track within Git.
- .gitreview - Input to the git-review command on how to send to
Gerrit.
- .testr.conf - Conf file input for the testr command (UT)
- CONTRIBUTING.rst - Information on how to contribute.
- HACKING.rst - Information on what needs to be done for updates.
- LICENSE - The license for the project
- README.rst - Information on what this project is. Currently this is
the blueprint.
- openstack-common.conf - Required openstack configuration for all
projects
- setup.cfg - Input to the setup.py on how to execute certain actions.
- setup.py - Used for build of the project.
- requirements.txt - Required packages (and levels) to run the code.
- test-requirements.txt - Required packages (and levels) in addition
to the requirements, that indicates what is
needed to run the UT.
- tox.ini - The input for the tox commands.
In addition, a base set of packages for the agent and unit tests were
loaded in.
Change-Id: Iaa186e449e7e0f75dc06a033d024a23d7faa0267
This commit is contained in:
Drew Thorstensen
parent
2af6e5a926
commit
095e1c183b
5
.gitignore
vendored
Normal file
5
.gitignore
vendored
Normal file
@ -0,0 +1,5 @@
|
|||||||
|
build/*
|
||||||
|
.testrepository
|
||||||
|
.tox/
|
||||||
|
nova_powervm.egg-info/
|
||||||
|
*.pyc
|
||||||
4
.gitreview
Normal file
4
.gitreview
Normal file
@ -0,0 +1,4 @@
|
|||||||
|
[gerrit]
|
||||||
|
host=***REMOVED***
|
||||||
|
port=29418
|
||||||
|
project=nova-powervm.git
|
||||||
7
.testr.conf
Normal file
7
.testr.conf
Normal file
@ -0,0 +1,7 @@
|
|||||||
|
[DEFAULT]
|
||||||
|
test_command=OS_STDOUT_CAPTURE=${OS_STDOUT_CAPTURE:-1} \
|
||||||
|
OS_STDERR_CAPTURE=${OS_STDERR_CAPTURE:-1} \
|
||||||
|
OS_TEST_TIMEOUT=${OS_TEST_TIMEOUT:-60} \
|
||||||
|
${PYTHON:-python} -m subunit.run discover -t ./ . $LISTOPT $IDOPTION
|
||||||
|
test_id_option=--load-list $IDFILE
|
||||||
|
test_list_option=--list
|
||||||
17
CONTRIBUTING.rst
Normal file
17
CONTRIBUTING.rst
Normal file
@ -0,0 +1,17 @@
|
|||||||
|
If you would like to contribute to the development of OpenStack,
|
||||||
|
you must follow the steps in the "If you're a developer, start here"
|
||||||
|
section of this page:
|
||||||
|
|
||||||
|
http://wiki.openstack.org/HowToContribute
|
||||||
|
|
||||||
|
Once those steps have been completed, changes to OpenStack
|
||||||
|
should be submitted for review via the Gerrit tool, following
|
||||||
|
the workflow documented at:
|
||||||
|
|
||||||
|
http://wiki.openstack.org/GerritWorkflow
|
||||||
|
|
||||||
|
Pull requests submitted through GitHub will be ignored.
|
||||||
|
|
||||||
|
Bugs should be filed on Launchpad, not GitHub:
|
||||||
|
|
||||||
|
https://bugs.launchpad.net/nova-powervm
|
||||||
21
HACKING.rst
Normal file
21
HACKING.rst
Normal file
@ -0,0 +1,21 @@
|
|||||||
|
Nova-PowerVM Style Commandments
|
||||||
|
===============================
|
||||||
|
|
||||||
|
- Step 1: Read the OpenStack Style Commandments
|
||||||
|
http://docs.openstack.org/developer/hacking/
|
||||||
|
- Step 2: Read on
|
||||||
|
|
||||||
|
Nova-PowerVM Specific Commandments
|
||||||
|
----------------------------------
|
||||||
|
- Follow the Nova HACKING.rst
|
||||||
|
|
||||||
|
Creating Unit Tests
|
||||||
|
-------------------
|
||||||
|
For every new feature, unit tests should be created that both test and
|
||||||
|
(implicitly) document the usage of said feature. If submitting a patch for a
|
||||||
|
bug that had no unit test, a new passing unit test should be added. If a
|
||||||
|
submitted bug fix does have a unit test, be sure to add a new one that fails
|
||||||
|
without the patch and passes with the patch.
|
||||||
|
|
||||||
|
For more information on creating unit tests and utilizing the testing
|
||||||
|
infrastructure in OpenStack Nova, please read ``nova/tests/README.rst``.
|
||||||
176
LICENSE
Normal file
176
LICENSE
Normal file
@ -0,0 +1,176 @@
|
|||||||
|
|
||||||
|
Apache License
|
||||||
|
Version 2.0, January 2004
|
||||||
|
http://www.apache.org/licenses/
|
||||||
|
|
||||||
|
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
|
||||||
|
|
||||||
|
1. Definitions.
|
||||||
|
|
||||||
|
"License" shall mean the terms and conditions for use, reproduction,
|
||||||
|
and distribution as defined by Sections 1 through 9 of this document.
|
||||||
|
|
||||||
|
"Licensor" shall mean the copyright owner or entity authorized by
|
||||||
|
the copyright owner that is granting the License.
|
||||||
|
|
||||||
|
"Legal Entity" shall mean the union of the acting entity and all
|
||||||
|
other entities that control, are controlled by, or are under common
|
||||||
|
control with that entity. For the purposes of this definition,
|
||||||
|
"control" means (i) the power, direct or indirect, to cause the
|
||||||
|
direction or management of such entity, whether by contract or
|
||||||
|
otherwise, or (ii) ownership of fifty percent (50%) or more of the
|
||||||
|
outstanding shares, or (iii) beneficial ownership of such entity.
|
||||||
|
|
||||||
|
"You" (or "Your") shall mean an individual or Legal Entity
|
||||||
|
exercising permissions granted by this License.
|
||||||
|
|
||||||
|
"Source" form shall mean the preferred form for making modifications,
|
||||||
|
including but not limited to software source code, documentation
|
||||||
|
source, and configuration files.
|
||||||
|
|
||||||
|
"Object" form shall mean any form resulting from mechanical
|
||||||
|
transformation or translation of a Source form, including but
|
||||||
|
not limited to compiled object code, generated documentation,
|
||||||
|
and conversions to other media types.
|
||||||
|
|
||||||
|
"Work" shall mean the work of authorship, whether in Source or
|
||||||
|
Object form, made available under the License, as indicated by a
|
||||||
|
copyright notice that is included in or attached to the work
|
||||||
|
(an example is provided in the Appendix below).
|
||||||
|
|
||||||
|
"Derivative Works" shall mean any work, whether in Source or Object
|
||||||
|
form, that is based on (or derived from) the Work and for which the
|
||||||
|
editorial revisions, annotations, elaborations, or other modifications
|
||||||
|
represent, as a whole, an original work of authorship. For the purposes
|
||||||
|
of this License, Derivative Works shall not include works that remain
|
||||||
|
separable from, or merely link (or bind by name) to the interfaces of,
|
||||||
|
the Work and Derivative Works thereof.
|
||||||
|
|
||||||
|
"Contribution" shall mean any work of authorship, including
|
||||||
|
the original version of the Work and any modifications or additions
|
||||||
|
to that Work or Derivative Works thereof, that is intentionally
|
||||||
|
submitted to Licensor for inclusion in the Work by the copyright owner
|
||||||
|
or by an individual or Legal Entity authorized to submit on behalf of
|
||||||
|
the copyright owner. For the purposes of this definition, "submitted"
|
||||||
|
means any form of electronic, verbal, or written communication sent
|
||||||
|
to the Licensor or its representatives, including but not limited to
|
||||||
|
communication on electronic mailing lists, source code control systems,
|
||||||
|
and issue tracking systems that are managed by, or on behalf of, the
|
||||||
|
Licensor for the purpose of discussing and improving the Work, but
|
||||||
|
excluding communication that is conspicuously marked or otherwise
|
||||||
|
designated in writing by the copyright owner as "Not a Contribution."
|
||||||
|
|
||||||
|
"Contributor" shall mean Licensor and any individual or Legal Entity
|
||||||
|
on behalf of whom a Contribution has been received by Licensor and
|
||||||
|
subsequently incorporated within the Work.
|
||||||
|
|
||||||
|
2. Grant of Copyright License. Subject to the terms and conditions of
|
||||||
|
this License, each Contributor hereby grants to You a perpetual,
|
||||||
|
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
||||||
|
copyright license to reproduce, prepare Derivative Works of,
|
||||||
|
publicly display, publicly perform, sublicense, and distribute the
|
||||||
|
Work and such Derivative Works in Source or Object form.
|
||||||
|
|
||||||
|
3. Grant of Patent License. Subject to the terms and conditions of
|
||||||
|
this License, each Contributor hereby grants to You a perpetual,
|
||||||
|
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
||||||
|
(except as stated in this section) patent license to make, have made,
|
||||||
|
use, offer to sell, sell, import, and otherwise transfer the Work,
|
||||||
|
where such license applies only to those patent claims licensable
|
||||||
|
by such Contributor that are necessarily infringed by their
|
||||||
|
Contribution(s) alone or by combination of their Contribution(s)
|
||||||
|
with the Work to which such Contribution(s) was submitted. If You
|
||||||
|
institute patent litigation against any entity (including a
|
||||||
|
cross-claim or counterclaim in a lawsuit) alleging that the Work
|
||||||
|
or a Contribution incorporated within the Work constitutes direct
|
||||||
|
or contributory patent infringement, then any patent licenses
|
||||||
|
granted to You under this License for that Work shall terminate
|
||||||
|
as of the date such litigation is filed.
|
||||||
|
|
||||||
|
4. Redistribution. You may reproduce and distribute copies of the
|
||||||
|
Work or Derivative Works thereof in any medium, with or without
|
||||||
|
modifications, and in Source or Object form, provided that You
|
||||||
|
meet the following conditions:
|
||||||
|
|
||||||
|
(a) You must give any other recipients of the Work or
|
||||||
|
Derivative Works a copy of this License; and
|
||||||
|
|
||||||
|
(b) You must cause any modified files to carry prominent notices
|
||||||
|
stating that You changed the files; and
|
||||||
|
|
||||||
|
(c) You must retain, in the Source form of any Derivative Works
|
||||||
|
that You distribute, all copyright, patent, trademark, and
|
||||||
|
attribution notices from the Source form of the Work,
|
||||||
|
excluding those notices that do not pertain to any part of
|
||||||
|
the Derivative Works; and
|
||||||
|
|
||||||
|
(d) If the Work includes a "NOTICE" text file as part of its
|
||||||
|
distribution, then any Derivative Works that You distribute must
|
||||||
|
include a readable copy of the attribution notices contained
|
||||||
|
within such NOTICE file, excluding those notices that do not
|
||||||
|
pertain to any part of the Derivative Works, in at least one
|
||||||
|
of the following places: within a NOTICE text file distributed
|
||||||
|
as part of the Derivative Works; within the Source form or
|
||||||
|
documentation, if provided along with the Derivative Works; or,
|
||||||
|
within a display generated by the Derivative Works, if and
|
||||||
|
wherever such third-party notices normally appear. The contents
|
||||||
|
of the NOTICE file are for informational purposes only and
|
||||||
|
do not modify the License. You may add Your own attribution
|
||||||
|
notices within Derivative Works that You distribute, alongside
|
||||||
|
or as an addendum to the NOTICE text from the Work, provided
|
||||||
|
that such additional attribution notices cannot be construed
|
||||||
|
as modifying the License.
|
||||||
|
|
||||||
|
You may add Your own copyright statement to Your modifications and
|
||||||
|
may provide additional or different license terms and conditions
|
||||||
|
for use, reproduction, or distribution of Your modifications, or
|
||||||
|
for any such Derivative Works as a whole, provided Your use,
|
||||||
|
reproduction, and distribution of the Work otherwise complies with
|
||||||
|
the conditions stated in this License.
|
||||||
|
|
||||||
|
5. Submission of Contributions. Unless You explicitly state otherwise,
|
||||||
|
any Contribution intentionally submitted for inclusion in the Work
|
||||||
|
by You to the Licensor shall be under the terms and conditions of
|
||||||
|
this License, without any additional terms or conditions.
|
||||||
|
Notwithstanding the above, nothing herein shall supersede or modify
|
||||||
|
the terms of any separate license agreement you may have executed
|
||||||
|
with Licensor regarding such Contributions.
|
||||||
|
|
||||||
|
6. Trademarks. This License does not grant permission to use the trade
|
||||||
|
names, trademarks, service marks, or product names of the Licensor,
|
||||||
|
except as required for reasonable and customary use in describing the
|
||||||
|
origin of the Work and reproducing the content of the NOTICE file.
|
||||||
|
|
||||||
|
7. Disclaimer of Warranty. Unless required by applicable law or
|
||||||
|
agreed to in writing, Licensor provides the Work (and each
|
||||||
|
Contributor provides its Contributions) on an "AS IS" BASIS,
|
||||||
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
||||||
|
implied, including, without limitation, any warranties or conditions
|
||||||
|
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
|
||||||
|
PARTICULAR PURPOSE. You are solely responsible for determining the
|
||||||
|
appropriateness of using or redistributing the Work and assume any
|
||||||
|
risks associated with Your exercise of permissions under this License.
|
||||||
|
|
||||||
|
8. Limitation of Liability. In no event and under no legal theory,
|
||||||
|
whether in tort (including negligence), contract, or otherwise,
|
||||||
|
unless required by applicable law (such as deliberate and grossly
|
||||||
|
negligent acts) or agreed to in writing, shall any Contributor be
|
||||||
|
liable to You for damages, including any direct, indirect, special,
|
||||||
|
incidental, or consequential damages of any character arising as a
|
||||||
|
result of this License or out of the use or inability to use the
|
||||||
|
Work (including but not limited to damages for loss of goodwill,
|
||||||
|
work stoppage, computer failure or malfunction, or any and all
|
||||||
|
other commercial damages or losses), even if such Contributor
|
||||||
|
has been advised of the possibility of such damages.
|
||||||
|
|
||||||
|
9. Accepting Warranty or Additional Liability. While redistributing
|
||||||
|
the Work or Derivative Works thereof, You may choose to offer,
|
||||||
|
and charge a fee for, acceptance of support, warranty, indemnity,
|
||||||
|
or other liability obligations and/or rights consistent with this
|
||||||
|
License. However, in accepting such obligations, You may act only
|
||||||
|
on Your own behalf and on Your sole responsibility, not on behalf
|
||||||
|
of any other Contributor, and only if You agree to indemnify,
|
||||||
|
defend, and hold each Contributor harmless for any liability
|
||||||
|
incurred by, or claims asserted against, such Contributor by reason
|
||||||
|
of your accepting any such warranty or additional liability.
|
||||||
|
|
||||||
337
README.rst
Normal file
337
README.rst
Normal file
@ -0,0 +1,337 @@
|
|||||||
|
===================
|
||||||
|
PowerVM Nova Driver
|
||||||
|
===================
|
||||||
|
|
||||||
|
Include the URL of your launchpad blueprint:
|
||||||
|
|
||||||
|
https://blueprints.launchpad.net/neutron/+spec/example
|
||||||
|
|
||||||
|
The IBM PowerVM hypervisor provides virtualization on POWER hardware. PowerVM
|
||||||
|
admins can see benefits in their environments by making use of OpenStack.
|
||||||
|
This driver (along with a Neutron ML2 compatible agent and Ceilometer agent)
|
||||||
|
will provide capability for admins of PowerVM (which encapsulates PHYP and
|
||||||
|
Virtual I/O Servers) to use OpenStack natively.
|
||||||
|
|
||||||
|
|
||||||
|
Problem Description
|
||||||
|
===================
|
||||||
|
|
||||||
|
As a new ecosystem evolves around the POWER platform, there is not an
|
||||||
|
OpenStack driver that meets all of the needs for that ecosystem. The work
|
||||||
|
done here is to build a PowerVM driver in within the broader community. This
|
||||||
|
will sit alongside the existing libvirt driver utilized by PowerKVM
|
||||||
|
environments.
|
||||||
|
|
||||||
|
This new driver must meet the following:
|
||||||
|
|
||||||
|
* Built within the community
|
||||||
|
|
||||||
|
* Fits the OpenStack model
|
||||||
|
|
||||||
|
* Utilizes automated functional and unit tests
|
||||||
|
|
||||||
|
* Enables use of PowerVM systems through the OpenStack APIs
|
||||||
|
|
||||||
|
* Allows attachment of volumes from Cinder over supported protocols
|
||||||
|
|
||||||
|
|
||||||
|
The use cases should be the following:
|
||||||
|
|
||||||
|
* As a deployer, all of the standard lifecycle operations (start, stop,
|
||||||
|
reboot, migrate, destroy, etc...) should be supported on a PowerVM based
|
||||||
|
instance.
|
||||||
|
|
||||||
|
* As a deployer, I should be able to capture an instance to an image.
|
||||||
|
|
||||||
|
|
||||||
|
Proposed Change
|
||||||
|
===============
|
||||||
|
|
||||||
|
The changes proposed are the following:
|
||||||
|
|
||||||
|
* Create a PowerVM based driver in a StackForge project. This will implement
|
||||||
|
the nova/virt/driver Compute Driver.
|
||||||
|
|
||||||
|
* Provide deployments that work with the OpenStack model.
|
||||||
|
|
||||||
|
* Driver will be implemented using a new version of the PowerVM REST API.
|
||||||
|
|
||||||
|
* Ephemeral disks will be supported either with Virtual I/O Server (VIOS)
|
||||||
|
hosted local disks or via Shared Storage Pools (a PowerVM cluster file
|
||||||
|
system).
|
||||||
|
|
||||||
|
* Volume support will be via Cinder through supported protocols for the
|
||||||
|
Hypervisor.
|
||||||
|
|
||||||
|
* Network integration will be supported via a ML2 compatible Neutron Agent.
|
||||||
|
|
||||||
|
* Automated Functional Testing will be provided to validate changes from the
|
||||||
|
broader OpenStack community against the PowerVM driver.
|
||||||
|
|
||||||
|
* Thorough unit testing will be provided for the driver.
|
||||||
|
|
||||||
|
The changes proposed will bring support for the PowerVM hypervisor into the
|
||||||
|
OpenStack ecosystem, following the OpenStack development model.
|
||||||
|
|
||||||
|
This development is planned to be done in StackForge in a project named
|
||||||
|
‘powervm’. The intent is that the completion of this work will provide the
|
||||||
|
foundation to bring the PowerVM Nova driver (with supporting components) into
|
||||||
|
Nova Core via a separate BluePrint in the L release of OpenStack.
|
||||||
|
|
||||||
|
Until the subsequent BluePrint is proposed for the L release, this driver is
|
||||||
|
to be considered experimental.
|
||||||
|
|
||||||
|
|
||||||
|
Data Model Impact
|
||||||
|
-----------------
|
||||||
|
|
||||||
|
No data model impacts are anticipated as part of this work.
|
||||||
|
|
||||||
|
|
||||||
|
REST API Impact
|
||||||
|
---------------
|
||||||
|
|
||||||
|
The intent of this work item is to enable PowerVM to fit within the broader
|
||||||
|
OpenStack ecosystem, without requiring changes to the REST API.
|
||||||
|
|
||||||
|
As such, no REST API impacts are anticipated.
|
||||||
|
|
||||||
|
|
||||||
|
Security Impact
|
||||||
|
---------------
|
||||||
|
|
||||||
|
The user may need to configure the credentials to communicate with the PowerVM
|
||||||
|
REST API via a CONF file. These should be encoded.
|
||||||
|
|
||||||
|
New root wrap policies may need to be updated to support various commands for
|
||||||
|
the PowerVM REST API.
|
||||||
|
|
||||||
|
No other security impacts are foreseen.
|
||||||
|
|
||||||
|
|
||||||
|
Notifications Impact
|
||||||
|
--------------------
|
||||||
|
|
||||||
|
No new notifications are anticipated.
|
||||||
|
|
||||||
|
|
||||||
|
Other End User Impact
|
||||||
|
---------------------
|
||||||
|
|
||||||
|
The administrator will notice new logging messages in the nova compute logs.
|
||||||
|
|
||||||
|
|
||||||
|
Performance Impact
|
||||||
|
------------------
|
||||||
|
|
||||||
|
It is a goal of the driver to deploy systems with the same speed and agility
|
||||||
|
as the libvirt driver within OpenStack.
|
||||||
|
|
||||||
|
Since this process should match the OpenStack model, it is not planned to add
|
||||||
|
any new periodic tasks, database queries or other items.
|
||||||
|
|
||||||
|
Performance impacts should be limited to the Compute Driver, as the changes
|
||||||
|
should be consolidated within the driver on the endpoint. The API processes
|
||||||
|
for instance should not be impacted.
|
||||||
|
|
||||||
|
|
||||||
|
Other Deployer Impact
|
||||||
|
---------------------
|
||||||
|
|
||||||
|
The cloud administrator will need to refer to documentation on how to
|
||||||
|
configure OpenStack for use with a PowerVM hypervisor.
|
||||||
|
|
||||||
|
The existing configuration file attributes will be reused as much as possible.
|
||||||
|
This reduces the number of PowerVM specific items that will be needed.
|
||||||
|
However, the driver is likely to need some PowerVM specific options.
|
||||||
|
|
||||||
|
In this case, we plan to keep the PowerVM specifics contained within the
|
||||||
|
configuration file (and driver code). Any new configuration options will have
|
||||||
|
the prefix "powervm_".
|
||||||
|
|
||||||
|
There should be no impact to customers upgrading their cloud stack as this is
|
||||||
|
a genesis driver and should not have database impacts.
|
||||||
|
|
||||||
|
|
||||||
|
Developer Impact
|
||||||
|
----------------
|
||||||
|
|
||||||
|
The code for this driver will be contained within a powervm StackForge
|
||||||
|
project. The driver will be contained within /nova/virt/powervm/. The driver
|
||||||
|
will extend nova.virt.driver.ComputeDriver.
|
||||||
|
|
||||||
|
The code will interact with PowerVM through an Open Sourced python binding
|
||||||
|
that is being defined. This python binding is a wrapper to the PowerVM REST
|
||||||
|
API. All operations to the hypervisor will go through the PowerVM REST API
|
||||||
|
via this binding. The driver will be maintained to support future revisions
|
||||||
|
of the PowerVM REST API as needed.
|
||||||
|
|
||||||
|
For ephemeral disk support, either a Virtual I/O Server hosted local disk or a
|
||||||
|
Shared Storage Pool (a PowerVM clustered file system) will be supported. For
|
||||||
|
volume attachments, the driver will support Cinder based attachments via
|
||||||
|
protocols supported by the hypervisor.
|
||||||
|
|
||||||
|
For networking, a blueprint is being proposed for the Neutron project that
|
||||||
|
will provide a Neutron ML2 Agent. This too will be developed in StackForge,
|
||||||
|
and a subsequent blueprint will be created to move to Neutron Core in the L
|
||||||
|
release of OpenStack. The Agent will provide the necessary configuration on
|
||||||
|
the Virtual I/O Server. The Nova driver code will have a
|
||||||
|
/nova/virt/powervm/vif.py file that will configure the network adapter on the
|
||||||
|
client VM.
|
||||||
|
|
||||||
|
Automated functional testing will be provided through a third party continuous
|
||||||
|
integration system. It will monitor for incoming Nova change sets, run a set
|
||||||
|
of functional tests (lifecycle operations) against the incoming change, and
|
||||||
|
provide a non-gating vote (+1 or -1).
|
||||||
|
|
||||||
|
Developers should not be impacted by these changes unless they wish to try the
|
||||||
|
driver.
|
||||||
|
|
||||||
|
Until the driver is accepted into Nova core it will be considered experimental.
|
||||||
|
|
||||||
|
|
||||||
|
Community Impact
|
||||||
|
----------------
|
||||||
|
|
||||||
|
The intent of this blueprint is to bring another driver to OpenStack that
|
||||||
|
aligns with the ideals and vision of the community.
|
||||||
|
|
||||||
|
It will be discussed in the Nova IRC and mailing lists. Representatives
|
||||||
|
working on this driver will be at the design summit, though no sessions are
|
||||||
|
planned on this topic.
|
||||||
|
|
||||||
|
|
||||||
|
Alternatives
|
||||||
|
------------
|
||||||
|
|
||||||
|
No alternatives appear viable to bring PowerVM support into the OpenStack
|
||||||
|
community.
|
||||||
|
|
||||||
|
|
||||||
|
Implementation
|
||||||
|
==============
|
||||||
|
|
||||||
|
Assignee(s)
|
||||||
|
-----------
|
||||||
|
|
||||||
|
Primary assignee:
|
||||||
|
kyleh
|
||||||
|
|
||||||
|
Other contributors:
|
||||||
|
thorst
|
||||||
|
dwarcher
|
||||||
|
efried
|
||||||
|
|
||||||
|
Work Items
|
||||||
|
----------
|
||||||
|
|
||||||
|
* Create a base PowerVM driver that is non-functional, but defines the methods
|
||||||
|
that need to be implemented.
|
||||||
|
|
||||||
|
* Implement the host statistics methods (get_host_stats, get_host_ip_addr,
|
||||||
|
get_host_cpu_stats, get_host_uptime, etc.).
|
||||||
|
|
||||||
|
* Implement the spawn method.
|
||||||
|
|
||||||
|
* Implement the destroy method.
|
||||||
|
|
||||||
|
* Implement the instance information methods (list_instances, instance_exists,
|
||||||
|
poll_rebooting_instances, etc.).
|
||||||
|
|
||||||
|
* Implement the live migration methods. Note that, for ephemeral disks, this
|
||||||
|
will be specific to Shared Storage Pool environments where the Virtual I/O
|
||||||
|
Servers on the source and target systems share the same (clustered) file
|
||||||
|
system.
|
||||||
|
|
||||||
|
* Implement support for Cinder volume operations.
|
||||||
|
|
||||||
|
* Implement an option to configure an internal management NIC - used for
|
||||||
|
Resource Monitoring and Control (RMC) – as part of deploy. This is a
|
||||||
|
prerequisite for migration and resize. This will be controlled as part of
|
||||||
|
the CONF file.
|
||||||
|
|
||||||
|
* Implement the network interface methods (attach_interface and
|
||||||
|
detach_interface). Delegate the Virtual I/O Server work to the
|
||||||
|
corresponding Neutron ML2 agent.
|
||||||
|
|
||||||
|
* Implement an automated functional test server that listens for incoming
|
||||||
|
commits from the community and provides a non-gating vote (+1 or -1) on the
|
||||||
|
change.
|
||||||
|
|
||||||
|
|
||||||
|
Dependencies
|
||||||
|
============
|
||||||
|
|
||||||
|
* Will utilize the PowerVM REST API specification for management. Will
|
||||||
|
utilize future versions of this specification as it becomes available:
|
||||||
|
http://ibm.co/1lThV9R
|
||||||
|
|
||||||
|
* Will build on top of a new open source python binding to previously noted
|
||||||
|
PowerVM REST API. This will be a prerequisite to utilizing the driver.
|
||||||
|
|
||||||
|
|
||||||
|
Testing
|
||||||
|
=======
|
||||||
|
|
||||||
|
Tempest Tests
|
||||||
|
-------------
|
||||||
|
|
||||||
|
Since the tempest tests should be implementation agnostic, the existing
|
||||||
|
tempest tests should be able to run against the PowerVM driver without issue.
|
||||||
|
This blueprint does not foresee any changes based off this driver.
|
||||||
|
|
||||||
|
Thorough unit tests will be created within the Nova project to validate
|
||||||
|
specific functions within this driver implementation.
|
||||||
|
|
||||||
|
|
||||||
|
Functional Tests
|
||||||
|
----------------
|
||||||
|
|
||||||
|
A third party functional test environment will be created. It will monitor
|
||||||
|
for incoming nova change sets. Once it detects a new change set, it will
|
||||||
|
execute the existing lifecycle API tests. A non-gating vote (+1 or -1) will
|
||||||
|
be provided with information provided (logs) based on the result.
|
||||||
|
|
||||||
|
|
||||||
|
API Tests
|
||||||
|
---------
|
||||||
|
|
||||||
|
The REST APIs are not planned to change as part of this. Existing APIs should
|
||||||
|
be valid. All testing is planned within the functional testing system and via
|
||||||
|
unit tests.
|
||||||
|
|
||||||
|
|
||||||
|
Documentation Impact
|
||||||
|
====================
|
||||||
|
|
||||||
|
User Documentation
|
||||||
|
------------------
|
||||||
|
|
||||||
|
Documentation will be contributed which identifies how to configure the
|
||||||
|
driver. This will include configuring the dependencies specified above.
|
||||||
|
|
||||||
|
Documentation will be done on wiki, specifically at a minimum to the following
|
||||||
|
page: http://docs.openstack.org/trunk/config-reference/content/
|
||||||
|
section_compute-hypervisors.html
|
||||||
|
|
||||||
|
Interlock will be done with the OpenStack documentation team.
|
||||||
|
|
||||||
|
|
||||||
|
Developer Documentation
|
||||||
|
-----------------------
|
||||||
|
|
||||||
|
No developer documentation additions are anticipated. If the existing
|
||||||
|
developer documentation is updated to reflect more hypervisor specific items,
|
||||||
|
this driver will follow suit.
|
||||||
|
|
||||||
|
|
||||||
|
References
|
||||||
|
==========
|
||||||
|
|
||||||
|
* PowerVM REST API Specification (may require newer versions as they
|
||||||
|
become available): http://ibm.co/1lThV9R
|
||||||
|
|
||||||
|
* PowerVM Virtualization Introduction and Configuration:
|
||||||
|
http://www.redbooks.ibm.com/abstracts/sg247940.html
|
||||||
|
|
||||||
|
* PowerVM Best Practices: http://www.redbooks.ibm.com/abstracts/sg248062.html
|
||||||
15
nova-powervm/__init__.py
Normal file
15
nova-powervm/__init__.py
Normal file
@ -0,0 +1,15 @@
|
|||||||
|
# Copyright 2014 IBM Corp.
|
||||||
|
#
|
||||||
|
# All Rights Reserved.
|
||||||
|
#
|
||||||
|
# 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.
|
||||||
15
nova-powervm/tests/__init__.py
Normal file
15
nova-powervm/tests/__init__.py
Normal file
@ -0,0 +1,15 @@
|
|||||||
|
# Copyright 2014 IBM Corp.
|
||||||
|
#
|
||||||
|
# All Rights Reserved.
|
||||||
|
#
|
||||||
|
# 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.
|
||||||
15
nova-powervm/tests/virt/__init__.py
Normal file
15
nova-powervm/tests/virt/__init__.py
Normal file
@ -0,0 +1,15 @@
|
|||||||
|
# Copyright 2014 IBM Corp.
|
||||||
|
#
|
||||||
|
# All Rights Reserved.
|
||||||
|
#
|
||||||
|
# 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.
|
||||||
15
nova-powervm/tests/virt/powervm/__init__.py
Normal file
15
nova-powervm/tests/virt/powervm/__init__.py
Normal file
@ -0,0 +1,15 @@
|
|||||||
|
# Copyright 2014 IBM Corp.
|
||||||
|
#
|
||||||
|
# All Rights Reserved.
|
||||||
|
#
|
||||||
|
# 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.
|
||||||
15
nova-powervm/virt/__init__.py
Normal file
15
nova-powervm/virt/__init__.py
Normal file
@ -0,0 +1,15 @@
|
|||||||
|
# Copyright 2014 IBM Corp.
|
||||||
|
#
|
||||||
|
# All Rights Reserved.
|
||||||
|
#
|
||||||
|
# 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.
|
||||||
15
nova-powervm/virt/powervm/__init__.py
Normal file
15
nova-powervm/virt/powervm/__init__.py
Normal file
@ -0,0 +1,15 @@
|
|||||||
|
# Copyright 2014 IBM Corp.
|
||||||
|
#
|
||||||
|
# All Rights Reserved.
|
||||||
|
#
|
||||||
|
# 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.
|
||||||
4
openstack-common.conf
Normal file
4
openstack-common.conf
Normal file
@ -0,0 +1,4 @@
|
|||||||
|
[DEFAULT]
|
||||||
|
|
||||||
|
# The base module to hold the copy of openstack.common
|
||||||
|
base=nova-powervm
|
||||||
6
requirements.txt
Normal file
6
requirements.txt
Normal file
@ -0,0 +1,6 @@
|
|||||||
|
pbr>=0.5.21,<1.0
|
||||||
|
Babel>=1.3
|
||||||
|
six>=1.7.0
|
||||||
|
oslo.serialization>=1.0.0 # Apache-2.0
|
||||||
|
oslo.utils>=1.0.0 # Apache-2.0
|
||||||
|
oslo.config>=1.4.0 # Apache-2.0
|
||||||
45
setup.cfg
Normal file
45
setup.cfg
Normal file
@ -0,0 +1,45 @@
|
|||||||
|
[metadata]
|
||||||
|
name = nova-powervm
|
||||||
|
summary = PowerVM driver for OpenStack Nova.
|
||||||
|
description-file = README.rst
|
||||||
|
author = IBM
|
||||||
|
author-email = kyleh@us.ibm.com
|
||||||
|
home-page = ???
|
||||||
|
classifier =
|
||||||
|
Environment :: OpenStack
|
||||||
|
Intended Audience :: Information Technology
|
||||||
|
Intended Audience :: System Administrators
|
||||||
|
License :: OSI Approved :: Apache Software License
|
||||||
|
Operating System :: POSIX :: Linux
|
||||||
|
Programming Language :: Python
|
||||||
|
Programming Language :: Python :: 2
|
||||||
|
Programming Language :: Python :: 2.7
|
||||||
|
Programming Language :: Python :: 2.6
|
||||||
|
Programming Language :: Python :: 3
|
||||||
|
Programming Language :: Python :: 3.3
|
||||||
|
|
||||||
|
[files]
|
||||||
|
packages =
|
||||||
|
nova-powervm
|
||||||
|
|
||||||
|
[build_sphinx]
|
||||||
|
source-dir = doc/source
|
||||||
|
build-dir = doc/build
|
||||||
|
all_files = 1
|
||||||
|
|
||||||
|
[upload_sphinx]
|
||||||
|
upload-dir = doc/build/html
|
||||||
|
|
||||||
|
[compile_catalog]
|
||||||
|
directory = nova-powervm/locale
|
||||||
|
domain = nova-powervm
|
||||||
|
|
||||||
|
[update_catalog]
|
||||||
|
domain = nova-powervm
|
||||||
|
output_dir = nova-powervm/locale
|
||||||
|
input_file = nova-powervm/locale/nova-powervm.pot
|
||||||
|
|
||||||
|
[extract_messages]
|
||||||
|
keywords = _ gettext ngettext l_ lazy_gettext
|
||||||
|
mapping_file = babel.cfg
|
||||||
|
output_file = nova-powervm/locale/nova-powervm.pot
|
||||||
22
setup.py
Normal file
22
setup.py
Normal file
@ -0,0 +1,22 @@
|
|||||||
|
#!/usr/bin/env python
|
||||||
|
# Copyright 2014 IBM Corp.
|
||||||
|
#
|
||||||
|
# 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.
|
||||||
|
|
||||||
|
# THIS FILE IS MANAGED BY THE GLOBAL REQUIREMENTS REPO - DO NOT EDIT
|
||||||
|
import setuptools
|
||||||
|
|
||||||
|
setuptools.setup(
|
||||||
|
setup_requires=['pbr'],
|
||||||
|
pbr=True)
|
||||||
12
test-requirements.txt
Normal file
12
test-requirements.txt
Normal file
@ -0,0 +1,12 @@
|
|||||||
|
hacking>=0.9.2,<0.10
|
||||||
|
|
||||||
|
coverage>=3.6
|
||||||
|
discover
|
||||||
|
fixtures>=0.3.14
|
||||||
|
python-subunit
|
||||||
|
sphinx>=1.1.2
|
||||||
|
oslosphinx
|
||||||
|
testrepository>=0.0.17
|
||||||
|
testscenarios>=0.4,<0.5
|
||||||
|
testtools>=0.9.32
|
||||||
|
mock>=1.0
|
||||||
30
tox.ini
Normal file
30
tox.ini
Normal file
@ -0,0 +1,30 @@
|
|||||||
|
[tox]
|
||||||
|
minversion = 1.6
|
||||||
|
envlist = py26,py27,py33,pypy,pep8
|
||||||
|
skipsdist = True
|
||||||
|
|
||||||
|
[testenv]
|
||||||
|
usedevelop = True
|
||||||
|
install_command = pip install -U {opts} {packages}
|
||||||
|
setenv =
|
||||||
|
VIRTUAL_ENV={envdir}
|
||||||
|
deps = -r{toxinidir}/requirements.txt
|
||||||
|
-r{toxinidir}/test-requirements.txt
|
||||||
|
-egit+https://github.com/openstack/nova#egg=nova
|
||||||
|
commands = python -m nova.openstack.common.lockutils python setup.py testr --slowest --testr-args='{posargs}'
|
||||||
|
|
||||||
|
[testenv:pep8]
|
||||||
|
commands = flake8
|
||||||
|
|
||||||
|
[testenv:venv]
|
||||||
|
commands = {posargs}
|
||||||
|
|
||||||
|
[testenv:cover]
|
||||||
|
commands = python setup.py testr --coverage --testr-args='{posargs}'
|
||||||
|
|
||||||
|
[flake8]
|
||||||
|
ignore = E125,E712,H104
|
||||||
|
exclude = .venv,.git,.tox,dist,doc,*openstack/common*,*lib/python*,*egg,build,tools
|
||||||
|
|
||||||
|
[hacking]
|
||||||
|
import_exceptions = nova.i18n
|
||||||
Loading…
Reference in New Issue
Block a user