Create Humanitec App

Action ID: humanitec:create-app
NPM Package:

@humanitec/backstage-plugin-scaffolder-backend-module

Description

Creates a new application using the specified application ID and optional setup file.

Input Schema

PropertyTypeDescriptionRequired
setupFilestring-

Output Schema

No output schema defined for this action.

Usage Examples

Create a Humanitec application with a provided app ID

Creates a new Humanitec application using the provided ID. Use this when you just need the application created and will configure resources and environments later. This typically follows fetching your service skeleton with fetch:template.

Copy
steps:
  - id: fetch-base
    action: fetch:template
    input:
      url: https://github.com/acme-org/service-template/archive/main.tar.gz
      targetPath: .
      values:
        name: ${{ parameters.name }}
        owner: ${{ parameters.owner }}

  - id: create-humanitec-app
    action: humanitec:create-app
    input:
      appId: ${{ parameters.appId }}

Create a Humanitec application using a setup file

Creates the application and bootstraps it with a setup file checked into your template. Use this to seed environments and initial configuration after fetching content with fetch:template.

Copy
steps:
  - id: fetch-template
    action: fetch:template
    input:
      url: ./skeleton
      targetPath: .
      values:
        appId: ${{ parameters.appId }}
        environments:
          - id: dev
            name: Development
          - id: prod
            name: Production

  - id: create-humanitec-app-with-setup
    action: humanitec:create-app
    input:
      appId: ${{ parameters.appId }}
      setupFile: .humanitec/setup.yaml