Ahoy es una herramienta muy util para organizar un listado de comandos que necesitamos ejectuar de manera secuencial. Se utiliza mucho cuando se tienen que correr migraciones en Drupal.

En este tutorial veremos como instalarlo en DDEV y como configurarlo y usarlo para correr los script o comandos que necesitemos.

Paso 1: Instalación de ahoy en DDEV

En el archivo de configuración de DDEV: config.yaml agregamos una entrada hooks para la instancia de post-start para que cada vez que iniciamos un proyecto (ddev start) se instale el software de ahoy

hooks:
  post-start:
    - exec: wget -q https://github.com/ahoy-cli/ahoy/releases/download/
    2.0.0/ahoy-bin-`uname -s`-amd64 -O 
    /usr/local/bin/ahoy && chmod +x /usr/local/bin/ahoy

Captura de ejemplo:

Luego creamos el comando para poder ejecutar el ahoy en ddev, para esto creamo el file: ahoy en la carpeta commands/web

#!/bin/bash

## Description: Run ahoy inside the web container
## Usage: ahoy [args]
## Example: "ddev ahoy db:pull"

ahoy $@

Captura de ejemplo:

Paso 2: Configuración de los scrips y del archivo .ahoy.yml

Creamos el file: .ahoy.yml (no olvidar el . delante) en la carpeta web del proyecto. Dentro del archivo tenemos que ir agregando los comandos que necesitemos debajo de la key: commands

ahoyapi: v2
commands:
  list:example:
    usage: 'simulate an ls command'
    cmd: |
      echo "Executing script"
      ls .

  hello:
    usage: Say hello
    cmd: echo "Hello, World!"
    aliases: ["hi", "greet"]

Captura de ejemplo:

Paso 3: Probando el script

Probamos ejecutar el comando ahoy para el script de ejemplo que llamamos hello

Referencias:

• https://github.com/ahoy-cli/ahoy
• https://ahoy-cli.readthedocs.io/en/latest/