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. In IcePanel, click on the landscape dropdown in the top navigation bar

3. Click on the Import landscape button and select Structurizr

4. Import the JSON file

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

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

3. Click on the Import landscape button and select Backstage

4. Import the YAML or JSON file

Importing from Backstage to IcePanel