pipeline-variable-management

Manage and query BK-CI pipeline variables across stages and sub-pipelines.

2.5k|521|Updated May 29, 2019
One-click install
npx skills add https://github.com/TencentBlueKing/bk-ci --skill pipeline-variable-management
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pipeline-variable-management
Source: https://github.com/TencentBlueKing/bk-ci/tree/main/ai/skills/pipeline-variable-management
Command: npx skills add https://github.com/TencentBlueKing/bk-ci --skill pipeline-variable-management

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Managing pipeline variables across BK-CI pipelines is complex: their creation, initialization, propagation, extension, and querying across stages and sub-pipelines can lead to configuration drift and runtime errors. This Skill provides a comprehensive guide to variable lifecycles and field extensions, clarifying how variables are defined, initialized, stored, transmitted, and debugged.

Core Features & Use Cases

  • Lifecycle management: creation, initialization, dynamic updates, storage, and querying across stages and jobs.
  • Field extension: how to add new variable attributes and ensure front-end/back-end synchronization.
  • Cross-pipeline and cross-job propagation: how variable values flow from triggers to tasks and across parent/child pipelines.
  • Reference-driven development: architectural references to BuildFormProperty, Variable, and VariableTransfer to align backend and YAML models.

Quick Start

Use this Skill to understand how pipeline variables work, then consult reference/1-lifecycle.md for lifecycle details and reference/2-extension.md for extension guidance.

Frequently Asked Questions about pipeline-variable-management

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage pipeline variables across BK-CI builds and sub-pipelines?

Pipeline variables across BK-CI builds are managed by aligning backend BuildFormProperty and YAML Variable models via VariableTransfer, handling creation, initialization, propagation, and querying across stages and sub-pipelines.

What is the lifecycle of a pipeline variable in BK-CI?

The pipeline variable lifecycle in BK-CI covers creation, initialization, dynamic updates, storage, and querying across stages and jobs, preventing configuration drift and runtime errors.

How do I extend pipeline variable fields and ensure front-end back-end synchronization?

Extending pipeline variable fields requires adding new attributes and ensuring front-end back-end synchronization by referencing BuildFormProperty and Variable models to maintain alignment.

Can I propagate pipeline variables across parent and child pipelines for webhook triggers?

Yes, cross-pipeline variable propagation flows values from triggers to tasks across parent and child pipelines, supporting manual, API, and webhook triggers.

Why do pipeline variables cause configuration drift and runtime errors?

Pipeline variables cause configuration drift and runtime errors when their creation, initialization, propagation, and extension across stages and sub-pipelines lack alignment between backend BuildFormProperty and YAML Variable models.

What's the best way to debug pipeline variables across different pipeline stages?

Debugging pipeline variables across stages involves consulting lifecycle documentation to understand how variables are defined, initialized, stored, and transmitted, ensuring proper cross-stage propagation.

Related Skills