GithubHelp home page GithubHelp logo

pbabinca / containerapplicationgenericlabels Goto Github PK

View Code? Open in Web Editor NEW

This project forked from projectatomic/containerapplicationgenericlabels

0.0 3.0 0.0 65 KB

Default Containerized Application Labels used to document the application and/or image

containerapplicationgenericlabels's Introduction

Standard Container/Application Identifiers

Default Containerized Application Labels/Annotations/Ids used to document the application and/or image

With the introduction of the Atomic command, we are accessing container image meta data to describe the purpose of the image or the application defined by the image.

We would like to get consensus on default names. Proposals have been made to namespace the label names defined in Docker.

But we believe there should be some generic toplevel names defined that are not vendor specific, or distribution specific.

If you would like to see additional names and descriptions added please open issues and send pull requests to update this readme.

Overview

The following types of data are being considered:

  1. Labels used to describe how to use the application/image
Name Description
help Command to run the help command of the image
run Command to run the image
uninstall Command to uninstall the image
install Command to install the image
stop Command to execute before stopping container
debug Command to run the image with debugging turned on
  1. Labels Names used to describe the application/image
Name Description
name Name of the Image
version Version of the image
release Release Number for this version
architecture Architecture for the image
build-date Date/Time image was built as RFC 3339 date-time
vendor Owner of the image
url Url with more information on the image
summary Short Description of the image
description Detailed description of the image
vcs-type The type of version control used by the container source. Generally one of git, hg, svn, bzr, cvs
vcs-url URL of the version control repository
vcs-ref A 'reference' within the version control repository; e.g. a git commit, or a subversion branch
authoritative-source-url The authoritative location in which the image is published
distribution-scope Intended scope of distribution for image (see below for possible values)
changelog-url URL of a page containing release notes for the image
  1. Possible values of distribution-scope field
Name Description
private No public redistribution intended
authoritative-source-only Redistribution only from the source listed in the 'authoritative-source-url' label
restricted Redistribution only with permission
public No redistribution limits beyond licenses
  1. Custom labels may be defined by a namespace prefix using reverse DNS notation of a domain controlled by the author. For example, com.redhat.access.

     LABEL io.openshift.expose-services="8080:http" \
           io.openshift.tags="builder,nodejs,nodejs010"
    

Details on Labels

authoritative-source-url

  • The authoritative location the image is published by the owner.
  • In combination with the 'name' label, this tells a user where to go and look for official updates and current versions of the image, regardless of the local tags.

distribution-scope

  • The intended scope of distribution for the image.
  • Allows a user to define the intended scope of distribution. This addresses the end-user case of internal builds vs. public content and the use case of a vendor like Red Hat that provides content streams under subscription agreements - which is different from the license(s) of the image content.
  • In combination with the 'authoritative-source-url' and 'name' labels allows automatic redirect to the authoritative source.

containerapplicationgenericlabels's People

Contributors

aweiteka avatar bexelbie avatar goldmann avatar hhorak avatar mmilata avatar pbabinca avatar rhatdan avatar tomastomecek avatar vbatts avatar

Watchers

 avatar  avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.