Skip to main content
Requires version 2.0.1 or later of the Archetype platform.
A package is a blueprint built with its models fixed. To view every package you can access, in and outside your projects, select Packages under Agents in the Developer Console sidebar. The Packages page replaces the Agent Manager, and links to the Agent Manager open this page. To build packages, use the Create Package endpoint. To list them through the API, use List Packages.

The Packages List

The columns shown in the list are:
  • Package: The package’s name. Select it to open the package’s details in a side panel.
  • Project: The project the package belongs to, or No project. Select the project’s name to open the project.
  • Blueprint: The blueprint the package was built from.
  • Status: The package’s build status: Building, Ready, or Build failed.
  • Created: The date on which the package was built.
Use the blueprint menu to show only the packages built from one blueprint, and the search field to find packages by name. You can sort the list by Package or Created by selecting the column’s header, or with the sorting popup button next to the search field.

Package Details

Selecting a package opens its details in a side panel. The top of the panel shows the package’s status, description, target, creation date, creator, project, and package ID. From the panel, you can step to the previous or next package in the list, or open the package on its own page. The panel has two tabs:
  • Overview lists:
    • Models: Each model slot of the blueprint and what it was resolved to when the package was built.
    • Deployments: The package’s deployments, with their kind, status, and creation date. Select View all to open the Deployments tab of the package’s project.
    • Latest sessions: The newest sessions run on the package’s deployments, with their status, start time, and duration.
  • API shows the API requests that get the package, list its deployments, deploy it, and delete it.

Running a Package

You can run a package if your role is Developer or Admin. To run a package, open it and select Run package. This opens the Run package dialog. Pick one or more input files, then select Start run. The run uses the values from the package’s blueprint, and the output file is named for you. Starting a run creates a batch deployment of the package in the package’s project and opens a session on it. The Developer Console then opens the new deployment in the project. You can only run a package that is ready, built to run on Archetype Cloud, and in a project. While a package is still building, the button reads Building…, and it unlocks on its own once the build finishes. A package whose build failed shows Build failed instead. A package outside any project can’t be deployed: build it again from a blueprint in a project.

Deleting a Package

To delete a package, open it on its own page, select the more actions button () next to Run package, and select Delete package. Review the package’s name in the confirmation dialog, then select Delete package again.
A package that has runs or deployments can’t be deleted. Deleting a package doesn’t affect the blueprint it was built from.