Kubernetes architecture
This page details the deployment architecture of Cinchy v5 when running on Kubernetes.
Infrastructure configuration (on cluster)
The diagram below shows a high level overview of a possible Infrastructure diagram with components on the cluster, but your specific configuration may vary (Image 1).
Tip: Click on an image to enlarge it.
![](https://platform.docs.cinchy.com/~gitbook/image?url=https%3A%2F%2F3728216363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FuXTzhcF5GwEVWPr9Y2dX%252Fuploads%252FyHpWjoSGxKRYQAu4whVK%252FTechnical%2520Deep%2520Dive%2520-%2520Tech%2520Stack%2520%281%29.png%3Falt%3Dmedia%26token%3Dd8a4afa9-1565-4ccf-9957-512c68a86240&width=768&dpr=4&quality=100&sign=9be30b0e&sv=1)
AWS infrastructure configuration (outside cluster)
When deploying Cinchy version 5 on Kubernetes, you may deploy via Amazon Web Services (AWS). The diagram below shows a high level overview of a possible AWS Infrastructure with components outside the cluster, but your specific configuration may vary (Image 2).
Tip: Click on an image to enlarge it.
Infrastructure component overview
![](https://platform.docs.cinchy.com/~gitbook/image?url=https%3A%2F%2F3728216363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FuXTzhcF5GwEVWPr9Y2dX%252Fuploads%252FZucZMkwrqRSnFEIGEWsC%252FDNB%2520Cloud%2520Architecture%2520-%2520AWS.png%3Falt%3Dmedia%26token%3Db13a7dff-ea59-4b48-9dea-e268b9d441df&width=768&dpr=4&quality=100&sign=1162f11d&sv=1)
Azure infrastructure configuration (outside cluster)
When deploying Cinchy v5 on Kubernetes, you may deploy via Microsoft Azure. The diagram below shows a high level overview of possible Azure Infrastructure with components outside the cluster, but your specific configuration may vary (Image 3).
Tip: Click on an image to enlarge it.
Infrastructure component overview
![](https://platform.docs.cinchy.com/~gitbook/image?url=https%3A%2F%2F3728216363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FuXTzhcF5GwEVWPr9Y2dX%252Fuploads%252F9m791o82VaQu8nG3lieW%252FDNB%2520Cloud%2520Architecture%2520-%2520Azure%2520%282%29.png%3Falt%3Dmedia%26token%3Db39e7913-d6cf-4d3c-badb-b7f3febb477b&width=768&dpr=4&quality=100&sign=8f7921eb&sv=1)
Cluster level component overview
The following highlighted area provides a high-level overview of cluster level components used when deploying Cinchy on Kubernetes and what versions they're running.
These are created once per cluster. Clients may choose to run these components outside of the cluster or replace with their own comparable components. This diagram shows them in the cluster (Image 4).
Tip: Click on an image to enlarge it.
![](https://platform.docs.cinchy.com/~gitbook/image?url=https%3A%2F%2F3728216363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FuXTzhcF5GwEVWPr9Y2dX%252Fuploads%252FJNbRMl4DG9OkcqE7jGMl%252FCluster%2520components%2520Technical%2520Deep%2520Dive%2520-%2520Tech%2520Stack%2520copy%25202.png%3Falt%3Dmedia%26token%3Db9c05879-7a0a-44f7-aef1-12854e61c7bc&width=768&dpr=4&quality=100&sign=e9da1ce7&sv=1)
Cluster level components
These are created once per cluster. Clients may choose to run these components outside of the cluster or replace with their own comparable components.
Service Mesh - Istio: Istio handles and routes all inbound traffic to your Cinchy instance, keeping it secure and managed.
Monitoring/Alerting - Prometheus & Grafana: Prometheus consumes metrics from the running components in your environment, which you can visualize into user friendly graphs and dashboards by Grafana. Prometheus can also connect to third party services to provide alerting capabilities. Both Prometheus and Grafana use persistent storage.
Logging - OpenSearch and Fluent Bit: OpenSearch captures and indexes all logs in a single, accessible location. These logs can be queried, searched, and filtered, and Correlation IDs mean that they can also be traced across various components. These logging components take advantage of persistent storage.
Caching - Redis: Redis facilitates a distributed lock using RedLock, which guarantees lock synchronizations across Cinchy instances. It's also a storage location for the execution output when running batch data syncs.
Event Processing - Kafka: This acts as the middleware for messaging between components through a queuing mechanism. Kafka features persistent storage.
Cluster configuration
Before you deploy Cinchy on Kubernetes, consider the following about your cluster configuration :
How many clusters will you need?
Will you be sharing from an existing cluster?
Will you be running multiple environments on a single cluster?
Instance component overview
Each Cinchy instance uses the following components to either provide an experience to users/applications or connect data in/out of Cinchy. You can deploy multiple Cinchy instances per cluster, so these components will repeat for each environment.
The following highlighted area provides a high-level overview of instance level components used when running Cinchy on Kubernetes (Image 5).
Tip: Click on an image to enlarge it.
![](https://platform.docs.cinchy.com/~gitbook/image?url=https%3A%2F%2F3728216363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FuXTzhcF5GwEVWPr9Y2dX%252Fuploads%252FWaYPPCjqMHzyBf1KQUSL%252FInstance%2520components%2520Technical%2520Deep%2520Dive%2520-%2520Tech%2520Stack%2520copy.png%3Falt%3Dmedia%26token%3D203c78a1-3496-46b5-95bd-5c92e5e08fe8&width=768&dpr=4&quality=100&sign=1403bb2e&sv=1)
Meta Experiences: Cinchy offers pre-packaged experiences that you can import into your Cinchy environment and use on your data network. This includes experiences like Meta-Forms and Meta-Reports.
Connections: Use the Cinchy Connections experience to create data syncs in/out of the platform. It features persistent storage.
Data Browser: Cinchy’s data collaboration platform features a Universal Data Browser that allows users to view, change, analyze, and otherwise interact with all data on the network. The Data Browser even enables non-technical business users to manage and update data, build models, and set controls, all through an easy and intuitive UI.
Identity Provider: An Identity Provider (IdP) creates and manages user credentials and associated identity attributes. Cinchy uses IdPs authentication services to authenticate end-users.
Event Listener: The Event Listener picks up events from connected sources during a data sync. Review the Data Sync page for further information on the Event Listener. The Event Listener uses persistent storage.
Event Stream Worker: The Event Stream Worker processes data picked up by the Event Listener during data syncs. Review the Data Sync page for further information on the Event Stream Worker. The Event Worker uses persistent storage.
Maintenance (Batch Jobs): Cinchy performs maintenance tasks through the CLI. This includes the data erasure and data compression deletions.
GitOps
ArgoCD is a declarative, GitOps continuous delivery tool for Kubernetes that simplifies the application deployment and lifecycle management. ArgoCD is highly recommended for deploying Cinchy, but you can also use another tool.
Once you set up the configurations, ArgoCD automates the deployment of the desired application states into your specified target environments. Implemented as a Kubernetes controller, it continuously monitors running applications and compares the current, live state against the desired target state (as specified in your repositories).
Last updated