Skip to content

Create a Singularity Application

This guide describes how to create a new Singularity application in AMD Accelerator Cloud (AAC).

Open applications and click new application

  1. Click Applications in the top bar, then Applications again.
  2. Click New Application at the top right.

Note

If you do not see + New Application, you do not have Developer or Admin permission.

Open new application

Select Singularity

Select Singularity on the container type screen, then click Next.

Select Singularity

Configure general attributes

In the general information panel, configure the application attributes.

  • Name: Name of the application.
  • Description: Description of the application.
  • Family: application family.
  • Version number: ROCm version on the application.
  • Categories: Assign a category to the application.
  • Architectures: Choose either x86_64 or arm64.
  • Accelerator: Select either AMD GPU or NVIDIA GPU.
  • Featured: When on, the application appears at the top of the Applications list in the Featured section.

General attributes

Configure settings

On the Settings page you can optionally add metadata fields. These can be used by API scripts for filtering and metadata. Use the drop-down to add as many fields as you need.

Settings

Create container

The Create Container page offers two options: import an existing container or build one from a definition file.

Import container

If you have a Singularity container on a remote server, use Import Container to add it. Provide the URL to the image and its checksum. The URL must be publicly accessible; authentication is not supported.

Import container

Upload def file

Use Upload Def File to submit a Singularity definition file. The AAC build service will build the container and add it to My Apps. Build time varies; allow up to about ten minutes. Click Next to start the build.

Upload def file

Example of a simple def file:

Upload def recipe

For detailed guidance on working with Singularity containers, please refer to the Singularity documentation:

https://docs.sylabs.io/guides/3.10/user-guide/

Review and create

The Review Container page shows a summary of the application. Click Create.

Find your application

After clicking the Create button, your newly imported application will appear on your My Apps page. By clicking on the application’s panel, you can view its configuration details.

Application example

Enable the application

The Maintenance section on the right shows the application as disabled by default. As the owner, you can set the usage to Private or All Users. All Users makes the app available to all AAC users.