Instalación de IBM Transformation Advisor

Instalar Red Hat OpenShift Container Platform

Configurar almacenamiento

Añadir el catálogo de operadores IBM

Transformation Advisor 2.4 + sólo está disponible en el catálogo de operadores IBM. Para obtener más información sobre cómo actualizar de 2.3 a 2.4, consulte Actualización.

Consulte la documentación Añadir el catálogo de operadores IBM.

Elija el modo de instalación

Transformation Advisor admite dos modos de instalación:

• Todos los espacios de nombres del clúster (por defecto) El operador estará disponible en todos los espacios de nombres.

• Un espacio de nombres específico del clúster sólo estará disponible en un único espacio de nombres.

En función de la modalidad de instalación elegida, tendrá que realizar distintas tareas de instalación como administrador del clúster. Consulte Tareas de administración de clúster.

Todos los espacios de nombres frente a los espacios de nombres

Una instalación de operador de TA con todos los espacios de nombres permite múltiples instancias de TA, cada una accesible a través de una URL única. Sin embargo, este enfoque podría comprometer la seguridad y hacer más compleja la gestión debido a los espacios de nombres compartidos.

Por otro lado, una instalación con espacios de nombres ofrece mayor seguridad y aislamiento al segregar las instancias de TA en espacios de nombres individuales. Esto puede ser especialmente beneficioso en entornos con permisos restringidos para el espacio de nombres ' openshift-operators '.

El enfoque óptimo depende de sus requisitos específicos y de las consideraciones de seguridad. Si necesita un aislamiento estricto y un control detallado, se recomienda una instalación namespaced. Para configuraciones más sencillas y con menos problemas de seguridad, puede bastar con una instalación de todos los espacios de nombres.

En general, estas son las ventajas de los dos enfoques:

All-Namespaces Install:
Benefits of an All-Namespaces Install:

- Broader Cluster Integration: In an all-namespaces install, the OpenShift components are deployed across multiple namespaces, which can provide better integration with other applications and services running on the same cluster.
- Simplified Deployment: The all-namespaces approach can be simpler to set up, as it does not require the same level of namespace-specific configuration and resource management.
- Shared Resource Utilization: With an all-namespaces install, the OpenShift components can share resources more freely across the entire cluster, potentially resulting in more efficient resource utilization.
- Easier Cluster-wide Management: From an administrative perspective, managing the OpenShift components in an all-namespaces install may be more straightforward, as they are integrated into the broader cluster.

Namespaced Install:
Benefits of a Namespaced Install:

- Isolation and Scoping: In a namespaced install, the OpenShift components are installed within a specific namespace, which helps isolate them from other applications or services running on the same cluster. This provides better security and resource management, as the OpenShift components are confined to their own namespace.
- Reduced Resource Consumption: Since the OpenShift components are confined to a specific namespace, they only consume resources within that namespace, which can be more efficient compared to an all-namespaces installation.
- Customization and Flexibility: With a namespaced install, you have more flexibility to customize the installation, configure resources, and manage the OpenShift components independently from the rest of the cluster.
- Easier Maintenance and Upgrades: Performing upgrades or maintenance tasks on the OpenShift components is generally simpler and more manageable in a namespaced install, as the changes are scoped to a specific namespace.
 

Realizar tareas de administración del clúster

Tareas de administración de clúster para una instalación de operador de todos los espacios de nombres

Tareas de administración de clúster para una instalación de operador de espacio de nombres único

El administrador del clúster debe realizar las tareas siguientes:

1. Cree un proyecto para el operador y la instancia.

   Esto se puede realizar desde la interfaz de usuario de OpenShift de la siguiente manera:

   a. Haga clic en el icono de hamburguesa del panel Red Hat OpenShift Container Platform.

   b. Despliegue el menú Inicio y seleccione Proyectos.

   c. Haga clic en Crear proyecto.

   d. Asigne un nombre al proyecto y pulse Crear.

   De forma alternativa, puede utilizar el mandato oc new-project NAMESPACE_PLACEHOLDER desde la línea de mandatos, donde NAMESPACE_PLACEHOLDER se sustituye por el nombre real del proyecto que desea crear.

2. Configurar el control de acceso basado en roles (RBAC) para el operador.

   El YAML de esta sección crea un recurso ServiceAccount, OperatorGroup, Role, RoleBinding, ClusterRole y ClusterRoleBinding , que juntos configuran RBAC para el operador. Aplique el YAML al clúster:

   a. Copie el archivo YAML y sustituya todas las apariciones de NAMESPACE_PLACEHOLDER por el proyecto en el que está instalando.

   b. Haga clic en el botón + de la interfaz de usuario OpenShift y pegue el archivo YAML en la ventana Importar YAML.

   c. Pulse Crear.

Alternativamente, puede guardar el YAML en un archivo, sustituir NAMESPACE_PLACEHOLDER por el proyecto en el que está instalando y crear los recursos utilizando el comando oc apply -f <filename> .

apiVersion: v1
kind: ServiceAccount
metadata:
  name: ta-operator-sa
  namespace: NAMESPACE_PLACEHOLDER

---

apiVersion: operators.coreos.com/v1
kind: OperatorGroup
metadata:
  name: ta-ownnamespace-operator-group
  namespace: NAMESPACE_PLACEHOLDER
spec:
  targetNamespaces:
    - NAMESPACE_PLACEHOLDER

---

apiVersion: rbac.authorization.k8s.io/v1
kind: Role
metadata:
  name: ibm-transformation-advisor
  namespace: NAMESPACE_PLACEHOLDER
rules:
  - apiGroups: ["networking.k8s.io"]
    resources: ["networkpolicies"]
    verbs: ["get", "list", "watch", "create", "delete", "patch"]
  - apiGroups: ["config.openshift.io"]
    resources: ["ingresses", "infrastructures", "dnses"]
    verbs: ["get"]
  - apiGroups: ["oauth.openshift.io"]
    resources: ["oauthclients", "oauthclients/finalizers"]
    verbs: ["get", "list", "create", "delete"]
  - apiGroups: ["operators.coreos.com"]
    resources: ["clusterserviceversions"]
    verbs: ["get", "list", "watch", "create", "delete", "patch"]
  - apiGroups: ["apiextensions.k8s.io"]
    resources: ["customresourcedefinitions", "customresourcedefinitions/finalizers"]
    verbs: ["get", "list", "watch", "create", "update", "delete", "patch"]
  - apiGroups: [""]
    resources: ["namespaces"]
    verbs: ["get"]
  - apiGroups: ["batch"]
    resources: ["jobs"]
    verbs: ["get", "list", "watch", "create", "update", "delete", "patch"]
  - apiGroups: [""]
    resources: ["configmaps", "persistentvolumeclaims", "pods", "services", "secrets", "serviceaccounts", "events"]
    verbs: ["*"]
  - apiGroups: ["apps"]
    resources: ["deployments", "statefulsets"]
    verbs: ["get", "list", "watch", "create", "update", "delete", "patch"]
  - apiGroups: ["monitoring.coreos.com"]
    resources: ["servicemonitors"]
    verbs: ["get", "create"]
  - apiGroups: ["apps"]
    resourceNames: ["ta-operator"]
    resources: ["deployments/finalizers", "statefulsets/finalizers"]
    verbs: ["update"]
  - apiGroups: [""]
    resources: ["pods"]
    verbs: ["get"]
  - apiGroups: ["apps"]
    resources: ["replicasets"]
    verbs: ["get", "list", "watch", "create", "update", "delete", "patch"]
  - apiGroups: ["ta.ibm.com"]
    resources: ["*"]
    verbs: ["get", "list", "watch", "create", "update", "delete", "patch"]
  - apiGroups: ["route.openshift.io"]
    resources: ["routes", "routes/custom-host"]
    verbs: ["get", "list", "watch", "create", "update", "delete", "patch"]

---

kind: RoleBinding
apiVersion: rbac.authorization.k8s.io/v1
metadata:
  name: ibm-transformation-advisor
  namespace: NAMESPACE_PLACEHOLDER
subjects:
  - kind: ServiceAccount
    name: ta-operator-sa
roleRef:
  kind: Role
  name: ibm-transformation-advisor
  apiGroup: rbac.authorization.k8s.io

---

apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: ibm-transformation-advisor
rules:
  - apiGroups: ["oauth.openshift.io"]
    resources: ["oauthclients", "oauthclients/finalizers", "consoleyamlsamples"]
    verbs: ["get", "list", "watch", "create", "update", "delete", "patch"]
  - apiGroups: ["console.openshift.io"]
    resources: ["consoleyamlsamples"]
    verbs: ["get", "list", "watch", "create", "update", "delete", "patch"]
  - apiGroups: ["config.openshift.io"]
    resources: ["ingresses", "infrastructures", "dnses"]
    verbs: ["get"]
  - apiGroups: ["rbac.authorization.k8s.io"]
    resources: ["clusterrolebindings", "clusterroles", "clusterroles/finalizers", "roles", "rolebindings", "roles/finalizers", "rolebindings/finalizers"]
    verbs: ["*"]
  - apiGroups: [""]
    resources: ["endpoints", "events"]
    verbs: ["get", "list", "watch", "create", "delete", "patch"]
  - apiGroups: ["discovery.k8s.io/v1"]
    resources: ["endpointslices"]
    verbs: ["get", "list", "watch", "create", "delete", "patch"]
  - apiGroups: ["network.openshift.io"]
    resources: ["netnamespaces", "clusternetworks", "egressnetworkpolicies"]
    verbs: ["get", "list", "watch", "create", "delete", "patch"]

---

kind: ClusterRoleBinding
apiVersion: rbac.authorization.k8s.io/v1
metadata:
  name: ibm-transformation-advisor-NAMESPACE_PLACEHOLDER
subjects:
  - kind: ServiceAccount
    name: ta-operator-sa
    namespace: NAMESPACE_PLACEHOLDER
roleRef:
  kind: ClusterRole
  name: ibm-transformation-advisor
  apiGroup: rbac.authorization.k8s.io

 

Instalar el operador

Instale el operador utilizando la interfaz de usuario de Red Hat OpenShift

• Vaya a Operadores...OperatorHub en la navegación de OpenShift .
• Seleccione el Catálogo de operadores deIBM en el filtro Origen .
• Seleccione el Transformation Advisor azulejo, filtrando si es necesario. Lea las instrucciones de instalación y tome las medidas necesarias.
• Pulse Instalar
• Seleccione las opciones deseadas y haga clic en Instalar

Después de unos minutos, debería ver la confirmación de que el operador se ha instalado correctamente. El operador Transformation Advisor está ahora disponible en el espacio de nombres elegido o en todos los espacios de nombres, dependiendo del modo de instalación seleccionado.

Crear una clave de asignación de derechos

Realice los pasos siguientes para crear un secreto docker-registry para habilitar el despliegue para obtener imágenes de operando de IBM® Entitled Registry.

Este secreto debe especificarse al instalar la Transformation Advisor instancia en el paso 9. Para más información, consulte Configuración.

Opción 1: Crear el secreto de clave de titularidad con la consola de OpenShift

1. Obtenga la clave de titulridad asignada a su IBMid. Inicie sesión en MyIBM Container Software Library con los datos IBMid y la contraseña asociados al software autorizado.
2. En la consola de OpenShift , asegúrese de que está en el proyecto (por ejemplo, mi proyecto) en el que ha instalado el operador.
3. Haga clic en Cargas de trabajo <Secretos> Crear y, a continuación, seleccione Image pull secret.
4. En el campo Nombre secreto, introduzca " ibm-entitlement-key.
5. En el campo Dirección del servidor de registro, introduzca " cp.icr.io.
6. En el campo Nombre de usuario, introduzca " cp.
7. En el campo Contraseña, especifique la credencial que ha recibido de la titularidad.
8. (Opcional) En el campo Correo electrónico, especifique una dirección de correo electrónico de contacto.

Opción 2: Crear el secreto de clave de titularidad con la CLI

Obtenga la clave de titulridad asignada a su IBMid. Inicie sesión en MyIBM Container Software Library Se abre en una nueva pestaña con los detalles de IBMid y contraseña que están asociados con el software autorizado. En la sección Claves de titularidad, seleccione Copiar clave para copiar la clave de titularidad en el portapapeles. Desde Red Hat OpenShift CLI, ejecute el siguiente comando para crear una imagen pull secret llamada ' ibm-entitlement-key.

oc create secret docker-registry ibm-entitlement-key \
--docker-username=cp\
--docker-password=<entitlement-key> \
--docker-server=cp.icr.io \
--namespace=<namespace>
 

Donde:

- <entitlement-key> is the entitlement key that you copied in step 2.
- <namespace> is the namespace that you want to install the Transformation Advisor instance in.
 

Como alternativa a la creación del secreto de ibm-entitlement-key , puede actualizar el secreto de extracción global del clúster utilizando las credenciales de clave de titularidad. Consulte https://docs.openshift.com/container-platform/4.9/openshift_images/managing_images/using-image-pull-secrets.html#images-update-global-pull-secret_using-image-pull-secrets para saber cómo actualizar el pull secret global. Debido a una limitación del producto, si utiliza el secreto de extracción global, deberá añadir las propiedades de imagePullSecret a la configuración de la instancia (consulte Configuración) Transformation Advisor (para más información, consulte Configuración. En este caso, el valor que utiliza para las propiedades no tiene que existir como secreto.

Realización de tareas de administración del clúster para la instalación de instancias

Antes de instalar la Transformation Advisor instancia, como administrador del clúster, deberá crear un proyecto para la Transformation Advisor instalación.

Crear un proyecto para instalar la instancia

Si ya ha elegido instalar el Transformation Advisor Operator en un espacio de nombres específico, entonces ya habrá creado el proyecto; de lo contrario, créelo ahora como se indica a continuación:

La creación del proyecto se puede realizar desde la interfaz de usuario de OpenShift :

• Haga clic en el icono de la hamburguesa en el panel de Red Hat OpenShift Container Platform.
• Expanda el menú Inicio y seleccione Proyectos.
• Pulse el botón Crear proyecto .
• Asigne un nombre al proyecto y pulse Crear.

Como alternativa, puede utilizar el mandato oc new-project NAMESPACE_PLACEHOLDER desde la línea de mandatos.

Necesitará el nombre del proyecto durante la instalación.

Ahora puede instalar la instancia Transformation Advisor instancia como usuario administrador del proyecto.

Crear Transformation Advisor instancia

Sustituya NAMESPACE_PLACEHOLDER por el nombre real del proyecto con el que está trabajando.

Busque el operador Transformation Advisor en la interfaz de usuario OpenShift en el proyecto creado para configurar y crear una instancia de Transformation Advisor.

• Haga clic en ' Operadores...Operadores instalados
• En el menú desplegable Proyectos seleccione NAMESPACE_PLACEHOLDER
• Haga clic en el Transformation Advisor operador
• Haga clic en el enlace Crear instancia en la pestaña Detalles, o haga clic en la pestaña Transformation Advisor y haga clic en Crear TransAdv.

Configuración de la instancia

• Deberá leer y aceptar los términos de licencia en la página de creación de instancia antes de que se le permita continuar con la instalación de la instancia.

• La configuración predeterminada le proporciona la mayor parte de lo que necesita para instalar el producto. Pulse el botón de selección Vista YAML para acceder al recurso personalizado YAML. Actualice los valores en ese YAML según sea necesario.

• Deberá configurar la persistencia antes de continuar con la instalación. Esto se puede realizar desde la vista de formulario de IU o desde la vista de YAML. Consulte el documento Configurar el almacenamiento para obtener todos los detalles, incluidos ejemplos, de la configuración de la persistencia.

• Es posible que también tenga que añadir secretos de extracción de imágenes para acceder a Transformation Advisor imágenes en el registro autorizado. Consulte la sección Crear clave de derechos y planificación para obtener más detalles sobre el acceso a imágenes en el registro de derechos. Añade ''imagePullSecret: ibm-entitlement-key' a las cuatro imágenes de Transformation Advisor, y haz clic en el enlace de la página de configuración.

Para obtener una lista completa de las configuraciones disponibles en el archivo YAML de recursos personalizados, consulte la página Configuración.

• Cuando esté satisfecho con la configuración, pulse Crear.

Acceder a la Transformation Advisor INTERFAZ DE USUARIO

Por defecto, el operador Transformation Advisor expone la interfaz de usuario como una ruta en OpenShift. Vaya a Redes - Rutas y haga clic en la ubicación de la ui-ruta.

Validación de una instalación correcta

Para validar la instalación, en la interfaz de usuario OpenShift vaya a los pods de los proyectos en los que se ha instalado Transformation Advisor está instalado. Debería ver los cuatro pods siguientes en estado LISTO y en ejecución:

ta-couchdb-0
ta-neo4j-0
ta-server-<ID>
ta-ui-<ID>
 

Además, debería ver el trabajo de preinstalación de la instancia en estado Completado:

ta-operator-instance-preinstall-<ID>
 

Si ha realizado una sola instalación de espacio de nombres, también verá el pod de operador en un estado READY y Running:

ibm-transformation-advisor-manager-<ID>
 

Navegue hasta la Transformation Advisor Como se describe aquí. Haga clic en el icono de la brocheta (⋮) de la Transformation Advisor Y, a continuación, haga clic en Novedades. Confirme la Transformation Advisor versión en el cuadro de diálogo Novedades.

Desinstalación de Transformation Advisor

Si ha instalado Transformation Advisor utilizando la interfaz de usuario Red Hat OpenShift, realice los siguientes pasos para eliminar completamente el operador y la instancia. Es importante no intentar suprimir el proyecto antes de suprimir los recursos del proyecto.

1. Desinstale la instancia:

   1. Haga clic en ' Operadores...Operadores instalados ' en la navegación de la izquierda.

   2. En el panel principal, seleccione el desplegable Proyecto y elija el proyecto donde Transformation Advisor está instalada la instancia

   3. Haga clic en el operador y, a continuación, en la Transformation Advisor pestaña

   4. Haga clic en el botón kebab de la instancia listada y seleccione Eliminar Transadv.

   5. En menos de 2 minutos, la instancia debe desaparecer (los pods asociados pueden tardar más en terminar). Si la instancia sigue siendo visible después de dos minutos, primero intente renovar el navegador. Si la instancia sigue mostrándose, ejecute el siguiente mandato oc (sustituya NAMESPACE_PLACEHOLDER por el nombre del proyecto en el que está instalada la instancia):

   oc patch transadvs.ta.ibm.com/ta -p '{"metadata":{"finalizers":[]}}' --type=merge -n NAMESPACE_PLACEHOLDER
    

2. Desinstale el operador:

   1. Haga clic en ' Operadores...Operadores instalados ' en la navegación de la izquierda.

   2. En el panel principal, seleccione el desplegable Proyecto y elija el proyecto donde Transformation Advisor está instalada la instancia

   3. Haga clic en el botón del operador de la lista y seleccione Desinstalar operador.

   4. En menos de 2 minutos, el operador debe desaparecer (los pods asociados pueden tardar más en terminar). Si el operador sigue siendo visible después de dos minutos, primero intente renovar el navegador. Si el operador sigue mostrándose, ejecute el siguiente mandato oc:

   oc patch crd/transadvs.ta.ibm.com -p '{"metadata":{"finalizers":[]}}' --type=merge
    

3. Para una única instalación de operador de espacio de nombres, elimine los recursos creados manualmente.

   1. Utilice la interfaz de usuario de OpenShift (pulse Inicio ...Busque en la navegación izquierda) para buscar y suprimir los recursos siguientes:

      1. ServiceAccount llamada ' ta-operator-sa

      2. OperatorGroup llamado ' ta-ownnamespace-operator-group

      3. Rol llamado ' ibm-transformation-advisor

      4. RoleBinding llamado ' ibm-transformation-advisor

      5. ClusterRole llamado ' ibm-transformation-advisor

      6. ClusterRoleBinding llamado ' ibm-transformation-advisor

   2. De forma alternativa, puede suprimir estos recursos desde la línea de mandatos utilizando oc delete ... .

4. Suprima el proyecto. Se recomienda eliminar el proyecto antes de intentar otra instalación de Transformation Advisor.

   1. Utilice la interfaz de usuario de OpenShift (pulse Inicio ...Proyectos) para eliminar el proyecto creado.