Skip to content
This repository has been archived by the owner on Mar 29, 2022. It is now read-only.

Latest commit

 

History

History
47 lines (32 loc) · 1.7 KB

03.create_app.md

File metadata and controls

47 lines (32 loc) · 1.7 KB
layout title tagline
page
Create a Custom Application
NOTE: The app building guide presented here is a work in progress, and it uses a development branch of the SD2E CLI. Please proceed with caution. If you would instead prefer to follow the old, but safe, app building guide, please go here




You can find Agave applications ("apps") in the SD2E catalog by using the apps-list command described previously. What if the app you are looking for is not available? Using the Agave CLI, you can create your own.


#### Components of an app

The essential components you need to create your own app are:

  1. An app bundle directory containing definitions and assets for the app
  2. A Docker image containing the executable and all runtime dependencies
  3. A wrapper script (generally written in bash) that runs the executable

Several example apps exist and all components are visible. For example, visit the SD2E Docker Hub to view existing app containers. And, example app bundles can be viewed on the SD2E GitHub page or SD2E GitLab.


#### Create your own by example

The best way to demonstrate the creation of a custom app is by example. The following sub-pages will go through the process:

  1. Set up your environment
  2. Initiate the app directory
  3. Containerize the executable
  4. Deploy and submit a test job
  5. Best practices and next steps

Return to the API Documentation Overview