Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/mimischi/dokku-dockerfile

Deploy applications to Dokku via Dockerfiles outside of the project root
https://github.com/mimischi/dokku-dockerfile

docker dockerfile dokku

Last synced: about 2 months ago
JSON representation

Deploy applications to Dokku via Dockerfiles outside of the project root

Awesome Lists containing this project

README

        

# dokku-dockerfile

Deploy your applications via `Dockerfile`, while keeping your project root clean of auxiliary files.

## Installation

```
sudo dokku plugin:install https://github.com/mimischi/dokku-dockerfile.git
```

## Commands

```
dockerfile:set Set custom path to Dockerfile
dockerfile:unset Unset custom path to Dockerfile
dockerfile:report Report custom path to Dockerfile
```

## Usage

Dokku will look for a `Dockerfile` in the project root, when building a
non-buildpack application. Depending on the projects structure, it's desirable
to keep deployment specific files in subdirectories. This plugin points Dokku
to the relative path of the `Dockerfile`.

To deploy an application with a directory structure as shown below, one would
use the following command:

```
dokku dockerfile:set docker/dokku/Dockerfile
```

### Example project structure
```
.
├── app
│   ├── [...]
├── docker
│   ├── dokku
│   │   ├── Dockerfile
│   │   ├── [...]
│   └── local
│   ├── Dockerfile-dev
├── docker-compose.yml
└── README.md
```

## Behind the scenes

During the deploy process, this plugin copies the `Dockerfile` specified path to
the projects root, enabling Dokku to build it.