github.com/projectcontour/contour@v1.28.2/site/content/docs/1.27/config/slow-start.md (about)

     1  # Slow Start Mode
     2  
     3  Slow start mode is a configuration setting that is used to gradually increase the amount of traffic targeted to a newly added upstream endpoint.
     4  By default, the amount of traffic will increase linearly for the duration of time window set by `window` field, starting from 10% of the target load balancing weight and increasing to 100% gradually.
     5  The easing function for the traffic increase can be adjusted by setting optional field `aggression`.
     6  A value above 1.0 results in a more aggressive increase initially, slowing down when nearing the end of the time window.
     7  Value below 1.0 results in slow initial increase, picking up speed when nearing the end of the time window.
     8  Optional field `minWeightPercent` can be set to change the minimum percent of target weight.
     9  It is used to avoid too small new weight, which may cause endpoint to receive no traffic in beginning of the slow start window.
    10  
    11  Slow start mode can be useful for example with JVM based applications, that might otherwise get overwhelmed during JIT warm-up period.
    12  Such applications may respond to requests slowly or return errors immediately after pod start or after container restarts.
    13  User impact of this behavior can be mitigated by using slow start configuration to gradually increase traffic to recently started service endpoints.
    14  
    15  The following example configures slow start mode for a service:
    16  
    17  ```yaml
    18  apiVersion: projectcontour.io/v1
    19  kind: HTTPProxy
    20  metadata:
    21    name: slow-start
    22  spec:
    23    virtualhost:
    24      fqdn: www.example.com
    25    routes:
    26      - services:
    27          - name: java-app
    28            port: 80
    29            slowStartPolicy:
    30              window: 3s
    31              aggression: "1.0"
    32              minWeightPercent: 10
    33  ```
    34  
    35  Slow start mode works only with `RoundRobin` and `WeightedLeastRequest` [load balancing strategies][2].
    36  For more details see [Envoy documentation][1].
    37  
    38  [1]: https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/load_balancing/slow_start
    39  [2]: api/#projectcontour.io/v1.LoadBalancerPolicy