Clonar Tableau Server

A partir de la versión 2022.3 de Tableau Server, un nuevo comando tsm le permite crear una copia de la configuración y la topología de una implementación de Tableau Server y utilícela para crear una réplica exacta de la implementación original. El comando tsm settings clone crea un conjunto de archivos (la "carga de clonación") que incluye ajustes, secretos, configuración y topología, incluidos los puertos que se utilizan e información sobre servicios externos.

Consideraciones sobre seguridad

El comando tsm settings clone genera un conjunto de archivos (la "carga de clonación") que contiene todos los secretos generados por Tableau Server, así como los proporcionados por el administrador del servidor durante la configuración, incluido un almacén de claves que contiene pares de claves y certificados. Es extremadamente importante para la seguridad que mantenga segura la carga útil del clon y la ubicación de salida. Para facilitar esto:

  • Si el directorio de salida no existe, tsm lo creará con acceso restringido al usuario que ejecuta el comando tsm settings clone.
  • Si el directorio de salida existe cuando ejecuta el comando, tsm confirmará que es propiedad del usuario que ejecuta el comando y que los permisos están limitados solo a ese usuario. Si el directorio no tiene los permisos esperados, aparece un mensaje:

    The output directory '<path/to/directory>' exists, but must be restricted to owner only.

Limitaciones de la carga útil del clon

  • La versión de Tableau Server clonado debe coincidir con la versión que se está creando. No puede instalar una versión más nueva de Server utilizando una carga de clonación de una versión anterior.

Usar el comando de clonación para crear una copia de Tableau Server

Crear una copia clonada de Tableau Server es un proceso de varios pasos, siendo los dos pasos de alto nivel:

  1. Crear una carga útil clonada desde la instalación de Tableau Server que desea duplicar.
  2. Use la carga de clonación para instalar una segunda implementación de Tableau Server. Usted es responsable de hacer coincidir la topología de las dos instalaciones, agregando nodos adicionales para que coincidan con la implementación original.

Creación de la carga útil del clon

Para generar un conjunto de archivos (carga de clonación) que contienen los ajustes de configuración y topología para Tableau Server, utilice el comando tsm settings clone. El comando toma un solo argumento, el directorio de salida donde se debe guardar el conjunto de archivos:

tsm settings clone --output-directory <output_directory>

Una vez que se crea la carga del clon, puede usarla al instalar una nueva instancia de Tableau Server con la misma configuración y topología de la instalación de origen.

Uso de la carga útil de clonación para crear una copia de Tableau Server

  1. Instale el paquete Tableau Server en el nodo inicial. No inicialice Tableau Server. Instalar el paquete Tableau Server

  2. Ejecute el script initialize-tsm y especifique la ruta a la carga de clonación creada por el comando tsm settings clone:

    sudo /opt/tableau/tableau_server/packages/scripts.<version>/initialize-tsm --accepteula --clone-artifact-dir <path-to-clone-directory>

    Nota: Tableau Server se ejecuta como un usuario de Tableau sin privilegios, por lo que el administrador debe asegurarse de que el usuario de Tableau tenga acceso de lectura a los directorios y archivos clonados. En la mayoría de los casos, esto requiere otorgar permisos de lectura en el contenido del directorio de clonación, así como permisos de ejecución (para atravesar) en todos los directorios principales a "otros".

  3. (Opcional) Instale nodos adicionales para igualar el número de nodos en la instalación original (clonada) de Tableau Server. Si la instalación original tenía nodos adicionales, este paso es obligatorio. Solo instale nodos adicionales para que coincidan con el número de la instalación original.

    1. Genere el archivo de arranque en el nodo inicial:
    2. Instale Tableau Server en cada nodo adicional y ejecute el script initialize-tsm:

      Instalar y configurar nodos adicionales

  4. En el nodo inicial, complete la inicialización:

    tsm initialize

Contenedor

La funcionalidad de clonación es conveniente cuando se usa Tableau Server en un Contenedor, especialmente cuando se usa con repositorio y almacenamiento externo. El comando de clonación le permite al administrador recrear rápidamente un entorno Tableau Server y volver a conectar los servicios externos.

Nota: Los pasos para recrear el clúster de Tableau Server pueden diferir según las tecnologías de contenedor que se utilicen (por ejemplo: docker, docker compose o Kubernetes).

La siguiente información es específica para usar Docker directamente. Al iniciar el contenedor del nodo inicial, debe especificar la ubicación de la carga útil del clon mediante la variable de entorno CLONE_ARTIFACT_DIR.

Por ejemplo:

docker run \
-v <path-to-clone-directory>:/docker/custom-clone-path \
-e CLONE_ARTIFACT_DIR=/docker/custom-clone-path \
-e LICENSE_KEY=<key> \
-p 8080:8080 -p 8800-9000:8800-9000 -p 27000-27010:27000-27010 \
--hostname=<static (internal) name of host machine> \
-d <Tableau Server in a Container image ID or tag>

Recrear una implementación de varios nodos de Tableau Server en un contenedor

Si la carga útil de su clon provino de una implementación de Tableau Server de varios nodos, su contenedor inicial esperará a que se unan más nodos al clúster.

Configurar nodos adicionales en el clúster cuando se usa clonar es lo mismo que agregar nodos en una implementación regular y requiere:

  • Montaje de volúmenes para compartir el archivo de arranque entre los nodos
  • Especificar las variables de entorno ALWAYS_WRITE_BOOTSTRAP_FILE yBOOTSTRAP_INSTALL

Los pasos detallados para crear un entorno de varios nodos en una implementación de contenedor se pueden encontrar aquí: Tableau Server en un contenedor de varios nodos.

Nota: La carga del clon solo debe montarse y usarse en el nodo inicial del clúster. No hace falta que monte la carga de trabajo clonada en los nodos adicionales.

¡Gracias por sus comentarios!Sus comentarios se han enviado correctamente. ¡Gracias!