Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/naskio/docker-compose-manager

Bash script to manage multiple docker-compose files (stacks)
https://github.com/naskio/docker-compose-manager

compose docker docker-compose docker-compose-files docker-compose-manager docker-compose-stacks manager stacks

Last synced: about 2 months ago
JSON representation

Bash script to manage multiple docker-compose files (stacks)

Awesome Lists containing this project

README

        

# Docker Compose Manager

manage multiple docker-compose files (stacks) in one place using an intuitive command line interface.

![screenshot](assets/screenshot2.png)

# Getting Started

## Install

Run the following command to install docker-compose-manager:

```shell
bash <(curl -sSL https://raw.githubusercontent.com/naskio/docker-compose-manager/main/install.sh)
```

Alternatively, you can specify a different version:

```shell
bash <(curl -sSL https://raw.githubusercontent.com/naskio/docker-compose-manager/main/install.sh) multi
bash <(curl -sSL https://raw.githubusercontent.com/naskio/docker-compose-manager/main/install.sh) local
bash <(curl -sSL https://raw.githubusercontent.com/naskio/docker-compose-manager/main/install.sh) dialog
bash <(curl -sSL https://raw.githubusercontent.com/naskio/docker-compose-manager/main/install.sh) arrow-keys
bash <(curl -sSL https://raw.githubusercontent.com/naskio/docker-compose-manager/main/install.sh) arrow-keys-v2
bash <(curl -sSL https://raw.githubusercontent.com/naskio/docker-compose-manager/main/install.sh) ps3
```

Available versions:

- ```multi```: run one-command on multiple docker-compose files (stacks), use dialog for selection. (default version)
- ```local```: same as ```multi```, but use local files `docker-compose.local.ya?ml` instead of default files.
- ```dialog```: Run one command on one stack, use dialog for selection.
- ```arrow-keys```: Run one command on one stack, use arrow keys for navigation.
- ```arrow-keys-v2```: Run one command on one stack, use arrow keys for navigation - version 2.
- ```ps3```: Run one command on one stack, use ps3 for selection.

## Check

Check if docker-compose-manager has been installed correctly:

```shell
which dcm
```

## Usage

Inside the folder where you want to manage docker-compose files, run the following commands:

```shell
dcm
```

### Available commands

- ```up```: start all services in the stack.
- ```down```: stop all services in the stack.
- ```restart```: restart all services in the stack (`up` then `down`).
- ```resync```: fetch the latest code from GitHub then restart all services in the stack (`down`, `git pull` then `up`).
- ```upgrade```: upgrade images of all services in the stack (`down`, `pull` then `up`).

![screenshot](assets/screenshot1.png)

### Dialog Usage

Use `arrow keys` and `space` to navigate and select from the list, and `enter` to validate.

## Uninstall

Run the following command to uninstall docker-compose-manager:

```shell
bash <(curl -sSL https://raw.githubusercontent.com/naskio/docker-compose-manager/main/uninstall.sh)
```

# Contributing

[Pull requests](https://github.com/naskio/docker-compose-manager/pulls) are welcome! For any bug reports, please create
an [issue](https://github.com/naskio/docker-compose-manager/issues).

Start by reading the [contributor guideline](CONTRIBUTING.md).

# License

[License](LICENSE)