Initial architecture documentation

docs/modules/ROOT/assets/diagrams/README.adoc

@@ -0,0 +1,4 @@
+Diagrams
+========
+
+Files generated by https://app.diagrams.net

docs/modules/ROOT/assets/diagrams/camel-k-operator-control-loop.drawio

@@ -0,0 +1 @@
+<mxfile host="app.diagrams.net" modified="2020-07-12T14:12:27.384Z" agent="5.0 (X11)" etag="2d2Qz5dBpfifzbfyRSyL" version="13.4.2" type="device"><diagram id="uLhqvVcLPNciDg8s2euJ" name="Page-1">5VnblpowFP0aH+0CIoiPXjtd09uqD50+ZiADaQNxYhixX98Ewk3QwRlHdKprabKTkGSffQ4n0APTIP7I4Mr/Ql1Eeobmxj0w6xnGyNTFrwS2KWACIwU8ht0U0gtgif8iBWoKjbCL1pWOnFLC8aoKOjQMkcMrGGSMbqrdHiipzrqCHqoBSweSOvoTu9xPUdvUCvwGYc/PZtY11RLArLMC1j506aYEgXkPTBmlPC0F8RQRyV3GSzpusac1XxhDIW8zwKN0YC8W4eaxzyYj3B+Hy7ivj9LLPEESqR2r1fJtRgGjUegieRWtByYbH3O0XEFHtm6EzQXm84CImi6KD5iQKSWUJWPBIvkKfM0Z/YNKLYOZ/IoWtQDEOIr3bk3PCRNCQzRAnG1FFzUAZGpRIgNDVd8UJjMyw/glcxkDBUIlEy+/dsGkKCgyjyB28C541XZ4tTrn1XgPvNpVWnO2nqM15/81tA6Dp2j8ZfvVjCz7/mZ6qzmbuzZyRa4IjKpKGfepR0NI5gU6qRJf9PlM6UrR/RtxvlVRHkacVo3xHOk1hsUCacQcdGBn2U0DMg/xA/3UhuUuD5qQIQI5fqreHk5uD71mj2/3a8TEtPvVrh+t9tFias7tQ/TWZL5X07qxI2q7Luq8T1nUpwgVjRya71bTRktNg4vSdD10z2UZ8usRNWiI1G8m6uaErQsNoxjzOzVcln/J8gdT1WZxqWm2zSqh2O5duVIaJavFsKSWjXPh2s8tLyvfIeeIhQliaG1cakfvL/Mx0NLHzuVSzWqwu5SDfoQcLtisjcyaXUZKUIuUP5A44DqYXE+oHGhdh8o6iz3DIlzSQMU2yyxajxHNGvrrRPdjqcrBKi4ak6cMGXcFCKzkU4YsT/5/CjnymJALDbOJxT7SudMeNWMKrvmh9CGkIdoxo4IgwZ50JkdYEAl8Ii2HHUjGqiHArpu4f5NEqiFhj+mPOeEMd5JBs0EMjQfHN7tvaleRDR4b4/bHrhYxzury1lXPzs9wwnnd05DBpUU4/TqO7ScRtdVS1DroUtVWzSDnOOOcVtYND/nOLOthFyp+SVabH3L04w45+z2mRZ58QqfSLy0dPrjKc+fDJ3Ur0+jarZpe9VxaPqztLKlxAuUstQluMf/vEu3aK5qGV1+nyrRFtXhdmbSV3vmC+T8=</diagram></mxfile>

docs/modules/ROOT/assets/diagrams/camel-k-state-machine-basic.drawio

@@ -0,0 +1 @@
+<mxfile host="app.diagrams.net" modified="2020-07-12T09:59:15.990Z" agent="5.0 (X11)" etag="oQLwBsUhoG38y9AXE9Zh" version="13.4.2" type="device"><diagram id="48Lw8YTL3a5nQOH6-A0w" name="Page-1">7VjbctsgEP0aPzajq2M9JnbSZKadpvV02j4SaS3RYKFByJd8fRcZWUg4sevGM562cR7gsCxwzoIWBv54vnovSJF95Amwgeckq4E/GXieG3jeQP07yXqDjNxwA6SCJtqoBab0GTToaLSiCZQdQ8k5k7TogjHPc4hlByNC8GXXbMZZd9SCpGAB05gwG/1GE5npVYROi98BTbNmZNfRLXPSGGugzEjClwbk3wz8seBcbkrz1RiYIq/hZdPv9oXW7cQE5PKQDpO75x/xPf30/PVnSL7zWRx9/fzO33hZEFbpBV893CMwBbEAoScu1w0buIZCFas5+0BnwGiOtesCBJ2DRHt/wjT80GLXy4xKmBYkVl2XGCeIZXLOsOZiEaWTBLuIbZ0xUpT0sR7VQURAXImSLuALlJsIUSivpBppvFVegTPK2JgzLuoJ+7f1D3G9ThASVi8S6G5lwXgGjvMXazTRHbxAK6lD2WukXhqBoaHMiAm/sSM6FtOt61YuLGjFfkO90FIPyZAC+fsbtItux+HN6G20C5xz08717K0XS8rz/8KZwoXDcxOuOc8N4SzJDKILTnNZzyG8HoSTnnJcyIynPCfM1O4g3l6JqhfZ9LtkuoFNpreDzNHJNsHoPLjcc3j0aPMuD6PNjU7GW2TxlnNJZ+vX2FMcUMxsrhhNc8QeuZR8jg2lJEJeqWRJsYg+EYM8aZBHxuOnxkxnaO3uhsRKoPbyKoARiSdLN1vbQZLu+qB0Nz7El9FF2FVk5HWdlLwSMeh+ZlLUc2VJ23eEa05BWo5q1bYr+oPDxN2xAYYM6btO6AKLqSrSfMGfoGnAgYy2f0LxIOzK5A+d4/QOI8tRE0p7FG9dNYZ8NivhNFFh5wZVkRAJR4ltCMsLyFVokTKDRPfD5nOQuK9M0P+AH7ylwz2OTr2lA0s8TKV4HlP2N+vXP0mD4Ej97NPdcnVqBYeWgozzp6poTuBH0Zy+ZHfKrvif6mqblty0qJmKEy04g5lyWWLOTvP0Q12beLtPZsGrPKlDQOXfsKLyuypfRKGu/qirbhTo+mRl2E7WRsVIlmrs+AjSAjoXTjDsCNg85rz1V8BxL6LRQVGG/JG1YaYzyYOH8qLo9UNn9Gf2vmajjeTNjA8kos/lOXzDLq1NRJi0dopxub0VZA77b64vvfCUUmCSZF5D6783evvpXUP9kX0F2CYlnTvAEfdQrLbPghs92sdV/+YX</diagram></mxfile>

docs/modules/ROOT/assets/diagrams/camel-k-state-machine-build.drawio

@@ -0,0 +1 @@
+<mxfile host="app.diagrams.net" modified="2020-07-13T12:35:22.888Z" agent="5.0 (X11)" etag="e5B2q61YGPAHzRJHm3Ih" version="13.4.2" type="device"><diagram id="0Kwz7zGRW0z1vaULMuBK" name="Page-1">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</diagram></mxfile>

docs/modules/ROOT/assets/diagrams/camel-k-state-machine-integration-platform.drawio

@@ -0,0 +1 @@
+<mxfile host="app.diagrams.net" modified="2020-07-12T13:44:26.155Z" agent="5.0 (X11)" etag="ggmsOCSB_B5J9U7Vbbn1" version="13.4.2"><diagram id="0Kwz7zGRW0z1vaULMuBK" name="Page-1">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</diagram></mxfile>

docs/modules/ROOT/assets/diagrams/camel-k-state-machine-integration.drawio

@@ -0,0 +1 @@
+<mxfile host="Electron" modified="2020-07-13T17:42:54.243Z" agent="5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/13.0.3 Chrome/80.0.3987.163 Electron/8.2.1 Safari/537.36" etag="nTuvFFSGTvKeo2VpzZrU" version="13.0.3" type="device"><diagram id="0Kwz7zGRW0z1vaULMuBK" name="Page-1">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</diagram></mxfile>

docs/modules/ROOT/assets/diagrams/camel-k-state-machine-integrationkit.drawio

@@ -0,0 +1 @@
+<mxfile host="app.diagrams.net" modified="2020-07-13T10:22:48.207Z" agent="5.0 (X11)" etag="RJWJeBRCgmQmYLY5A1VI" version="13.4.2" type="device"><diagram id="0Kwz7zGRW0z1vaULMuBK" name="Page-1">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</diagram></mxfile>

docs/modules/ROOT/assets/diagrams/operator-control-loop.drawio

@@ -0,0 +1 @@
+<mxfile host="app.diagrams.net" modified="2020-07-12T14:03:52.590Z" agent="5.0 (X11)" etag="SvOojC_3nr3ceSXHBW-h" version="13.4.2" type="device"><diagram id="uLhqvVcLPNciDg8s2euJ" name="Page-1">3VZNc9MwEP01OcL4Iy7JsbgOnYECQ5ihPar21hbI3oy8jm1+PZIt+QNPM3CABHKJ3ttdr/T0LGvlh3nzRrJDdocJiJXnJM3Kv1l5nrt1PPWnmdYwzpXfM6nkieFGYs+/g000bMUTKGeJhCiIH+ZkjEUBMc04JiXW87QnFPOuB5bCgtjHTCzZLzyhrGc3gTPyt8DTzHZ2HRPJmU02RJmxBOsJ5UcrP5SI1I/yJgSh1bO69HW7Z6LDxCQU9CsFr/JjdX3Xvg+qq83jbfjWiev7F+v+KUcmKrNgM1lqrQKQKEEMREkZplgwEY3sa4lVkYBu4yg05rxDPCjSVeRXIGrN7rKKUFEZ5cJE+5660bNrM1SJlYzhxIKsR5hMgU7kecMOKO8C5kCyVXUSBCN+nM+DGQ+lQ94osxoYpX9D9e05RIaG070ufxkY9DCJ3DTmyR1oLSjUcidFGg5VGoxlHRrrkmv98ilYYAE9s+NapS5eqv0hmxELVpY8/pzxwoZMqm6TsDLrlm3BR0YEsugYz3G7EonfIESBslPT73/nMZZ/TmO5i9f5w2MJUrX92XCjnbSCdcYJ9gfWKVCro3xunSe1HRN5t7swiDaDvEeQBM1pgZeC2AJ7PJoPhLcxuB5P2yEnm5y0a+cPaRj8b0ei9y8411uoHukxo8u17mDVi7GuvxDxE6iLUczF5aq4Xv89FRUc71tdbHJt9aMf</diagram></mxfile>

docs/modules/ROOT/nav.adoc

@@ -18,6 +18,15 @@
 ** xref:configuration/logging.adoc[Logging]
 ** xref:configuration/dependencies.adoc[Dependencies]
 ** xref:configuration/configmap-secret.adoc[ConfigMap/Secret]
+* xref:architecture/architecture.adoc[Architecture]
+** xref:architecture/operator.adoc[Operator]
+*** xref:architecture/cr/integration-platform.adoc[IntegrationPlatform]
+*** xref:architecture/cr/integration.adoc[Integration]
+*** xref:architecture/cr/integration-kit.adoc[IntegrationKit]
+*** xref:architecture/cr/build.adoc[Build]
+*** xref:architecture/cr/camel-catalog.adoc[CamelCatalog]
+** xref:architecture/runtime.adoc[Runtime]
+** xref:architecture/traits.adoc[Traits]
 * Observability
 ** xref:observability/monitoring.adoc[Monitoring]
 * xref:traits:traits.adoc[Traits]

docs/modules/ROOT/pages/architecture/architecture.adoc

@@ -0,0 +1,11 @@
+[[architecture]]
+= Architecture
+
+
+image::architecture/camel-k.jpg[Overview]
+
+The *Camel K* platform is based on three concepts:
+
+1. The xref:architecture/operator.adoc[Operator] which is the intelligence that coordinates all the moving parts.
+2. The xref:architecture/runtime.adoc[Runtime] which provides the functionnality to run the integration.
+3. The xref:architecture/traits.adoc[Traits] through wich the behavior of the operator and the runtime can be customized.

docs/modules/ROOT/pages/architecture/cr/build.adoc

@@ -0,0 +1,27 @@
+[[build]]
+= Build
+
+A *Build* resources, describes the process of assembling a container image that copes with the requirement of an xref:architecture/cr/integration.adoc[Integration] or xref:architecture/cr/integration-kit.adoc[IntegrationKit].
+
+[source,go]
+----
+type Build struct {
+	Spec   BuildSpec    // <1>
+	Status BuildStatus  // <2>
+}
+
+type BuildSpec struct {
+	Tasks []Task        // <3>
+}
+----
+<1> The desired state
+<2> The status of the object at current time
+<3> The build tasks
+
+[NOTE]
+====
+the full go definition can be found https://github.com/apache/camel-k/blob/master/pkg/apis/camel/v1/build_types.go[here]
+====
+
+image::architecture/camel-k-state-machine-build.png[life cycle]
+

docs/modules/ROOT/pages/architecture/cr/camel-catalog.adoc

@@ -0,0 +1,9 @@
+[[camel-catalog]]
+= CamelCatalog
+
+The*CamelCatalog* is a static side resources that provides metadata related to the what it is included in the xref:architecture/runtime.adoc[Runtime] in term of Camel components, languages, dataformats and what capabilities are prvided.
+
+[NOTE]
+====
+the full go definition can be found https://github.com/apache/camel-k/blob/master/pkg/apis/camel/v1/camelcatalog_types.go[here]
+====

docs/modules/ROOT/pages/architecture/cr/integration-kit.adoc

@@ -0,0 +1,34 @@
+[[integration-kit]]
+= IntegrationKit
+
+The *IntegrationKit* is a fundamental side resource which describe a container image created by the camel-k operator as well as the configurations that need to be applied to every integration that is executed on top of it. An *IntegrationKit* does not include any source code or resource file defined by the **Integration** from wcich it has been generated.
+
+[source,go]
+----
+type IntegrationKit struct {
+	Spec   IntegrationKitSpec   // <1>
+	Status IntegrationKitStatus // <2>
+}
+
+type IntegrationKitSpec struct {
+	Image         string                 // <3>
+	Dependencies  []string               // <4>
+	Repositories  []string               // <4>    
+	Profile       TraitProfile           // <5>
+	Traits        map[string]TraitSpec   // <5>
+	Configuration []ConfigurationSpec    // <6>
+}
+----
+<1> The desired state
+<2> The status of the object at current time
+<3> The container image
+<4> The dependencies required by the kit and related repositories (if needed)
+<5> The traits configuration
+<6> The integration configuration (properties, secrets, configmaps)
+
+[NOTE]
+====
+the full go definition can be found https://github.com/apache/camel-k/blob/master/pkg/apis/camel/v1/integrationkit_types.go[here]
+====
+
+image::architecture/camel-k-state-machine-integrationkit.png[life cycle]