Correct vimType in vimConnectionInfo or vim_type in vim_connection_info
to `ETSINFV.OPENSTACK_KEYSTONE.V_2` as defined in ETSI-NFV SOL specs.
Closes-bug: #2069800
Change-Id: Ida18790772250a087c03c6e898577747aad0bff4
Signed-off-by: Yasufumi Ogawa <yasufum.o@gmail.com>
Co-Authored-By: Yoshiro Watanabe <fj3838ct@fujitsu.com>
Added notifications sent to API consumers by the VNF Fault Management
and VNF Performance Management features to the API Reference.
Added the following APIs:
- alarm notification
- AlarmClearedNotification
- PerformanceInformationAvailableNotification
- ThresholdCrossedNotification
- Test the notification endpoint
Change-Id: I5f169809c14bc980c8e2b37f1b49299cfa62086f
Signed-off-by: Yasufumi Ogawa <yasufum.o@gmail.com>
Co-Authored-By: Yoshiro Watanabe <fj3838ct@fujitsu.com>
This patch mainly fixes the description related to the version of
ETSI NFV-SOL that Tacker complies with.
The fixes are as follows:
* Fix the supported version of SubscriptionAuthentication to
SOL013 v3.4.1
* Add comment that TLS_CERT is not supported
* Add comment that OAUTH2_CLIENT_CERT complies with SOL013 v3.5.1
* Add authentication details to the create subscription request
for VNF FM
* Fix the supported version of the coordination interface to
SOL002 v3.6.1
Change-Id: Ie0bc2c45a068a24a262709b4caba510979b0a1ce
This patch changes the value corresponding to the vimConnectionId field
in the ResouceHandle data structure in the DB from the vimId value of
VimConnectionInfo to the key of the map of VimConnectionInfo.
Closes-Bug: #2046321
Change-Id: I3245d5ccb97bbf9dce8364ba37b68f99ed3af6d2
This patch removes documentation for the following legacy features.
- Extensions
- Virtualized Network Function Descriptors (VNFDs)
- Virtualized Network Functions (VNFs)
- Events
- VNF Forwarding Graph Descriptors (VNFFGDs)
- VNF Forwarding Graphs (VNFFGs)
- Network Forwarding Paths (NFPs)
- Service Function Chains (SFCs)
- Classifiers
- Network Service Descriptors (NSD)
- Network Services (NSs)
And also remove the following tools that are currently not in use.
- tools/vnfc/build_image.sh
- tools/check_i18n_test_case.txt
- tools/check_i18n.py
- tools/i18n_cfg.py
- tools/clean.sh
- tools/prepare_function_test.sh
- tools/test-setup.sh
- tools/install_venv_common.py
- tools/install_venv.py
- tools/with_venv.sh
For the following tools used in FT, move them under
`tacker/tests/functional/tools`.
- tools/test-setup-default-vim.sh
- tools/test-setup-k8s-vim.sh
- tools/test-setup-mgmt.sh
- tools/test-setup-fake-prometheus-server.sh
Implements: blueprint deprecate-legacy-apis
Change-Id: Iea89c32f69ccbe47badcfddcf77430abda98362b
This patch updates Use Case Guide and API Documentation related to
Change Current VNF Package for Bobcat.
These updates include changes in the following patches.
* Fix missing modificationsTriggeredByVnfPkgChange [1]
* Add timeout setting to VNF LCM Coordination IF [2]
The main fixes in this patch are as follows.
* Add "vnflcm update" Use Case Guide for CNF
* Add how to update metadata/extensions/vnfConfigurableProperties
* Add note about extManagedVirtualLinks of ChangeCurrentVnfPkgRequest
* Add modificationTriggeredByVnfPkgChange to VnfLcmOpOcc
* Add timeout to additionalParams for ChangeCurrentVnfPkgRequest
* Add OAUTH2_CLIENT_CERT to authType
* Change vdu_params to required parameter
[1] https://review.opendev.org/c/openstack/tacker/+/880129
[2] https://review.opendev.org/c/openstack/tacker/+/887256
Closes-Bug: #2015941
Implements: blueprint add-sample-coordinate-script
Change-Id: I5a50ed88621ec7d2f82eb1f6d844d0ad5adae544
This patch updates the v2 API reference according to
the current implementation.
The main update APIs are as follows:
* Show VNF instance
* List VNF instance
* Change Current VNF Package
* Show VNF LCM operation occurrence
* List VNF LCM operation occurrence
* Fail a VNF LCM operation occurrence
* Create a new subscription
* Show subscription
* List subscription
Change-Id: Idca22a874b746c02e9d97f4ca08a1cfcee76ccc3
This patch makes the following updates to the API and CLI docs.
* Add support CNF auto scale via PM Threshold interface
Implements: blueprint support-auto-lcm
Change-Id: Ic699dd973f5a9fc14196d5f0c80e9f6ab2a9ab88
Provide the option to use mutual TLS client authentication when
accessing external servers from Tacker. Oauth2MtlsAuthHandle has been
added to support Mutual-TLS client authentication for access from Tacker
to external NFVO servers and notification endpoints using user-provided
Mutual-TLS client certificates.
Implements: blueprint support-oauth2-mtls
Change-Id: I4d5967a26f07cc00dab177c999aff5f76a37e461
This patch provides the following User guide and
API documentation updates (fixes) in Tacker Antelope.
User doc:
* Update current support v2 API
operation status in the cli doc.
* Fix the settings of "vimConnectionInfo".
* Add vimType "ETSINFV.KUBERNETES.V_1"
to the samples of "vimConnectionInfo".
API doc:
* Fix the misdescription of VNF LCM Interface v2.
* Fix the misdescription of VNF FM Interface v1.
* Fix the misdescription of VNF PM Interface v2.
* Fix the format of request parameters
in Prometheus Plugin Interface
and Fault Notification Interface.
Implements: blueprint enhance-change-package
Implements: blueprint support-auto-lcm
Co-Author: Taiki Kimura <taiki.kimura@ntt-at.co.jp>
Change-Id: I50c130d5de812efac631ed8ad1432a98a9d00e6c
This patch deprecates the Legacy APIs excluding VIM feature.
* Emit a warning log when a Deprecated API is executed.
* Add warning block to api-refs and docs related with deprecated
Legacy feature.
Implements: blueprint deprecate-legacy-apis
Change-Id: Ie378d1000089401e3a0854b209654182da09e272
This patch makes the following updates to the API and CLI docs.
* Add support cnf auto heal and scale
Implements: blueprint support-auto-lcm
Change-Id: I776637f1361aa5861d42fb98e71ebabd3825ca4c
This patch provides the following User guide and
API documentation updates.
API doc:
* Fix the description of "extensions" which is
the Request Parameter for the "Instantiate VNF"
* Add "extVirtualLinks" which is the Request
parameter for the "Change Current VNF package"
CLI doc:
* Fix Change Current VNF package operations
for refactoring and adding modifying external NW
* Add Heal/Scale/Rollback operation commands in v2 LCM API
* Add LCM operations using Helm chart for v2 LCM API
Closes-Bug: #1981533
Implements: blueprint support-nfv-solv3-scale-vnf
Implements: blueprint support-nfv-solv3-heal-vnf
Implements: blueprint support-nfv-solv3-error-handling
Implements: blueprint helmchart-k8s-vim
Implements: blueprint enhance-change-package
Co-Author: Hirofumi Noguchi <hirofumi.noguchi.rs@hco.ntt.co.jp>
Change-Id: I95df17a29afc6aa425f93235ac006e14719e2b0b
This patch adds the description for paging large query results of
target NFV Orchestration API below into the API document.
- {apiRoot}/vnfpkgm/v1/vnf_packages
Implements: blueprint paging-query-result
Change-Id: I0c8151613193cb90944a1103c2b3359de227f37a
This patch makes the following updates to the api-ref doc.
* Add `metadata` information into vnf_instance.instantiatedVnfInfo
Implement: blueprint system-performance-management
Change-Id: I022367f9268315d4e3d8ffe4f590ac809dcedf07
This patch makes the following updates to the API and CLI docs.
* Add support faultnotification auto heal
Implements: blueprint support-autoheal-queue
Change-Id: I2fcb3c54ef3cca4e79bf701daebf1286a36f730c
This patch makes the following updates to the API and CLI docs.
API doc:
* Fix "vnfState" which is Response Parameters of List/Show VNF instance
is incorrectly set to option
* Add "maxScaleLevels" and "scaleStatus" which are Response Parameters
of List/Show VNF instance
CLI doc:
* Add subscription commands such as Create, Delete, List and Show
* Fix typo about "Change External VNF Connectivity"
* Minor fixes such as indentation correction and typo correction
Co-Author: Ai Hamano <ai.hamano@ntt-at.co.jp>
Change-Id: I4c643c542deed6b459da4f53bfe4ce90eca96d74
This patch modifies the following for the API Documentation for v2 API:
[1] Added 400 code
- All APIs return "400 Bad Request" if the validation check in the
Version header fails.
[2] Added 406 code
- All APIs except api_versions return "406 Not Acceptable" if an
unsupported version is set in the Version header.
[3] Removed 422 code
- It is not necessary to describe the "422 Unprocessable Entity"
error that occurs after returning "202 Accepted" in the response.
Change-Id: I8565c12a69ca75f6c7934e351b5f76ca093ffb02
This patch provides Tacker documents for change current vnf package
in V2-API. The specification about new API is added to API Reference.
Also, change current vnf package operation is added to
Tacker Use Cases Guide and CLI Reference.
This patch also adds change current vnf package restrictions to
error_handling user guide.
Implements: blueprint upgrade-vnf-package
Change-Id: I3f18bbab17c67e717dc0a9d36e92f812a40862e5
This patch adds the description for paging large query results of
target NFV Orchestration APIs below supported in Yoga into the API
document.
- {apiRoot}/vnflcm/v1/vnf_lcm_op_occs
- {apiRoot}/vnflcm/v1/vnf_instances
- {apiRoot}/vnflcm/v1/subscriptions
Change-Id: Ic173bde521caccf0f683a1308d80de152bbe1c5f
This patch provides Tacker documents for enhance operations(heal,
scale, update, changeextconn) in V2-API. The specification about new
API is added to API Reference. Also, update operation is added to
Tacker Use Cases Guide and CLI Reference.
This patch also includes changes to the user data script.
Implements: blueprint support-nfv-solv3-change-external-connectivity
Implements: blueprint support-nfv-solv3-heal-vnf
Implements: blueprint support-nfv-solv3-modify-vnf
Implements: blueprint support-nfv-solv3-scale-vnf
Change-Id: I6adefc59903a4c8305a66c224c086af4b86812df
This patch provides Tacker documents for error handling operations
(retry, fail, rollback) in V2-API. The specification about new API is
added to API Reference. Also, these descriptions are added to an error
handling page of Tacker Use Cases Guide.
This patch includes some improvements of these documents. For example,
modifying spelling inconsistencies, unifying uppercase and lowercase
letters and so on.
This patch does not include documents for other operations
(Modify, Scale, Heal, Changeextconn) in V2-API. Those documents
will be provided with another patch by the release of Yoga.
Implements: blueprint support-nfv-solv3-error-handling
Change-Id: Id045469db965b0e0ef12e271d9259002ef7e60af
This patch provides Tacker documents for multi-version API support.
VNF LCM API Version 2 is added to API Reference and the page hierarchy
is changed for readability.
Also, the Show VNF LCM Versions command is added to Command-Line
Interface Reference.
Furthermore, a manual of the Userdata script is added to Tacker User
Guide.
Implements: blueprint multi-version-api
Implements: blueprint support-nfv-solv3-start-and-terminate-vnf
Implements: blueprint support-nfv-solv3-query-vnf-instances
Implements: blueprint support-nfv-solv3-query-operation-occurrences
Implements: blueprint support-nfv-solv3-subscriptions
Change-Id: I603e32090303af080b17e549a0caf7e862aa7e1e
We've been using old cirros-0.4.0 for long time, and don't need to fix
the version of cirros to 0.4.0. This patch is update to the latest
0.5.2.
Most of the changes in this patch is replacing `image`, `hash` and
`version` in TOSCA definition files. The rest of them are:
* Replace images. First one is only an actual image, and rest of them
are empty text files which is a trick for reducing total size in
tacker repo. So, text files are not replaced, but renamed simply.
* tacker/tests/etc/samples/etsi/nfv/common/Files/images/cirros-0.5.2-x86_64-disk.img
* samples/vnf_packages/Files/images/cirros-0.5.2-x86_64-disk.img
* tacker/tests/etc/samples/etsi/nfv/test_csar_utils_data/sample_vnfpkg_no_meta_single_vnfd/Files/images/cirros-0.5.2-x86_64-disk.img
* tacker/tests/etc/samples/sample_vnf_package_csar_in_meta_and_manifest/Files/images/cirros-0.5.2-x86_64-disk.img
* Update functional tests verifying images. A refactor of defining
package size is included.
* Update devstack script, and helper scripts under `contrib` dir.
* Update API references and documents describing usage of the image.
Signed-off-by: Yasufumi Ogawa <yasufum.o@gmail.com>
Implements: blueprint update-cirros-052
Change-Id: I081b791dc986ab10f4845784b3e19dbb626e3cac
Host-path is missing in some of the api-ref
sample files.
This patch adds host-path in such related api-ref
sample files.
Change-Id: Iaee9daf266a6377b5de0d258aee6bcf9c6aef36e
In the condition when the vnf instance hasn't been instantiated,
an error occurs when Patching Individual VNF instance.
1. Fix the exception caused by the NULL value of vnf's
updated_at field.
2. Fix the exception happened when one of its attributes is not
existed in method to_dict in Class VnfInfoModifications.
3. Fix the problem that vnfInstanceName and vnfInstanceDescription
are not displayed in notification when vnfdId is included in the
fields which need modified.
4. In the API reference, modify the method of modifying an
"Individual VNF instance" resource from POST to PATCH.
Closes-Bug: #1915100
Change-Id: Iddb5bb540b817d4fd24e2c7c12f885bd39f8662b
- Added support for the following attributes:
*operationStates
*vnfInstanceSubscriptionFilter
- The filtering criteria is enhanced by adding the
above attributes to effectively send_notifications
- We also updated the following table in DB:
vnf_lcm_filters
Implements: blueprint support-fundamental-lcm
Spec: https://specs.openstack.org/openstack/tacker-specs/specs/wallaby/support-fundamental-vnf-lcm-based-on-ETSI-NFV.html
Change-Id: Iebe70c43ef1a5b653f8ec204b1b3a79ca882399f
This feature will enable the client to use this API to perform the
following operations:
- allow client to change the external connectivity of a VNF
instance
- VNFM support to change port/network
- VNFM also supports to change ip address/mac address/
allowed_address_pair
The operations provided through additional attributes are below:
- Grant(POST)
- VNF instances (GET)
- Individual VNF Instances (GET)
- Notification Endpoint (POST)
Modified .zuul.yaml to disable image_volume_cache, since cache
Volume remains during Terminate implementation and responds to
Heat Stack deletion failure without erasing volume type.
Implements: blueprint support-change-external-connectivity
Spec: https://specs.openstack.org/openstack/tacker-specs/specs/wallaby/support-change-external-VNF-connectivity-operation.html
Change-Id: Ie6b8b2b46b6de24e2d2d0a8bccef87bbdfa39191
In this implementation, tacker support only "fixedAddresses" parameter.
This patch support "numDynamicAddresses" parameter in
IpOverEthernetAddress, modify to be accepted API Request.
*In this patch, support for addressRange has been postponed.
It is defined into ipAddress parameter by
ETSI SOL003 -> v2.6.1 -> 4.4.1.10c.
IpOverEthernetAddressData
-> ipAddresses
-> numDynamicAddresses
And, modify the LCM user data route so that it can use
IpOverEthernetAddressData.
Change-Id: I3f6ba1f4e1bacf1fc5295726afc7ffd8626db444
- Added support for getting Individual VNF LCM
operation occurrence by its ID
- The query information is enhanced by improving
filtering expressions and operators
- Attributes are also added including (but not
limited to):
* grant_id
* _links
* >retry
* >fail
* changedExtConnectivity
- This patch has 2 BP features (Get VNFM LCM Operation
Occurence and attributes of Change External Connectivity
are also added). Since both features are related, they are
merged to one patch. This is why this patch have 2 BPs.
- Filtering for the following attributes:
operationParams, error, resourceChanges and
changedInfo is only limited to the parent
attribute. Currently, child attributes/nested
attributes are not searchable.
Implements: blueprint support-fundamental-lcm
Implements: blueprint support-change-external-connectivity
Spec: https://specs.openstack.org/openstack/tacker-specs/specs/wallaby/support-fundamental-vnf-lcm-based-on-ETSI-NFV.html
Spec: https://specs.openstack.org/openstack/tacker-specs/specs/wallaby/support-change-external-VNF-connectivity-operation.html
Change-Id: Ie9b07c203807d08857be65298d9128b026a8fd37
This feature will enable the client to use an API
to mark a VNF Lifecycle Management Operation
occurrence as "finally failed".
It is based on the ETSI NFV specification where
"FAILED" is "finally failed". Once the operation
is marked as "finally failed",it can no longer be
retried or rolled back anymore.
- As defined in SOL003, operation status can
change from FAILED_TEMP to FAILED.
- When VNFM receive this API , VNFM send
Notification(POST) to requested node.
- Regarding support of Fail Response parameter,
will provide with separated patch.
Implements: blueprint support-error-handling
Spec: https://specs.openstack.org/openstack/tacker-specs/specs/wallaby/support-error-handling-based-on-ETSI-NFV.html
Change-Id: Ieb221c6e2dd4ed6c873123325efb95f09af4a135
fetch-artifact api is implemented at patch
https://review.opendev.org/c/openstack/tacker/+/739697
but api-ref is not added.
This patch will add missing api-ref for this interface
Change-Id: If2863dfeb289fb900d13a43f1864300ae88dd178
In VNF LCM API document, there is a Notification API
where Tacker doesn't have an endpoint.
Therefore, the API definition is unnecessary and
should be removed.
Change-Id: If0272e3211da2c1372551fcb47f8bf99c10a468e
Closes-Bug: #1913665
In python 3, all strings are considered as unicode string.
This patch drops the explicit unicode literal (u'...')
or (u"..") appearances from the unicode strings.
Note: The scope of the patch is to drop unicode literal prefix
from python source code files, documentation and comment are overlook.
Change-Id: I66389d3f4b236a50bd3f193d4e67c2ac10e6ca24
