Skip to content

Latest commit

 

History

History
76 lines (51 loc) · 1.89 KB

README.adoc

File metadata and controls

76 lines (51 loc) · 1.89 KB
Raw

Container Builder (Drone Plugin)

Caution
 This project is under active development. It has reached stability when it has the semantic version "1.0.0" or above, as indicated by the git tag.

Purpose

This project allows the creation of docker images according to the styleguide in the littleman.co documentation. This includes the following guidelines:

  • OCI Labels such as org.opencontainers.image.ref.name

  • Image tags with the git hash, git tag (if it exists) and conditionally on the branch master, :latest

  • Allowing scheduled rebuilds

The plugin is written for consumption by the drone.io[https://drone.io/] open source build tooling.

Usage

Not yet documented

Configuration

Example

---
name: "Container Builder"

Reference

Nested configuration is described by dot notation. For example,

foo:
  bar: "baz"

is foo.bar=baz

Parameter Usage Examples

name

Used as part of the registry URL as well as the OCI label specifications

quay.io/littlemanco/drone/container-builder, org.opencontainers.image.ref.name=container-builder, org.opencontainers.image.ref.title=Container Builder

Development

Git Hooks

There are a series of git hooks that provide fast feedback to users about violations to code style, failing tests and so fourth before committing. To enable these git hooks run:

git config hooksPath $(git rev-parse --show-toplevel)/bin

Parts of the hooks can be disabled with the following configuration:

Configuraton Result

lint

Disable (or enable) lints.

Apply the configuration by running:

git config --bool hooks.${CONFIGURATION_PATH} true|false