Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?

Get SPDX license overview

Marketplace Release

This action will create a SPDX license overview with ORT and SPDX-builder.

THIS IS AN EXPERIMENTAL ACTION

Configuration

You can specify the configuration in a .spdx-builder.yml in the root of your project. See instructions in philips-software/spdx-builder.

Environment

This action requires a java environment. (See example)

Description

Get SPDX license overview

Inputs

parameter description required default
project project true spdx-builder
spdx-builder-version spdx-builder-version true v0.9.0
mode Scan mode. Can be 'ort', 'blackduck' or 'tree' true ort
scanner-url scanner-url (license-scanner) false
bombase-url bombase-url (in case of mode: 'tree') false
upload-url upload-url (f.e. BOM-bar) false
ort-version philipssoftware/ort version (in case of mode: 'ort') false 2021-05-31
ort-file Specifies an ort-file to override ORT scanning in this action. (in case of mode: 'ort') false
tree file with tree input (in case of mode: 'tree') false
format format input (in case of mode: 'tree') false
blackduck-url Blackduck url (in case of mode: 'blackduck') false
blackduck-token Blackduck token (in case of mode: 'blackduck') false
blackduck-project Blackduck project (in case of mode: 'blackduck') false
blackduck-version Blackduck version (in case of mode: 'blackduck') false
optional-arguments Optional arguments like --tree, --release, --force and --custom false
capture-stdout-file Capture stdout in a file. When given, this will be used as the filename of the output false

Outputs

parameter description
spdx-file spdx-license file
ort-file ort-license file

Runs

This action is an composite action.

GitHub workflow

Make sure you have a proper .spdx-builder.yml file in your project.

ORT mode

  - uses: actions/checkout@v2
  - uses: actions/setup-java@v1
    with:
      java-version: '11.0.1'
  - name: Create spdx-file
    id: spdx-builder
    uses: philips-software/[email protected]
    with:
      project: my-project
      mode: ort
  - uses: actions/upload-artifact@v2
    with:
      name: licenses
      path: ${{ steps.spdx-builder.outputs.spdx-file }}

tree mode

  - uses: actions/checkout@v2
  - uses: actions/setup-java@v1
    with:
      java-version: '11.0.1'
  - name: Create tree
    run: |
      npm list --all --production > npm-dependencies.txt
  - name: Create spdx-file
    id: spdx-builder
    uses: philips-software/[email protected]
     with:
      project: my-project
      mode: 'tree'
      tree: 'npm-dependencies.txt'
      format: 'npm'
      bombase-url: <bombase-url> # Optional
  - uses: actions/upload-artifact@v2
    with:
      name: licenses
      path: ${{ steps.spdx-builder.outputs.spdx-file }}

blackduck mode

  - uses: actions/checkout@v2
  - uses: actions/setup-java@v1
    with:
      java-version: '11.0.1'
  - name: Create spdx-file
    id: spdx-builder
    uses: philips-software/[email protected]
    with:
      project: my-project
      mode: 'blackduck'
      blackduck-url: <blackduck-url>
      blackduck-token: ${{ secrets.BLACKDUCK_TOKEN }}
      blackduck-project: <project-name>
      blackduck-version: <project-version>
  - uses: actions/upload-artifact@v2
    with:
      name: licenses
      path: ${{ steps.spdx-builder.outputs.spdx-file }}

Philips Forest

This module is part of the Philips Forest.

                                                     ___                   _
                                                    / __\__  _ __ ___  ___| |_
                                                   / _\/ _ \| '__/ _ \/ __| __|
                                                  / / | (_) | | |  __/\__ \ |_
                                                  \/   \___/|_|  \___||___/\__|

                                                                            CI