docker-hub-description-updater/README.md
2019-11-12 20:16:46 +01:00

60 lines
2.3 KiB
Markdown

# docker hub description updater
[![Build Status](https://travis-ci.com/volker-raschek/docker-hub-description-updater.svg?branch=master)](https://travis-ci.com/volker-raschek/docker-hub-description-updater)
[![Go Report Card](https://goreportcard.com/badge/github.com/volker-raschek/docker-hub-description-updater)](https://goreportcard.com/report/github.com/volker-raschek/docker-hub-description-updater)
[![GoDoc Reference](https://godoc.org/github.com/volker-raschek/docker-hub-description-updater?status.svg)](http://godoc.org/github.com/volker-raschek/docker-hub-description-updater)
[![Docker Pulls](https://img.shields.io/docker/pulls/volkerraschek/dhdu)](https://hub.docker.com/r/volkerraschek/dhdu)
By specifying the login data for [hub.docker.com](https://hub.docker.com) you
can update the short and long description of a docker repository.
## Usage
The examples below describe two ways to update the full description of the
docker hub repository. First by the binary and second by a container based way.
```bash
dhdu \
--user=<username> \
--password=<password> \
--namespace=<namespace> \
--repository=<repository> \
--file=./README.md
```
```bash
docker run \
--rm \
--volume $(pwd):/workspace \
volkerraschek/dhdu \
--user=<username> \
--password=<password> \
--namespace=<namespace> \
--repository=<repository> \
--file=./README.md
```
## Compiling the source code
There are two different ways to compile dhdu from scratch. The easier ways is
to use the pre-defined container image in the Makefile, which has included all
dependancies to compile dhdu. Alternatively, if all dependencies are met,
dhdu can also be compiled without the container image. Both variants are
briefly described.
### Compiling the source code via container image
To compile dhdu via container image it's necessary, that a container runtime
is installed. In the Makefile is predefined docker, but it's can be also used
podman. Execute `make container-run/dhdu` to start the compiling process.
```bash
make container-run/dhdu
```
#### Compiling the source code without container image
Make sure you have installed go >= v1.12. Execute `make dhdu` to compile
dhdu without a container-image. There should be a similar output as when
compiling dhdu via the container image.