Rollout

    The component supported for rollout is:

    • webservice
    • worker

    Before using this trait you must enable the addon by this command.

    Apply the Application YAML below which includes a webservice-type workload with Rollout Trait, and control version of component name to be express-server-v1.

    1. cat <<EOF | vela up -f -
    2. apiVersion: core.oam.dev/v1beta1
    3. kind: Application
    4. metadata:
    5.   name: rollout-trait-test
    6. spec:
    7.   components:
    8.     - name: express-server
    9.       type: webservice
    10.       externalRevision: express-server-v1
    11.       properties:
    12.         image: stefanprodan/podinfo:4.0.3
    13.       traits:
    14.         - type: rollout
    15.           properties:
    16.             targetSize: 5
    17.             rolloutBatches:
    18.               - replicas: 2
    19.               - replicas: 3
    20. EOF

    This Rollout Trait has target size of 5 and two rollout batches. The first batch has 2 replicas and second batch has 3. Only after all replicas in the first batch are ready, it will start to rollout the second batch.

    Check the Application status whether the rollout is successful:

    1. $ vela status rollout-trait-test
    2. About:
    4.   Name:         rollout-trait-test
    5.   Namespace:    default
    6.   Created at:   2022-01-12 20:29:50 +0800 CST
    7.   Status:       running
    9. Workflow:
    11.   mode: DAG
    12.   finished: true
    13.   Suspend: false
    14.   Terminated: false
    15.   Steps
    16.   - id:6pnibgonga
    17.     name:express-server
    18.     type:apply-component
    19.     phase:succeeded
    20.     message:
    22. Services:
    24.   - Name: express-server  Env:
    25.     Type: webservice
    26.     healthy Ready:5/5
    27.     Traits:
    28.       - ✅ rollout: rolloutSucceed

    Check the status of Rollout Trait. The rollout is successful only if ROLLING-STATE equals rolloutSucceed, and all replicas are ready only if BATCH-STATE equals batchReady. TARGET, UPGRADED and READY indicates target size of replicas is 5, updated number of replicas is 5 and all 5 replicas are ready.

    1. $ kubectl get rollout express-server
    2. NAME             TARGET   UPGRADED   READY   BATCH-STATE   ROLLING-STATE    AGE
    3. express-server   5        5          5       batchReady    rolloutSucceed   2d20h

    Check Workload Status (Underlying resource behind the workload is )

    1. $ kubectl get deploy -l app.oam.dev/component=express-server
    2. NAME                READY   UP-TO-DATE   AVAILABLE   AGE
    3. express-server-v1   5/5     5            5           2d20h

    Apply the YAML below to modify the image of the container. It will generate a new ControllerRevision.

    1. cat <<EOF | vela up -f -
    2. apiVersion: core.oam.dev/v1beta1
    3. kind: Application
    4. metadata:
    5.   name: rollout-trait-test
    6. spec:
    7.   components:
    8.     - name: express-server
    9.       type: webservice
    10.       externalRevision: express-server-v2
    11.       properties:
    12.         image: stefanprodan/podinfo:5.0.2
    13.       traits:
    14.         - type: rollout
    15.           properties:
    16.             targetSize: 5
    17.             batchPartition: 0
    18.             rolloutBatches:
    19.               - replicas: 2
    20.               - replicas: 3
    21. EOF

    This Rollout Trait represents the target size of replicas is 5 and update will be performed in 2 batches. The first batch will update 2 replicas and the second batch will update 3 replicas. Only 2 replicas in first batch will be updated by setting to 0.

    Check controllerRevision and there is a new controllerRevision express-server-v2.

    1. NAME                CONTROLLER                                    REVISION   AGE
    2. express-server-v1   application.core.oam.dev/rollout-trait-test   1          2d22h
    3. express-server-v2   application.core.oam.dev/rollout-trait-test   2          1m

    Check the status of Rollout Trait after a while when first batch has been upgraded successfully. TARGET, UPGREADED and READY indicates the target size of replicas for this revision is 5, there are 2 replicas sucessfully upgraded and they are ready. batchReady means replicas in the first rolloutBatch are all ready, rollingInBatches means there are batches still yet to be upgraded.

    1. $ kubectl get rollout express-server
    2. NAME             TARGET   UPGRADED   READY   BATCH-STATE   ROLLING-STATE    AGE
    3. express-server   5        2          2       batchReady   rollingInBatches  2d20h

    Check Workload status to verify, we can see there are 2 replicas of new Workload express-server-v2 have been upgraded and old version of Workload express-server-v1 still has 3 replicas.

    1. $ kubectl get deploy -l app.oam.dev/component=express-server
    2. NAME                READY   UP-TO-DATE   AVAILABLE   AGE
    3. express-server-v1   3/3     3            3           2d20h
    4. express-server-v2   2/2     2            2           1m

    Check Rollout Trait, we can see rollout is succeed.

    1. $ kubectl get rollout express-server
    2. NAME             TARGET   UPGRADED   READY   BATCH-STATE   ROLLING-STATE    AGE
    3. express-server   5        5           5       batchReady   rolloutSucceed  2d20h

    Check Workload status, all replicas of Workload has been upgraded to a new revision and old workload has been deleted.

    1. $ kubectl get deploy -l app.oam.dev/component=express-server
    2. NAME                READY   UP-TO-DATE   AVAILABLE   AGE
    3. express-server-v2   5/5     5            5           1m

    Apply the YAML below to make controllerRevision roll back to express-server-v1 by assigning targetRevision field to express-server-v1 in Rollout Trait.

    1. cat <<EOF | vela up -f -
    2. apiVersion: core.oam.dev/v1beta1
    3. kind: Application
    4. metadata:
    5.   name: rollout-trait-test
    6. spec:
    7.   components:
    8.     - name: express-server
    9.       type: webservice
    10.       externalRevision: express-server-v2
    11.       properties:
    12.         image: stefanprodan/podinfo:5.0.2
    13.       traits:
    14.         - type: rollout
    15.           properties:
    16.             targetRevision: express-server-v1
    17.             targetSize: 5
    18.             rolloutBatches:
    19.               - replicas: 2
    20.               - replicas: 3
    21. EOF

    Check Rollout Trait status after rollback has been succeed.

    1. $ kubectl get rollout express-server
    2. NAME             TARGET   UPGRADED   READY   BATCH-STATE   ROLLING-STATE    AGE
    3. express-server   5        5          5       batchReady    rolloutSucceed  2d20h

    Check Workload status, we can see Workload has rolled back to express-server-v1.

    1. $ kubectl get deploy -l app.oam.dev/component=express-server
    2. NAME                READY   UP-TO-DATE   AVAILABLE   AGE
    3. express-server-v1   5/5     5            5           15s

    Rollout Trait also be able to scale up a Workload, apply the YAML below to modify the targetSize, in order to increase the number of replicas from 5 to 7.

    1. cat <<EOF | vela up -f -
    2. apiVersion: core.oam.dev/v1beta1
    3. kind: Application
    4. metadata:
    5.   name: rollout-trait-test
    6. spec:
    7.   components:
    8.     - name: express-server
    9.       type: webservice
    10.       externalRevision: express-server-v2
    11.       properties:
    12.         image: stefanprodan/podinfo:5.0.2
    13.       traits:
    14.         - type: rollout
    15.           properties:
    16.             targetRevision: express-server-v1
    17.             targetSize: 7
    18. EOF

    This Rollout Trait represents it will scale workload up to 7. You also can set every batch’s number by setting rolloutBatches.

    danger

    A known issue exists if you scale up/down the workload twice or more times by not setting the rolloutBatches.So please set the rolloutBatches when scale up/down.

    Check the status after expansion has been succeed.

    1. $ kubectl get rollout express-server
    2. NAME             TARGET   UPGRADED   READY   BATCH-STATE   ROLLING-STATE    AGE
    3. express-server   7        7          7       batchReady    rolloutSucceed   2d20h
    5. $ kubectl get deploy -l app.oam.dev/component=express-server
    6. NAME                READY   UP-TO-DATE   AVAILABLE   AGE
    7. express-server-v1   7/7     7            7           2m

    Apply the YAML below to scale down the size of replicas from 7 to 3.

    1. cat <<EOF | vela up -f -
    2. apiVersion: core.oam.dev/v1beta1
    3. kind: Application
    4. metadata:
    6. spec:
    7.   components:
    8.     - name: express-server
    9.       type: webservice
    10.       properties:
    11.         image: stefanprodan/podinfo:5.0.2
    12.       traits:
    13.         - type: rollout
    14.           properties:
    15.             targetRevision: express-server-v1
    16.             targetSize: 5
    17. EOF

    This Rollout Trait scale workload down to 5.

    You need to enable kruise addon。

    1. $ vela addon enable kruise

    Check types of components.

    1. $ vela components
    2. NAME                NAMESPACE        WORKLOAD                        DESCRIPTION
    3. cloneset           vela-system     clonesets.apps.kruise.io

    Apply the YAML below to create an Application, this Application includes a Workload of type cloneset with a Rollout Trait.

    1. cat <<EOF | vela up -f -
    2. apiVersion: core.oam.dev/v1beta1
    3. kind: Application
    4. metadata:
    5.   name: rollout-trait-test-cloneset
    6. spec:
    7.   components:
    8.     - name: cloneset-server
    9.       type: cloneset
    10.       externalRevision: cloneset-server-v1
    11.       properties:
    12.         image: stefanprodan/podinfo:4.0.3
    13.       traits:
    14.         - type: rollout
    15.           properties:
    16.             targetSize: 5
    17.             rolloutBatches:
    18.               - replicas: 2
    19.               - replicas: 3
    20. EOF

    Check the status of related resources.

    1. $ kubectl get app rollout-trait-test-cloneset
    2. NAME                              COMPONENT         TYPE               PHASE      HEALTHY   STATUS     AGE
    3. rollout-trait-test-cloneset        cloneset   clonesetservice          running      true               4m18s
    5. $ kubectl get controllerRevision  -l controller.oam.dev/component=cloneset-server
    6. NAME                CONTROLLER                                           REVISION   AGE
    7. cloneset-server-v1   application.core.oam.dev/rollout-trait-test-cloneset   1          4m45s
    9. $ kubectl get rollout cloneset-server
    10. NAME             TARGET   UPGRADED   READY   BATCH-STATE   ROLLING-STATE    AGE
    11. cloneset-server   5        5          5       batchReady    rolloutSucceed   5m10s

    Check the status of Workload. As cloneset Workload supports in-place upgrade, the most noticeable difference between it and webservice/worker is that the name of underlying Workload’s name is exactly the component’s name.

    1. $ kubectl get cloneset -l app.oam.dev/component=cloneset-server
    2. NAME             DESIRED   UPDATED   UPDATED_READY   READY   TOTAL   AGE
    3. cloneset-server   5         5         5               5       5       7m3s

    Check the image.

    1. $ kubectl get cloneset cloneset-server -o=jsonpath='{.spec.template.spec.containers[0].image}'
    2. stefanprodan/podinfo:4.0.3

    Apply the YAML below to upgrade the image.

    1. cat <<EOF | vela up -f -
    2. apiVersion: core.oam.dev/v1beta1
    3. kind: Application
    4. metadata:
    5.   name: rollout-trait-test-cloneset
    6. spec:
    7.   components:
    8.     - name: cloneset-server
    9.       type: cloneset
    10.       externalRevision: cloneset-server-v2
    11.       properties:
    12.         image: stefanprodan/podinfo:5.0.2
    13.       traits:
    14.         - type: rollout
    15.           properties:
    16.             targetSize: 5
    17.             rolloutBatches:
    18.               - replicas: 2
    19.               - replicas: 3
    20. EOF

    Check the status of related resources after upgrade has been succeed.

    1. $ kubectl get controllerRevision  -l controller.oam.dev/component=cloneset-server
    2. NAME                CONTROLLER                                             REVISION    AGE
    3. cloneset-server-v1   application.core.oam.dev/rollout-trait-test-cloneset    1          6m43s
    4. cloneset-server-v2   application.core.oam.dev/rollout-trait-test-clonesett   2          108s
    6. $ kubectl get rollout cloneset-server
    7. NAME             TARGET   UPGRADED   READY   BATCH-STATE   ROLLING-STATE    AGE
    8. cloneset-server  5        5          5       batchReady    rolloutSucceed   6m10s

    Check the status of the Workload, we can see the name after upgrade is still cloneset-server.

    Verify the rollout by checking the image.

    1. $ kubectl get cloneset cloneset-server -o=jsonpath='{.spec.template.spec.containers[0].image}'

    Other operations such as Scale up, Scale down, Rollback are the same as the operations on webservice/worker.

    Rollout Trait supports following workload types: webservice,worker and cloneset.