Custom commands

Introduction

Any script in the project's .draky directory, that has a name ending with the .dk.sh is considered a command, will be automatically added to the list of available commands in the output of the draky -h command, and can be run by using draky [my-command] where [my-command] is the part of its filename that comes before the .dk.sh suffix. The specific location of the file doesn't matter.

There are two types of custom commands.

Commands executed on the host

This is the default behavior. These commands can run stuff inside the container, but only through the means available on the host, like the docker exec command.

These commands are useful if they need to do something across multiple containers, or need to have access to the host (like the database dump that needs to be saved on the host's filesystem).

Commands executed inside the container

To make command executed inside the container, its filename should end with .[service].dk.sh. E.g.: my-command.php.dk.sh. draky can recognize that the php is the name of the service in the docker-compose.yml file, and will run this command inside this service's container. It means that this script will have access to all programs inside the container.

Metadata

You can associate metadata with a custom command. For that, create a yaml file with the same name as a command file, but with .yml appended to it.

The following metadata values are supported:

• help [string]: Information displayed in the terminal next to the command in the draky's -h output.
• user [string/int]: This value is used only for the commands that run inside the containers. It allows to run the command as a given user inside the container. You can use user's numeric id, or name. In the case of name, the user has to exist in the container's /etc/passwd file.

stdin

All custom commands can handle standard input. It means that you can have a script registered as a command executed inside your database container like so:

.draky/mysql.database.dk.sh:

#!/usr/bin/env bash
mysql -uroot "$@" < /dev/stdin

And that command could be invoked in a following way:

$ draky mysql mydatabase < ./dbdump.sql

That way you can pass/redirect input into your commands to feed it into processes running inside the containers.