Apigee hybrid supports two kinds of updates. The first is anin-place update where you apply a configuration change and hybrid begins a Kubernetesrolling update. In Kubernetes, rolling updates allow Deployment updates to take place with zero downtime by incrementally updating Pod instances with new ones.

Apigee hybrid also supports a canary or AB-style update. In an AB update, the new revision is deployed; however, at first a small percentage of traffic is directed to it. Over time, this percentage increases until all of the traffic goes to the revision.

In-place updates

To trigger an in-place update, simply modify the desired settings in the overrides file and apply it to the cluster. For example, suppose you want to change the currentruntime memory from 1Gi to 5Gi:

Here is the initial configuration:

...runtime:  replicaCountMin: 2  replicaCountMax: 20  resources:    requests:      cpu: 1000m      memory: 1Gi...

In the new configuration, memory is changed to 5Gi:

...runtime:  replicaCountMin: 2  replicaCountMax: 20  resources:    requests:      cpu: 1000m      memory: 5Gi...

When you apply the change, the updated pods start up and replace the existing pods. Because of the Kubernetes rolling update feature, clients do not experience any downtime.

How to perform an AB update

To perform an AB update, use therevision tag in your overrides file. For example, suppose you want to change the currentruntime memory from 1Gi to 5Gi:

In the current configuration,revision is set toblue:

...revision: blue...runtime:  replicaCountMin: 2  replicaCountMax: 20  resources:    requests:      cpu: 1000m      memory: 1Gi...

In the new configuration, if you changerevision togreen, you signal that you want to perform a rolling update when the change is applied. The value you setrevision to does not matter; you can use any string you wish, as long as you change it from the previous value to something else.

...revision: green...runtime:  replicaCountMin: 2  replicaCountMax: 20  resources:    requests:      cpu: 1000m      memory: 5Gi...

When you apply the change, a small percentage of traffic to the new revision. Over time, more traffic goes to the new revision until it reaches 100%. At that time, the old revisionis deleted.

To trigger an AB rollout, either add therevision tag if it is not present, or change the value of therevision tag if it is already present. You are not required to make any other changes to the overrides file to trigger an AB rollout.

The following table the schedule of an AB rollout:

In the current release, the percentages and wait times are not configurable.