Configuring External Load Balancer for GCP

Applies to: Kyvos Enterprise Kyvos Cloud (SaaS on AWS) Kyvos AWS Marketplace

Kyvos Azure Marketplace Kyvos GCP Marketplace Kyvos Single Node Installation (Kyvos SNI)

This section details how to configure an external load balancer for Kyvos on Google Cloud Platform (GCP) to route user traffic to Kyvos services and ensure high availability and reliable access to the Kyvos environment.

Note

While configuring an external load balancer for GCP, ensure that the frontend and backend certificates are in the same format.

Prerequisites

Reserve a static IP address for the load balancer. See Google documentation for more details.
Create a Proxy-only subnet in the VPC you are using. See Google documentation for more details.

Firewall Rules

Rule to allow Google health check to the Virtual Machine.
1. Target: Service Account which is used by Kyvos VMs
2. Source IP Ranges: 35.191.0.0/16, 130.211.0.0/22
3. Protocol: TCP ports 8443 and 9443
  For TLS Port, use 8443 and 9443. For non-TLS ports, use 8081 and 8080
Rule to allow access to selected ports from load balancer to Virtual Machine Target:
1. Service Account which is used by Kyvos VMs
2. Source IP Ranges: CIDR of the Proxy only Subnet
3. Protocol: tcp ports: 8443 and 9443 (TLS Ports). For non-TLS ports, use 8081 and 8080

Note:

Without source filter as Proxy-only subnet you will get the upstream request timeout while browsing the Application Load Balancer URL.

Creating and configuring a load balancer

Creating instance group

Select the preferred project.
Create an instance group. To do this, search Instance Group in the Search box. The Instance groups page is displayed. On the page, click the Create Instance Group option.
Click New unmanaged instance group.
On the page, provide the following details:
1. Type a Name to your instance group. For example, kyvos-instancegroup.
2. From the Network and Instances list, select the Networks shared with me option.
3. From the shared subnetwork list, select the required option.
4. From the VM Instances list, select the VMs on which you want to use this backend service.
  You must select the VMs used for the Kyvos Webserver node.
  For Kyvos reporting node deployment, select Kyvos Reporting
5. In the Port Mapping area, click Add Port.
  1. Port name as km-https and Port number as 9443
  2. Port name as kyvos-https and Port number as 8443
    NOTE: For TLS Ports, use 8443 and 9443. For non-TLS ports, use 8081 and 8080
Click Create. The Instance group has created.

Creating a load balancer

Select the preferred project.
On the Search bar, type load balancing and select it. The Load Balancing page is displayed.
On the Load balancing page, click Create Load Balancer.
In the Create a load balancer section, click the Application Load Balancing option. It is selected by default.
Click Next. In the Public facing or Internal section, select the Public facing option. It is selected by default. Click Next.
In the Global or Single region deployment section, select the Best for regional workloads (single region) option. Click Next.
The Create a load balancer section is displayed.
Click Configure. The Create global external Application Load Balancer page is displayed.
Click Frontend Configuration.
1. Provide a name to the frontend configuration, such as frontendwebserverhttps.
2. In the Protocol list, select the HTTPS option.
  NOTE: For non-TLS, select HTTP.
3. Select IP version as IPv4 and IP Address as Ephemeral.
4. Enter port as 443
5. From the Certificate list, select the appropriate option.
Click Done. The Backend configuration section is displayed.
Click Create a Backend Service.
For Kyvos Manager: Provide a Name to create a backend service—for example, backendservicekmhttps.
1. Backend Type: Instance Group
2. Protocol: For TLS, use HTTPS. For non-TLS, use HTTP.
3. Use the default value for Timeout.
4. Named Port: km-https
For Kyvos: Provide a Name to create a backend service—for example, backendservicekyvoshttps.
1. Backend Type: Instance Group
2. Protocol: For TLS, use HTTPS. For non-TLS, use HTTP.
3. Instance Group that you have created.
4. Named Port: kyvos-https
5. Click Use Selected Named Port. The Port for that instance group will be auto-populated.
Scroll down and click Advanced configurations.
In the Health check section, click the Create a Health Check option.
1. For Kyvos Manager: Provide a Name, such as kyvosmanagerhealthcheck.
  1. Path: /kyvosmanager/
  2. Protocol: For TLS, use HTTPS. For non-TLS, use HTTP.
  3. Port: 9443
    For TLS ports, use 9443. For non-TLS ports, use 8080.
2. For Kyvos: Provide a Name, such as kyvoshealthcheck.
  1. Path: /kyvos/
  2. Protocol: For TLS, use HTTPS. For non-TLS, use HTTP.
  3. Port: 8443
    For TLS ports, use 8443. For non-TLS ports, use 8081.
Click the Save button.
Scroll down and expand the Advanced Configurations section, and then select the Client IP option from the Session Affinity list and click Create.
Provide a Name, such as httpskyvoswebserver. Click Create. The Backend Configuration is completed.
Click Routing Rules and enter Host and Path rules.
Click Review and Finalize.
After reviewing the fields, click Create.
The load balancer is created with requisite configurations.

HTTP Status 429 – Too Many Requests