Skip to content
This repository has been archived by the owner on Feb 23, 2023. It is now read-only.
/ docker-tags-orb Public archive

CircleCI orb to generate aliases from 4 digits semver

License

Notifications You must be signed in to change notification settings

Jahia/docker-tags-orb

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Jahia logo

Docker images tagging

CircleCI Build Status CircleCI Orb Version GitHub License CircleCI Community

A CircleCI orb to facilitate the tagging of Docker images and the creation of shorter versions of the tags acting as aliases to full versions of the image.

When provided with a version, the Orb will automatically check other versions already published to the registry (only Docker Hub for now) and determine all of the tags that needs to be generated.

The orb can also be provided with a path to a file containing a version.

For example, if releasing version 8.2.0.1, the orb will automatically created the following alliases:

  • 8
  • 8.2
  • 8.2.0

The objective is to allow CI/CD platforms to automatically use the "latest" of the selected flavor, for example latest 8, lasted 8.0, latest 8.0.2

This orb also supports SNAPSHOT tagging. Snapshot and release tags are not mixed.

Note: Due to Docker Layer caching, generating additonal tags does not increase resource usage.

Use Cases

Assuming the following tags already exist in Docker hub.

7.3.4.1
7.3.4.2
7.3.5.0
7.3.5.1
7.3.6.0
7.3.7.0
8.0.0.0
8.0.1.0
8.0.2.0

When submitting 8.0.2.0

All versions : 7.3.4.1 7.3.4.2 7.3.5.0 7.3.5.1 7.3.6.0 7.3.7.0 8.0.0.0 8.0.1.0 8.0.2.0
latest is : 8.0.2.0 , require tag update
8 is : 8.0.2.0 , require tag update
8.0 is : 8.0.2.0 , require tag update
8.0.2 is : 8.0.2.0 , require tag update

When submitting 7.3.7.0

All versions : 7.3.4.1 7.3.4.2 7.3.5.0 7.3.5.1 7.3.6.0 7.3.7.0 8.0.0.0 8.0.1.0 8.0.2.0
latest is : 8.0.2.0 , unchanged
7 is : 7.3.7.0 , require tag update
7.3 is : 7.3.7.0 , require tag update
7.3.7 is : 7.3.7.0 , require tag update

When submitting 7.3.5.1

All versions : 7.3.4.1 7.3.4.2 7.3.5.0 7.3.5.1 7.3.6.0 7.3.7.0 8.0.0.0 8.0.1.0 8.0.2.0
latest is : 8.0.2.0 , unchanged
7 is : 7.3.7.0 , unchanged
7.3 is : 7.3.7.0 , unchanged
7.3.5 is : 7.3.5.1 , require tag update

When submitting 7.3.5.0

7.3.5.0
All versions : 7.3.4.1 7.3.4.2 7.3.5.0 7.3.5.1 7.3.6.0 7.3.7.0 8.0.0.0 8.0.1.0 8.0.2.0
latest is : 8.0.2.0 , unchanged
7 is : 7.3.7.0 , unchanged
7.3 is : 7.3.7.0 , unchanged
7.3.5 is : 7.3.5.1 , unchanged

When submitting 8.0.1.1

Submitting a version that does not exist yet in the docker registry

8.0.1.1 not found yet, adding it
All versions : 7.3.4.1 7.3.4.2 7.3.5.0 7.3.5.1 7.3.6.0 7.3.7.0 8.0.0.0 8.0.1.0 8.0.1.1 8.0.2.0
latest is : 8.0.2.0 , unchanged
8 is : 8.0.2.0 , unchanged
8.0 is : 8.0.2.0 , unchanged
8.0.1 is : 8.0.1.1 , require tag update 

When submitting 8.0.3.0-SNAPSHOT

8.0.3.0-SNAPSHOT not found yet, adding it
All versions : 8.0.3.0-SNAPSHOT
latest-SNAPSHOT is : 8.0.3.0-SNAPSHOT , require tag update
8-SNAPSHOT is : 8.0.3.0-SNAPSHOT , require tag update
8.0-SNAPSHOT is : 8.0.3.0-SNAPSHOT , require tag update
8.0.3-SNAPSHOT is : 8.0.3.0-SNAPSHOT , require tag upda

Development

Complex orbs can be found here:

Release

Release of the orb is performed by merging content to the main branch with a semvar tag in the commit.

Please see this page for more details: https://circleci.com/docs/2.0/creating-orbs/#issue-a-new-release

Open-Source

This is an Open-Source module, you can find more details about Open-Source @ Jahia in this repository.

About

CircleCI orb to generate aliases from 4 digits semver

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages