Projects zh TW

Projects

English · 繁體中文

瀏覽與選定

taiga project list
taiga project view example-project
taiga project use example-project
taiga project use example-project --local

project use 把預設專案寫進目前 profile；加上 --local 則只綁定目前的 Git repository。之後所有需要專案的 指令都可以省略 --project。

建立、編輯與刪除

taiga project create --name "Mobile App" --template scrum
taiga project edit mobile-app --description "Product delivery" --kanban=true
taiga project delete mobile-app --yes

專案預設建立為 private，要公開必須明確加上 --public。--template 接受 Taiga 站台上已定義的 project template（常見為 scrum 與 kanban）。

永久刪除由 Taiga 以背景工作執行且不可還原，非互動模式必須提供 --yes。

Archive 的限制

Taiga 6 的 REST API 把 archived_code 設為唯讀，也沒有對應的 archive action，因此 taiga project archive|unarchive 會明確回報 unsupported_capability，需要由站台管理者處理。CLI 不會用 其他 endpoint 迂迴模擬這個行為。

匯出與匯入

taiga project export example-project --format gzip --json
taiga project import ./example-project-export.json.gz --dry-run --json
taiga project import ./example-project-export.json.gz --yes --json
cat example-project-export.json | taiga project import - --yes --json

支援 plain JSON 與 gzip 兩種 dump 格式。

Taiga 的 production deployment 通常以背景工作產生 export 或執行 import。此時 CLI 會回報 status: "accepted"、task ID 與 verified: false，完成或失敗的結果由 Taiga 寄送 email。停用 Celery 的 同步部署則會直接回傳 status: "ready" 加下載 URL，或 status: "created" 加已建立的專案。

Export 使用 Taiga 的 GET endpoint，但該 endpoint 會建立背景工作，屬於非 idempotent 操作，因此 CLI 刻意不自動重試。Import 會先在本機以串流方式驗證 JSON／gzip 格式，不會把整份 dump 載入記憶體； 非互動模式必須明確提供 --yes。

Ownership transfer

taiga project transfer start --user 27 --reason "New maintainer" --yes
taiga project transfer validate-token --token "$TRANSFER_TOKEN"
taiga project transfer accept --token "$TRANSFER_TOKEN" --yes

Transfer token 不會出現在 dry-run 或結果輸出中。

Like 與 fans

taiga project like
taiga project unlike
taiga project fans --json

CSV export

taiga csv export issue --output ./issues.csv
taiga csv export story --output ./stories.csv
taiga csv export task --output ./tasks.csv
taiga csv export epic --output ./epics.csv

流程是：向 Taiga 申請一個短期的 server 端 UUID，串流下載到權限 0600 的暫存檔，計算 SHA-256，原子替換 目的檔，最後撤銷該 UUID。預設不覆寫既有檔案。