env

Query and deploy BOE/PPE environments, TCE/TCC services, and ByteFaaS via DSL APIs.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill env-yuezhen-huang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: env
Source: https://github.com/yuezhen-huang/my-bytedance-skillhub/tree/main/env
Command: npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill env-yuezhen-huang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing ByteDance BOE/PPE test environments requires navigating multiple internal APIs for environment details, service clusters, permissions, and deployments. This Skill consolidates environment querying and DSL-based service deployment into a single CLI interface, eliminating manual console operations. ## Core Features & Use Cases - Environment Querying: Retrieve environment details, deployed service lists, PSM cluster info, permission checks, fallback configuration, instance metadata, and SCM code dependencies across VRegions. - DSL Deployment: Deploy, upgrade, or delete TCE/TCC services in existing environments (dsl_deploy), create brand-new environments with services (dsl_create), and deploy ByteFaaS services (faas_deploy/faas_create) with automatic parameter completion from create_suggest and scm_dependencies. - Deployment Lifecycle: Track deployment status via dsl_status, retry failed deployments with dsl_retry, and delete entire environments when no longer needed. - Use Case: A developer needs to upgrade a service in a PPE environment in EU-TTP. They run dsl_deploy with the environment name, PSM, and version, then poll dsl_status until the deployment succeeds. ## Quick Start Ask the AI to deploy version 1.0.0.213 of your service PSM to your PPE environment in the EU-TTP region using the env skill.

Frequently Asked Questions about env

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

FAQPage Schema
How do I deploy a service to a PPE environment?

Use the dsl_deploy action with the environment name, service PSM, and either a version or branch. The skill auto-detects upgrade versus create mode based on existing clusters and fills missing parameters from create_suggest.

How do I check the status of a DSL deployment?

Run the dsl_status action with the deployment_id returned by dsl_deploy or dsl_create. Poll until the status field shows success or failure, and use dsl_retry to rerun failed deployments.

What is the difference between dsl_deploy and dsl_create?

dsl_deploy operates on an existing environment using the DSLUpdate API to create, upgrade, or delete services. dsl_create uses DSLCreate to provision a brand-new environment together with its first service deployment.

Does TCC service deployment require extra parameters?

Yes, TCC deployments require the region parameter such as EU-TTP, US-EastRed, or CN, with multiple regions separated by commas. The service_id is fetched automatically via SearchTccService but can be specified manually.

Why does my environment query fail with authentication errors?

Authentication failures mean the JWT credential is missing or expired. Run gdpa-cli login first to obtain credentials, and ensure the vregion parameter matches the target region since it controls API routing and auth type.

When should I use faas_deploy instead of dsl_deploy?

Use faas_deploy for ByteFaaS services in existing PPE environments, as it handles region selection, code version resolution, and pre-checks automatically. Use dsl_deploy for standard TCE or TCC services.