OpenShift (ROSA) Deployment
This guide covers deploying Collate on AWS ROSA (Red Hat OpenShift Service on AWS). ROSA differs from standard EKS in three key ways: Security Context Constraints (SCC) replace Pod Security Admission, OpenShift Routes replace Ingress, and ROSA includes a built-in OIDC provider for IRSA.The Collate Helm chart supports any OpenShift 4.14+ cluster — not just ROSA. The AWS-specific sections (IRSA, ECR, S3, RDS) use ROSA as the reference example. If you are running self-managed OpenShift on-premises or on another cloud, skip the AWS prerequisite sections and substitute your own infrastructure (registry, object storage, database, secrets management). The OpenShift-specific chart configuration — SCCs, Routes, security contexts, and
emptyDir volume mounts — applies regardless of where the cluster runs.Architecture
Collate on ROSA requires four components, each with OpenShift-specific adaptations:- Collate Server — runs as an OpenShift Deployment under the
restricted-v2SCC - Database — MySQL 8.0+ or PostgreSQL 12+; RDS in the same VPC is recommended
- Search Engine — Amazon OpenSearch Service (recommended) or in-cluster OpenSearch
- Argo Workflows — orchestrates ingestion pipeline pods; requires
anyuidSCC for its system components
- IRSA via ROSA OIDC — pods assume IAM roles using the cluster’s built-in OIDC provider (no manual setup required)
- OpenShift Routes — replace Kubernetes Ingress; TLS is terminated at the OpenShift router
Sizing Requirements
Node requirements
ROSA Hosted Control Plane (HCP) is recommended. Minimum 2 worker nodes, each with:- 4 vCPUs
- 16 GiB Memory
- 128 GiB Storage
Software requirements
| Component | Minimum Version |
|---|---|
| ROSA | 4.14+ |
| Kubernetes | 1.27+ |
| Helm | 3.x |
| Argo Workflows | 3.5.4 |
| MySQL | 8.0 |
| PostgreSQL | 12.0 |
| OpenSearch | 2.7 |
| ElasticSearch | 8.10 |
Minimum Hardware requirements
| Component | vCPU | Memory | Storage | Notes |
|---|---|---|---|---|
| Collate Server | 2 | 4–8 GiB | — | Minimum 2 pods recommended |
| RDS | 2 | 8 GiB | 100 GiB | |
| OpenSearch | 2 | 8 GiB | 128 GiB | |
| Argo Workflows runners | 2 | 8 GiB | — |
m6i.xlarge for worker nodes, db.t4g.medium for RDS, r6g.large.search for OpenSearch.
These are minimum requirements. Please reach out to support for your custom requirements.
Deployment Steps
Prerequisites
Set up the ROSA OIDC provider reference, S3 bucket, and required AWS resources before deploying.
Deploy Argo Workflows
Create IAM roles for Argo, configure SCCs, and install Argo Workflows with the OpenShift-compatible values.
Deploy Collate
Create the Collate IAM role, configure ECR credentials, and install Collate with the openmetadata Helm chart.