Setting up a Kubernetes environment on Ubuntu
You can use the readily available scripts to set up a microk8s Kubernetes environment along with other configurations to install Rational® Test Automation Server software in the Ubuntu server.
Before you begin
-
You must have completed the tasks provided in the Prerequisites section. See Prerequisites for installing the server software on Ubuntu
-
You must have a static IP address or Domain Name Server (DNS) to resolve host name into a machine-readable IP address.
Procedure
- Log in to the Ubuntu server as a non-root user.
-
Run the following command to retrieve the case from IBM Cloud Pack
repository:
curl -o ibm-rtas-case-1.101.0.tgz https://raw.githubusercontent.com/IBM/cloud-pak/master/repo/case/ibm-rtas-case-1.101.0.tgz
-
Run the following command to extract the case:
tar xvf ibm-rtas-case-1.101.0.tgz
-
Run one of the following two sets of commands to install the Kubernetes
environment:
Note: The second option allows you to override the name of the Kubernetes domain that is created.
-
To install with the default name that is either based on IP address or fully qualified host name, run the following commands:
$ cd ibm-rtas-case/inventory/ibmRtasBase/files $ sudo ./ubuntu-init.sh
-
To install by overriding the default name, run the following commands:
$ cd ibm-rtas-case/inventory/ibmRtasBase/files $ sudo INGRESS_DOMAIN={rtas}.myorg.com ./ubuntu-init.sh
where:- {rtas} is a sub-domain name that you select for the server.
- myorg.com is a domain name of your organization.
On completion of the scripts, the output displays the following information on the command-line interface:
-
The INGRESS_DOMAIN that is in use. This is the URL from where you can access Rational® Test Automation Server login page.
-
The DNS information that the Kubernetes cluster uses to resolve names.
-
Certificate Authority that you must be import into the browser to prevent certificate errors.
-
Instructions to confirm whether the Kubernetes environment has started.
-
Instructions to access Kiali to open product logs. For more information about Kiali dashboards, refer to Related information.
-
-
Perform one of the following to configure a firewall:
-
Run the following script to configure the firewall that allows traffic on cni0 and port 443:
$ sudo ./ubuntu-firewall.sh
-
You must update the firewall that allows traffic on cni0 and port 443, if your Ubuntu server is already configured with the firewall.
-
- Optional:
Run the following command to enable the Jaeger traces for performance and Web
UI tests:
$ ./service.sh expose jaeger
Note:If you do not enable Jaeger, Rational® Test Automation Server produces text output in a microservice log file instead of Jaeger traces, when you run performance and Web UI test assets.
Important:The Jaeger traces are not protected, thus, any information logged into the Jaeger server might be easily accessible by anyone who has or discovers the <server-url>/jaeger URL.
- Optional:
Run the following command to enable the Prometheus server to monitor your
system resources by using metrics data:
$ ./service.sh expose prometheus
Important:The Prometheus metrics are not protected, thus, any information logged into the Prometheus server might be easily accessible by anyone who has or discovers the <server-url>/prometheus URL.
Results
You have set up the Kubernetes environment on Ubuntu and you can now install the server software.
What to do next
-
You must log in again to the server host system after the installation process completes so that changes to the group membership are applied.
-
You can run the
kubectl get pods -A
command to verify that the Kubernetes environment is working. After a while, the status of the pods must be Running state. - You must install the server software. See Installing the server software on Ubuntu using microk8s.