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: Doc for dynamically executing the Pipeline #9523

Open
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

krishi0408
Copy link
Collaborator

Thanks for contributing to the Harness Developer Hub! Our code owners will review your submission.

Description

  • Please describe your changes: __________________________________
  • Jira/GitHub Issue numbers (if any): ______________________________
  • Preview links/images (Internal contributors only): __________________

PR lifecycle

We aim to merge PRs within one week or less, but delays happen sometimes.

If your PR is open longer than two weeks without any human activity, please tag a code owner in a comment.

PRs must meet these requirements to be merged:

  • Successful preview build.
  • Code owner review.
  • No merge conflicts.
  • Release notes/new features docs: Feature/version released to at least one prod environment.

@CLAassistant
Copy link

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.

@krishi0408 krishi0408 added the DO NOT MERGE PR is not ready to be merged. label Feb 26, 2025
@bot-gitexp-user
Copy link

Please check the Execution Link of the Pipeline for the Website Draft URL. This is located in the Preview Step behind the Harness VPN and also is available in #hdh_alerts. E.g Website Draft URL: https://unique-id--harness-developer.netlify.app. Current Draft URL is: https://67beef20d47d4900a8929052--harness-developer.netlify.app


### YAML Configuration

You need to provide valid YAML configuration provided through Dynamic Execution API.
Copy link
Contributor

Choose a reason for hiding this comment

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

Add a link to APIDocs , linking to the specific API here. Also name it here so users know what to look for.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Yes will add the same here


Users need both [**Edit and Execute**](/docs/platform/role-based-access-control/add-manage-roles.md) permissions on the Pipelines.

### YAML Configuration
Copy link
Contributor

Choose a reason for hiding this comment

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

Not sure what "YAML Configuration" means in this context? I assume you want to explain "How to use the feature" - which is only through the API. We should clarify here that we don't support Dynamic Executions through UI (by design).

You need to provide valid YAML configuration provided through Dynamic Execution API.

## Dynamic Execution API

Copy link
Contributor

Choose a reason for hiding this comment

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

Also, how does a user know that a pipeline was run dynamically? there's a few icons on the UI - let's list them here.

Copy link
Collaborator Author

@krishi0408 krishi0408 Feb 26, 2025

Choose a reason for hiding this comment

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

Yes need to add the same. In the execution we show whether it was triggered dynamically or not, I will add the same .

description: You can dynamically execute pipelines in Harness.
---

Dynamic execution of Pipelines allows you to execute pipelines by providing pipeline YAML configuration during runtime without requiring pre-saved configurations in Harness. This enables seamless integration with user existing ecosystem while maintanining Harness's robust security and governance controls.
Copy link
Contributor

Choose a reason for hiding this comment

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

I think its worth expanding the use case a little. Essentially we are using Harness as a pure Execution engine, letting an external system, somewhere in the ecosystem, do the YAML creation and editing. This is useful when Pipelines are being generated on the fly based on user actions.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Sure will add more details on the use case

@krishi0408
Copy link
Collaborator Author

Hi @SudarshanPurohit this is just the first draft. Have asked Brijesh to provide me the API, couldn't find the same in API docs. Will add more details on the same. Had some queries in the API that I saw in the channel so will add the same once I try out the same. For now, I have added the basic details. Will incorporate the changes you mentioned in the PR. Thanks

@bot-gitexp-user
Copy link

Please check the Execution Link of the Pipeline for the Website Draft URL. This is located in the Preview Step behind the Harness VPN and also is available in #hdh_alerts. E.g Website Draft URL: https://unique-id--harness-developer.netlify.app. Current Draft URL is: https://67bf39ed484a9ba23e2314b9--harness-developer.netlify.app

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
DO NOT MERGE PR is not ready to be merged.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants