Skip to main content

Configuration file path

# aqua.yaml
registries:
- type: standard
ref: v3.27.0 # renovate: depName=aquaproj/aqua-registry

packages:
- name: cli/cli@v2.1.0
- name: junegunn/fzf@0.28.0
- name: tfmigrator/cli@v0.2.1
# bar/aqua.yaml
registries:
- type: standard
ref: v3.27.0 # renovate: depName=aquaproj/aqua-registry

packages:
- name: cli/cli@v2.0.0

aqua finds configuration files from the current directory to the root directory.

$ pwd
/home/foo/workspace/bar
$ mkdir zoo
$ cd zoo

$ gh version # find the configuration file /home/foo/workspace/bar/aqua.yaml
gh version 2.0.0 (2021-08-24)
https://github.com/cli/cli/releases/tag/v2.0.0

aqua reads configuration files until the tool is found.

tfmigrator isn't found in ../aqua.yaml, but is found in ../../aqua.yaml.

$ tfmigrator -v
INFO[0000] download and unarchive the package aqua_version=1.19.2 package_name=tfmigrator/cli package_version=v0.2.1 program=aqua registry=standard
tfmigrator version 0.2.1 (3993c0824016673338530f4e7e8966c35efa5706)

If the configuration file isn't found and the tool isn't installed outside aqua, the command fails.

$ cd /tmp
$ gh version
FATA[0000] aqua failed aqua_version=1.19.2 error="command is not found" exe_name=gh program=aqua