Skip to content

RHIDP-6573: Document resource requirements (Helm-based) for orchestrator in RHDH #1282

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions assemblies/assembly-install-rhdh-orchestrator-helm.adoc
Original file line number Diff line number Diff line change
@@ -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-resource-requirements-orchestrator.adoc[leveloffset=+1]
37 changes: 37 additions & 0 deletions modules/installation/con-resource-requirements-orchestrator.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
// Module included in the following assemblies
// assembly-install-rhdh-orchestrator-helm.adoc

:_mod-docs-content-type: PROCEDURE
[id="con-resource-requirements-orchestrator_{context}"]
== Resource requirements for Orchestrator

The Orchestrator flavor of {product} comes with the following default resource requests and limits as defined in the Helm chart:

[cols="2,2", options="header"]
|===
| Resource
| Default value

| CPU requests
| 250m

| Memory requests
| 64Mi

| CPU limits
| 500m

| Memory limits
| 1Gi
|===
Comment on lines +11 to +26
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think users would only be interested in resource limits (not requests), as this is what is enforced by the cluster.


You can customize these values by updating your `values.yaml` file or by passing `--set` flags during installation as shown in the following example :

[source,bash]
----
helm install <release_name> redhat-developer/backstage \
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
helm install <release_name> redhat-developer/backstage \
helm upgrade --install <release_name> openshift-helm-charts/redhat-developer-hub \

helm upgrade --install is generally recommended, as it will either install a new Helm release or upgrade it with the new parameters.

And similar to my comment here, we should use the official OpenShift Helm Charts repo.

--set orchestrator.sonataflowPlatform.resources.requests.cpu=500m \
--set orchestrator.sonataflowPlatform.resources.requests.memory=128Mi \
--set orchestrator.sonataflowPlatform.resources.limits.cpu=1 \
--set orchestrator.sonataflowPlatform.resources.limits.memory=2Gi
----
1 change: 1 addition & 0 deletions titles/orchestrator/artifacts
1 change: 1 addition & 0 deletions titles/orchestrator/assemblies
13 changes: 13 additions & 0 deletions titles/orchestrator/docinfo.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
<title>{title}</title>
<productname>{product}</productname>
<productnumber>{product-version}</productnumber>
<subtitle>{subtitle}
</subtitle>
<abstract>
<para>{abstract}</para>
</abstract>
<authorgroup>
<orgname>{company-name} Customer Content Services</orgname>
</authorgroup>
<xi:include href="Common_Content/Legal_Notice.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
1 change: 1 addition & 0 deletions titles/orchestrator/images
11 changes: 11 additions & 0 deletions titles/orchestrator/master.adoc
Original file line number Diff line number Diff line change
@@ -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]
1 change: 1 addition & 0 deletions titles/orchestrator/modules