pipeline-variable-management
流水线变量管理完整指南,涵盖变量生命周期(创建、初始化、更新、存储、传递、查询)和变量字段扩展(字段定义、类型扩展、作用域、继承)。当用户开发变量功能、处理变量传递、扩展变量字段或调试变量问题时使用。
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
流水线变量管理完整指南,涵盖变量生命周期(创建、初始化、更新、存储、传递、查询)和变量字段扩展(字段定义、类型扩展、作用域、继承)。当用户开发变量功能、处理变量传递、扩展变量字段或调试变量问题时使用。
How to use
Zainstaluj skill pipeline-variable-management z repozytorium TencentBlueKing (bk-ci). Skill dostarcza dokumentację i narzędzia do pracy ze zmiennymi w potokach CI/CD.
Zapoznaj się z dwoma głównymi modelami danych: BuildFormProperty (wewnętrzny model przechowywania w bazie danych) i Variable (model YAML do definiowania potoków). Oba modele są używane równolegle w systemie.
Gdy definiujesz zmienne w potoku, użyj modelu YAML (Variable) — zawiera on pola zgodne ze standardem Jackson do serializacji JSON. Zmienne mogą być parametrami konfiguracyjnymi, danymi przekazywanymi między etapami lub wartościami wprowadzanymi przez użytkownika.
Aby przekonwertować zmienne między formatami, skorzystaj z VariableTransfer. Klasa ta obsługuje transformację BuildFormProperty → Variable (do API i PAC) oraz Variable → BuildFormProperty (do przechowywania wewnętrznego).
Podczas uruchamiania potoku zmienne są inicjalizowane w momencie startu (StartBuild), a ich wartości przechowywane są w tabeli T_PIPELINE_BUILD_VAR. Możesz odczytać, zaktualizować i przesłać zmienne między zadaniami w ramach tego samego etapu lub między etapami.
Jeśli rozszerzasz strukturę zmiennych (nowe pola, typy, zakresy), modyfikuj definicje w BuildFormProperty i upewnij się, że VariableTransfer obsługuje nowe pola w obu kierunkach konwersji. Przetestuj konwersję na przykładach YAML.