@roadiehq/scaffolder-backend-argocd

scaffolder-backend-argocd

Welcome to the argocd actions for the scaffolder-backend.

This contains one action: argocd:create-resources.

The argocd:create-resources action allows the task to call any of the Argo CD instance APIs available to the user that triggers it.

Getting started

Create your Backstage application using the Backstage CLI as described here: https://backstage.io/docs/getting-started/create-an-app

Note: If you are using this plugin in a Backstage monorepo that contains the code for @backstage/plugin-scaffolder-backend, you need to modify your internal build processes to transpile files from the node_modules folder as well.

Note: To use this scaffolder action you need to ensure the Argo CD user you are utilizing has the create permission for both projects and applications

You need to configure the action in your backend as well as your software template:

From your Backstage root directory

cd packages/backend
yarn add @roadiehq/scaffolder-backend-argocd

Configure the action: (you can check the docs to see all options):

// packages/backend/src/plugins/scaffolder.ts

const actions = [
  createArgoCdResources({ config, logger }),
  ...createBuiltinActions({
    containerRunner,
    integrations,
    config,
    catalogClient,
    reader,
  }),
];

return await createRouter({
  containerRunner,
  logger,
  config,
  database,
  catalogClient,
  reader,
  actions,
});

New backend system

From your Backstage root directory

cd packages/backend
yarn add @roadiehq/scaffolder-backend-argocd

// packages/backend/src/index.ts
import { createBackend } from '@backstage/backend-defaults';
import { createBackendModule } from '@backstage/backend-plugin-api';

const backend = createBackend();
backend.add(import('@backstage/plugin-scaffolder-backend/alpha'));
backend.add(
  import('@roadiehq/scaffolder-backend-argocd/new-backend'),
);
backend.start();

### From your software template yaml file

Under `spec.steps[]` insert the below. In the below we reference items in the `spec.paramters[]` section.

- id: create-argocd-resources
  name: Create ArgoCD Resources
  action: argocd:create-resources
  input:
    appName: ${{ parameters.name }}-nonprod
    argoInstance: ${{ parameters.argoinstance }}
    namespace: ${{ parameters.namespace }}
    repoUrl: ${{ steps.publish.output.remoteUrl }}
    labelValue: ${{ parameters.name }}
    path: "kubernetes/nonprod"

> If needed there is an optional parameter of `projectName` as well.

## Contributed By American Airlines

---

Roadie gives you a hassle-free, fully customisable SaaS Backstage. Find out more here: [https://roadie.io](https://roadie.io).