Skip to content

This is a repository for Singularity container base OS images

Notifications You must be signed in to change notification settings

gmkurtzer/singularity-images

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 

Repository files navigation

This is a repository for Singularity container base OS images. To include images into this repository, please fork the repo and submit pull a pull request making sure you abide by the following standards.

The container nomenclature

Within the final directory defined above, the container nomenclature itself must represent much of the above information in the following order:

  1. The distribution name
  2. Build specific nomenclature
  3. Version string
  4. Date build string in the format of YYYY-MM-DD (optional but encouraged)
  5. Architecture
  6. End with .img

Examples

centos-base-7.2-2016-05-01.x86_64.img
scientific-python-6.5.x86_64.img

Directory structure

The directory structure is all in lowercase and each directory into the path is defined as follows:

  1. The distribution name (e.g. centos, redhat, ubuntu, mint, etc.)
  2. Version string as defined by the distribution (e.g. 7.1)
  3. Architecture (e.g. x86_64/amd64, i386, ppc, etc.)
  4. Build specific nomenclature (e.g. base, python, R, base_mpi, etc.)

Examples

centos/7.2/x86_64/base/
redhat/5.0/i386/python

Container inclusion standards

Within the directory defined above, do the following:

  • Provide the bootstrap definition that created the container and use the name BOOTSTRAP.def
  • Create a tar archive of the container itself (tar -CjSf $full_container_name.tbz2 $full_container_name)
  • Include a MAINTAINER file (template below)
  • Include a DESCRIPTION file (template below)

Maintainer file

In the container directory, you must include a MAINTAINER file which includes the following information:

NAME: Your Name
EMAIL: Your@Email
GITHUB: https://github.com/username

Description file

In the container direcotry you must include a DESCRIPTION file which includes the following information:

DISTRIBUTION: distribution_name
VERSION: distribution_version
ARCHITECTURE: distribution_architecture
TARBALLSUM: md5sum_checksum_of_tarball (NOT IMAGE!)
DATE: YYYY-MM-DD

Here you will provide a free form summary about the container, any specific
features you have included, motivation, etc.

About

This is a repository for Singularity container base OS images

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published