Skip to content

chore: Add example templates for ArgoCD actions#8704

Merged
CryptoRodeo merged 5 commits into
backstage:mainfrom
CryptoRodeo:feat/argocd-action-examples
May 12, 2026
Merged

chore: Add example templates for ArgoCD actions#8704
CryptoRodeo merged 5 commits into
backstage:mainfrom
CryptoRodeo:feat/argocd-action-examples

Conversation

@CryptoRodeo
Copy link
Copy Markdown
Contributor

Hey, I just made a Pull Request!

New actions were added to the ArgoCD plugin. We should also have some example templates users can reference.

Related to #8539

Get ArgoCD Application

get-argocd-application-demo.mp4

Get ArgoCD Revision Details

get-argocd-revision-details.mp4

List ArgoCD Applications

list-argocd-apps-demo.mp4

Find ArgoCD Applications

Screencast.From.2026-04-17.16-26-16.mp4

✔️ Checklist

  • A changeset describing the change and affected packages. (more info)
  • Added or updated documentation
  • Tests for new functionality and regression tests for bug fixes
  • Screenshots attached (for UI changes)
  • All your commits have a Signed-off-by line in the message. (more info)

New actions were added to the ArgoCD plugin. We should also have some
example templates users can reference.

Signed-off-by: Bryan Ramos <bramos@redhat.com>
@backstage-goalie
Copy link
Copy Markdown
Contributor

backstage-goalie Bot commented Apr 21, 2026

Changed Packages

Package Name Package Path Changeset Bump Current Version
@backstage-community/plugin-argocd-backend workspaces/argocd/plugins/argocd-backend patch v1.4.0

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds user-facing examples for the new ArgoCD Actions API operations introduced in #8539, making it easier for users to invoke these actions via Scaffolder templates (and via raw actionId payload examples).

Changes:

  • Added 4 new Scaffolder Template examples for the new ArgoCD read actions (find/get/list/revision-details).
  • Added 4 new “action invocation” YAML examples demonstrating minimal/full inputs and expected outputs.
  • Registered the new templates in the ArgoCD workspace catalog locations and added a changeset.

Reviewed changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 12 comments.

Show a summary per file
File Description
workspaces/argocd/examples/templates/argocd-find-applications.yaml New scaffolder template example for finding apps across instances
workspaces/argocd/examples/templates/argocd-get-application.yaml New scaffolder template example for fetching a single application
workspaces/argocd/examples/templates/argocd-get-revision-details.yaml New scaffolder template example for fetching revision metadata
workspaces/argocd/examples/templates/argocd-list-applications.yaml New scaffolder template example for listing apps on an instance
workspaces/argocd/examples/02-argocd-find-applications-action.yaml New raw action invocation example for find-applications
workspaces/argocd/examples/03-argocd-get-application-action.yaml New raw action invocation example for get-application
workspaces/argocd/examples/04-argocd-get-revision-details-action.yaml New raw action invocation example for get-revision-details
workspaces/argocd/examples/05-argocd-list-applications-action.yaml New raw action invocation example for list-applications
workspaces/argocd/app-config.yaml Imports the new templates into the workspace catalog
workspaces/argocd/.changeset/stale-steaks-doubt.md Changeset for publishing the examples update

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread workspaces/argocd/examples/02-argocd-find-applications-action.yaml Outdated
Comment thread workspaces/argocd/examples/03-argocd-get-application-action.yaml Outdated
Comment thread workspaces/argocd/examples/04-argocd-get-revision-details-action.yaml Outdated
Comment thread workspaces/argocd/examples/03-argocd-get-application-action.yaml Outdated
Comment thread workspaces/argocd/examples/03-argocd-get-application-action.yaml Outdated
Comment thread workspaces/argocd/examples/02-argocd-find-applications-action.yaml Outdated
Comment thread workspaces/argocd/examples/05-argocd-list-applications-action.yaml Outdated
Comment thread workspaces/argocd/examples/04-argocd-get-revision-details-action.yaml Outdated
Comment thread workspaces/argocd/examples/05-argocd-list-applications-action.yaml Outdated
Comment thread workspaces/argocd/examples/05-argocd-list-applications-action.yaml Outdated
Signed-off-by: Bryan Ramos <bramos@redhat.com>
Signed-off-by: Bryan Ramos <bramos@redhat.com>
@CryptoRodeo CryptoRodeo marked this pull request as draft April 21, 2026 14:11
@CryptoRodeo
Copy link
Copy Markdown
Contributor Author

CryptoRodeo commented Apr 21, 2026

I just noticed that some actions are registered as backstage-community-argocd:argocd:<action> but the createResources action is registered as backstage-community-argocd:create-resources.
Should the new actions be updated to follow the latter format (backstage-community-argocd:<action>)? Or the other way around?

This PR can focus on just adding example templates.

Signed-off-by: Bryan Ramos <bramos@redhat.com>
@CryptoRodeo CryptoRodeo requested a review from Copilot April 21, 2026 14:34
@CryptoRodeo CryptoRodeo marked this pull request as ready for review April 21, 2026 14:35
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 11 out of 11 changed files in this pull request and generated 2 comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread workspaces/argocd/app-config.yaml
Comment thread workspaces/argocd/plugins/argocd-backend/README.md
Signed-off-by: Bryan Ramos <bramos@redhat.com>
@CryptoRodeo CryptoRodeo self-assigned this Apr 22, 2026
@CryptoRodeo
Copy link
Copy Markdown
Contributor Author

I created #8820 to update the action names. This PR can focus on the example templates.

@CryptoRodeo
Copy link
Copy Markdown
Contributor Author

Heads up @Eswaraiahsapram , @karthikjeeyar . These might be good for testing the new actions.

Copy link
Copy Markdown
Contributor

@dzemanov dzemanov left a comment

Choose a reason for hiding this comment

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

@CryptoRodeo thank you for the PR!
I have tested locally that templates work:

Image Image Image Image

It would be great if we could add examples similarly to this action.examples.ts and register, so they show up in Backstage.
I haven't checked though if and how it can be done for actions registered by actionsRegistry

@CryptoRodeo CryptoRodeo merged commit d2cf455 into backstage:main May 12, 2026
12 checks passed
@CryptoRodeo
Copy link
Copy Markdown
Contributor Author

@dzemanov Thank you for testing and reviewing. If time allows I will take a look soon on adding those examples you referenced

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants