You can import assets that you export from a deployment space or a project (either a project export or a Git archive) into a new or existing deployment space. This way, you can add assets or update existing assets (for example, replacing a model with its newer version) to use for your deployments.
You can import a space or a project export file to a new deployment space or an existing deployment space to populate the space with assets.
Importing a space or a project to a new deployment space
To import a space or a project when you are creating a new deployment space:
- Click New deployment space.
- Enter the details for the space. For more information, see Creating deployment spaces.
- In the Upload space assets section, upload the exported compressed file that contains data assets and click Create.
The assets from the exported file are added as space assets.
Importing a space or a project to an existing deployment space
To import a space or a project into an existing space:
- From your deployment space, click the import and export space
icon. From the list, select Import space. - Add your compressed file that contains assets from a watsonx.ai Studio project or deployment space.
Tip: If the space that you are importing is encrypted, enter the password in the Password field. - After your asset is imported, click Done.
The assets from the exported file are added as space assets.
Resolving issues with asset duplication
The importing mechanism compares assets that exist in your space with the assets that are being imported. If it encounters an asset with the same name and of the same type:
- If the asset type supports revisions, the importing mechanism creates a new revision of the existing asset and fixes the new revision.
- If the asset type does not support revisions, the importing mechanism fixes the existing asset.
This table describes how import works to resolve cases where assets are duplicated between the import file and the existing space.
| Your space | File being imported | Result |
|---|---|---|
| No assets with matching name or type | One or more assets with matching name or type | All assets are imported. If multiple assets in the import file have the same name, they are imported as duplicate assets in the target space. |
| One asset with matching name or type | One asset with matching name or type | Matching asset is updated with new version. Other assets are imported normally. |
| One asset with matching name or type | More than one asset with matching name or type | The first matching asset that is processed is imported as a new version for the existing asset in the space, extra assets with matching name are created as duplicates in the space. Other assets are imported normally. |
| Multiple assets with matching name or type | One or more assets with matching name or type | Assets with matching names fail to import. Other assets are imported normally. |
For more information, see Managing asset versions.
Existing deployments get updated differently, depending on deployment type:
- If a batch deployment was created by using the previous version of the asset, the next invocation of the batch deployment job will refer to the updated state of the asset.
- If an online deployment was created by using the previous version of the asset, the next "restart" of the deployment refers to the updated state of the asset.
Learn more
- For an example of how to export and import a deployment space by using the watsonx.ai Python client library, view or download this sample notebook.
- To learn about adding other types of assets to a space, refer to Assets in deployment spaces.
- To learn about exporting assets from a deployment space, refer to Exporting space assets.
Parent topic: Deployment spaces