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

add C8Run documentation to self managed #4266

Merged
merged 15 commits into from
Sep 9, 2024
Merged

add C8Run documentation to self managed #4266

merged 15 commits into from
Sep 9, 2024

Conversation

conceptualshark
Copy link
Contributor

@conceptualshark conceptualshark commented Sep 6, 2024

Description

Product Hub link: https://github.com/camunda/product-hub/issues/2240

Adds the feature documentation for C8Run to the Self Managed docs. Does not include the getting started experience as part of this update (though the reusable component has been created for later implementation).

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/).
  • I included my new page in the sidebar file(s).

@conceptualshark conceptualshark added component:self-managed Docs and issues related to Camunda Platform 8 Self-Managed 8.6.0-alpha5 September 2024 alpha release labels Sep 6, 2024
@conceptualshark conceptualshark self-assigned this Sep 6, 2024
@conceptualshark conceptualshark marked this pull request as ready for review September 6, 2024 16:20
Copy link
Contributor

github-actions bot commented Sep 6, 2024

👋 🤖 🤔 Hello! 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.5/.

  • docs/guides/react-components/install-c8run.md
  • docs/self-managed/setup/deploy/local/c8run.md
  • docs/self-managed/setup/deploy/local/img/c8run-deploy-diagram.png

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.

@conceptualshark conceptualshark added the deploy Stand up a temporary docs site with this PR label Sep 6, 2024
@conceptualshark conceptualshark requested a review from a team September 6, 2024 16:34
@github-actions github-actions bot temporarily deployed to camunda-docs September 6, 2024 17:06 Destroyed
@mesellings mesellings requested review from mesellings and removed request for a team September 9, 2024 07:45
@mesellings
Copy link
Contributor

@conceptualshark I wasn't sure if you needed this reviewed, but I will just in case 👍

mesellings
mesellings previously approved these changes Sep 9, 2024
Copy link
Contributor

@mesellings mesellings left a comment

Choose a reason for hiding this comment

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

LGTM - great work! Just some non-blocking comments to consider 👍

docs/guides/react-components/install-c8run.md Show resolved Hide resolved
2. Navigate to the new C8Run directory.
3. Start C8Run by running `./start.sh` (or `.\c8run.exe start` on Windows) in your terminal.

When successful, a new Operate window will open automatically.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
When successful, a new Operate window will open automatically.
When successful, a new Operate window automatically opens.

NB suggestion

When successful, a new Operate window will open automatically.

:::note
If C8Run fails to start, run the [shutdown script](/self-managed/setup/deploy/local/c8run.md/#shut-down-c8run) to end the current processes before running the start script again.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
If C8Run fails to start, run the [shutdown script](/self-managed/setup/deploy/local/c8run.md/#shut-down-c8run) to end the current processes before running the start script again.
If C8Run fails to start, run the [shutdown script](/self-managed/setup/deploy/local/c8run.md/#shut-down-c8run) to end the current processes, and run the start script again.

NB suggestion

docs/self-managed/setup/deploy/local/c8run.md Show resolved Hide resolved
C8Run is not supported for production use.
:::

The Camunda 8 Run Distribution, or C8Run, allows you to set up a local installation environment of Camunda 8 via a downloadable script. This page guides you through the manual installation of the Camunda 8 on a local or virtual machine.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
The Camunda 8 Run Distribution, or C8Run, allows you to set up a local installation environment of Camunda 8 via a downloadable script. This page guides you through the manual installation of the Camunda 8 on a local or virtual machine.
You can use the Camunda 8 Run Distribution (C8Run) to set up a local installation environment of Camunda 8 via a downloadable script. This page guides you through the manual installation of the Camunda 8 Run Distribution on a local or virtual machine.

NB suggestion

Comment on lines 28 to 38
## Install and start C8Run

1. Download the [latest release of C8run](https://github.com/camunda/camunda/releases/tag/c8run-8.6.0-alpha3) for your operating system and architecture. Opening the .tgz file will extract the C8Run script into a new directory.
2. Navigate to the new C8Run directory.
3. Start C8Run by running `./start.sh` (or `.\c8run.exe start` on Windows) in your terminal.

When successful, a new Operate window will open automatically.

:::note
If C8Run fails to start, run the [shutdown script](#shut-down-c8run) to end the current processes before running the start script again.
:::
Copy link
Contributor

Choose a reason for hiding this comment

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

See previous comments


## Access Camunda components

All C8Run components can be accessed with the username/password combination `demo`/`demo`.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
All C8Run components can be accessed with the username/password combination `demo`/`demo`.
All C8Run components can be accessed using the username/password combination `demo`/`demo`.

- Tasklist: `http://localhost:8080/tasklist`
- Operate: `http://localhost:8080/operate`

The following components do not have a web interface, but the URLs may be required for any additional configuration:
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
The following components do not have a web interface, but the URLs may be required for any additional configuration:
The following components do not have a web interface, but the URLs may be required for additional configuration:

- **Cluster endpoint:** `http://localhost:26500`, the location of your Zeebe Gateway
- **Authentication:** None

A success notification will display when complete. [Start a new process instance](/components/modeler/desktop-modeler/start-instance.md) to view your running process in Operate.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
A success notification will display when complete. [Start a new process instance](/components/modeler/desktop-modeler/start-instance.md) to view your running process in Operate.
A success notification is shown when deployment is complete. [Start a new process instance](/components/modeler/desktop-modeler/start-instance.md) to view your running process in Operate.

jessesimpson36
jessesimpson36 previously approved these changes Sep 9, 2024
@@ -0,0 +1,90 @@
---
id: c8run
title: "Local installation with C8Run"
Copy link
Contributor

Choose a reason for hiding this comment

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

Can we use Camunda 8 Run (C8Run). C8Run looks like an abbreviation. It will also help with SEO.

Copy link
Member

Choose a reason for hiding this comment

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

Late to the party 💃 but here I am!! 😆

Can we use Camunda 8 Run (C8Run). C8Run looks like an abbreviation. It will also help with SEO.

@conceptualshark you can consider using keywords in the page metadata for things like this.

keywords: ["C8Run"]

@github-actions github-actions bot temporarily deployed to camunda-docs September 9, 2024 16:06 Destroyed
@github-actions github-actions bot temporarily deployed to camunda-docs September 9, 2024 16:39 Destroyed
@mesellings mesellings self-requested a review September 9, 2024 19:02
Copy link
Contributor

@mesellings mesellings left a comment

Choose a reason for hiding this comment

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

New changes all lgtm - great job - approved 👍

@conceptualshark conceptualshark merged commit 18ec9b4 into main Sep 9, 2024
8 checks passed
@conceptualshark conceptualshark deleted the feat-c8run branch September 9, 2024 19:17
Copy link
Contributor

github-actions bot commented Sep 9, 2024

🧹 Preview environment for this PR has been torn down.


1. Download the [latest release of Camunda 8 Run](https://github.com/camunda/camunda/releases/tag/c8run-8.6.0-alpha3) for your operating system and architecture. Opening the .tgz file extracts the Camunda 8 Run script into a new directory.
2. Navigate to the new `c8run` directory.
3. Start Camunda 8 Run by running `./start.sh` (or `.\c8run.exe start` on Windows) in your terminal.
Copy link
Contributor

Choose a reason for hiding this comment

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

I assume ./start.sh will work for both Linux and Mac users?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
8.6.0-alpha5 September 2024 alpha release component:self-managed Docs and issues related to Camunda Platform 8 Self-Managed deploy Stand up a temporary docs site with this PR
Projects
Archived in project
Development

Successfully merging this pull request may close these issues.

6 participants