15.4. Configuring ingress cluster traffic using a load balancer

Procedure

1. Create a new project for your service:

   $ oc new-project <project_name>

   Copy to Clipboard Toggle word wrap

   For example:

   $ oc new-project myproject

   Copy to Clipboard Toggle word wrap

2. Use the oc new-app command to create a service. For example:

   $ oc new-app \
       -e MYSQL_USER=admin \
       -e MYSQL_PASSWORD=redhat \
       -e MYSQL_DATABASE=mysqldb \
       registry.redhat.io/rhscl/mysql-80-rhel7

   Copy to Clipboard Toggle word wrap

3. Run the following command to see that the new service is created:

   $ oc get svc -n myproject

   Copy to Clipboard Toggle word wrap

   Example output

   NAME             TYPE        CLUSTER-IP     EXTERNAL-IP   PORT(S)    AGE
   mysql-80-rhel7   ClusterIP   172.30.63.31   <none>        3306/TCP   4m55s

   Copy to Clipboard Toggle word wrap

   By default, the new service does not have an external IP address.

1. Log in to OpenShift Container Platform.

2. Log in to the project where the service you want to expose is located:

   $ oc project myproject

   Copy to Clipboard Toggle word wrap

3. Run the following command to expose the route:

   $ oc expose service <service_name>

   Copy to Clipboard Toggle word wrap

   For example:

   $ oc expose service mysql-80-rhel7

   Copy to Clipboard Toggle word wrap

   Example output

   route "mysql-80-rhel7" exposed

   Copy to Clipboard Toggle word wrap

4. Use a tool, such as cURL, to make sure you can reach the service using the cluster IP address for the service:

   $ curl <pod_ip>:<port>

   Copy to Clipboard Toggle word wrap

   For example:

   $ curl 172.30.131.89:3306

   Copy to Clipboard Toggle word wrap

   The examples in this section uses a MySQL service, which requires a client application. If you get a string of characters with the Got packets out of order message, you are connected to the service.

   If you have a MySQL client, log in with the standard CLI command:

   $ mysql -h 172.30.131.89 -u admin -p

   Copy to Clipboard Toggle word wrap

   Example output

   Enter password:
   Welcome to the MariaDB monitor.  Commands end with ; or \g.
   
   MySQL [(none)]>

   Copy to Clipboard Toggle word wrap

1. Log in to OpenShift Container Platform.

2. Load the project where the service you want to expose is located.

   $ oc project project1

   Copy to Clipboard Toggle word wrap

3. Open a text file on the master node and paste the following text, editing the file as needed:

   Sample load balancer configuration file

   apiVersion: v1
   kind: Service
   metadata:
     name: egress-2 

   1

   
   spec:
     ports:
     - name: db
       port: 3306 

   2

   
     loadBalancerIP:
     type: LoadBalancer 

   3

   
     selector:
       name: mysql 

   4

   Copy to Clipboard Toggle word wrap

   1

   Enter a descriptive name for the load balancer service.

   2

   Enter the same port that the service you want to expose is listening on.

   3

   Enter loadbalancer as the type.

   4

   Enter the name of the service.

4. Save and exit the file.

5. Run the following command to create the service:

   $ oc create -f <file-name>

   Copy to Clipboard Toggle word wrap

   For example:

   $ oc create -f mysql-lb.yaml

   Copy to Clipboard Toggle word wrap

6. Execute the following command to view the new service:

   $ oc get svc

   Copy to Clipboard Toggle word wrap

   Example output

   NAME       TYPE           CLUSTER-IP      EXTERNAL-IP                             PORT(S)          AGE
   egress-2   LoadBalancer   172.30.22.226   ad42f5d8b303045-487804948.example.com   3306:30357/TCP   15m

   Copy to Clipboard Toggle word wrap

   The service has an external IP address automatically assigned if there is a cloud provider enabled.

7. On the master, use a tool, such as cURL, to make sure you can reach the service using the public IP address:

   $ curl <public-ip>:<port>

   Copy to Clipboard Toggle word wrap

   For example:

   $ curl 172.29.121.74:3306

   Copy to Clipboard Toggle word wrap

   The examples in this section use a MySQL service, which requires a client application. If you get a string of characters with the Got packets out of order message, you are connecting with the service:

   If you have a MySQL client, log in with the standard CLI command:

   $ mysql -h 172.30.131.89 -u admin -p

   Copy to Clipboard Toggle word wrap

   Example output

   Enter password:
   Welcome to the MariaDB monitor.  Commands end with ; or \g.
   
   MySQL [(none)]>

   Copy to Clipboard Toggle word wrap