diff --git a/assemblies/assembly-install-rhdh-orchestrator-helm.adoc b/assemblies/assembly-install-rhdh-orchestrator-helm.adoc new file mode 100644 index 0000000000..1529de1cf2 --- /dev/null +++ b/assemblies/assembly-install-rhdh-orchestrator-helm.adoc @@ -0,0 +1,15 @@ +:_mod-docs-content-type: ASSEMBLY + +ifndef::context[] +[id="install-rhdh-orchestrator-helm"] +endif::[] +ifdef::context[] +[id="install-rhdh-orchestrator-helm_{context}"] +endif::[] += Installing {product} with Orchestrator using Helm + +:context: install-rhdh-orchestrator-helm + +You can install {product} with Orchestrator by using Helm, review resource requirements for Orchestrator, and plan for resource considerations in air-gapped environments. + +include::modules/installation/con-airgapped-requirements-orchestrator.adoc[leveloffset=+1] \ No newline at end of file diff --git a/modules/installation/con-airgapped-requirements-orchestrator.adoc b/modules/installation/con-airgapped-requirements-orchestrator.adoc new file mode 100644 index 0000000000..3a24fa61e6 --- /dev/null +++ b/modules/installation/con-airgapped-requirements-orchestrator.adoc @@ -0,0 +1,60 @@ +// Module included in the following assemblies +// assembly-install-rhdh-orchestrator-helm.adoc + +:_mod-docs-content-type: PROCEDURE +[id="con-airgapped-requirements-orchestrator_{context}"] += Resource requirements for air-gapped environments + +You can deploy the Orchestrator flavor of {product} in air-gapped environments by ensuring that all container images, and Helm charts required by {product} and SonataFlow are available internally. + +For workflow orchestration in air-gapped environments, the following resources are recommended: + +[cols="2,2", options="header"] +|=== +| Resource component +| Recommended resources + +| RHDH Orchestrator plugin +| 2 vCPUs, 2–4 GiB memory + +| SonataFlow runtime +| 1 vCPU, 1–2 GiB memory + +| Knative Serving and Eventing +| 1–2 vCPUs, 1.5 GiB memory + +| PostgreSQL or External DB +| 1 vCPU, 1 GiB memory + +| Persistent storage +| 5 GiB (minimum), adjust based on workflow logs and artifacts +|=== + +To prepare for an air-gapped deployment, complete the following steps: + +. **Mirror container images** + + Mirror all required {product-very-short}, SonataFlow, Knative, and orchestrator plugin images to an internal container registry. Ensure that the image versions match the Helm chart values. + +. **Mirror Helm charts** + + Pre-download the Helm charts for `redhat-developer-hub`, `orchestrator-infra`, and any dependent charts (for example, `bitnami` and `backstage`). Host them in an internal chart repository or file server. + +. **CRD and operator installation** + + Download the required CRDs and YAML manifests for SonataFlow and Knative operators and apply them manually. + +. **Configure network policies** + + Validate inter-pod communication and ensure internal DNS resolution to the mirrored image registry. + +. **Use `imagePullSecrets`** + + Update your `values.yaml` file with credentials for the internal registry if it is private: + +[source,yaml] +---- + global: + imagePullSecrets: + - name: internal-registry-secret +---- diff --git a/titles/orchestrator/artifacts b/titles/orchestrator/artifacts new file mode 120000 index 0000000000..f30b6dea60 --- /dev/null +++ b/titles/orchestrator/artifacts @@ -0,0 +1 @@ +../../artifacts \ No newline at end of file diff --git a/titles/orchestrator/assemblies b/titles/orchestrator/assemblies new file mode 120000 index 0000000000..91646274db --- /dev/null +++ b/titles/orchestrator/assemblies @@ -0,0 +1 @@ +../../assemblies \ No newline at end of file diff --git a/titles/orchestrator/docinfo.xml b/titles/orchestrator/docinfo.xml new file mode 100644 index 0000000000..e7fae0f66e --- /dev/null +++ b/titles/orchestrator/docinfo.xml @@ -0,0 +1,13 @@ +{title} +{product} +{product-version} +{subtitle} + + + {abstract} + + + {company-name} Customer Content Services + + diff --git a/titles/orchestrator/images b/titles/orchestrator/images new file mode 120000 index 0000000000..5fa6987088 --- /dev/null +++ b/titles/orchestrator/images @@ -0,0 +1 @@ +../../images \ No newline at end of file diff --git a/titles/orchestrator/master.adoc b/titles/orchestrator/master.adoc new file mode 100644 index 0000000000..e767771a24 --- /dev/null +++ b/titles/orchestrator/master.adoc @@ -0,0 +1,11 @@ +include::artifacts/attributes.adoc[] +:context: orchestrator-helm +:imagesdir: images +:title: Orchestrator flavor installation using Helm +:subtitle: Install, configure, and manage the Orchestrator flavor in {product} using Helm +:abstract: As a {product} ({product-very-short}) administrator, you can install and configure the Orchestrator flavor using Helm, ensuring your environment is prepared for workflow orchestration with {product}. + += {title} + +//Helm-based +include::assemblies/assembly-install-rhdh-orchestrator-helm.adoc[leveloffset=+1] \ No newline at end of file diff --git a/titles/orchestrator/modules b/titles/orchestrator/modules new file mode 120000 index 0000000000..8b0e854007 --- /dev/null +++ b/titles/orchestrator/modules @@ -0,0 +1 @@ +../../modules \ No newline at end of file