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

feat: add RPA getting started guide #5186

Merged
merged 13 commits into from
Mar 10, 2025
Merged

feat: add RPA getting started guide #5186

merged 13 commits into from
Mar 10, 2025

Conversation

marstamm
Copy link
Member

@marstamm marstamm commented Mar 7, 2025

Description

This PR adds RPA getting started guides. It is currently a Draft PR to get feedback on structure and wording. I will migrate the changes to the 8.7 version as well once we feedback on the content.

related to https://github.com/camunda/product-hub/issues/2533

When should this change go live?

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

PR Checklist

  • My changes are for an upcoming minor release and:
    • are in the /docs directory (version 8.8).
    • are in the /versioned_docs/version-8.7/ directory (version 8.7).
  • My changes are for an already released minor and are in a /versioned_docs directory.
  • I included my new page in the sidebar file(s).

@marstamm marstamm added the target:8.7 Issues included in the 8.7 release label Mar 7, 2025
@marstamm marstamm self-assigned this Mar 7, 2025
Copy link
Contributor

github-actions bot commented Mar 7, 2025

👋 🤖 🤔 Hello, @christinaausley! 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/components/RPA/getting-started.md
  • docs/components/RPA/img/create-new-task.png
  • docs/components/RPA/img/rpa-editor-initial.png
  • docs/components/RPA/img/rpa-editor-results.png
  • docs/components/RPA/img/rpa-task-configuration.png
  • docs/components/RPA/overview.md
  • docs/components/RPA/production.md
  • docs/components/early-access/experimental/rpa/camunda-rpa-framework-library.md
  • docs/components/early-access/experimental/rpa/img/rpa-task-example.png
  • docs/components/early-access/experimental/rpa/img/testing-rpa.png
  • docs/components/early-access/experimental/rpa/rpa-integration-with-camunda.md
  • docs/components/early-access/overview.md
  • docs/components/modeler/desktop-modeler/flags/flags.md
These files were changed only in docs/. You might want to duplicate these changes in versioned_docs/version-8.7/.
  • docs/components/RPA/getting-started.md
  • docs/components/RPA/img/create-new-task.png
  • docs/components/RPA/img/rpa-editor-initial.png
  • docs/components/RPA/img/rpa-editor-results.png
  • docs/components/RPA/img/rpa-task-configuration.png
  • docs/components/RPA/overview.md
  • docs/components/RPA/production.md
These files were changed only in versioned_docs/version-8.7/. You might want to duplicate these changes in docs/.
  • versioned_docs/version-8.7/components/rpa/getting-started.md
  • versioned_docs/version-8.7/components/rpa/img/create-new-task.png
  • versioned_docs/version-8.7/components/rpa/img/rpa-editor-initial.png
  • versioned_docs/version-8.7/components/rpa/img/rpa-editor-results.png
  • versioned_docs/version-8.7/components/rpa/img/rpa-task-configuration.png
  • versioned_docs/version-8.7/components/rpa/overview.md
  • versioned_docs/version-8.7/components/rpa/production.md
These files were changed only in versioned_docs/version-8.7/. You might want to duplicate these changes in versioned_docs/version-8.6/.
  • versioned_docs/version-8.7/components/early-access/experimental/rpa/camunda-rpa-framework-library.md
  • versioned_docs/version-8.7/components/early-access/experimental/rpa/img/rpa-task-example.png
  • versioned_docs/version-8.7/components/early-access/experimental/rpa/img/testing-rpa.png
  • versioned_docs/version-8.7/components/early-access/experimental/rpa/rpa-integration-with-camunda.md
  • versioned_docs/version-8.7/components/early-access/overview.md
  • versioned_docs/version-8.7/components/modeler/desktop-modeler/flags/flags.md
  • versioned_docs/version-8.7/components/rpa/getting-started.md
  • versioned_docs/version-8.7/components/rpa/img/create-new-task.png
  • versioned_docs/version-8.7/components/rpa/img/rpa-editor-initial.png
  • versioned_docs/version-8.7/components/rpa/img/rpa-editor-results.png
  • versioned_docs/version-8.7/components/rpa/img/rpa-task-configuration.png
  • versioned_docs/version-8.7/components/rpa/overview.md
  • versioned_docs/version-8.7/components/rpa/production.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.

This article covers the specific configuration of your RPA runner. For the basic getting started guide, check the
[getting started guide](./getting-started.md).

## Using Secrets
Copy link

Choose a reason for hiding this comment

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

Secrets are disabled by default, and are enabled by configuring the property camunda.rpa.zeebe.secrets.secrets-endpoint (the Worker has no way of determining this).

It doesn't apply to the prod SaaS environment (and therefore might not be worth mentioning), but the default value for camunda.rpa.zeebe.secrets.token-audience only works for prod, and must be configured for the dev instances.

Copy link
Member Author

Choose a reason for hiding this comment

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

The Console secrets endpoint for C8-SaaS is https://cluster-api.cloud.camunda.io/secrets, why not have this as the default?

With the default and graceful failure, we could enable secrets by default. Alternatively, consider Secrets being a Boolean toggle, similar to enabling zeebe. This makes it explicit to the user what implications the Config option has

Copy link
Member Author

Choose a reason for hiding this comment

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

I'd like to avoid exposing the cluster-api.cloud.camunda.io endpoint to the users, as the console API is internal and not publicly documented

Copy link
Member Author

Choose a reason for hiding this comment

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

I added the config option in 321d9d5 for now

@christinaausley
Copy link
Contributor

Awesome @marstamm! I will get this reviewed today. Is this something that can go out with the alpha next week, or is removing it from the early access section reserved for the minor? If that's the case, we could always get the getting started guide merged in for the alpha and remove early access in a separate PR for the minor.

@christinaausley
Copy link
Contributor

Note to self that I will need to add redirects.

@christinaausley
Copy link
Contributor

@marstamm -- This looks like it has undergone initial review. Would you like this to go out tomorrow? I can review, remove the old pages, and get it merged before the end of the day.

If this sounds good to you, can you put together a few brief sentences for the release notes?

@marstamm
Copy link
Member Author

Thank you @christinaausley , this sounds good! I'll have the release notes ready by EOD. My afternoon is a bit packed so I can't promise it any sooner, but I'll try to squeeze it in 😄

@christinaausley christinaausley added the 8.7.0-alpha5 March 2025 alpha release label Mar 10, 2025
@christinaausley christinaausley marked this pull request as ready for review March 10, 2025 13:54
@christinaausley
Copy link
Contributor

This is ready for final review -- I'll have one more look over it this afternoon and merge. @mattli2024 Not sure if you want to have a look?

Thanks all for your efforts!

@marstamm marstamm added the deploy Stand up a temporary docs site with this PR label Mar 10, 2025
@github-actions github-actions bot temporarily deployed to camunda-docs March 10, 2025 14:38 Destroyed
@github-actions github-actions bot temporarily deployed to camunda-docs March 10, 2025 15:58 Destroyed
@christinaausley christinaausley merged commit cb10f70 into main Mar 10, 2025
8 checks passed
@christinaausley christinaausley deleted the rpa-10 branch March 10, 2025 18:52
Copy link
Contributor

🧹 Preview environment for this PR has been torn down.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
8.7.0-alpha5 March 2025 alpha release deploy Stand up a temporary docs site with this PR target:8.7 Issues included in the 8.7 release
Projects
Status: ✅ Done
Development

Successfully merging this pull request may close these issues.

3 participants