Skip to content
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

Helm Chart Production Guide #4703

Draft
wants to merge 25 commits into
base: main
Choose a base branch
from
Draft

Helm Chart Production Guide #4703

wants to merge 25 commits into from

Conversation

hamza-m-masood
Copy link
Contributor

Description

closes: https://github.com/camunda/distribution/issues/344

When should this change go live?

  • This is a bug fix, security concern, or something that needs urgent release support.
  • This is already available but undocumented and should be released within a week.
  • This on a specific schedule and the assignee will coordinate a release with the DevEx team. (apply hold label or convert to draft PR)
  • This is part of a scheduled alpha or minor. (apply alpha or minor label)
  • There is no urgency with this change and can be released at any time.

PR Checklist

  • My changes are for an already released minor and are in /versioned_docs directory.
  • My changes are for the next minor and are in /docs directory (aka /next/).

@hamza-m-masood hamza-m-masood added hold This issue is parked, do not merge. target:8.7 Issues included in the 8.7 release labels Dec 3, 2024
@hamza-m-masood hamza-m-masood self-assigned this Dec 3, 2024
Copy link
Contributor

github-actions bot commented Dec 3, 2024

👋 🤖 🤔 Hello, @hamza-m-masood! Did you make your changes in all the right places?

These files were changed only in docs/. You might want to duplicate these changes in versioned_docs/version-8.6/.

  • docs/self-managed/operational-guides/assets/smarch.jpg
  • docs/self-managed/operational-guides/assets/smarch.pdf
  • docs/self-managed/operational-guides/production-guide.md

You may have done this intentionally, but we wanted to point it out in case you didn't. You can read more about the versioning within our docs in our documentation guidelines.

@hamza-m-masood
Copy link
Contributor Author

@conceptualshark, I wanted to add a link to the OpenSearch IRSA guide, but I am having a problem with the docs. I opened an issue here: #4754


We have a number of guides on connecting to external databases with the Camunda Helm Chart:

- [Using existing Elasticsearch](/docs/self-managed/setup/guides/using-existing-elasticsearch/)
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ [vale] reported by reviewdog 🐶
[docsInstance.hrefDocsToDocs] Improper link format: 'Using existing Elasticsearch'. Please specify the file extension.

We have a number of guides on connecting to external databases with the Camunda Helm Chart:

- [Using existing Elasticsearch](/docs/self-managed/setup/guides/using-existing-elasticsearch/)
- [Using Amazon OpenSearch Service](/docs/self-managed/setup/guides/using-existing-opensearch/)
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ [vale] reported by reviewdog 🐶
[docsInstance.hrefDocsToDocs] Improper link format: 'Using Amazon OpenSearch Service'. Please specify the file extension.

- [Using existing Elasticsearch](/docs/self-managed/setup/guides/using-existing-elasticsearch/)
- [Using Amazon OpenSearch Service](/docs/self-managed/setup/guides/using-existing-opensearch/)
- [Using Amazon OpenSearch Service through IRSA (only applicable if you are running Camunda Platform on EKS)](/docs/self-managed/setup/deploy/amazon/amazon-eks/terraform-setup.md#opensearch-module-setup)
- [Running Web Modeler on Amazon Aurora PostgreSQL](/docs/self-managed/modeler/web-modeler/configuration/database/#running-web-modeler-on-amazon-aurora-postgresql)
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ [vale] reported by reviewdog 🐶
[docsInstance.hrefDocsToDocs] Improper link format: 'Running Web Modeler on Amazon Aurora PostgreSQL'. Please specify the file extension.

@hamza-m-masood hamza-m-masood added the deploy Stand up a temporary docs site with this PR label Dec 12, 2024
@github-actions github-actions bot temporarily deployed to camunda-docs December 12, 2024 12:00 Destroyed

- [Connect to an OpenID Connect provider](http://localhost:3000/docs/next/self-managed/setup/guides/connect-to-an-oidc-provider/)
- Connect to existing Keycloak:
- [Configuration of the Camunda Helm Chart](/docs/self-managed/setup/guides/using-existing-keycloak/)
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ [vale] reported by reviewdog 🐶
[docsInstance.hrefDocsToDocs] Improper link format: 'Configuration of the Camunda Helm Chart'. Please specify the file extension.

- [Connect to an OpenID Connect provider](http://localhost:3000/docs/next/self-managed/setup/guides/connect-to-an-oidc-provider/)
- Connect to existing Keycloak:
- [Configuration of the Camunda Helm Chart](/docs/self-managed/setup/guides/using-existing-keycloak/)
- [Configuration of Keycloak](/docs/next/self-managed/identity/user-guide/configuration/configure-external-identity-provider/)
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ [vale] reported by reviewdog 🐶
[docsInstance.hrefDocsToDocs] Improper link format: 'Configuration of Keycloak'. Please specify the file extension.

@github-actions github-actions bot temporarily deployed to camunda-docs December 12, 2024 15:47 Destroyed
@github-actions github-actions bot temporarily deployed to camunda-docs December 12, 2024 20:02 Destroyed
@github-actions github-actions bot temporarily deployed to camunda-docs December 16, 2024 08:34 Destroyed

### Multi-namespace Deployment

The next recommended step is to setup a multi-namespace deployemnt. A [guide](/docs/self-managed/setup/guides/multi-namespace-deployment/) for this is already available. This is the most recommended approach to allow you to setup various environments using the Camunda Orchestration Cluster.
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ [vale] reported by reviewdog 🐶
[docsInstance.hrefDocsToDocs] Improper link format: 'guide'. Please specify the file extension.

replicationFactor: "3"
```

The `clusterSize` refers to the amount of borkers, the `partitionCount` refers to how each [partition](/docs/components/zeebe/technical-concepts/partitions/) is setup in the cluster, and the `replicationFactor` refers to the [number of nodes](/docs/components/zeebe/technical-concepts/partitions/#replication).
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ [vale] reported by reviewdog 🐶
[docsInstance.hrefDocsToDocs] Improper link format: 'partition'. Please specify the file extension.

replicationFactor: "3"
```

The `clusterSize` refers to the amount of borkers, the `partitionCount` refers to how each [partition](/docs/components/zeebe/technical-concepts/partitions/) is setup in the cluster, and the `replicationFactor` refers to the [number of nodes](/docs/components/zeebe/technical-concepts/partitions/#replication).
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ [vale] reported by reviewdog 🐶
[docsInstance.hrefDocsToDocs] Improper link format: 'number of nodes'. Please specify the file extension.

@github-actions github-actions bot temporarily deployed to camunda-docs December 16, 2024 09:06 Destroyed
replicationFactor: "3"
```

The `core.clusterSize` refers to the amount of borkers, the `core.partitionCount` refers to how each [partition](/docs/components/zeebe/technical-concepts/partitions/) is setup in the cluster, and the `core.replicationFactor` refers to the [number of nodes](/docs/components/zeebe/technical-concepts/partitions/#replication).
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ [vale] reported by reviewdog 🐶
[docsInstance.hrefDocsToDocs] Improper link format: 'partition'. Please specify the file extension.

replicationFactor: "3"
```

The `core.clusterSize` refers to the amount of borkers, the `core.partitionCount` refers to how each [partition](/docs/components/zeebe/technical-concepts/partitions/) is setup in the cluster, and the `core.replicationFactor` refers to the [number of nodes](/docs/components/zeebe/technical-concepts/partitions/#replication).
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ [vale] reported by reviewdog 🐶
[docsInstance.hrefDocsToDocs] Improper link format: 'number of nodes'. Please specify the file extension.

@github-actions github-actions bot temporarily deployed to camunda-docs December 16, 2024 09:27 Destroyed

We have a number of guides on connecting to external databases with the Camunda Helm Chart:

- [Using existing Elasticsearch](/docs/self-managed/setup/guides/using-existing-elasticsearch/)
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ [vale] reported by reviewdog 🐶
[docsInstance.hrefDocsToDocs] Improper link format: 'Using existing Elasticsearch'. Please specify the file extension.

We have a number of guides on connecting to external databases with the Camunda Helm Chart:

- [Using existing Elasticsearch](/docs/self-managed/setup/guides/using-existing-elasticsearch/)
- [Using Amazon OpenSearch Service](/docs/self-managed/setup/guides/using-existing-opensearch/)
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ [vale] reported by reviewdog 🐶
[docsInstance.hrefDocsToDocs] Improper link format: 'Using Amazon OpenSearch Service'. Please specify the file extension.

- [Using existing Elasticsearch](/docs/self-managed/setup/guides/using-existing-elasticsearch/)
- [Using Amazon OpenSearch Service](/docs/self-managed/setup/guides/using-existing-opensearch/)
- [Using Amazon OpenSearch Service through IRSA (only applicable if you are running Camunda Platform on EKS)](/docs/self-managed/setup/deploy/amazon/amazon-eks/terraform-setup.md#opensearch-module-setup)
- [Running Web Modeler on Amazon Aurora PostgreSQL](/docs/self-managed/modeler/web-modeler/configuration/database/#running-web-modeler-on-amazon-aurora-postgresql)
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ [vale] reported by reviewdog 🐶
[docsInstance.hrefDocsToDocs] Improper link format: 'Running Web Modeler on Amazon Aurora PostgreSQL'. Please specify the file extension.


### Multi-namespace Deployment

The next recommended step is to setup a multi-namespace deployemnt. A [guide](/docs/self-managed/setup/guides/multi-namespace-deployment/) for this is already available. This is the most recommended approach to allow you to setup various environments using the Camunda Orchestration Cluster.
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ [vale] reported by reviewdog 🐶
[docsInstance.hrefDocsToDocs] Improper link format: 'guide'. Please specify the file extension.

### Keycloak

- Connect to existing Keycloak:
- [Configuration of the Camunda Helm Chart](/docs/self-managed/setup/guides/using-existing-keycloak/)
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ [vale] reported by reviewdog 🐶
[docsInstance.hrefDocsToDocs] Improper link format: 'Configuration of the Camunda Helm Chart'. Please specify the file extension.


- Connect to existing Keycloak:
- [Configuration of the Camunda Helm Chart](/docs/self-managed/setup/guides/using-existing-keycloak/)
- [Configuration of Keycloak](/docs/next/self-managed/identity/user-guide/configuration/configure-external-identity-provider/)
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ [vale] reported by reviewdog 🐶
[docsInstance.hrefDocsToDocs] Improper link format: 'Configuration of Keycloak'. Please specify the file extension.

@github-actions github-actions bot temporarily deployed to camunda-docs December 17, 2024 21:08 Destroyed
@github-actions github-actions bot temporarily deployed to camunda-docs December 18, 2024 18:18 Destroyed
@github-actions github-actions bot temporarily deployed to camunda-docs December 20, 2024 11:25 Destroyed
- **NGINX Ingress Controller**: Ensure the NGINX ingress controller is set up in the cluster.
- **Persistent Volumes**: Configure block storage persistent volumes for stateful components.
- **Namespace Configuration**: Plan and create namespaces with appropriate resource quotas and LimitRanges for the Camunda Helm Chart.
- **Resource Planning**: Evaluate sufficient CPU, memory, and storage necessary for the deployment. Have a look at our [sizing guide](/docs/next/components/best-practices/architecture/sizing-your-environment/#camunda-8-self-managed) for more information.
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ [vale] reported by reviewdog 🐶
[docsInstance.hrefDocsToDocs] Improper link format: 'sizing guide'. Please specify the file extension.

@github-actions github-actions bot temporarily deployed to camunda-docs December 20, 2024 11:57 Destroyed
@github-actions github-actions bot temporarily deployed to camunda-docs December 20, 2024 12:16 Destroyed
@github-actions github-actions bot temporarily deployed to camunda-docs December 20, 2024 16:16 Destroyed
@github-actions github-actions bot temporarily deployed to camunda-docs December 20, 2024 17:04 Destroyed
policyName: core-record-retention-policy
```

If you would like more information on configuring ILM policy. Please refer to [our guide](/docs/next/self-managed/operate-deployment/data-retention/).
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ [vale] reported by reviewdog 🐶
[docsInstance.hrefDocsToDocs] Improper link format: 'our guide'. Please specify the file extension.

@github-actions github-actions bot temporarily deployed to camunda-docs December 20, 2024 18:27 Destroyed
Copy link
Contributor

The preview environment relating to the commit d9445fa has successfully been deployed. You can access it at https://preview.docs.camunda.cloud/pr-4703/index.html

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
deploy Stand up a temporary docs site with this PR hold This issue is parked, do not merge. target:8.7 Issues included in the 8.7 release
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants