From bea107fea8e3bc22018a2bd7047fc6eceffb4a94 Mon Sep 17 00:00:00 2001 From: NISHIMURA Yoshitaka Date: Sat, 3 Jan 2026 04:20:33 +0900 Subject: [PATCH] docs: aqua/README.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 移動後の aqua 系タスクの動作確認と修正が終わったのでドキュメントも再整理 - bashの再整理が終わったらもうちょい直す（と思う） --- aqua/README.md | 89 ++++++++++++++++++-------------------------------- 1 file changed, 31 insertions(+), 58 deletions(-) diff --git a/aqua/README.md b/aqua/README.md index 484cd57..e884e84 100644 --- a/aqua/README.md +++ b/aqua/README.md @@ -1,7 +1,36 @@ -# .config/aqua +# aqua - [CLI バージョン管理ツールの aqua を使うようになって少し経ったので少しまとめておく](https://zenn.dev/raki/articles/2024-05-16_aqua) +## tl;dr + +```bash +# このリポジトリのルートディレクトリ（このファイルのひとつ上のディレクトリ） +dotfiles $ pwd +/home/raki/officel/dotfiles + +# aqua の設定は XDG_BASE_DIRECTORY の XDG_CONFIG_HOME/aqua に置いてある、ということ +dotfiles $ ls -l ~/.config/aqua +lrwxrwxrwx 1 raki raki 32 1月 2 02:56 /home/raki/.config/aqua -> /home/raki/officel/dotfiles/aqua + +# 中身はこのディレクトリ +dotfiles $ ls -l ~/.config/aqua/ +合計 16 +-rwxrwxrwx 1 raki raki 2823 12月 31 13:34 README.md +-rwxrwxrwx 1 raki raki 4470 1月 3 03:58 Taskfile.yml +-rwxrwxrwx 1 raki raki 1683 1月 3 03:59 aqua.yaml + +# どこからでも task は呼べる +dotfiles $ t -t aqua/Taskfile.yml +task: Available tasks for this project: +* alias: show alias for aqua (aliases: aa) +* git: auto git, use -- COMMIT TITLE (aliases: ag) +* packages: random package from aqua.yaml (aliases: ap) +* update: Run aqua update, install, list for globally (aliases: au) + +reminder this package kubernetes/kubectl@v1.35.0 +``` + ## aqua.yaml のパッケージをソート ```bash @@ -12,66 +41,10 @@ yq '.packages |= sort_by(.name | split("/") | .[1])' aqua.yaml - 管理に迷ったらソートしておくと見やすい（かも） - 関連ツール毎にまとめたい時は [Split the list of packages](https://aquaproj.github.io/docs/guides/split-config) を使うとよさげ -## .bashrc +## .bashrc @todo 整理予定 ```bash # cli version manager aqua export PATH="$(aqua root-dir)/bin:$PATH" export AQUA_GLOBAL_CONFIG=${XDG_CONFIG_HOME:-$HOME/.config}/aqua/aqua.yaml ``` - -## alias - -```bash -alias aq='aqua' -alias aqcd="cd ${XDG_CONFIG_HOME:-$HOME/.config}/aqua/" -alias aqgi='aqua generate -i -o $AQUA_GLOBAL_CONFIG' -alias aqia='aqua install --all' -alias aqli='aqua list --installed --all | sort' -alias aqup='aqua update' -``` - -## task - -```bash -$ aqcd -aqua $ task -task: Available tasks for this project: -* aqua:alias: show alias for aqua (aliases: aa) -* aqua:git: auto git, use -- COMMIT TITLE (aliases: ag) -* aqua:packages: random package from aqua.yaml (aliases: ap) -* aqua:update: Run aqua update, install, list for globally (aliases: au) - -reminder this package cli/cli@v2.76.2 - -aqua $ task ls -task: Available tasks for this project: -* _git: -* _git:auto: -* _git:gh: -* aqua:alias: show alias for aqua (aliases: aa) -* aqua:git: auto git, use -- COMMIT TITLE (aliases: ag) -* aqua:packages: random package from aqua.yaml (aliases: ap) -* aqua:update: Run aqua update, install, list for globally (aliases: au) -* default: -* util:list: (aliases: ul, ls) -* util:summary: (aliases: us, la) - -aqua $ task au - aqua up が実行される - -aqua $ task ag - git add aqua.yaml から commit, push, gh pr create, gh pr merge まで自動化 -``` - -## direnv - -- .direnv と .env で GitHub token を設定した -- [Tips ｜ aqua CLI Version Manager 入門](https://zenn.dev/shunsuke_suzuki/books/aqua-handbook/viewer/tips#github_token%2C-aqua_github_token-%E3%82%92%E8%A8%AD%E5%AE%9A%E3%81%97%E3%81%A6-rate-limit-%E3%82%92%E5%9B%9E%E9%81%BF%E3%81%99%E3%82%8B) - -# related my projects - -- [officel/config_aqua: .config/aqua](https://github.com/officel/config_aqua) -- [officel/config_bash: .config/bash](https://github.com/officel/config_bash) -- [officel/config_git: .config/git](https://github.com/officel/config_git) -- [officel/config_task: .config/task](https://github.com/officel/config_task)