Application variants enable advanced deployment strategies including blue-green deployments, canary releases, and preview environments. Each variant represents a different version of an application with specific traffic routing configuration.
namestringThe name of the application variant.
uidstringThe unique identifier of the application variant.
namespacestringThe Kubernetes namespace for this variant.
traffic_percentageintegerThe percentage of traffic routed to this variant (0-100).
traffic_split_namestringThe name of the traffic split configuration.
statusstringThe current status of the variant (e.g., "active", "canary", "preview").
git_hashstringThe git commit hash associated with this variant.
deploy_sessionstringThe deployment session identifier.
dns_recordarrayArray of DNS records associated with this variant.
created_atstringThe ISO 8601 timestamp when the application variant was created.
updated_atstringThe ISO 8601 timestamp when the application variant was last updated.
Variant Types:
- Active: The current production version receiving 100% traffic
- Canary: A rollout variant receiving a percentage of traffic for testing
- Blue/Green: A rollout variant for blue-green deployments
- Preview: A preview environment for testing changes
Example
{
"name": "canary",
"uid": "variant-456def789",
"namespace": "my-app-canary",
"traffic_percentage": 10,
"traffic_split_name": "main-canary-split",
"status": "canary",
"git_hash": "a1b2c3d4e5f6",
"deploy_session": "deploy-session-123",
"dns_record": [
"canary.myapp.com",
"test.myapp.com"
],
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:45:00Z"
}