Skip to content

Latest commit

 

History

History
117 lines (76 loc) · 2.91 KB

README.build.md

File metadata and controls

117 lines (76 loc) · 2.91 KB
Raw

mkpasswd for Docker

Docker image with the mkpasswd tool rom the whois project.

Synopsis

This script will create a Docker image with the mkpasswd tool installed.

The Docker image resulting from this script should be the one used to run the mkpasswd tool.

Getting Started

There are a couple of things needed for the script to work.

Prerequisites

Docker, either the Community Edition (CE) or Enterprise Edition (EE), needs to be installed on your local computer.

Docker

Docker installation instructions can be found here.

Usage

In order to create a Docker image using this Dockerfile you need to run the docker command with a few options.

docker image build --force-rm --no-cache --progress plain --tag <USER>/<IMAGE>:<TAG> <PATH>
  • <USER> - [required] The user that will own the container image (e.g.: "johndoe").
  • <IMAGE> - [required] The container name (e.g.: "mkpasswd").
  • <TAG> - [required] The container tag (e.g.: "latest").
  • <PATH> - [required] The location of the Dockerfile folder.

A build example:

docker image build --force-rm --no-cache --progress plain --tag johndoe/my_mkpasswd:latest .

To clean any none image(s) left by the build process the following command can be used:

docker image rm `docker image ls --filter "dangling=true" --quiet`

You can also use the following command to achieve the same result:

docker image prune -f

Add Tags to the Docker Image

Additional tags can be added to the image using the following command:

docker image tag <image_id> <user>/<image>:<extra_tag>

Push the image to Docker Hub

After adding an image to Docker, that image can be pushed to a Docker registry... Like Docker Hub.

Make sure that you are logged in to the service.

docker login

When logged in, an image can be pushed using the following command:

docker image push <user>/<image>:<tag>

Extra tags can also be pushed.

docker image push <user>/<image>:<extra_tag>

Contributing

  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -am 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request

Please read the CONTRIBUTING.md file for more details on how to contribute to this project.

Versioning

This project uses SemVer for versioning. For the versions available, see the tags on this repository.

Authors

  • Frederico Martins - fscm

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE file for details