Page cover image

Imports

You can import data to IcePanel from Structurizr, Backstage, and our REST API (REST API).

Only Admins can import data into IcePanel.

Structurizr

  1. Use the export command in Structurizr's CLI to get a JSON file of your workspace/

  2. From the home section in IcePanel, click on the landscape dropdown in the top navigation bar.

  3. Click on the Import landscape button and select Structurizr.

  4. Upload the JSON file and click Import.

Backstage

Everything in Backstage exists as an Entity with the appropriate assigned type.

  1. The first step is to export all these entities into a YAML or JSON file. The Backstage API includes an endpoint to get a list of all entities, which can be filtered if needed. You can use the following curl command to export a list of your entities into a JSON file.

curl https://demo.backstage.io/api/catalog/entities --output entities.json

IcePanel supports the following kinds (types) from Backstage:

Backstage kind
Imported to IcePanel as

Domain

Domain

System

System (systems without a domain will be added to the default domain)

Resource

Store (resources without a system will be added to the default system)

Component

App (components without a system will be added to the default system)

API

App (APIs without a system will be added to the default system)

IcePanel will also import entity properties from Backstage, such as:

  • Name

  • Description

  • Tags

  • Links

  1. Once you have your list of entities, go to IcePanel and click the landscape dropdown in the top navigation bar.

  2. Click on the Import landscape button and select Backstage.

  3. Import the YAML or JSON file.

Importing from Backstage to IcePanel

Last updated

Was this helpful?