Deploy WebRTC

From Genesys Documentation
Revision as of 17:39, June 30, 2021 by Lakshmi.krishnamurthy@genesys.com (talk | contribs) (Published)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
This topic is part of the manual WebRTC Private Edition Guide for version Current of WebRTC.

Learn how to deploy WebRTC.

Important
Make sure to review Before you begin for the full list of prerequisites required to deploy WebRTC.
WebRTC uses blue-green model of deployment. It has the following main deployment principles:
  • Both components - WebRTC Gateway and CoTurn Server - are deployed for each color and switched together
  • Blue WebRTC Gateway is always configured to work with Blue CoTurn and green WebRTC Gateway is always configured to work with green CoTurn
  • WebRTC have two FQDNs to reach active and inactive deployments:
    • webrtc.domain.com - active deployment. For example: webrtc.genesyshtcc.com
    • webrtc-test.domain.com - inactive deployment for tests. For example: webrtc-test.genesyshtcc.com

You can deploy WebRTC using:

  • Internal CoTurn Load Balancer or
  • External CoTurn Load Balancer

Deploying WebRTC using internal CoTurn Load Balancer

Initial deployment and Upgrade use the same sequence:

  1. Deploy/upgrade inactive color of deployment
  2. Make the cutover

You need to deploy the Color Infra package with CoTurn Load Balancer to get the IP address assigned automatically for the CoTurn Load Balancer by the infrastructure. Then, the infrastructure team should assign the IP to the CoTurn Load Balancer, create the FQDN for the IP and ensure that the IP is set in the firewall and is available from outside the cluster.

Important
The IP address assigned to the CoTurn Load Balancer must be external and available outside the cluster. Else, the media will not get through the WebRTC.

The following image shows the steps involved in deploying WebRTC using the internal CoTurn Load Balancer:

WebRTC-Internal-Deployment.png

Follow the below steps to deploy WebRTC using internal CoTurn Load Balancer:

  1. Create common infrastructure elements such as dashboards and alarms: This step deploys dashboards, alarms, and other common infrastructure elements.
    Important
    You should perform this step even if you do not require the dashboard and alarms.
    Run the following command to create the common infrastructure elements:
    helm upgrade --install -f {Webrtc Values files} --set-string deployment.type=infra --set-string deployment.color="" webrtc-infra {HelmRepoPath}/webrtc-service --version={WebRTC Charts Version}
    Example:
    helm upgrade --install -f ./k8s/values.yaml --set-string deployment.type=infra --set-string deployment.color="" webrtc-infra wrtchelmrepodevwestus2/webrtc-service --version=0.1.93 -n webrtc
  2. Create infrastructure elements for the deployment color: This step deploys the infrastructure objects such as Turn Load Balancer, Gateway Service Object, Gateway Network Policies, and Turn Network Policies for the given color of deployment.
    You should also specify the INACTIVE color of deployment in this step.
    Important
    You should configure the deployment.coturnDeployment option with the value internal in your values.yaml file.
    Run the following command to deploy the infrastructure objects:
    helm upgrade --install -f {Webrtc Values files} --set-string deployment.type=infra --set-string deployment.color={INACTIVE_COLOR} webrtc-infra-{INACTIVE_COLOR} {HelmRepoPath }/webrtc-service --version={WebRTC Charts Version}
    Example:
    helm upgrade --install -f ./k8s/values.yaml --set-string deployment.type=infra --set-string deployment.color=blue webrtc-infra-blue wrtchelmrepodevwestus2/webrtc-service --version=0.1.93 -n webrtc
  3. Get the IPs from the CoTurn Load Balancers, create DNS records and firewall rules: This step gets the IP address from the Colurn Load Balancer created in Step 2. The name of LoadBalancer will be similar to: webrtc-coturn-service-{COLOR}.
    Create appropriate FQDN for this IP address in your DNS. This FQDN will be used by the WebRTC agents from outside the cluster to establish the RTP stream. Though you can use the IP address as it is, it is not the best practice to do so.
  4. Create CoTurn elements for the deployment color: This step is to Upgrade/Deploy CoTurn for INACTIVE color.
    Run the following command to upgrade/deploy the INACTIVE color of deployment:
    helm upgrade --install -f {Webrtc Values files} --set-string deployment.type=coturn --set-string deployment.color={INACTIVE_COLOR} webrtc-coturn-{INACTIVE_COLOR} {HelmRepoPath }/webrtc-service --version={WebRTC Charts Version}
    Example:
    helm upgrade --install -f ./k8s/values.yaml --set-string deployment.type=coturn --set-string deployment.color=blue webrtc-coturn-blue wrtchelmrepodevwestus2/webrtc-service --version=0.1.93 -n webrtc
  5. Create Gateway elements for deployment color using the information from Step 3: This step is to Upgrade/Deploy Gateway for INACTIVE color. You shoud also specify the extenal FQDN of the CoTurn LoadBalancer in this step using the gateway.turnExternalUriBlue or gateway.turnExternalUriGreen options.
    Run the following command:
    helm upgrade --install -f {Webrtc Values files} --set-string deployment.type=gateway --set-string deployment.color={INACTIVE_COLOR} --set-string gateway.turnExternalUri{INACTIVE_COLOR}={COTURN FQDN INACTIVE_COLOR} webrtc-gateway-{INACTIVE_COLOR} {HelmRepoPath }/webrtc-service --version={WebRTC Charts Version}
    Example for Blue deployment:
    helm upgrade --install -f ./k8s/values.yaml--set-string deployment.type=gateway --set-string deployment.color=blue --set-string gateway.turnExternalUriBlue=turn-blue.ext.mydoamin.com  webrtc-gateway-blue wrtchelmrepodevwestus2/webrtc-service --version=0.1.93 -n webrtc
    Or, you can specify the IP of the Blue CoTurn Load Balancer
    helm upgrade --install -f ./k8s/values.yaml--set-string deployment.type=gateway --set-string deployment.color=blue --set-string gateway.turnExternalUriBlue=12.106.34.55  webrtc-gateway-blue wrtchelmrepodevwestus2/webrtc-service --version=0.1.93 -n webrtc
  6. Create/update Ingress controller rules for Active/Inactive routing for Gateway deployments: This step is to Install/upgrade ingress without changing the active color. The same step is used for the Cutover.
    Important
    If you are deploying/upgrading green, specify the current ACTIVE color of deployment in the deployment.color option. Then specify blue and vice versa. If you deploying/upgrading green and specify green for the cutover step, the current active deployment will be switched to the just deployed/upgraded green.
    You must perform this step even if you are not planning to make the cutover right now. This step is to upgrade the ingress and environment.
    Run the following command to create/upgrade Ingress controller rules:
    helm upgrade --install -f {Webrtc Values files} --set-string deployment.type=cutover --set-string deployment.color={ACTIVE_COLOR} webrtc-ingress {HelmRepoPath }/webrtc-service --version={WebRTC Charts Version}
    Example:
    helm upgrade --install -f ./k8s/values.yaml --set-string deployment.type=cutover --set-string deployment.color=green webrtc-ingress wrtchelmrepodevwestus2/webrtc-service --version=0.1.93 -n webrtc

Deployment with external CoTurn Load Balancer

Initial deployment and Upgrade use the same sequence:

  1. Deploy/upgrade inactive color of deployment
  2. Make the cutover

The following image shows the steps involved in deploying WebRTC using the external CoTurn Load Balancer:

WebRTC-External-Deployment-1.png

Follow the below steps to deploy WebRTC with external CoTurn Load Balancer

  1. Create static IPs for CoTurn: This step is to specify the pre-created public IP for CoTurn Green in the coturn.lbIpGreen option and public IP for CoTurn Blue in the coturn.lbIpBlue option.
  2. Create DNS records for the created IPs: This step is to specify the public FQDNs for CoTurn. Specify the pre-created public FQDN for CoTurn Green in the gateway.turnExternalUriGreen option and public FQDN for CoTurn Blue in the gateway.turnExternalUriBlue option.
  3. Create common infrastructure elements: This step will deploy Persistent Volumes, Persistent Volume Claims, dashboards, alarms, and other common infrastructure elements.
    Important
    You need to run this step even if you are not using the dashboard and alarms.
    Run the following command to create the infrastructure elements:
    helm upgrade --install -f {Webrtc Values files} --set-string deployment.type=infra --set-string deployment.color="" webrtc-infra {HelmRepoPath}/webrtc-service --version={WebRTC Charts Version}
    Example:
    helm upgrade --install -f ./k8s/values.yaml --set-string deployment.type=infra --set-string deployment.color="" webrtc-infra wrtchelmrepodevwestus2/webrtc-service --version=0.1.93 -n webrtc
  4. Create infrastructure elements for deployment color: This step is to deploy the infrastructure objects such as Turn Load Balancer, Gateway Service Object, Gateway Network Policies, and Turn Network Policies for the given color of deployment.
    You must specify INACTIVE color of deployment for this step.
    Important
    Configure the deployment.coturnDeployment option with the value external in your values.yaml file.
    Run the following command to create the infrastructure elements:
    helm upgrade --install -f {Webrtc Values files} --set-string deployment.type=infra --set-string deployment.color={INACTIVE_COLOR} webrtc-infra-{INACTIVE_COLOR} {HelmRepoPath }/webrtc-service --version={WebRTC Charts Version}
    Example:
    helm upgrade --install -f ./k8s/values.yaml --set-string deployment.type=infra --set-string deployment.color=blue webrtc-infra-blue wrtchelmrepodevwestus2/webrtc-service --version=0.1.93 -n webrtc
  5. Create CoTurn elements for deployment color: This step is to upgrade/deploy CoTurn for inactive color.
    Run the following command to specify the INACTIVE color of deployment:
    helm upgrade --install -f {Webrtc Values files} --set-string deployment.type=coturn --set-string deployment.color={INACTIVE_COLOR} webrtc-coturn-{INACTIVE_COLOR} {HelmRepoPath }/webrtc-service --version={WebRTC Charts Version}
    Example:
    helm upgrade --install -f ./k8s/values.yaml --set-string deployment.type=coturn --set-string deployment.color=blue webrtc-coturn-blue wrtchelmrepodevwestus2/webrtc-service --version=0.1.93 -n webrtc
  6. Create Gateway elements for deployment color: This step is to upgrade/deploy the Gateway for inactive color.
    Important
    CoTurn DNS name is used for Gateway deployment as a parameter in the corresponding values.yaml file.
    Run the following command to specify the INACTIVE color of deployment:
    helm upgrade --install -f {Webrtc Values files} --set-string deployment.type=gateway --set-string deployment.color={INACTIVE_COLOR} webrtc-gateway-{INACTIVE_COLOR} {HelmRepoPath }/webrtc-service --version={WebRTC Charts Version}
    Example:
    helm upgrade --install -f ./k8s/values.yaml--set-string deployment.type=gateway --set-string deployment.color=blue webrtc-gateway-blue wrtchelmrepodevwestus2/webrtc-service --version=0.1.93 -n webrtc
  7. Create/update Ingress controller rules for Active/Inactive routing for the Gateway deployments: This step is to install/upgrade ingress without changing the active color. The sampe step is also used for the Cutover.
    Important
    If you are deploying/upgrading green, specify the current ACTIVE color of deployment in the deployment.color option which is blue and vice versa. If you deploying/upgrading green and specify green for the cutover step, the current active deployment will be switched to the just deployed/upgraded green.
    Important
    You must perform this step even if you do not plan to make cutover right now. This step is to upgrade the ingress and environment.
    Run the following command to create/upgrade Ingress controller rules:
    helm upgrade --install -f {Webrtc Values files} --set-string deployment.type=cutover --set-string deployment.color={ACTIVE_COLOR} webrtc-ingress {HelmRepoPath }/webrtc-service --version={WebRTC Charts Version}
    Example:
    helm upgrade --install -f ./k8s/values.yaml --set-string deployment.type=cutover --set-string deployment.color=green webrtc-ingress wrtchelmrepodevwestus2/webrtc-service --version=0.1.93 -n webrtc

Cutover

During cutover, it switches active color of deployment. This step should be performed only after you confirm that the newly installed/upgraded deployment is alive and functional. You must specify the current INACTIVE color of deployment in the deployment.color option - deployment that was just deployed/upgraded and tested. Run the following command to specify the cutover: 

helm upgrade --install -f {Webrtc Values files} --set-string deployment.type=cutover --set-string deployment.color={INACTIVE_COLOR} webrtc-ingress {HelmRepoPath }/webrtc-service --version={WebRTC Charts Version}

Example: 

helm upgrade --install -f ./k8s/values.yaml --set-string deployment.type=cutover --set-string deployment.color=blue webrtc-ingress wrtchelmrepodevwestus2/webrtc-service --version=0.1.93 -n webrtc

Deploy in OpenShift

You need to use PersistentVolume and PersistentVolumeClaim instead of HostPath logs of Gateway pods and CoTurn Pods.

Validate the deployment in OpenShift

Content coming soon
Retrieved from "https://all.docs.genesys.com/WebRTC/Current/WebRTCPEGuide/Deploy (2025-06-22 06:24:28)"
Comments or questions about this documentation? Contact us for support!