This is an automated email from the ASF dual-hosted git repository.
markt pushed a commit to branch 10.1.x
in repository https://gitbox.apache.org/repos/asf/tomcat.git
commit 1ede487a54faaebb45a222b6d0d1b22bbf42192c
Author: Mark Thomas <ma...@apache.org>
AuthorDate: Tue Sep 10 13:55:03 2024 +0100
Add diagram 6 - deployment of applications by HostConfig
---
webapps/docs/architecture/startup.xml | 5 +-
.../startup/6_catalina_host_config.plantuml | 90 +++++++++++++++++++++
.../startup/6_catalina_host_config.png | Bin 0 -> 65519 bytes
3 files changed, 93 insertions(+), 2 deletions(-)
diff --git a/webapps/docs/architecture/startup.xml
b/webapps/docs/architecture/startup.xml
index 28fec45bf2..c96eab6632 100644
--- a/webapps/docs/architecture/startup.xml
+++ b/webapps/docs/architecture/startup.xml
@@ -96,8 +96,9 @@ Clusters, Realms and Valves.
for Context elements as it is rather more involved that the other Containers.
</p>
<p>
-Diagram 6 will show HostConfig.
-</p>
+<a href="startup/6_catalina_host_config.png">Diagram 5</a> shows how the
+HostConfig component responds to lifecycle events triggered by the Host to
+deploy web applications to the Host.</p>
<p>
Diagram 7 will show ContextConfig.
</p>
diff --git a/webapps/docs/architecture/startup/6_catalina_host_config.plantuml
b/webapps/docs/architecture/startup/6_catalina_host_config.plantuml
new file mode 100644
index 0000000000..7cd77e9b2c
--- /dev/null
+++ b/webapps/docs/architecture/startup/6_catalina_host_config.plantuml
@@ -0,0 +1,90 @@
+@startuml
+
+' Licensed to the Apache Software Foundation (ASF) under one or more
+' contributor license agreements. See the NOTICE file distributed with
+' this work for additional information regarding copyright ownership.
+' The ASF licenses this file to You under the Apache License, Version 2.0
+' (the "License"); you may not use this file except in compliance with
+' the License. You may obtain a copy of the License at
+'
+' http://www.apache.org/licenses/LICENSE-2.0
+'
+' Unless required by applicable law or agreed to in writing, software
+' distributed under the License is distributed on an "AS IS" BASIS,
+' WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+' See the License for the specific language governing permissions and
+' limitations under the License.
+
+hide footbox
+skinparam style strictuml
+
+activate Host
+
+== BEFORE_START_EVENT ==
+
+Host -> HostConfig ++:lifecycleEvent(BEFORE_START_EVENT)
+
+HostConfig -> HostConfig ++: beforeStart()
+return
+
+return
+
+== START_EVENT ==
+
+Host -> HostConfig ++:lifecycleEvent(START_EVENT)
+
+HostConfig -> HostConfig ++: start()
+
+HostConfig -> HostConfig ++: deployApps()
+
+|||
+HostConfig -> HostConfig ++: migrateLegacyApps()
+return
+
+|||
+HostConfig -> HostConfig ++: deployDescriptors()
+return
+
+|||
+HostConfig -> HostConfig ++: deployWARs()
+return
+
+|||
+HostConfig -> HostConfig ++: deployDirectories()
+return
+
+return
+
+return
+
+return
+
+== PERIODIC_EVENT ==
+
+Host -> HostConfig ++:lifecycleEvent(PERIODIC_EVENT)
+
+HostConfig -> HostConfig ++: check()
+
+group Each DeployedApplication is called sequentially
+HostConfig -> DeployedApplication ++: checkResources()
+note right
+Triggers reloading, redeployment
+or undeployment as appropriate
+depending on which resources have
+been added, removed and/or changed.
+end note
+return
+end group
+
+HostConfig -> HostConfig ++: deployApps()
+note right
+See START_EVENT for an expansion
+of the deployApps() call.
+end note
+return
+
+return
+
+return
+
+@enduml
\ No newline at end of file
diff --git a/webapps/docs/architecture/startup/6_catalina_host_config.png
b/webapps/docs/architecture/startup/6_catalina_host_config.png
new file mode 100644
index 0000000000..5f75867dc1
Binary files /dev/null and
b/webapps/docs/architecture/startup/6_catalina_host_config.png differ
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org
