round_robin_test.py

Go to the documentation of this file.

# Copyright 2021 gRPC authors.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
import logging
from typing import List
 
from absl import flags
from absl.testing import absltest
 
from framework import xds_k8s_testcase
 
logger = logging.getLogger(__name__)
flags.adopt_module_key_flags(xds_k8s_testcase)
 
# Type aliases
_XdsTestServer = xds_k8s_testcase.XdsTestServer
_XdsTestClient = xds_k8s_testcase.XdsTestClient
 
 
class RoundRobinTest(xds_k8s_testcase.RegularXdsKubernetesTestCase):
 
    def test_round_robin(self) -> None:
        REPLICA_COUNT = 2
 
        with self.subTest('00_create_health_check'):
            self.td.create_health_check()
 
        with self.subTest('01_create_backend_services'):
            self.td.create_backend_service()
 
        with self.subTest('02_create_url_map'):
            self.td.create_url_map(self.server_xds_host, self.server_xds_port)
 
        with self.subTest('03_create_target_proxy'):
            self.td.create_target_proxy()
 
        with self.subTest('04_create_forwarding_rule'):
            self.td.create_forwarding_rule(self.server_xds_port)
 
        test_servers: List[_XdsTestServer]
        with self.subTest('05_start_test_servers'):
            test_servers = self.startTestServers(replica_count=REPLICA_COUNT)
 
        with self.subTest('06_add_server_backends_to_backend_services'):
            self.setupServerBackends()
 
        test_client: _XdsTestClient
        with self.subTest('07_start_test_client'):
            test_client = self.startTestClient(test_servers[0])
 
        with self.subTest('08_test_client_xds_config_exists'):
            self.assertXdsConfigExists(test_client)
 
        with self.subTest('09_test_server_received_rpcs_from_test_client'):
            self.assertSuccessfulRpcs(test_client)
 
        with self.subTest('10_round_robin'):
            num_rpcs = 100
            expected_rpcs_per_replica = num_rpcs / REPLICA_COUNT
 
            rpcs_by_peer = self.getClientRpcStats(test_client,
                                                  num_rpcs).rpcs_by_peer
            total_requests_received = sum(rpcs_by_peer[x] for x in rpcs_by_peer)
            self.assertEqual(total_requests_received, num_rpcs,
                             'Wrong number of RPCS')
            for server in test_servers:
                pod_name = server.pod_name
                self.assertIn(pod_name, rpcs_by_peer,
                              f'pod {pod_name} did not receive RPCs')
                self.assertLessEqual(
                    abs(rpcs_by_peer[pod_name] - expected_rpcs_per_replica), 1,
                    f'Wrong number of RPCs for {pod_name}')
 
 
if __name__ == '__main__':
    absltest.main(failfast=True)