From 87ffab8a9b0c1b1b8e2e67b7ad192c61ddd235ce Mon Sep 17 00:00:00 2001 From: FrancescoFioraEst Date: Fri, 23 Feb 2024 09:10:39 +0000 Subject: Update documentation for composition and instance states Issue-ID: POLICY-4935 Change-Id: I737fdead03bb5d485d665bee598ee8626824d7e5 Signed-off-by: FrancescoFioraEst --- docs/clamp/acm/acm-states.rst | 32 ++++++++++++++++++++- .../AcElementInstanceStatesOnRuntime.png | Bin 46714 -> 73526 bytes .../acm/images/acm-states/AcInstanceStates.png | Bin 46778 -> 65369 bytes .../images/acm-states/AcInstanceStatesDelete.png | Bin 0 -> 25370 bytes .../images/acm-states/AcInstanceStatesDeploy.png | Bin 0 -> 82858 bytes .../images/acm-states/AcInstanceStatesMigrate.png | Bin 0 -> 29048 bytes .../images/acm-states/AcInstanceStatesUpdate.png | Bin 0 -> 32107 bytes .../acm/images/acm-states/AcTypeStatesFail.png | Bin 0 -> 69275 bytes .../states/AcElementInstanceStatesOnRuntime.puml | 12 +++++--- .../acm/plantuml/states/AcInstanceStates.puml | 13 +++++---- .../plantuml/states/AcInstanceStatesDelete.puml | 12 ++++++++ .../plantuml/states/AcInstanceStatesDeploy.puml | 25 ++++++++++++++++ .../plantuml/states/AcInstanceStatesMigrate.puml | 12 ++++++++ .../plantuml/states/AcInstanceStatesUpdate.puml | 14 +++++++++ .../acm/plantuml/states/AcTypeStatesFail.puml | 29 +++++++++++++++++++ 15 files changed, 139 insertions(+), 10 deletions(-) create mode 100644 docs/clamp/acm/images/acm-states/AcInstanceStatesDelete.png create mode 100644 docs/clamp/acm/images/acm-states/AcInstanceStatesDeploy.png create mode 100644 docs/clamp/acm/images/acm-states/AcInstanceStatesMigrate.png create mode 100644 docs/clamp/acm/images/acm-states/AcInstanceStatesUpdate.png create mode 100644 docs/clamp/acm/images/acm-states/AcTypeStatesFail.png create mode 100644 docs/clamp/acm/plantuml/states/AcInstanceStatesDelete.puml create mode 100644 docs/clamp/acm/plantuml/states/AcInstanceStatesDeploy.puml create mode 100644 docs/clamp/acm/plantuml/states/AcInstanceStatesMigrate.puml create mode 100644 docs/clamp/acm/plantuml/states/AcInstanceStatesUpdate.puml create mode 100644 docs/clamp/acm/plantuml/states/AcTypeStatesFail.puml (limited to 'docs') diff --git a/docs/clamp/acm/acm-states.rst b/docs/clamp/acm/acm-states.rst index f6a10e66..215baf71 100644 --- a/docs/clamp/acm/acm-states.rst +++ b/docs/clamp/acm/acm-states.rst @@ -19,7 +19,7 @@ Participant states are NOT managed by ACM but the state of a participant is reco Automation Composition Type State ================================= -The states that an Automation Composition Type can have are shown in the diagram below. +The states that an Automation Composition Type can have, are shown in the diagram below. .. image:: images/acm-states/AcTypeStates.png @@ -33,6 +33,11 @@ The states that an Automation Composition Element Type can have on a Participant .. image:: images/acm-states/AcElementTypeStatesOnPpnt.png +The states diagram below, shows the fail and timeout scenario. +In that diagram the state is presented using this combination [ Composition Element Type State : Composition Type State : StateChangeResult ]. + +.. image:: images/acm-states/AcTypeStatesFail.png + Automation Composition Instance State ===================================== The states that an Automation Composition Instance can have are shown in the diagram below. @@ -49,4 +54,29 @@ The states that an Automation Composition Element Instance can have on a Partici .. image:: images/acm-states/AcElementInstanceStatesOnPpnt.png +Automation Composition State with fail and timeout +================================================== +The states that an Automation Composition Element Instance can have for each flow, are shown in the diagrams below. +For each diagram the state is presented using this combination [ Instance Element State : Instance State : StateChangeResult ]. + +Deploy +------ + +.. image:: images/acm-states/AcInstanceStatesDeploy.png + +Update +------ + +.. image:: images/acm-states/AcInstanceStatesUpdate.png + +Migrate +------- + +.. image:: images/acm-states/AcInstanceStatesMigrate.png + +Delete +------ + +.. image:: images/acm-states/AcInstanceStatesDelete.png + End of Document diff --git a/docs/clamp/acm/images/acm-states/AcElementInstanceStatesOnRuntime.png b/docs/clamp/acm/images/acm-states/AcElementInstanceStatesOnRuntime.png index ca9b2c1e..8d1ace14 100644 Binary files a/docs/clamp/acm/images/acm-states/AcElementInstanceStatesOnRuntime.png and b/docs/clamp/acm/images/acm-states/AcElementInstanceStatesOnRuntime.png differ diff --git a/docs/clamp/acm/images/acm-states/AcInstanceStates.png b/docs/clamp/acm/images/acm-states/AcInstanceStates.png index 72dff824..ef17ba7a 100644 Binary files a/docs/clamp/acm/images/acm-states/AcInstanceStates.png and b/docs/clamp/acm/images/acm-states/AcInstanceStates.png differ diff --git a/docs/clamp/acm/images/acm-states/AcInstanceStatesDelete.png b/docs/clamp/acm/images/acm-states/AcInstanceStatesDelete.png new file mode 100644 index 00000000..29c96b53 Binary files /dev/null and b/docs/clamp/acm/images/acm-states/AcInstanceStatesDelete.png differ diff --git a/docs/clamp/acm/images/acm-states/AcInstanceStatesDeploy.png b/docs/clamp/acm/images/acm-states/AcInstanceStatesDeploy.png new file mode 100644 index 00000000..412dcc3b Binary files /dev/null and b/docs/clamp/acm/images/acm-states/AcInstanceStatesDeploy.png differ diff --git a/docs/clamp/acm/images/acm-states/AcInstanceStatesMigrate.png b/docs/clamp/acm/images/acm-states/AcInstanceStatesMigrate.png new file mode 100644 index 00000000..205c2e95 Binary files /dev/null and b/docs/clamp/acm/images/acm-states/AcInstanceStatesMigrate.png differ diff --git a/docs/clamp/acm/images/acm-states/AcInstanceStatesUpdate.png b/docs/clamp/acm/images/acm-states/AcInstanceStatesUpdate.png new file mode 100644 index 00000000..e5f85024 Binary files /dev/null and b/docs/clamp/acm/images/acm-states/AcInstanceStatesUpdate.png differ diff --git a/docs/clamp/acm/images/acm-states/AcTypeStatesFail.png b/docs/clamp/acm/images/acm-states/AcTypeStatesFail.png new file mode 100644 index 00000000..6a9bc59a Binary files /dev/null and b/docs/clamp/acm/images/acm-states/AcTypeStatesFail.png differ diff --git a/docs/clamp/acm/plantuml/states/AcElementInstanceStatesOnRuntime.puml b/docs/clamp/acm/plantuml/states/AcElementInstanceStatesOnRuntime.puml index c27b320c..13faeacf 100644 --- a/docs/clamp/acm/plantuml/states/AcElementInstanceStatesOnRuntime.puml +++ b/docs/clamp/acm/plantuml/states/AcElementInstanceStatesOnRuntime.puml @@ -3,20 +3,24 @@ [*] --> UNDEPLOYED: Create UNDEPLOYED --> [*]: Delete UNDEPLOYED --> DEPLOYING: Deploy -DEPLOYING --> DEPLOYED: AC Element\nInstance DEPLOYED +DEPLOYING --> DEPLOYED: AC Instance\nElement DEPLOYED DEPLOYING --> UNDEPLOYING: Undeploy DEPLOYED --> UNDEPLOYING: Undeploy -UNDEPLOYING --> UNDEPLOYED: AC Element\nInstance UNDEPLOYED +DEPLOYED --> UPDATING: Update +DEPLOYED --> MIGRATING: Migrate +MIGRATING --> DEPLOYED: AC Instance\nElement MIGRATED +UNDEPLOYING --> UNDEPLOYED: AC Instance\nElement UNDEPLOYED +UNDEPLOYING --> UNDEPLOYED: AC Instance\nElement UNDEPLOYED state DEPLOYED { [*] --> LOCKED: Deploy LOCKED --> [*]: Undeploy LOCKED --> UNLOCKING: Unlock - UNLOCKING --> UNLOCKED: AC Element\nInstance UNLOCKED + UNLOCKING --> UNLOCKED: AC Instance\nElement UNLOCKED UNLOCKED --> LOCKING: Lock UNLOCKING --> LOCKING: Lock - LOCKING --> LOCKED: AC Element\nInstance LOCKED + LOCKING --> LOCKED: AC Instance\nElement LOCKED } @enduml diff --git a/docs/clamp/acm/plantuml/states/AcInstanceStates.puml b/docs/clamp/acm/plantuml/states/AcInstanceStates.puml index 17958411..f8483ffe 100644 --- a/docs/clamp/acm/plantuml/states/AcInstanceStates.puml +++ b/docs/clamp/acm/plantuml/states/AcInstanceStates.puml @@ -3,20 +3,23 @@ [*] --> UNDEPLOYED: Create UNDEPLOYED --> [*]: Delete UNDEPLOYED --> DEPLOYING: Deploy -DEPLOYING --> DEPLOYED: AC Element Instances\nall DEPLOYED +DEPLOYING --> DEPLOYED: AC Instance Elements\nall DEPLOYED DEPLOYING --> UNDEPLOYING: Undeploy DEPLOYED --> UNDEPLOYING: Undeploy -UNDEPLOYING --> UNDEPLOYED: AC Element Types\nall UNDEPLOYED - +DEPLOYED --> UPDATING: Update +DEPLOYED --> MIGRATING: Migrate +UPDATING --> DEPLOYED: AC Instance Elements\nall UPDATED +MIGRATING --> DEPLOYED: AC Instance Elements\nall MIGRATED +UNDEPLOYING --> UNDEPLOYED: AC Instance Elements\nall UNDEPLOYED state DEPLOYED { [*] --> LOCKED: Deploy LOCKED --> [*]: Undeploy LOCKED --> UNLOCKING: Unlock - UNLOCKING --> UNLOCKED: AC Element Types\nall UNLOCKED + UNLOCKING --> UNLOCKED: AC Instance Elements\nall UNLOCKED UNLOCKED --> LOCKING: Lock UNLOCKING --> LOCKING: Lock - LOCKING --> LOCKED: AC Element Types\nall LOCKED + LOCKING --> LOCKED: AC Instance Elements\nall LOCKED } @enduml diff --git a/docs/clamp/acm/plantuml/states/AcInstanceStatesDelete.puml b/docs/clamp/acm/plantuml/states/AcInstanceStatesDelete.puml new file mode 100644 index 00000000..c6dae42d --- /dev/null +++ b/docs/clamp/acm/plantuml/states/AcInstanceStatesDelete.puml @@ -0,0 +1,12 @@ +@startuml + +UNDEPLOYED:UNDEPLOYED:NO_ERROR --> DELETING:DELETING: Delete +DELETING:DELETING --> UNDEPLOYED:DELETING:FAILED: Delete failed +DELETING:DELETING --> DELETING:DELETING:TIMEOUT +DELETING:DELETING --> [*]: Deleted +UNDEPLOYED:DELETING:FAILED --> DELETING:DELETING: Delete +DELETING:DELETING:TIMEOUT --> UNDEPLOYED:DELETING:FAILED: Delete failed +DELETING:DELETING:TIMEOUT --> DELETING:DELETING: Delete +DELETING:DELETING:TIMEOUT --> [*]: Deleted + +@enduml diff --git a/docs/clamp/acm/plantuml/states/AcInstanceStatesDeploy.puml b/docs/clamp/acm/plantuml/states/AcInstanceStatesDeploy.puml new file mode 100644 index 00000000..1d0f0920 --- /dev/null +++ b/docs/clamp/acm/plantuml/states/AcInstanceStatesDeploy.puml @@ -0,0 +1,25 @@ +@startuml + +[*] --> UNDEPLOYED:UNDEPLOYED:NO_ERROR: Create +UNDEPLOYED:UNDEPLOYED:NO_ERROR --> [*]: Delete +UNDEPLOYED:UNDEPLOYED:NO_ERROR --> DEPLOYING:DEPLOYING: Deploy +DEPLOYING:DEPLOYING --> DEPLOYED:DEPLOYED:NO_ERROR: Deployed +DEPLOYING:DEPLOYING --> UNDEPLOYED:DEPLOYING:FAILED: Deploy failed +DEPLOYING:DEPLOYING --> DEPLOYING:DEPLOYING:TIMEOUT: Deploy timeout +DEPLOYING:DEPLOYING:TIMEOUT --> DEPLOYED:DEPLOYED:NO_ERROR: Deployed +DEPLOYING:DEPLOYING:TIMEOUT --> UNDEPLOYED:DEPLOYING:FAILED: Deploy failed +DEPLOYING:DEPLOYING:TIMEOUT --> DEPLOYING:DEPLOYING: Deploy +UNDEPLOYED:DEPLOYING:FAILED --> DEPLOYING:DEPLOYING: Deploy +UNDEPLOYED:DEPLOYING:FAILED --> UNDEPLOYING:UNDEPLOYING: Undeploy +DEPLOYED:DEPLOYED:NO_ERROR --> UNDEPLOYING:UNDEPLOYING: Undeploy +UNDEPLOYING:UNDEPLOYING --> UNDEPLOYED:UNDEPLOYED:NO_ERROR: Undeployed +UNDEPLOYING:UNDEPLOYING --> DEPLOYED:UNDEPLOYING:FAILED: Undeploy failed +UNDEPLOYING:UNDEPLOYING --> UNDEPLOYING:UNDEPLOYING:TIMEOUT: Undeploy timeout +DEPLOYED:UNDEPLOYING:FAILED --> UNDEPLOYING:UNDEPLOYING: Undeploy +DEPLOYED:UNDEPLOYING:FAILED --> DEPLOYING:DEPLOYING: Deploy +UNDEPLOYING:UNDEPLOYING:TIMEOUT --> UNDEPLOYED:UNDEPLOYED:NO_ERROR: Undeployed +UNDEPLOYING:UNDEPLOYING:TIMEOUT --> DEPLOYED:UNDEPLOYING:FAILED: Undeploy failed +UNDEPLOYING:UNDEPLOYING:TIMEOUT --> UNDEPLOYING:UNDEPLOYING: Undeploy +UNDEPLOYING:UNDEPLOYING:TIMEOUT --> DEPLOYING:DEPLOYING: Deploy + +@enduml diff --git a/docs/clamp/acm/plantuml/states/AcInstanceStatesMigrate.puml b/docs/clamp/acm/plantuml/states/AcInstanceStatesMigrate.puml new file mode 100644 index 00000000..b3875e81 --- /dev/null +++ b/docs/clamp/acm/plantuml/states/AcInstanceStatesMigrate.puml @@ -0,0 +1,12 @@ +@startuml + +DEPLOYED:DEPLOYED:NO_ERROR --> MIGRATING:MIGRATING: Migrate +MIGRATING:MIGRATING --> DEPLOYED:DEPLOYED:NO_ERROR: Migrated +MIGRATING:MIGRATING --> DEPLOYED:MIGRATING:FAILED: Migrate failed +MIGRATING:MIGRATING --> MIGRATING:MIGRATING:TIMEOUT: Migrate timeout +DEPLOYED:MIGRATING:FAILED --> UNDEPLOYING:UNDEPLOYING: Undeploy +MIGRATING:MIGRATING:TIMEOUT --> DEPLOYED:MIGRATING:FAILED: Migrate failed +MIGRATING:MIGRATING:TIMEOUT --> UNDEPLOYING:UNDEPLOYING: Undeploy +MIGRATING:MIGRATING:TIMEOUT --> DEPLOYED:DEPLOYED:NO_ERROR: Migrated + +@enduml diff --git a/docs/clamp/acm/plantuml/states/AcInstanceStatesUpdate.puml b/docs/clamp/acm/plantuml/states/AcInstanceStatesUpdate.puml new file mode 100644 index 00000000..f5531b4c --- /dev/null +++ b/docs/clamp/acm/plantuml/states/AcInstanceStatesUpdate.puml @@ -0,0 +1,14 @@ +@startuml + +DEPLOYED:DEPLOYED:NO_ERROR --> UPDATING:UPDATING: Update +UPDATING:UPDATING --> DEPLOYED:DEPLOYED:NO_ERROR: Updated +UPDATING:UPDATING --> DEPLOYED:UPDATING:FAILED: Update failed +UPDATING:UPDATING --> UPDATING:UPDATING:TIMEOUT: Update timeout +DEPLOYED:UPDATING:FAILED --> UPDATING:UPDATING: Update +DEPLOYED:UPDATING:FAILED --> UNDEPLOYING:UNDEPLOYING: Undeploy +UPDATING:UPDATING:TIMEOUT --> UPDATING:UPDATING: Update +UPDATING:UPDATING:TIMEOUT --> DEPLOYED:UPDATING:FAILED: Update failed +UPDATING:UPDATING:TIMEOUT --> UNDEPLOYING:UNDEPLOYING: Undeploy +UPDATING:UPDATING:TIMEOUT --> DEPLOYED:DEPLOYED:NO_ERROR: Updated + +@enduml diff --git a/docs/clamp/acm/plantuml/states/AcTypeStatesFail.puml b/docs/clamp/acm/plantuml/states/AcTypeStatesFail.puml new file mode 100644 index 00000000..d9ff69bf --- /dev/null +++ b/docs/clamp/acm/plantuml/states/AcTypeStatesFail.puml @@ -0,0 +1,29 @@ +@startuml + +COMMISSIONED:COMMISSIONED:NO_ERROR --> PRIMING:PRIMING: Prime + +PRIMING:PRIMING --> PRIMED:PRIMED:NO_ERROR: AC Element Types\nall PRIMED +PRIMING:PRIMING --> COMMISSIONED:PRIMING:FAIL: Prime Failed +PRIMING:PRIMING --> PRIMING:PRIMING:TIMEOUT: Prime Timeout + +COMMISSIONED:PRIMING:FAIL --> DEPRIMING:DEPRIMING: Deprime +COMMISSIONED:PRIMING:FAIL --> PRIMING:PRIMING: Prime Again + +PRIMING:PRIMING:TIMEOUT --> DEPRIMING:DEPRIMING: Deprime +PRIMING:PRIMING:TIMEOUT --> PRIMING:PRIMING: Prime Again +PRIMING:PRIMING:TIMEOUT --> PRIMED:PRIMED:NO_ERROR: AC Element Types\nall PRIMED + +DEPRIMING:DEPRIMING --> COMMISSIONED:COMMISSIONED:NO_ERROR: AC Element Types\nall DEPRIMED +DEPRIMING:DEPRIMING --> PRIMED:DEPRIMING:FAIL: Deprime Failed +DEPRIMING:DEPRIMING --> DEPRIMING:DEPRIMING:TIMEOUT: Deprime Timeout + +PRIMED:DEPRIMING:FAIL --> DEPRIMING:DEPRIMING: Deprime Again +PRIMED:DEPRIMING:FAIL --> PRIMING:PRIMING: Prime + +DEPRIMING:DEPRIMING:TIMEOUT --> DEPRIMING:DEPRIMING: Deprime Again +DEPRIMING:DEPRIMING:TIMEOUT --> PRIMING:PRIMING: Prime +DEPRIMING:DEPRIMING:TIMEOUT --> COMMISSIONED:COMMISSIONED:NO_ERROR: AC Element Types\nall DEPRIMED + +PRIMED:PRIMED:NO_ERROR --> DEPRIMING:DEPRIMING: Deprime + +@enduml -- cgit 1.2.3-korg