ワークスペースと環境

自分だけの鍵と、チームの鍵が、同じ画面の同じ表に並びます。切り替えのためにサインインし直すことはありません。

個人と、チーム

置き場所は 2 とおりです。

• 個人。自分だけの保管庫です。ほかの人を招くことはできず、消すこともできません。アカウントを作った時点でひとつあります。
• ワークスペース。チームで使う場所です。メンバー・役割・記録の単位でもあります。

画面の上のバーが、いま見ているのがどちらかを示します。左のメニューはその場所の中身です。

階層

ワークスペースの中はこうなっています。

キーが置けるのはプロジェクトの環境の下だけです。ワークスペースの直下には置きません。

環境

プロジェクトを作ると、開発・検証・本番の 3 つができます。プロジェクトの設定の「環境」から、足すことも名前を変えることもできます。

ふだん使う環境は、リポジトリの .aikagi.toml に書いておきます。ブランチごとに変えることもできます。

environment = "development"

[branches]
main    = "production"
release = "staging"

個人からチームへ移す

自分で持っていた鍵をチームに配る段になったら、行のメニューから移動先のプロジェクトと環境を選びます。移動なので、移したあと個人の側からは消えます。どちらが持ち主かがあいまいな鍵を作らないためです。

移動先に同じ名前がすでにあるときは、上書きせずに止まります。名前を変えるか、先にある鍵を確かめてください。

ターミナルからも同じことができます。--to に書くのは移動先のフルネームで、フォルダではありません。

aikagi promote openai/api_key --to acme/web-app/production/openai/api_key

チームから個人へ写す

逆向きは複製です。プロジェクトのキーの行のメニューから、自分の保管庫に写しを作れます。もとの鍵はそのまま残ります。

写したあとは別の鍵です。もとの値が更新されても、写しは追随しません。

作る

ワークスペースとプロジェクトは画面からも、ターミナルからも作れます。名前は英小文字・数字・ハイフンです。

aikagi workspace create acme
aikagi project create acme/web-app
aikagi env ls -w acme -p web-app

プロジェクトを作ると、開発・検証・本番の 3 つが一緒にできます。それ以外の環境が要るときは足してください。並びは末尾に付きます。

aikagi env add qa -w acme -p web-app

画面を開かずに、ここまでの全部をターミナルだけで済ませられます。移行もそのまま続けられます。