@piotr.pasich/circleci-backstage-plugin v0.1.5

CircleCI Plugin

Website: https://circleci.com/

Screenshots

Setup

1. If you have a standalone app (you didn't clone this repo), then do

# From your Backstage root directory
yarn add --cwd packages/app @piotr.pasich/circleci-backstage-plugin

2. Add the EntityCircleCIContent extension to the entity page in your app:

// In packages/app/src/components/catalog/EntityPage.tsx
import {
  EntityCircleCIContent,
  isCircleCIAvailable,
} from '@circleci/backstage-plugin';

// For example in the CI/CD section
const cicdContent = (
  <EntitySwitch>
    <EntitySwitch.Case if={isCircleCIAvailable}>
      <EntityCircleCIContent />
    </EntitySwitch.Case>

4. Add proxy config:

# In app-config.yaml
proxy:
  '/circleci/api':
    target: https://circleci.com/api/v1.1
    headers:
      Circle-Token: ${CIRCLECI_AUTH_TOKEN}
  '/circleci/private':
      target: https://circleci.com/api/private
      headers:
        Circle-Token: ${CIRCLECI_AUTH_TOKEN}

5. Get and provide a CIRCLECI_AUTH_TOKEN as an environment variable (see the CircleCI docs).
6. Add an annotation to your respective catalog-info.yaml files, with the format circleci.com/project-slug: <git-provider>/<owner>/<project> (See reference in ADR002).

# Example catalog-info.yaml entity definition file
apiVersion: backstage.io/v1alpha1
kind: Component
metadata:
  # ...
  annotations:
    # This also supports bitbucket/xxx/yyy
    circleci.com/project-slug: github/my-org/my-repo
spec:
  type: service
  # ...

Features

• List top 50 builds for a project
• Dive into one build to see logs
• Polling (logs only)
• Retry builds
• Works for both project and personal tokens
• Pagination for builds

Limitations

• CircleCI has pretty strict rate limits per token, be careful with opened tabs
• CircleCI doesn't provide a way to auth by 3rd party (e.g. GitHub) token, nor by calling their OAuth endpoints, which currently stands in the way of better auth integration with Backstage (reference feature request and discussion topic)

Release Notes

v0.1.1

• Update README.md's screenshots and assets path.

v0.1.0

• New release under CircleCI
• Please watch out for new updates in the coming weeks

v0.1.4

• Revert changes that removed build preview functionality
• Fix issue with calling CircleCI API protected by CORS by adding a proxy and replacing calls to CircleCI API with calls to the proxy