wip

Author: jopemachine

docs/manager/graphql-reference/supergraph.graphql

@@ -1626,13 +1626,7 @@ to support integers outside the range of a signed 32-bit integer.
 scalar BigInt
   @join__type(graph: GRAPHENE)
 
-"""
-Added in 25.19.0.
-Input parameters for configuring a blue-green deployment strategy.
-When auto_promote is true, traffic is automatically switched from the blue (old)
-replica set to the green (new) set after promote_delay_seconds elapse.
-When auto_promote is false (default), an explicit promotion action is required.
-"""
+"""Added in 25.19.0. Configuration for blue-green deployment strategy."""
 input BlueGreenConfigInput
   @join__type(graph: STRAWBERRY)
 {
@@ -3652,14 +3646,7 @@ enum DeploymentOrderField
   NAME @join__enumValue(graph: STRAWBERRY)
 }
 
-"""
-Added in 25.19.0.
-Defines the deployment policy attached to a model deployment,
-including the rollout strategy (rolling update or blue-green),
-strategy-specific parameters, and whether to automatically roll back on failure.
-Each deployment has at most one policy; creating a new policy for the same deployment
-replaces the existing one (upsert semantics).
-"""
+"""Added in 25.19.0. Deployment policy configuration."""
 type DeploymentPolicy implements Node
   @join__implements(graph: STRAWBERRY, interface: "Node")
   @join__type(graph: STRAWBERRY)
@@ -3730,10 +3717,7 @@ input DeploymentStrategyInput
 }
 
 """
-Added in 25.19.0.
-Base interface for all deployment strategy specifications.
-Each concrete implementation (RollingUpdateStrategySpec, BlueGreenStrategySpec)
-carries strategy-specific parameters that control how replica transitions are performed.
+Added in 25.19.0. Base interface for deployment strategy specifications.
 """
 interface DeploymentStrategySpec
   @join__type(graph: STRAWBERRY)
@@ -3742,10 +3726,7 @@ interface DeploymentStrategySpec
 }
 
 """
-Added in 25.19.0.
-Determines how new revisions of a model deployment are rolled out to replace old ones.
-ROLLING performs incremental replica replacement controlled by max_surge and max_unavailable,
-while BLUE_GREEN provisions a complete new replica set before switching traffic.
+Added in 25.19.0. This enum represents the deployment strategy type of a model deployment, indicating the strategy used for deployment.
 """
 enum DeploymentStrategyType
   @join__type(graph: STRAWBERRY)
@@ -11528,14 +11509,7 @@ enum RoleStatus
   DELETED @join__enumValue(graph: STRAWBERRY)
 }
 
-"""
-Added in 25.19.0.
-Input parameters for configuring a rolling update strategy.
-max_surge sets the maximum number of additional replicas that can be created
-beyond the desired count during an update (default: 1).
-max_unavailable sets the maximum number of replicas that can be unavailable
-during the update (default: 0). At least one of these must be positive.
-"""
+"""Added in 25.19.0. Configuration for rolling update strategy."""
 input RollingUpdateConfigInput
   @join__type(graph: STRAWBERRY)
 {

docs/manager/graphql-reference/v2-schema.graphql

@@ -1083,13 +1083,7 @@ enum BgtaskEventType {
   FAILED
 }
 
-"""
-Added in 25.19.0.
-Input parameters for configuring a blue-green deployment strategy.
-When auto_promote is true, traffic is automatically switched from the blue (old)
-replica set to the green (new) set after promote_delay_seconds elapse.
-When auto_promote is false (default), an explicit promotion action is required.
-"""
+"""Added in 25.19.0. Configuration for blue-green deployment strategy."""
 input BlueGreenConfigInput {
   autoPromote: Boolean! = false
   promoteDelaySeconds: Int! = 0
@@ -2080,14 +2074,7 @@ enum DeploymentOrderField {
   NAME
 }
 
-"""
-Added in 25.19.0.
-Defines the deployment policy attached to a model deployment,
-including the rollout strategy (rolling update or blue-green),
-strategy-specific parameters, and whether to automatically roll back on failure.
-Each deployment has at most one policy; creating a new policy for the same deployment
-replaces the existing one (upsert semantics).
-"""
+"""Added in 25.19.0. Deployment policy configuration."""
 type DeploymentPolicy implements Node {
   """The Globally Unique ID of this object"""
   id: ID!
@@ -2143,20 +2130,14 @@ input DeploymentStrategyInput {
 }
 
 """
-Added in 25.19.0.
-Base interface for all deployment strategy specifications.
-Each concrete implementation (RollingUpdateStrategySpec, BlueGreenStrategySpec)
-carries strategy-specific parameters that control how replica transitions are performed.
+Added in 25.19.0. Base interface for deployment strategy specifications.
 """
 interface DeploymentStrategySpec {
   strategy: DeploymentStrategyType!
 }
 
 """
-Added in 25.19.0.
-Determines how new revisions of a model deployment are rolled out to replace old ones.
-ROLLING performs incremental replica replacement controlled by max_surge and max_unavailable,
-while BLUE_GREEN provisions a complete new replica set before switching traffic.
+Added in 25.19.0. This enum represents the deployment strategy type of a model deployment, indicating the strategy used for deployment.
 """
 enum DeploymentStrategyType {
   ROLLING
@@ -6918,14 +6899,7 @@ enum RoleStatus {
   DELETED
 }
 
-"""
-Added in 25.19.0.
-Input parameters for configuring a rolling update strategy.
-max_surge sets the maximum number of additional replicas that can be created
-beyond the desired count during an update (default: 1).
-max_unavailable sets the maximum number of replicas that can be unavailable
-during the update (default: 0). At least one of these must be positive.
-"""
+"""Added in 25.19.0. Configuration for rolling update strategy."""
 input RollingUpdateConfigInput {
   maxSurge: Int! = 1
   maxUnavailable: Int! = 0

src/ai/backend/manager/api/gql/deployment/types/policy.py

@@ -22,39 +22,23 @@
 DeploymentStrategyTypeGQL: type[DeploymentStrategy] = strawberry.enum(
     DeploymentStrategy,
     name="DeploymentStrategyType",
-    description=dedent_strip("""
-        Added in 25.19.0.
-        Determines how new revisions of a model deployment are rolled out to replace old ones.
-        ROLLING performs incremental replica replacement controlled by max_surge and max_unavailable,
-        while BLUE_GREEN provisions a complete new replica set before switching traffic.
-    """),
+    description="Added in 25.19.0. This enum represents the deployment strategy type of a model deployment, indicating the strategy used for deployment.",
 )
 
 # ========== Output Types (Response) ==========
 
 
 @strawberry.interface(
     name="DeploymentStrategySpec",
-    description=dedent_strip("""
-        Added in 25.19.0.
-        Base interface for all deployment strategy specifications.
-        Each concrete implementation (RollingUpdateStrategySpec, BlueGreenStrategySpec)
-        carries strategy-specific parameters that control how replica transitions are performed.
-    """),
+    description="Added in 25.19.0. Base interface for deployment strategy specifications.",
 )
 class DeploymentStrategySpecGQL:
     strategy: DeploymentStrategyTypeGQL
 
 
 @strawberry.type(
     name="RollingUpdateStrategySpec",
-    description=dedent_strip("""
-        Added in 25.19.0.
-        Strategy specification for rolling updates.
-        Replicas are replaced incrementally: max_surge controls how many extra replicas
-        can be created above the desired count, and max_unavailable controls how many
-        existing replicas can be taken down simultaneously during the transition.
-    """),
+    description="Added in 25.19.0. Rolling update strategy specification.",
 )
 class RollingUpdateStrategySpecGQL(DeploymentStrategySpecGQL):
     max_surge: int
@@ -63,13 +47,7 @@ class RollingUpdateStrategySpecGQL(DeploymentStrategySpecGQL):
 
 @strawberry.type(
     name="BlueGreenStrategySpec",
-    description=dedent_strip("""
-        Added in 25.19.0.
-        Strategy specification for blue-green deployments.
-        A complete new replica set (green) is provisioned alongside the existing one (blue).
-        When auto_promote is true, traffic is automatically switched to the green set
-        after promote_delay_seconds; otherwise, manual promotion is required.
-    """),
+    description="Added in 25.19.0. Blue-green deployment strategy specification.",
 )
 class BlueGreenStrategySpecGQL(DeploymentStrategySpecGQL):
     auto_promote: bool
@@ -78,14 +56,7 @@ class BlueGreenStrategySpecGQL(DeploymentStrategySpecGQL):
 
 @strawberry.type(
     name="DeploymentPolicy",
-    description=dedent_strip("""
-        Added in 25.19.0.
-        Defines the deployment policy attached to a model deployment,
-        including the rollout strategy (rolling update or blue-green),
-        strategy-specific parameters, and whether to automatically roll back on failure.
-        Each deployment has at most one policy; creating a new policy for the same deployment
-        replaces the existing one (upsert semantics).
-    """),
+    description="Added in 25.19.0. Deployment policy configuration.",
 )
 class DeploymentPolicyGQL(Node):
     id: NodeID[str]
@@ -136,14 +107,7 @@ def from_data(cls, data: DeploymentPolicyData) -> Self:
 
 @strawberry.input(
     name="RollingUpdateConfigInput",
-    description=dedent_strip("""
-        Added in 25.19.0.
-        Input parameters for configuring a rolling update strategy.
-        max_surge sets the maximum number of additional replicas that can be created
-        beyond the desired count during an update (default: 1).
-        max_unavailable sets the maximum number of replicas that can be unavailable
-        during the update (default: 0). At least one of these must be positive.
-    """),
+    description="Added in 25.19.0. Configuration for rolling update strategy.",
 )
 class RollingUpdateConfigInputGQL:
     max_surge: int = 1
@@ -158,13 +122,7 @@ def to_spec(self) -> RollingUpdateSpec:
 
 @strawberry.input(
     name="BlueGreenConfigInput",
-    description=dedent_strip("""
-        Added in 25.19.0.
-        Input parameters for configuring a blue-green deployment strategy.
-        When auto_promote is true, traffic is automatically switched from the blue (old)
-        replica set to the green (new) set after promote_delay_seconds elapse.
-        When auto_promote is false (default), an explicit promotion action is required.
-    """),
+    description="Added in 25.19.0. Configuration for blue-green deployment strategy.",
 )
 class BlueGreenConfigInputGQL:
     auto_promote: bool = False