tce

Query TCE service deployments, clusters, Pod instances, and readiness checks across VRegions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a service misbehaves on TCE, engineers waste time clicking through the cloud console to find deployment status, cluster configuration, and failing Pods. This Skill turns those lookups into direct queries so you can diagnose deployment and Pod startup issues from a single command. ## Core Features & Use Cases - Service Discovery & Details: Search TCE services by PSM and retrieve deployment status, SCM version, owners, and runtime image info. - Cluster & Pod Inspection: List clusters with resource quotas and replica counts, then drill into Pod IPs, container states, and CPU/memory usage. - Readiness Diagnostics: Fetch Pod readiness check results (container environment, service startup, port, third-party components) to pinpoint why a Pod failed to start. - Use Case: A service in Singapore fails health checks after a deploy. Search by PSM to get the service_id, list clusters and Pod instances, then run get_pod_readiness_msg to see that the service startup check failed with a panic message and a link to the fix documentation. ## Quick Start Ask the agent to check the deployment status and Pod readiness of your TCE service by providing its PSM name and target region.

Frequently Asked Questions about tce

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

FAQPage Schema
How do I check TCE service deployment status by PSM?

Run the list_services action with the psm parameter to find the service_id, then call get_service_detail with that ID. The response includes deployment status, SCM version, owners, and runtime image version.

How to troubleshoot a TCE Pod that fails to start?

Use the get_pod_readiness_msg action with the Pod name to retrieve staged readiness checks covering container environment, service startup, ports, and third-party components. Failed checks include an error message, oncall contact, and a documentation link.

Can I use a service_id from one VRegion in another region?

No, service_id and cluster_id values are scoped to a single VRegion and are not interchangeable. When switching regions, run list_services again in the target VRegion to obtain the correct IDs.

What VRegion aliases does TCE querying support?

Supported aliases include boe for China-BOE, cn for China-North, sg for Singapore-Central, us for US-East, and ttp for US-TTP. The default region is China-BOE, so specify vregion explicitly for production queries.

Why does TCE querying return an authentication failed error?

The authentication failed error means the JWT credential could not be obtained. Run gdpa-cli login first to authenticate, then retry the query with your session.

Can this tool modify TCE service configurations?

No, it only supports read-only queries such as listing services, clusters, and Pod instances. It cannot change service configurations, restart Pods, or trigger deployments.