Add user guides for using Tacker
Add user guides to deploy VNF or CNF by using Tacker.
Issue-ID: SMO-79
Signed-off-by: Ayumu Ueha <ueha.ayumu@jp.fujitsu.com>
Change-Id: Ic93e89707b265cbde7913460b35e1b31caa91f9f
diff --git a/docs/tacker-user-guide-cnf.rst b/docs/tacker-user-guide-cnf.rst
new file mode 100644
index 0000000..a68b05c
--- /dev/null
+++ b/docs/tacker-user-guide-cnf.rst
@@ -0,0 +1,327 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+
+How to deploy CNF Deployment
+============================
+
+This user guide shows how to deploy CNF (Container Network Function) using Helm via Tacker.
+See the `ETSI NFV-SOL CNF Deployment by Helm chart` for the original procedure.
+
+.. contents::
+ :depth: 3
+ :local:
+
+Prerequisites
+-------------
+
+VIM
+~~~
+Register Kubernetes VIM (Virtualized Infrastructure Manager) by following procedure below.
+
+1. Prepare VIM config file, please change the parameters to suit your environment.
+ If you get bearer_token via INF O2 service, follow the "Use Kubernetes Control Client through O2 DMS profile" section of `INF O2 Service Userguide`_.
+
+ Sample config file:
+
+ .. code:: bash
+
+ $ cat vim_config_k8s.yaml
+ auth_url: "https://192.168.121.170:6443"
+ project_name: "default"
+ bearer_token: "eyJhbGciOiJSUzI1NiIsImtpZCI6InZQOGs5bjhKdExWVkZiRU5reVZRdEtBS0pnYXJFemROcElKNFpIdEFtMXMifQ.eyJpc3MiOiJrdWJlcm5ldGVzL3NlcnZpY2VhY2NvdW50Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9uYW1lc3BhY2UiOiJrdWJlLXN5c3RlbSIsImt1YmVybmV0ZXMuaW8vc2VydmljZWFjY291bnQvc2VjcmV0Lm5hbWUiOiJhZG1pbi11c2VyLXRva2VuLTk4am1qIiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9zZXJ2aWNlLWFjY291bnQubmFtZSI6ImFkbWluLXVzZXIiLCJrdWJlcm5ldGVzLmlvL3NlcnZpY2VhY2NvdW50L3NlcnZpY2UtYWNjb3VudC51aWQiOiIzZWJkZmEzZi0wMTA1LTRhN2YtODFjZS1kYjg5ODcxYTBiMDYiLCJzdWIiOiJzeXN0ZW06c2VydmljZWFjY291bnQ6a3ViZS1zeXN0ZW06YWRtaW4tdXNlciJ9.df_mV4RbsRN6oOS2KnkaKid0cJBAvdpautWnK67R0y8PRSm79Vc02NbUCmai0M4QiIF9gKhqtM0OYB5vZYJJng9vkcSNVWFUv6hA4Tvjw8FnEcGWe7TnWE2q-ZywJYiZNHvToRIgP5EH5UuLACEXu8KeeG56LxL3T2qNsUenUYLYaT6EciwKiy5SaEk3H1BB0zvSff0d_6sPvGCtY4xL_Q1pqqdgeL2lwC7tcivwEyRy3rMp1FBRrWOVdyeybww0XiNfEnYOjFyVSI4ED2n2msIdz_2JoHAnphGO7nslpn3MmkO-K1Mnhk7EKiR0kgHboGXwQlcnjW4Cje77PjumPg"
+ type: "kubernetes"
+
+2. Register VIM to Tacker by running following command.
+
+ .. code:: bash
+
+ $ source ${devstack_dir}/openrc admin admin
+ $ openstack vim register --confi-file vim_config_k8s.yaml vim-kubernetes
+
+3. Check the registered VIM status is ``REACHABLE``.
+
+ .. code:: bash
+
+ $ openstack vim list
+ +--------------------------------------+----------------+----------------------------------+------------+------------+-----------+
+ | ID | Name | Tenant_id | Type | Is Default | Status |
+ +--------------------------------------+----------------+----------------------------------+------------+------------+-----------+
+ | 5a5815fa-bf1d-41f4-a824-3e39bbdcebd0 | vim-kubernetes | a51290751e094e608ad1e5e251b8cd39 | kubernetes | True | REACHABLE |
+ +--------------------------------------+----------------+----------------------------------+------------+------------+-----------+
+
+Helm Environment
+~~~~~~~~~~~~~~~~
+Create an executable environment for Helm CLI by following procedure below.
+
+1. Install Helm.
+
+ .. code:: bash
+
+ $ HELM_VERSION="3.10.0" # Change to version that is compatible with your cluster
+ $ wget -P /tmp https://get.helm.sh/helm-v$HELM_VERSION-linux-amd64.tar.gz
+ $ tar zxf /tmp/helm-v$HELM_VERSION-linux-amd64.tar.gz -C /tmp
+ $ sudo mv /tmp/linux-amd64/helm /usr/local/bin/helm
+
+2. Create directory to store Helm chart.
+
+ .. code:: bash
+
+ $ HELM_CHART_DIR="/var/tacker/helm"
+ $ sudo mkdir -p $HELM_CHART_DIR
+
+3. Update Helm Connection Information to VIM DB.
+
+ .. code:: bash
+
+ $ mysql
+ mysql> use tacker;
+ mysql> update vims set extra=json_object(
+ 'helm_info', '{"masternode_ip": ["127.0.0.1"], "masternode_username": "stack", "masternode_password": "******"}')
+ where id="5a5815fa-bf1d-41f4-a824-3e39bbdcebd0";
+ mysql> exit
+
+ .. note::
+
+ The specified user must meet the following criteria:
+ * User can run Helm CLI commands via SSH.
+ * User can access to masternode_ip via ssh with password.
+ * User can execute sudo mkdir/chown/rm command without password.
+
+VNF Package
+~~~~~~~~~~~
+Create and upload the VNF Package that you want to deploy by following procedure below.
+
+1. Prepare VNF Package.
+ The sample VNF Package used in this guide is stored in ``o2/tacker/samples/packages/cnf`` directory.
+
+ .. code:: bash
+
+ $ git clone https://gerrit.o-ran-sc.org/r/smo/o2
+ $ cd o2/tacker/samples/packages/cnf
+ $ ls
+ Definitions Files input_param.json TOSCA-Metadata
+
+ $ zip sample_cnf_package.zip -r Definitions/ Files/ TOSCA-Metadata/
+
+ About details to prepare VNF Package, please refer to `Prepare VNF Package`_.
+
+2. Create and Upload VNF Package.
+
+ .. code:: bash
+
+ $ openstack vnf package create
+ +-------------------+-------------------------------------------------------------------------------------------------+
+ | Field | Value |
+ +-------------------+-------------------------------------------------------------------------------------------------+
+ | ID | 1efcf585-3fea-4813-88dd-bbc93692b51a |
+ | Links | { |
+ | | "self": { |
+ | | "href": "/vnfpkgm/v1/vnf_packages/1efcf585-3fea-4813-88dd-bbc93692b51a" |
+ | | }, |
+ | | "packageContent": { |
+ | | "href": "/vnfpkgm/v1/vnf_packages/1efcf585-3fea-4813-88dd-bbc93692b51a/package_content" |
+ | | } |
+ | | } |
+ | Onboarding State | CREATED |
+ | Operational State | DISABLED |
+ | Usage State | NOT_IN_USE |
+ | User Defined Data | {} |
+ +-------------------+-------------------------------------------------------------------------------------------------+
+
+ $ openstack vnf package upload --path sample_cnf_package.zip 1efcf585-3fea-4813-88dd-bbc93692b51a
+ Upload request for VNF package 1efcf585-3fea-4813-88dd-bbc93692b51a has been accepted.
+
+
+Deployment Procedure
+--------------------
+
+.. note::
+
+ This procedure uses the CLI available by installing python-tackerclient.
+ If you want to process with RESTfull API, see the `API-Docs`_ for more information.
+
+Create
+~~~~~~
+Create a VNF Instance by specifying the VNFD ID. The VNFD ID is the value defined in the VNFD file and can be found in the :command:`openstack vnf package show` command.
+
+.. code:: bash
+
+ $ openstack vnflcm create 37391b92-a1d9-44e5-855a-83644cdc3265
+ +-----------------------------+------------------------------------------------------------------------------------------------------------------+
+ | Field | Value |
+ +-----------------------------+------------------------------------------------------------------------------------------------------------------+
+ | ID | b0915924-7e04-4c16-b229-d3dfcc366eee |
+ | Instantiation State | NOT_INSTANTIATED |
+ | Links | { |
+ | | "self": { |
+ | | "href": "http://localhost:9890/vnflcm/v1/vnf_instances/b0915924-7e04-4c16-b229-d3dfcc366eee" |
+ | | }, |
+ | | "instantiate": { |
+ | | "href": "http://localhost:9890/vnflcm/v1/vnf_instances/b0915924-7e04-4c16-b229-d3dfcc366eee/instantiate" |
+ | | } |
+ | | } |
+ | VNF Configurable Properties | |
+ | VNF Instance Description | None |
+ | VNF Instance Name | vnf-b0915924-7e04-4c16-b229-d3dfcc366eee |
+ | VNF Product Name | Sample CNF |
+ | VNF Provider | Company |
+ | VNF Software Version | 1.0 |
+ | VNFD ID | 37391b92-a1d9-44e5-855a-83644cdc3265 |
+ | VNFD Version | 1.0 |
+ | vnfPkgId | |
+ +-----------------------------+------------------------------------------------------------------------------------------------------------------+
+
+Instantiate
+~~~~~~~~~~~
+Instantiate a VNF by specifying the ID of the created VNF Instance and a file path of input parameters.
+
+.. code:: bash
+
+ $ cat input_param.json
+ {
+ "flavourId": "helmchart",
+ "additionalParams": {
+ "namespace": "default",
+ "use_helm": "true",
+ "using_helm_install_param": [
+ {
+ "exthelmchart": "false",
+ "helmchartfile_path": "Files/kubernetes/localhelm-0.1.0.tgz",
+ "helmreleasename": "tacker-test-vdu"
+ }
+ ],
+ "helm_replica_values": {
+ "vdu1_aspect": "replicaCount"
+ }
+ },
+ "vimConnectionInfo": [
+ {
+ "id": "742f1fc7-7f00-417d-85a6-d4e788353181",
+ "vimId": "5a5815fa-bf1d-41f4-a824-3e39bbdcebd0",
+ "vimType": "kubernetes"
+ }
+ ]
+ }
+
+ $ openstack vnflcm instantiate b0915924-7e04-4c16-b229-d3dfcc366eee input_param.json
+ Instantiate request for VNF Instance b0915924-7e04-4c16-b229-d3dfcc366eee has been accepted.
+
+You can verify that the deployment was successful in the following ways:
+
+1. Verify that the VNF Instance displayed by the command is as follows:
+
+ * ``Instantiation State`` became ``INSTANTIATED``.
+ * Deployed resource information is stored in ``vnfcResourceInfo`` of ``Instantiated Vnf Info``.
+
+ .. code:: bash
+
+ $ openstack vnflcm show b0915924-7e04-4c16-b229-d3dfcc366eee
+ +-----------------------------+----------------------------------------------------------------------------------------------------------------------+
+ | Field | Value |
+ +-----------------------------+----------------------------------------------------------------------------------------------------------------------+
+ | ID | b0915924-7e04-4c16-b229-d3dfcc366eee |
+ | Instantiated Vnf Info | { |
+ | | "flavourId": "helmchart", |
+ | | "vnfState": "STARTED", |
+ | | "scaleStatus": [ |
+ | | { |
+ | | "aspectId": "vdu1_aspect", |
+ | | "scaleLevel": 0 |
+ | | } |
+ | | ], |
+ | | "extCpInfo": [], |
+ | | "vnfcResourceInfo": [ |
+ | | { |
+ | | "id": "df202937-2bb8-40a9-8be0-a8aa5e2ec0ae", |
+ | | "vduId": "VDU1", |
+ | | "computeResource": { |
+ | | "vimConnectionId": null, |
+ | | "resourceId": "tacker-test-vdu-localhelm-7b5489f949-fzmc5", |
+ | | "vimLevelResourceType": "Deployment" |
+ | | }, |
+ | | "storageResourceIds": [] |
+ | | } |
+ | | ], |
+ | | "additionalParams": { |
+ | | "useHelm": "true", |
+ | | "namespace": "default", |
+ | | "helmReplicaValues": { |
+ | | "vdu1Aspect": "replicaCount" |
+ | | }, |
+ | | "usingHelmInstallParam": [ |
+ | | { |
+ | | "exthelmchart": "false", |
+ | | "helmreleasename": "tacker-test-vdu", |
+ | | "helmchartfilePath": "Files/kubernetes/localhelm-0.1.0.tgz" |
+ | | } |
+ | | ] |
+ | | } |
+ | | } |
+ | Instantiation State | INSTANTIATED |
+ | Links | { |
+ | | "self": { |
+ | | "href": "http://localhost:9890/vnflcm/v1/vnf_instances/b0915924-7e04-4c16-b229-d3dfcc366eee" |
+ | | }, |
+ | | "terminate": { |
+ | | "href": "http://localhost:9890/vnflcm/v1/vnf_instances/b0915924-7e04-4c16-b229-d3dfcc366eee/terminate" |
+ | | }, |
+ | | "heal": { |
+ | | "href": "http://localhost:9890/vnflcm/v1/vnf_instances/b0915924-7e04-4c16-b229-d3dfcc366eee/heal" |
+ | | }, |
+ | | "changeExtConn": { |
+ | | "href": "http://localhost:9890/vnflcm/v1/vnf_instances/b0915924-7e04-4c16-b229-d3dfcc366eee/change_ext_conn" |
+ | | } |
+ | | } |
+ | VIM Connection Info | [ |
+ | | { |
+ | | "id": "742f1fc7-7f00-417d-85a6-d4e788353181", |
+ | | "vimId": "5a5815fa-bf1d-41f4-a824-3e39bbdcebd0", |
+ | | "vimType": "kubernetes", |
+ | | "interfaceInfo": {}, |
+ | | "accessInfo": {}, |
+ | | "extra": {} |
+ | | } |
+ | | ] |
+ | VNF Configurable Properties | |
+ | VNF Instance Description | None |
+ | VNF Instance Name | vnf-b0915924-7e04-4c16-b229-d3dfcc366eee |
+ | VNF Product Name | Sample CNF |
+ | VNF Provider | Company |
+ | VNF Software Version | 1.0 |
+ | VNFD ID | 37391b92-a1d9-44e5-855a-83644cdc3265 |
+ | VNFD Version | 1.0 |
+ | metadata | namespace=default |
+ | vnfPkgId | |
+ +-----------------------------+----------------------------------------------------------------------------------------------------------------------+
+
+2. Verify the CNF resources that were actually created as follows:
+
+ .. code:: bash
+
+ $ kubectl get deployment
+ NAME READY UP-TO-DATE AVAILABLE AGE
+ tacker-test-vdu-localhelm 1/1 1 1 20s
+
+ $ kubectl get pod
+ NAME READY STATUS RESTARTS AGE
+ tacker-test-vdu-localhelm-7b5489f949-fzmc5 1/1 Running 0 24s
+
+ $ helm list
+ NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION
+ tacker-test-vdu default 1 2022-06-29 14:54:32.20990033 +0000 UTC deployed localhelm-0.1.0 1.16.0
+
+Terminate
+~~~~~~~~~
+Terminate a VNF by specifying the VNF Instance ID.
+
+.. code:: bash
+
+ $ openstack vnflcm terminate b0915924-7e04-4c16-b229-d3dfcc366eee
+ Terminate request for VNF Instance 'b0915924-7e04-4c16-b229-d3dfcc366eee' has been accepted.
+
+
+.. _ETSI NFV-SOL CNF Deployment by Helm chart: https://docs.openstack.org/tacker/latest/user/mgmt_driver_deploy_k8s_and_cnf_with_helm.html#etsi-nfv-sol-cnf-deployment-by-helm-chart
+.. _INF O2 Service Userguide: https://docs.o-ran-sc.org/projects/o-ran-sc-pti-o2/en/latest/user-guide.html
+.. _Prepare VNF Package: https://docs.openstack.org/tacker/latest/user/mgmt_driver_deploy_k8s_and_cnf_with_helm.html#prepare-vnf-package
+.. _API-Docs: https://docs.o-ran-sc.org/projects/o-ran-sc-smo-o2/en/latest/tacker/api-docs.html
diff --git a/docs/tacker-user-guide-vnf.rst b/docs/tacker-user-guide-vnf.rst
new file mode 100644
index 0000000..00e8130
--- /dev/null
+++ b/docs/tacker-user-guide-vnf.rst
@@ -0,0 +1,389 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+
+How to deploy VNF Deployment
+============================
+
+This user guide shows how to deploy VNF (Virtualized Network Function) via Tacker.
+See the `ETSI NFV-SOL VNF Deployment` for the original procedure.
+
+.. contents::
+ :depth: 3
+ :local:
+
+Prerequisites
+-------------
+
+VIM
+~~~
+Register OpenStack VIM (Virtualized Infrastructure Manager) by following procedure below.
+
+1. Prepare VIM config file, please change the parameters to suit your environment.
+
+ Sample config file:
+
+ .. code:: bash
+
+ $ cat vim_config.yaml
+ auth_url: 'http://192.168.121.170/v3'
+ username: 'admin'
+ password: 'devstack'
+ project_name: 'admin'
+ project_domain_name: 'Default'
+ user_domain_name: 'Default'
+ cert_verify: 'False'
+
+2. Register VIM to Tacker by running following command.
+
+ .. code:: bash
+
+ $ source ${devstack_dir}/openrc admin admin
+ $ openstack vim register --confi-file vim_config.yaml vim-openstack
+
+3. Check the registered VIM status is ``REACHABLE``.
+
+ .. code:: bash
+
+ $ openstack vim list
+ +--------------------------------------+----------------+----------------------------------+------------+------------+-----------+
+ | ID | Name | Tenant_id | Type | Is Default | Status |
+ +--------------------------------------+----------------+----------------------------------+------------+------------+-----------+
+ | d8d886e4-fd98-4493-81e2-0e2b9991d629 | vim-openstack | a51290751e094e608ad1e5e251b8cd39 | openstack | True | REACHABLE |
+ +--------------------------------------+----------------+----------------------------------+------------+------------+-----------+
+
+VNF Package
+~~~~~~~~~~~
+Create and upload the VNF Package that you want to deploy by following procedure below.
+
+1. Prepare VNF Package.
+ The sample VNF Package used in this guide is stored in ``o2/tacker/samples/packages/vnf`` directory.
+
+ .. code:: bash
+
+ $ git clone https://gerrit.o-ran-sc.org/r/smo/o2
+ $ cd o2/tacker/samples/packages/vnf
+ $ ls
+ BaseHOT Definitions Files input_param.json TOSCA-Metadata UserData
+
+ $ wget -P Files/images https://opendev.org/openstack/tacker/raw/branch/master/tacker/tests/etc/samples/etsi/nfv/common/Files/images/cirros-0.5.2-x86_64-disk.img
+
+ $ zip sample_vnf_package.zip -r BaseHOT/ Definitions/ Files/ TOSCA-Metadata/ UserData/
+
+
+ About details to prepare VNF Package, please refer to `Prepare VNF Package`_.
+
+2. Create and Upload VNF Package.
+
+ .. code:: bash
+
+ $ openstack vnf package create
+ +-------------------+-------------------------------------------------------------------------------------------------+
+ | Field | Value |
+ +-------------------+-------------------------------------------------------------------------------------------------+
+ | ID | 9f10134f-90ae-4e71-bfdc-de6593552de8 |
+ | Links | { |
+ | | "self": { |
+ | | "href": "/vnfpkgm/v1/vnf_packages/9f10134f-90ae-4e71-bfdc-de6593552de8" |
+ | | }, |
+ | | "packageContent": { |
+ | | "href": "/vnfpkgm/v1/vnf_packages/9f10134f-90ae-4e71-bfdc-de6593552de8/package_content" |
+ | | } |
+ | | } |
+ | Onboarding State | CREATED |
+ | Operational State | DISABLED |
+ | Usage State | NOT_IN_USE |
+ | User Defined Data | {} |
+ +-------------------+-------------------------------------------------------------------------------------------------+
+
+ $ openstack vnf package upload --path sample_vnf_package.zip 9f10134f-90ae-4e71-bfdc-de6593552de8
+ Upload request for VNF package 9f10134f-90ae-4e71-bfdc-de6593552de8 has been accepted.
+
+Deployment Procedure
+--------------------
+
+.. note::
+
+ This procedure uses the CLI available by installing python-tackerclient.
+ If you want to process with RESTfull API, see the `API-Docs`_ for more information.
+
+Create
+~~~~~~
+Create a VNF Instance by specifying the VNFD ID. The VNFD ID is the value defined in the VNFD file and can be found in the :command:`openstack vnf package show` command.
+
+.. code:: bash
+
+ $ openstack vnflcm create b1bb0ce7-ebca-4fa7-95ed-4840d70a1177
+ +-----------------------------+------------------------------------------------------------------------------------------------------------------+
+ | Field | Value |
+ +-----------------------------+------------------------------------------------------------------------------------------------------------------+
+ | ID | fba5bda0-0b52-4d80-bffb-709200baf1e3 |
+ | Instantiation State | NOT_INSTANTIATED |
+ | Links | { |
+ | | "self": { |
+ | | "href": "http://localhost:9890/vnflcm/v1/vnf_instances/fba5bda0-0b52-4d80-bffb-709200baf1e3" |
+ | | }, |
+ | | "instantiate": { |
+ | | "href": "http://localhost:9890/vnflcm/v1/vnf_instances/fba5bda0-0b52-4d80-bffb-709200baf1e3/instantiate" |
+ | | } |
+ | | } |
+ | VNF Configurable Properties | |
+ | VNF Instance Description | None |
+ | VNF Instance Name | vnf-fba5bda0-0b52-4d80-bffb-709200baf1e3 |
+ | VNF Product Name | Sample VNF |
+ | VNF Provider | Company |
+ | VNF Software Version | 1.0 |
+ | VNFD ID | b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 |
+ | VNFD Version | 1.0 |
+ | vnfPkgId | |
+ +-----------------------------+------------------------------------------------------------------------------------------------------------------+
+
+Instantiate
+~~~~~~~~~~~
+Instantiate a VNF by specifying the ID of the created VNF Instance and a file path of input parameters.
+
+.. note::
+ Please change the parameters in ``input_param.json`` to suite your environment.
+
+.. code:: bash
+
+ $ cat input_param.json
+ {
+ "flavourId": "simple",
+ "extVirtualLinks": [
+ {
+ "id": "test1",
+ "resourceId": "0e1cc46a-6808-4738-8b84-9e99a775c9eb",
+ "extCps": [
+ {
+ "cpdId": "CP1",
+ "cpConfig": [
+ {
+ "cpProtocolData": [
+ {
+ "layerProtocol": "IP_OVER_ETHERNET",
+ "ipOverEthernet": {
+ "ipAddresses": [
+ {
+ "type": "IPV4",
+ "numDynamicAddresses": 1,
+ "subnetId": "309614e6-4aab-4424-977f-fd9c8dfe493e"
+ }
+ ]
+ }
+ }
+ ]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "vimConnectionInfo": [
+ {
+ "id": "e24f9796-a8e9-4cb0-85ce-5920dcddafa1",
+ "vimId": "d8d886e4-fd98-4493-81e2-0e2b9991d629",
+ "vimType": "openstack"
+ }
+ ],
+ "additionalParams": {
+ "lcm-operation-user-data": "./UserData/lcm_user_data.py",
+ "lcm-operation-user-data-class": "SampleUserData"
+ }
+ }
+
+ $ openstack vnflcm instantiate b0915924-7e04-4c16-b229-d3dfcc366eee input_param.json
+ Instantiate request for VNF Instance b0915924-7e04-4c16-b229-d3dfcc366eee has been accepted.
+
+You can verify that the deployment was successful in the following ways:
+
+1. Verify that the VNF Instance displayed by :command:`openstack vnflcm show` command is as follows:
+
+ * ``Instantiation State`` became ``INSTANTIATED``.
+ * Deployed resource information is stored in ``vnfcResourceInfo`` of ``Instantiated Vnf Info``.
+
+ .. code:: bash
+
+ $ openstack vnflcm show fba5bda0-0b52-4d80-bffb-709200baf1e3
+ +-----------------------------+----------------------------------------------------------------------------------------------------------------------+
+ | Field | Value |
+ +-----------------------------+----------------------------------------------------------------------------------------------------------------------+
+ | ID | fba5bda0-0b52-4d80-bffb-709200baf1e3 |
+ | Instantiated Vnf Info | { |
+ | | "flavourId": "simple", |
+ | | "vnfState": "STARTED", |
+ | | "extCpInfo": [ |
+ | | { |
+ | | "id": "4e9cda91-f625-4790-8efb-273b3fbd03a1", |
+ | | "cpdId": "CP1", |
+ | | "extLinkPortId": null, |
+ | | "associatedVnfcCpId": "65676b39-1e80-435f-997d-217963d25298", |
+ | | "cpProtocolInfo": [ |
+ | | { |
+ | | "layerProtocol": "IP_OVER_ETHERNET", |
+ | | "ipOverEthernet": { |
+ | | "macAddress": null, |
+ | | "ipAddresses": [ |
+ | | { |
+ | | "type": "IPV4", |
+ | | "subnetId": "309614e6-4aab-4424-977f-fd9c8dfe493e", |
+ | | "isDynamic": true, |
+ | | "addresses": [] |
+ | | } |
+ | | ] |
+ | | } |
+ | | } |
+ | | ] |
+ | | } |
+ | | ], |
+ | | "extVirtualLinkInfo": [ |
+ | | { |
+ | | "id": "test1", |
+ | | "resourceHandle": { |
+ | | "vimConnectionId": null, |
+ | | "resourceId": "0e1cc46a-6808-4738-8b84-9e99a775c9eb", |
+ | | "vimLevelResourceType": null |
+ | | } |
+ | | } |
+ | | ], |
+ | | "vnfcResourceInfo": [ |
+ | | { |
+ | | "id": "65676b39-1e80-435f-997d-217963d25298", |
+ | | "vduId": "VDU1", |
+ | | "computeResource": { |
+ | | "vimConnectionId": "d8d886e4-fd98-4493-81e2-0e2b9991d629", |
+ | | "resourceId": "0f0ee6b9-cf6c-41c7-a36c-78d41fcba99c", |
+ | | "vimLevelResourceType": "OS::Nova::Server" |
+ | | }, |
+ | | "storageResourceIds": [], |
+ | | "vnfcCpInfo": [ |
+ | | { |
+ | | "id": "a3da58ce-039d-42ee-9569-a0e2a9adf9bb", |
+ | | "cpdId": "CP1", |
+ | | "vnfExtCpId": null, |
+ | | "vnfLinkPortId": "d61dcdf1-d5c6-4add-8b0f-0095b00908cd", |
+ | | "cpProtocolInfo": [ |
+ | | { |
+ | | "layerProtocol": "IP_OVER_ETHERNET", |
+ | | "ipOverEthernet": { |
+ | | "macAddress": null, |
+ | | "ipAddresses": [ |
+ | | { |
+ | | "type": "IPV4", |
+ | | "subnetId": "309614e6-4aab-4424-977f-fd9c8dfe493e", |
+ | | "isDynamic": true, |
+ | | "addresses": [] |
+ | | } |
+ | | ] |
+ | | } |
+ | | } |
+ | | ] |
+ | | } |
+ | | ] |
+ | | } |
+ | | ], |
+ | | "vnfVirtualLinkResourceInfo": [ |
+ | | { |
+ | | "id": "006531d5-7bb9-472d-9243-7dd415ca9839", |
+ | | "vnfVirtualLinkDescId": "internalVL1", |
+ | | "networkResource": { |
+ | | "vimConnectionId": null, |
+ | | "resourceId": "", |
+ | | "vimLevelResourceType": null |
+ | | }, |
+ | | "vnfLinkPorts": [ |
+ | | { |
+ | | "id": "11d2a97d-884d-4943-9539-bc6c8e4e9e2b", |
+ | | "resourceHandle": { |
+ | | "vimConnectionId": "d8d886e4-fd98-4493-81e2-0e2b9991d629", |
+ | | "resourceId": "601c9ce5-91df-4636-9fc3-0ae979781d9a", |
+ | | "vimLevelResourceType": "OS::Neutron::Port" |
+ | | }, |
+ | | "cpInstanceId": "a3da58ce-039d-42ee-9569-a0e2a9adf9bb" |
+ | | } |
+ | | ] |
+ | | }, |
+ | | { |
+ | | "id": "3a9607a4-0d5a-42da-aca3-2c471544ee86", |
+ | | "vnfVirtualLinkDescId": "test1", |
+ | | "networkResource": { |
+ | | "vimConnectionId": null, |
+ | | "resourceId": "0e1cc46a-6808-4738-8b84-9e99a775c9eb", |
+ | | "vimLevelResourceType": "OS::Neutron::Net" |
+ | | }, |
+ | | "vnfLinkPorts": [ |
+ | | { |
+ | | "id": "d61dcdf1-d5c6-4add-8b0f-0095b00908cd", |
+ | | "resourceHandle": { |
+ | | "vimConnectionId": null, |
+ | | "resourceId": "", |
+ | | "vimLevelResourceType": null |
+ | | }, |
+ | | "cpInstanceId": "a3da58ce-039d-42ee-9569-a0e2a9adf9bb" |
+ | | } |
+ | | ] |
+ | | } |
+ | | ], |
+ | | "vnfcInfo": [ |
+ | | { |
+ | | "id": "341f2d8c-b53f-4d4b-b7f2-2f1726355803", |
+ | | "vduId": "VDU1", |
+ | | "vnfcState": "STARTED" |
+ | | } |
+ | | ], |
+ | | "additionalParams": { |
+ | | "lcm-operation-user-data": "./UserData/lcm_user_data.py", |
+ | | "lcm-operation-user-data-class": "SampleUserData" |
+ | | } |
+ | | } |
+ | Instantiation State | INSTANTIATED |
+ | Links | { |
+ | | "self": { |
+ | | "href": "http://localhost:9890/vnflcm/v1/vnf_instances/fba5bda0-0b52-4d80-bffb-709200baf1e3" |
+ | | }, |
+ | | "terminate": { |
+ | | "href": "http://localhost:9890/vnflcm/v1/vnf_instances/fba5bda0-0b52-4d80-bffb-709200baf1e3/terminate" |
+ | | }, |
+ | | "heal": { |
+ | | "href": "http://localhost:9890/vnflcm/v1/vnf_instances/fba5bda0-0b52-4d80-bffb-709200baf1e3/heal" |
+ | | }, |
+ | | "changeExtConn": { |
+ | | "href": "http://localhost:9890/vnflcm/v1/vnf_instances/fba5bda0-0b52-4d80-bffb-709200baf1e3/change_ext_conn" |
+ | | } |
+ | | } |
+ | VIM Connection Info | [ |
+ | | { |
+ | | "id": "e24f9796-a8e9-4cb0-85ce-5920dcddafa1", |
+ | | "vimId": "d8d886e4-fd98-4493-81e2-0e2b9991d629", |
+ | | "vimType": "openstack", |
+ | | "interfaceInfo": {}, |
+ | | "accessInfo": {}, |
+ | | "extra": {} |
+ | | } |
+ | | ] |
+ | VNF Configurable Properties | |
+ | VNF Instance Description | None |
+ | VNF Instance Name | vnf-fba5bda0-0b52-4d80-bffb-709200baf1e3 |
+ | VNF Product Name | Sample VNF |
+ | VNF Provider | Company |
+ | VNF Software Version | 1.0 |
+ | VNFD ID | b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 |
+ | VNFD Version | 1.0 |
+ | vnfPkgId | |
+ +-----------------------------+----------------------------------------------------------------------------------------------------------------------+
+
+2. Verify the VM created successfully by :command:`openstack stack list/show` command or OpenStack Dashboard.
+
+Terminate
+~~~~~~~~~
+Terminate a VNF by specifying the VNF Instance ID.
+
+.. code:: bash
+
+ $ openstack vnflcm terminate fba5bda0-0b52-4d80-bffb-709200baf1e3
+ Terminate request for VNF Instance 'fba5bda0-0b52-4d80-bffb-709200baf1e3' has been accepted.
+
+
+.. _ETSI NFV-SOL VNF Deployment: https://docs.openstack.org/tacker/latest/user/etsi_vnf_deployment_as_vm_with_user_data.html
+.. _Prepare VNF Package: https://docs.openstack.org/tacker/latest/user/vnf-package.html
+.. _API-Docs: https://docs.o-ran-sc.org/projects/o-ran-sc-smo-o2/en/latest/tacker/api-docs.html
diff --git a/docs/user-guide.rst b/docs/user-guide.rst
index 3557acb..9a52b6c 100644
--- a/docs/user-guide.rst
+++ b/docs/user-guide.rst
@@ -26,7 +26,16 @@
--------------------
.. Provide enough information that a user will be able to operate the feature on a deployed scenario. content can be added from administration, management, using, Troubleshooting sections perspectives.
+Tacker
+~~~~~~
+An example of the procedure how to deploy VNF or CNF by using Tacker is shown on the following pages.
+If you want to see the other procedure, please refer to `Tacker User Guide`_
+
+.. toctree::
+ :maxdepth: 1
+
+ tacker-user-guide-vnf.rst
+ tacker-user-guide-cnf.rst
-
-
+.. _Tacker User Guide: https://docs.openstack.org/tacker/latest/user/index.html