summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorFrancescoFioraEst <francesco.fiora@est.tech>2023-06-08 09:01:22 +0100
committerFrancesco Fiora <francesco.fiora@est.tech>2023-06-08 10:17:08 +0000
commitd3ea2362501e3b51a709f8e2671f97ec5aad1349 (patch)
treee7c820b4121ddc426d17275bc0d383ab8006f766 /docs
parentd4f8ac0768b95d2f9da8f84de82b88c80a6705b6 (diff)
Add extend instance deletion support in ACM docs
Issue-ID: POLICY-4730 Change-Id: Ifbbd2369b9ef0032f9066b287f98fc2fcbd4d550 Signed-off-by: FrancescoFioraEst <francesco.fiora@est.tech>
Diffstat (limited to 'docs')
-rw-r--r--docs/clamp/acm/acm-architecture.rst8
-rw-r--r--docs/clamp/acm/acm-user-guide.rst2
-rw-r--r--docs/clamp/acm/api-protocol/acm-participant-protocol.rst2
-rw-r--r--docs/clamp/acm/api-protocol/system-level-dialogues.rst9
-rw-r--r--docs/clamp/acm/design-impl/clamp-runtime-acm.rst5
-rw-r--r--docs/clamp/acm/design-impl/participants/participant-intermediary.rst24
-rw-r--r--docs/clamp/acm/images/system-dialogues/DeleteAcInstance.pngbin26328 -> 31050 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/DeleteInstanceElements.pngbin0 -> 25513 bytes
-rw-r--r--docs/clamp/acm/images/system-dialogues/DeleteResponseStored.pngbin0 -> 21072 bytes
9 files changed, 36 insertions, 14 deletions
diff --git a/docs/clamp/acm/acm-architecture.rst b/docs/clamp/acm/acm-architecture.rst
index 4e8f6744..2e8f5186 100644
--- a/docs/clamp/acm/acm-architecture.rst
+++ b/docs/clamp/acm/acm-architecture.rst
@@ -240,9 +240,11 @@ At Run Time, the following Automation Composition Life Cycle management capabili
that the Automation Composition instance is removed from Participants.
#. **Automation Composition Instance Deletion:** A user can order the removal of a Automation Composition Instance
- from the ACM runtime. Automation Composition Instances that are DEPLOYED/UNLOCKED on participants cannot
- be removed from the ACM runtime. The post condition for an execution of this capability
- is that the Automation Composition instance is removed from Instance Automation Composition Inventory.
+ from the ACM runtime and participants. Automation Composition Instances that are DEPLOYED/UNLOCKED on participants cannot
+ be removed from the ACM runtime. Each participant begins accepting and processing automation composition events removing the
+ Automation Composition Instance from the inventory. The post condition for an execution of this capability
+ is that the Automation Composition instance is removed from Instance Automation Composition Inventory
+ in ACM runtime and participants.
#. **Automation Composition Depriming on Participants.** The Depriming operation removes Automation Composition Types
and common property values from participants for each Automation Composition Element Type in the Automation
diff --git a/docs/clamp/acm/acm-user-guide.rst b/docs/clamp/acm/acm-user-guide.rst
index 56dc66b7..c2485ecf 100644
--- a/docs/clamp/acm/acm-user-guide.rst
+++ b/docs/clamp/acm/acm-user-guide.rst
@@ -268,7 +268,7 @@ This deletes the AC instance from the database including all the element propert
Invoke a DELETE request
'http://policy_runtime_ip:port/onap/policy/clamp/acm/v2/compositions/${compositionId}/instances/${instanceId}'
-This returns 200 on successful deletion of the instance.
+This returns a 202 response on successful delete order request.
Deprime Ac defintions
---------------------
diff --git a/docs/clamp/acm/api-protocol/acm-participant-protocol.rst b/docs/clamp/acm/api-protocol/acm-participant-protocol.rst
index 2dae2b00..b4755ae2 100644
--- a/docs/clamp/acm/api-protocol/acm-participant-protocol.rst
+++ b/docs/clamp/acm/api-protocol/acm-participant-protocol.rst
@@ -101,7 +101,7 @@ message.
.. image:: ../images/acm-participants-protocol/acm-state-change.png
-The flow of the DEPLOY/UNDEPLOY state change messages are shown below. But the same flow is true for LOCK/UNLOCK
+The flow of the DEPLOY/UNDEPLOY state change messages are shown below. But the same flow is true for LOCK/UNLOCK and DELETE
.. note:: More details of the state machine are available on :ref:`ACM States <acm-states-label>`
diff --git a/docs/clamp/acm/api-protocol/system-level-dialogues.rst b/docs/clamp/acm/api-protocol/system-level-dialogues.rst
index 4ffcbe69..c5105313 100644
--- a/docs/clamp/acm/api-protocol/system-level-dialogues.rst
+++ b/docs/clamp/acm/api-protocol/system-level-dialogues.rst
@@ -114,9 +114,18 @@ Note that this dialogue creates the Automation Composition Instance in the ACM d
3.2 Delete an Automation Composition Instance
---------------------------------------------
+The user requests the AC Instance to be deleted using a REST endpoint. The ACM Runtime orders the AC Instance to be deleted.
.. image:: ../images/system-dialogues/DeleteAcInstance.png
+Each participant deletes its AC Element Instances from the AC Instance
+
+.. image:: ../images/system-dialogues/DeleteInstanceElements.png
+
+The ACM Runtime receives and stores the responses, when all instances element are deleted, it delete the instance.
+
+.. image:: ../images/system-dialogues/DeleteResponseStored.png
+
3.3 Deploy Automation Composition Instance
------------------------------------------
The user requests the AC Instance to be deployed using a REST endpoint. The ACM Runtime orders the AC Instance to be deployed to Participants.
diff --git a/docs/clamp/acm/design-impl/clamp-runtime-acm.rst b/docs/clamp/acm/design-impl/clamp-runtime-acm.rst
index ba5ffe33..dd6348c8 100644
--- a/docs/clamp/acm/design-impl/clamp-runtime-acm.rst
+++ b/docs/clamp/acm/design-impl/clamp-runtime-acm.rst
@@ -123,7 +123,9 @@ Delete of a Automation Composition Instance
- GUI calls DELETE "/onap/policy/clamp/acm/v2/compositions/{compositionId}/instances/{instanceId}" endpoint
- runtime-ACM receives the call by Rest-Api (InstantiationController)
- It checks that AC Instance is in UNDEPLOYED deployState
-- It deletes the AC Instance from DB
+- It updates the AC Instance to DB with DELETING deployState
+- It triggers the execution to send a broadcast AUTOMATION_COMPOSITION_STATE_CHANGE message
+- the message is built by AutomationCompositionStateChangePublisher using Instance data. (with startPhase = last StartPhase)
Depriming of a Automation Composition Definition Type
+++++++++++++++++++++++++++++++++++++++++++++++++++++
@@ -242,6 +244,7 @@ Monitoring is designed to process the follow operations:
- to determine the next startPhase in a AUTOMATION_COMPOSITION_DEPLOY message
- to update AC deployState: in a scenario that "AutomationComposition.deployState" is in a kind of transitional state (example DEPLOYING), if all - AC elements are moved properly to the specific state, the "AutomationComposition.deployState" will be updated to that and saved to DB
- to update AC lockState: in a scenario that "AutomationComposition.lockState" is in a kind of transitional state (example LOCKING), if all - AC elements are moved properly to the specific state, the "AutomationComposition.lockState" will be updated to that and saved to DB
+- to delete AC Instance: in a scenario that "AutomationComposition.deployState" is in DELETING, if all - AC elements are moved properly to DELETED, the AC Instance will be deleted from DB
- to retry AUTOMATION_COMPOSITION_DEPLOY/AUTOMATION_COMPOSITION_STATE_CHANGE messages. if there is a AC Element not in the proper state, it will retry a broadcast message
The solution Design of retry, timeout, and reporting for all Participant message dialogues are implemented into the monitoring execution.
diff --git a/docs/clamp/acm/design-impl/participants/participant-intermediary.rst b/docs/clamp/acm/design-impl/participants/participant-intermediary.rst
index 6ebc76f9..53215389 100644
--- a/docs/clamp/acm/design-impl/participants/participant-intermediary.rst
+++ b/docs/clamp/acm/design-impl/participants/participant-intermediary.rst
@@ -64,31 +64,39 @@ DePrime of an Automation Composition Definition Type
- the message is built by ParticipantPrimePublisher with an empty list of ParticipantDefinition
- Participant-intermediary will receive a PARTICIPANT_PRIME message and deletes the Tosca Service Template data on ParticipantHandler
-Design of "issues automation composition commands to automation compositions" - case UNDEPLOY to DEPLOY
--------------------------------------------------------------------------------------------------------
+Design of "issues automation composition commands to automation compositions" - case UNDEPLOYED to DEPLOYED
+-----------------------------------------------------------------------------------------------------------
- AUTOMATION_COMPOSITION_DEPLOY message with instantiation details and DEPLOY order state is sent to participants
- Participant-intermediary validates the current deployState change
- Participant-intermediary will receive AUTOMATION_COMPOSITION_DEPLOY message and sends the details of AutomationCompositionElements to participants
- Each participant performs its designated job of deployment by interacting with respective frameworks
-Design of "issues automation composition commands to automation compositions" - case DEPLOY to UNDEPLOY
--------------------------------------------------------------------------------------------------------
+Design of "issues automation composition commands to automation compositions" - case DEPLOYED to UNDEPLOYED
+-----------------------------------------------------------------------------------------------------------
- AUTOMATION_COMPOSITION_STATE_CHANGE message with instantiation details and UNDEPLOY order state is sent to participants
- Participant-intermediary validates the current deployState change
- Participant-intermediary will receive AUTOMATION_COMPOSITION_STATE_CHANGE message and sends AC-element details to participants
- Each participant performs its designated job of undeployment by interacting with respective frameworks
-Design of "issues automation composition commands to automation compositions" - case LOCK to UNLOCK
----------------------------------------------------------------------------------------------------
+Design of "issues automation composition commands to automation compositions" - case LOCKED to UNLOCKED
+-------------------------------------------------------------------------------------------------------
- AUTOMATION_COMPOSITION_STATE_CHANGE message with instantiation details and UNLOCK order state is sent to participants
- Participant-intermediary validates the current lockState change
- Participant-intermediary will receive AUTOMATION_COMPOSITION_STATE_CHANGE message
-Design of "issues automation composition commands to automation compositions" - case UNLOCK to LOCK
----------------------------------------------------------------------------------------------------
+Design of "issues automation composition commands to automation compositions" - case UNLOCKED to LOCKED
+-------------------------------------------------------------------------------------------------------
- AUTOMATION_COMPOSITION_STATE_CHANGE message with instantiation details and LOCK order state is sent to participants
- Participant-intermediary validates the current lockState change
+Design of Delete - case UNDEPLOYED to DELETED
+---------------------------------------------
+- AUTOMATION_COMPOSITION_STATE_CHANGE message with instantiation details and DELETE order state is sent to participants
+- Participant-intermediary validates the current deployState change
+- Participant-intermediary will receive AUTOMATION_COMPOSITION_STATE_CHANGE message and sends AC-element details to participants
+- Each participant performs its designated job of removing instantiation data if not done in undeployment
+- Participant-intermediary will remove instantiation data
+
Design of a PARTICIPANT_STATUS_REQ message
------------------------------------------
- AC-runtime triggers the execution to send a broadcast PARTICIPANT_STATUS_REQ message or to send it to a specific participant
diff --git a/docs/clamp/acm/images/system-dialogues/DeleteAcInstance.png b/docs/clamp/acm/images/system-dialogues/DeleteAcInstance.png
index ab6e2795..60107669 100644
--- a/docs/clamp/acm/images/system-dialogues/DeleteAcInstance.png
+++ b/docs/clamp/acm/images/system-dialogues/DeleteAcInstance.png
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/DeleteInstanceElements.png b/docs/clamp/acm/images/system-dialogues/DeleteInstanceElements.png
new file mode 100644
index 00000000..73f7f52b
--- /dev/null
+++ b/docs/clamp/acm/images/system-dialogues/DeleteInstanceElements.png
Binary files differ
diff --git a/docs/clamp/acm/images/system-dialogues/DeleteResponseStored.png b/docs/clamp/acm/images/system-dialogues/DeleteResponseStored.png
new file mode 100644
index 00000000..6ac70cd2
--- /dev/null
+++ b/docs/clamp/acm/images/system-dialogues/DeleteResponseStored.png
Binary files differ