Update Choreo Connect

Choreo Connect components are available as public Docker images in the MWARE organization in Docker hub, whereas you will be able to find images corresponding to Choreo Connect releases in the relevant repository.

However, if you have a MWARE Subscription, you will be able to use the latest Docker images with updates, which include bug fixes, features, improvements, etc. on top of generally available releases. This documentation is about how you can use these particular updates.

Docker Image Tags

The Docker images related to Choreo Connect updates reside in MWARE private Docker registry and the image tags have the following format for Choreo Connect components.

Component Name Image tag format Example
Router choreo-connect-router:{WSO2_PRODUCT_VERSION}.{UPDATE_LEVEL} choreo-connect-router:1.2.0.1
Enforcer choreo-connect-enforcer:{WSO2_PRODUCT_VERSION}.{UPDATE_LEVEL} choreo-connect-enforcer:1.2.0.1
Adapter choreo-connect-adapter:{WSO2_PRODUCT_VERSION}.{UPDATE_LEVEL} choreo-connect-adapter:1.2.0.1

An example for complete image tag looks like follows.

enforcer:
    image: docker.wso2.com/choreo-connect-enforcer:1.2.0.1

Info

For more details on versioning, refer to the documentation on Docker image tags with Updates 2.0.

You will be able to use the Updates Portal to see more details about these update levels in Docker image tags, which will be covered in the next section.

Updates Portal

Use your subscription details to log in to the Updates Portal via https://updates-info.wso2.com. You will be able to see the information like General description, Implementation details, Impact, Bug fixes, and specific Instructions on each update in the Update Levels section by choosing Choreo Connect as the product and the appropriate product version.

Info

For more information on this, refer to the official documentation for Updates Portal.

Steps to Update

  1. Update the image value for all three components of Choreo Connect in the following files.

    Deployment Option Files to update
    Docker Compose docker-compose.yaml
    Kubernetes adapter-deployment.yaml and choreo-connect-deployment.yaml

    Following is an example on updating Choreo Connect 1.2.0 to update level 9.

    Component Image
    Adapter docker.wso2.com/choreo-connect-adapter:1.2.0.9
    Enforcer docker.wso2.com/choreo-connect-enforcer:1.2.0.9
    Router docker.wso2.com/choreo-connect-enforcer:1.2.0.9

  2. Login to docker.wso2.com.

    docker login docker.wso2.com

  3. Start Choreo Connect with Docker Compose or apply the K8s artifacts.

See also

Top