Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fscm/docker-mkpasswd
Docker recipe to build a mkpasswd tool image
https://github.com/fscm/docker-mkpasswd
docker docker-image dockerfile mkpasswd
Last synced: 11 days ago
JSON representation
Docker recipe to build a mkpasswd tool image
- Host: GitHub
- URL: https://github.com/fscm/docker-mkpasswd
- Owner: fscm
- License: mit
- Created: 2021-10-08T09:04:52.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2022-03-31T16:52:18.000Z (over 2 years ago)
- Last Synced: 2023-10-20T06:59:57.601Z (about 1 year ago)
- Topics: docker, docker-image, dockerfile, mkpasswd
- Language: Dockerfile
- Homepage:
- Size: 13.7 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.build.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# mkpasswd for Docker
Docker image with the `mkpasswd` tool rom the
[whois](https://github.com/rfc1036/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](https://docs.docker.com/install/).
### Usage
In order to create a Docker image using this Dockerfile you need to run the
`docker` command with a few options.
```shell
docker image build --force-rm --no-cache --progress plain --tag /:
```
- `` - *[required]* The user that will own the container image (e.g.: "johndoe").
- `` - *[required]* The container name (e.g.: "mkpasswd").
- `` - *[required]* The container tag (e.g.: "latest").
- `` - *[required]* The location of the Dockerfile folder.
A build example:
```shell
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:
```shell
docker image rm `docker image ls --filter "dangling=true" --quiet`
```
You can also use the following command to achieve the same result:
```shell
docker image prune -f
```
### Add Tags to the Docker Image
Additional tags can be added to the image using the following command:
```shell
docker image 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.
```shell
docker login
```
When logged in, an image can be pushed using the following command:
```shell
docker image push /:
```
Extra tags can also be pushed.
```shell
docker image push /:
```
## 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](CONTRIBUTING.md) file for more details on how
to contribute to this project.
## Versioning
This project uses [SemVer](http://semver.org/) for versioning. For the versions
available, see the [tags on this repository](https://github.com/fscm/docker-mkpasswd/tags).
## Authors
- **Frederico Martins** - [fscm](https://github.com/fscm)
See also the list of [contributors](https://github.com/fscm/docker-mkpasswd/contributors)
who participated in this project.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE)
file for details