Plan your deployment

This page is your first stop when considering a deployment of Cinchy v5.

Overview

This section will guide you through the considerations and the prerequisites before deploying version 5 of the Cinchy platform.

The pages in this section include:

• Deployment Architecture Overview: This page explores your two high-level options for deploying Cinchy, on Kubernetes or on VM, and why Cinchy recommends a Kubernetes deployment. It also walks you through selecting a database to run your deployment on and some sizing considerations.

  • Kubernetes Deployment Architecture: This page provides Infrastructure (for both Azure and AWS), Cluster, and Platform component overviews for Kubernetes deployments. It also guides you through considerations about your cluster configuration.

  • IIS Deployment Architecture: This page provides Infrastructure and Platform component overviews for IIS (VM) deployments.

• Deployment Prerequisites: This page details important prerequisites for deploying Cinchy v5.

Deployment planning checklist

Use the following checklist when planning for your Cinchy v5 deployment. Each item links to the appropriate documentation page.

• Will you run on Kubernetes or a VM?

The main differences between a Kubernetes based deployment and an IIS deployment are:

• Kubernetes offers the ability to elastically scale.

• IIS limits certain components to running single instances.

• As all caching is in memory in an IIS deployment, if multiple instances are online for redundancy there is point to point communication between them (HTTP requests on the server IPs) required to maintain the cache.

• Performance is better on Kubernetes because of Kafka/Redis

• Prometheus/Grafana and OpenSearch aren't available in an IIS deployment

• The Maintenance CLI runs as a CronJob in Kubernetes while this needs to be orchestrated using a scheduler for an IIS deployment.

• Upgrades are simpler with the container images on Kubernetes.

Kubernetes checklist

If you will be running on Kubernetes, please review the following checklist:

• Which database will you use?
• Define your sizing.
• Define 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?

  • Will you be using Cinchy's recommended cluster components or your own?

• Define your object storage requirements.

  • Create an S3 compatible bucket.
• Create your SSL Certs (With the option to use Self-Signed).
• Define your Secrets Management, if desired.
• Define whether you will use Cinchy's Docker Images or your own.

  • If using Cinchy’s, pull the images.

Starting in Cinchy v5.4, you will have the option between Alpine or Debian based image tags for the listener, worker, and connections. Using Debian tags will allow a Kubernetes deployment to be able to connect to a DB2 data source, and that option should be selected if you plan on leveraging a DB2 data sync.

• When installing or upgrading your platform, you can use the following Docker image tags for the listener, worker, and connections:

  • "5.x.x" - Alpine

  • "5.x.x-debian" - Debian

• Access the deployment repositories and copy them into your own repository (GitHub or similar).

IIS checklist

If you will be running on IIS, please review the following checklist:

• Ensure that you have an instance of SQL Server 2017+
• Ensure that you have a Windows Server 2012+ machine with IIS 7.5+ installed
• Install .net core Hosting bundle Version 6.0

  • Specifically, install: ASP.NET Core/.NET Core Runtime & Hosting Bundle

• Ensure that you review the minimum web server hardware recommendations
• Ensure that you review the minimum database server hardware recommendations
• Define your application storage requirements.
• Ensure you have access to the release binary.