1.4.5 • Published 7 days ago

@janus-idp/backstage-scaffolder-backend-module-quay-dynamic v1.4.5

Weekly downloads
-
License
Apache-2.0
Repository
-
Last release
7 days ago

Quay actions for Backstage

This module provides Backstage template actions for Quay.

The following actions are currently supported in this module:

  • Create a Quay repository

Installation

Run the following command to install the action package in your Backstage project

yarn workspace backend add @janus-idp/backstage-scaffolder-backend-module-quay

Installing the action on the legacy backend

  1. Register the Quay actions by modifying the packages/backend/src/plugins/scaffolder.ts file from your project with the following changes:

    import { CatalogClient } from '@backstage/catalog-client';
    import { ScmIntegrations } from '@backstage/integration';
    import {
      createBuiltinActions,
      createRouter,
    } from '@backstage/plugin-scaffolder-backend';
    
    import { Router } from 'express';
    
    import { createQuayRepositoryAction } from '@janus-idp/backstage-scaffolder-backend-module-quay';
    
    import type { PluginEnvironment } from '../types';
    
    export default async function createPlugin(
      env: PluginEnvironment,
    ): Promise<Router> {
      const catalogClient = new CatalogClient({
        discoveryApi: env.discovery,
      });
    
      const integrations = ScmIntegrations.fromConfig(env.config);
    
      const builtInActions = createBuiltinActions({
        integrations,
        catalogClient,
        config: env.config,
        reader: env.reader,
      });
    
      const actions = [...builtInActions, createQuayRepositoryAction()];
    
      return await createRouter({
        actions,
        logger: env.logger,
        config: env.config,
        database: env.database,
        reader: env.reader,
        catalogClient,
        identity: env.identity,
      });
    }
  2. Optional: If you are doing the previous step for the first time, you also have to install the @backstage/integration package

    yarn workspace backend add @backstage/integration

Installing the action on the new backend

Add the following to your packages/backend/src/index.ts file:

const backend = createBackend();

// Add the following line
backend.add(
  import('@janus-idp/backstage-scaffolder-backend-module-quay/alpha'),
);

backend.start();

Configuration

Add the Quay actions to your templates, see the example file in this repository for complete usage examples

action: quay:create-repository
id: create-quay-repo
name: Create quay repo
input:
  baseUrl: https://quay.io
  token: UW1dLVdCTj8uZWNuIW97K1k0XiBkSmppVU9MYzFT
  name: foo
  visibility: public
  description: This is a foo repository
  namespace: bar
  repoKind: image

Usage

Action: quay:create-repository

Input

Parameter NameTypeRequiredDescriptionExample
namestringYesQuay repository namefoo
visibilitystringYesVisibility setting for the created repository, either public or privatepublic
descriptionstringYesDescription for the created repositoryThis if foo repository
tokenstringYesAuthentication token, see docsUW1dLVdCTj8uZWNuIW97K1k0XiBkSmppVU9MYzFT
baseUrlstringNoBase url of a quay instance, defaults to https://quay.iohttps://foo.quay.io
namespacestringNoNamespace to create repository in, defaults to the namespace the token belongs tobar
repoKindstringNoCreated repository kind, either image or application, if empty defaults to imageimage

Output

NameTypeDescription
repositoryUrlstringQuay repository URL created by this action
1.4.5

7 days ago

1.4.4

7 days ago

1.4.3

9 days ago

1.4.2

9 days ago

1.4.1

14 days ago

1.4.0

24 days ago

1.3.10

1 month ago

1.3.9

1 month ago

1.3.8

1 month ago

1.3.7

1 month ago

1.3.6

1 month ago

1.3.5

2 months ago

1.3.4

2 months ago

1.3.3

2 months ago

1.3.2

3 months ago

1.3.1

3 months ago

1.3.0

3 months ago

1.2.7

4 months ago

1.2.6

4 months ago

1.2.5

5 months ago