From fb18cf6657ff9cdf8d632ca2e0d9559cd2a14b96 Mon Sep 17 00:00:00 2001 From: Carl Baldwin Date: Thu, 23 Apr 2015 11:22:10 -0600 Subject: [PATCH] Introduce address scopes ApiImpact Change-Id: I2c75f7ef74fea4f659436c32da8feab88f9e4153 --- images/address-scopes.png | Bin 0 -> 78203 bytes specs/liberty/address-scopes.rst | 302 +++++++++++++++++++++++++++++++ 2 files changed, 302 insertions(+) create mode 100644 images/address-scopes.png create mode 100644 specs/liberty/address-scopes.rst diff --git a/images/address-scopes.png b/images/address-scopes.png new file mode 100644 index 0000000000000000000000000000000000000000..4a9000900ebf98c630026715f8a08c3e6f438626 GIT binary patch literal 78203 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 + +Other contributors: + `ryan-tidwell `_ + `vikschw `_ + `jbelamaric `_ + +Work Items +---------- + +#. Add address scope id to RPC response to L3 agent. (Initially just the + subnet pool id) +#. Enhance L3 agent to honor address scopes in routing tables and policy + routing. Initially just subnet pool id. It must be able to handle changing + scope ids for any given port. +#. Add DB model for address scopes. +#. Add CRUD for AddressScope, including association with SubnetPool. Update + the Neutron server to send the appropriate scope instead of the pool. + + +Dependencies +============ + +None + +Testing +======= + +Tempest Tests +------------- + +None + +Functional Tests +---------------- + +Functional testing of the L3 agent enhancements to the routing tables. + +API Tests +--------- + +Full API test coverage of the new API. + + +Documentation Impact +==================== + +User Documentation +------------------ + +This feature deserves some new user documentation for how/why to use the new +API. + +Developer Documentation +----------------------- + +New API to be documented. + +References +========== + +https://blueprints.launchpad.net/neutron/+spec/subnet-allocation