Skip to content

Asset Naming Convention

General

This document outlines the naming convention and nomenclature for assets in our system.

With the exception of stacks, assets such as execgroups, shelloutconfigs, and env_vars are referenced using the following format:
<username>:::<repo_name>::<asset_name>:<version>
Example: williamwu:::aws::api-gateway:6

Assets are addressed with these components:

  • username
  • repository
  • name
  • version*

Stacks

The special stacks assets are first-class citizens and do not require a repository name:
<username>:::<stack_name>:<version>
Example: williamwu:::docker-ci:0.02

Stacks are addressed with these components:

  • username
  • stack_name
  • version*

*Note: Version is optional. Version can be auto-incrementing (e.g., 1, 2, 3) or can be a release version provided by the user.