diff options
author | Jenkins <jenkins@review.openstack.org> | 2017-05-31 03:37:08 +0000 |
---|---|---|
committer | Gerrit Code Review <review@openstack.org> | 2017-05-31 03:37:09 +0000 |
commit | 40532a2a457eba1179183654079e0ed81ddbcc48 (patch) | |
tree | e10876acfeecb2dc426a46ed996ca99781bb3fec | |
parent | 268ca151dcb5e45485d19deaf7610b633aded297 (diff) | |
parent | c35fb276ce75479792dc3d4b8e89cfb62aed06ae (diff) | |
download | oslo-messaging-40532a2a457eba1179183654079e0ed81ddbcc48.tar.gz |
Merge "Mark the Pika driver as deprecated"
-rw-r--r-- | doc/source/pika_driver.rst | 4 | ||||
-rw-r--r-- | oslo_messaging/_drivers/impl_pika.py | 16 | ||||
-rw-r--r-- | releasenotes/notes/pika-driver-has-been-deprecated-e2407fa53c91fe5c.yaml | 8 |
3 files changed, 23 insertions, 5 deletions
diff --git a/doc/source/pika_driver.rst b/doc/source/pika_driver.rst index 646fe92..b89fabd 100644 --- a/doc/source/pika_driver.rst +++ b/doc/source/pika_driver.rst @@ -4,6 +4,10 @@ Pika Driver Deployment Guide .. currentmodule:: oslo_messaging +.. warning:: the Pika driver is no longer maintained and will be + removed from Oslo.Messaging at a future date. It is recommended that + all users of the Pika driver transition to using the Rabbit driver. + ============ Introduction ============ diff --git a/oslo_messaging/_drivers/impl_pika.py b/oslo_messaging/_drivers/impl_pika.py index 0d413b4..65e7b48 100644 --- a/oslo_messaging/_drivers/impl_pika.py +++ b/oslo_messaging/_drivers/impl_pika.py @@ -12,6 +12,7 @@ # License for the specific language governing permissions and limitations # under the License. +from debtcollector import deprecate from oslo_config import cfg from oslo_log import log as logging from oslo_utils import timeutils @@ -127,15 +128,20 @@ rpc_opts = [ class PikaDriver(base.BaseDriver): """Pika Driver - The ``pika`` driver is the successor to the existing rabbit/kombu driver. - It is based on the Pika client library and supports the RabbitMQ broker as - the messaging back end. - - See :doc:`pika_driver` for details. + **Warning**: The ``pika`` driver has been deprecated and will be removed in + a future release. It is recommended that all users of the ``pika`` driver + transition to using the ``rabbit`` driver. """ def __init__(self, conf, url, default_exchange=None, allowed_remote_exmods=None): + + deprecate("The pika driver is no longer maintained. It has been" + " deprecated", + message="It is recommended that all users of the pika driver" + " transition to using the rabbit driver.", + version="pike", removal_version="rocky") + opt_group = cfg.OptGroup(name='oslo_messaging_pika', title='Pika driver options') conf.register_group(opt_group) diff --git a/releasenotes/notes/pika-driver-has-been-deprecated-e2407fa53c91fe5c.yaml b/releasenotes/notes/pika-driver-has-been-deprecated-e2407fa53c91fe5c.yaml new file mode 100644 index 0000000..b425778 --- /dev/null +++ b/releasenotes/notes/pika-driver-has-been-deprecated-e2407fa53c91fe5c.yaml @@ -0,0 +1,8 @@ +--- +deprecations: + - The pika driver has been deprecated for removal in Rocky. This + driver was developed as a replacement for the default rabbit + driver. However testing has not shown any appreciable improvement + over the default rabbit driver in terms of performance and + stability. + |