Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/fscm/docker-amazonlinux

Docker recipe to build an Amazon GNU/Linux image
https://github.com/fscm/docker-amazonlinux

amazonlinux2 docker docker-image dockerfile

Last synced: about 2 months ago
JSON representation

Docker recipe to build an Amazon GNU/Linux image

Awesome Lists containing this project

README

        

# Amazon Linux for Docker

Docker image with Amazon GNU/Linux.

## Synopsis

This is a set of scripts designed to create Docker images with Amazon
GNU/Linux.

The Docker images resulting from these scripts should be the ones used
to instantiate an Amazon Linux container.

## 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 Dockerfiles you need to
run the `docker` command with a few options.

```shell
docker image build --force-rm --no-cache --progress plain --file /Dockerfile --tag /:
```

- `` - *[required]* The user that will own the container image (e.g.: "johndoe").
- `` - *[required]* The container name (e.g.: "amazonlinux").
- `` - *[required]* The container tag (e.g.: "latest").
- `` - *[required]* The location of the Dockerfile folder.
- `` - *[required]* The variant that is being build (`amazonlinux2`).

A build example:

```shell
docker image build --force-rm --no-cache --progress plain --file amazonlinux2/Dockerfile --tag johndoe/my_amazonlinux:2 .
```

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-amazonlinux/tags).

## Authors

- **Frederico Martins** - [fscm](https://github.com/fscm)

See also the list of [contributors](https://github.com/fscm/docker-amazonlinux/contributors)
who participated in this project.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE)
file for details