Install the TimesTen Operator

A TimesTen container image contains the TimesTen YAML manifest file and Helm chart for installing the TimesTen Kubernetes Operator (TimesTen Operator). To find out how to obtain TimesTen YAML manifest files and Helm charts, see Part 3: Obtain TimesTen YAML Manifest Files and Helm Charts.

The installation process consists of the following steps:

• Install the service account for the TimesTen Operator: The TimesTen Operator requires a service account, a role, and a role binding to run properly. The service account requires a set of defined privileges and permissions, which are granted through a role. A role binding assigns a role to a service account. TimesTen provides the service_account.yaml file in its container image that defines the role binding, role, and service account for the TimesTen Operator.

• Modify the operator.yaml file with your customizations. For this example, the modifications are as follows:

  • image: Replace container-registry.oracle.com/timesten/timesten:latest with your container image. This example changes the image to container-registry.oracle.com/timesten/timesten:22.1.1.27.0.

  • imagePullSecrets: Replace sekret with the name of your image pull secret. This example does not change the name of the image pull secret.

Let's install the TimesTen Operator.

1. Change to the directory that contains the YAML manifest files. In this example, the kube_files/deploy contains the files.

   cd kube_files/deploy

2. Install the service account.

   kubectl create -f service_account.yaml

   The output is similar to the following:

   role.rbac.authorization.k8s.io/timesten-operator created
   serviceaccount/timesten-operator created
   rolebinding.rbac.authorization.k8s.io/timesten-operator created

3. To modify the operator.yaml file, do the following:
   1. Use a text editor to modify the operator.yaml file.

      Replace the following:

      • image: Replace container-registry.oracle.com/timesten/timesten:latest with the name of your image. In this example, the name of the image is container-registry.oracle.com/timesten/timesten:22.1.1.27.0.

      • imagePullSecrets: Replace sekret with the name of your image pull secret. In this example, the name of the image pull secret is sekret.

      vi operator.yaml
      
      # Copyright (c) 2019 - 2024, Oracle and/or its affiliates.
      apiVersion: apps/v1
      kind: Deployment
      metadata:
        name: timesten-operator
      spec:
        replicas: 1
      ...
          spec:
            serviceAccountName: timesten-operator
            imagePullSecrets:
            - name: sekret
            containers:
              - name: timesten-operator
                image: container-registry.oracle.com/timesten/timesten:22.1.1.27.0

   2. Save and close the operator.yaml file.
4. Install the TimesTen Operator.

   kubectl create -f operator.yaml

5. Verify the TimesTen Operator is running.

   kubectl get pods

   The output is similar to the following:

   NAME                                 READY   STATUS    RESTARTS   AGE
   timesten-operator-545d5f7fdb-xbdfw   1/1     Running   0          27s

Congratulations! You successfully installed the TimesTen Operator in your namespace. It is up and running. You are now ready to create TimesTen databases. See Create TimesTen Classic Databases.