Magallanes annotated minimal example

.mage.yml

magephp:
  # log_dir: .

  environments:
    development:
      ssh:
        port: 22
        flags: -o ConnectTimeout=3600 # if rsyncing takes a bit longer...
      user:
      branch:
      # DON'T: use releases if symlinks on the server cause problems
      # releases: 5
      from: ./
      host_path: /absolute/path/on/server/
      exclude:
        # DO: start with ```/```; it will be interpreted as relative from local source dir
        # DON'T: start with ```./```; it won't work
        - /.env
        - /.vscode
        - /*.code-workspace
        - /node_modules
        - /tests
        - .cache
        - .mage.yml
        # DON'T: use ```**/*.log``` only; it will cause a parse error
        # DO: add ```/*.log``` for root level AND ```/**/*.log``` for nested files
        - /**/*.log
      hosts:
        -
      pre-deploy:
        - git/update
        - composer/install
        - composer/dump-autoload
        - exec: { cmd: "bash command", desc: "What it does, e.g. clear cache" }
      on-deploy:
        - fs/link: { from: "../shared/example", to: "example" }