Traffic Routing
Use traffic routing commands to configure and view traffic distribution across cloud function versions, enabling gradual release and version rollback.
Configure Version Traffic
Use the tcb fn config-route command to configure traffic distribution for function versions:
tcb fn config-route <functionName> <version1> <traffic1> [version2] [traffic2]
Parameter Description:
| Parameter | Description | Required |
|---|---|---|
functionName | Function name | Yes |
version1 | First version number, can be a specific version or $LATEST | Yes |
traffic1 | Traffic percentage for the first version, range 0-100 | Yes |
version2 | Second version number | No |
traffic2 | Traffic percentage for the second version | No |
Usage Examples:
# Allocate 10% traffic to version 2, remaining 90% to $LATEST
tcb fn config-route app 2 10
# Allocate 30% traffic to version 1, 70% to version 2
tcb fn config-route app 1 30 2 70
# Switch 100% traffic to version 3
tcb fn config-route app 3 100
View Traffic Configuration
Use the tcb fn get-route command to view traffic configuration for function versions:
tcb fn get-route <functionName>
Usage Example:
# View traffic configuration for app function
tcb fn get-route app
Important Notes
- If only one version and traffic percentage is specified, the remaining traffic is allocated to the
$LATESTversion - If two versions are specified, the traffic percentages must sum to 100
- Traffic routing configuration takes effect immediately, adjustments will impact live traffic instantly
- It is recommended to perform traffic adjustments during off-peak business hours