Déployer Data Connect

S’applique à : Tableau Cloud

Avant de déployer Data Connect dans votre organisation, vérifiez que les conditions préalables sont remplies :

La personne ou l’équipe responsable du déploiement de Data Connect doit maîtriser le système d’exploitation Linux, les scripts shell, Docker et Kubernetes.
Un jeton d’accès personnel d’administrateur de site Tableau. Consultez Jetons d’accès personnels.
Configuration matérielle minimale requise, telle que spécifiée dans Programmer votre déploiement Data Connect.
Spécifications réseau et accès à la base de données, comme spécifié dans Programmer votre déploiement Data Connect.

Étape 1 : Configurer votre cluster

Vérifiez la connectivité et l’accès suivants :

L’infrastructure, le cluster et le conteneur Data Connect ont besoin d’un accès réseau aux services du fournisseur d’orchestration (n° 2 dans l’image ci-dessus) et à Tableau Cloud (sortant uniquement, n°5).
L’infrastructure, le cluster, le conteneur et l’agent Data Connect ont besoin d’un accès réseau à votre base de données (#6).

Consultez Spécifications réseau.

Déployer et configurer

Exécutez la procédure suivante sur chaque ordinateur de votre organisation sur lequel vous souhaitez exécuter le cluster Kubernetes.

Vérifiez que votre volume secondaire n’est pas formaté. Sur le nœud Linux, exécutez la commande suivante :
lsblk -f
L’image suivante montre un exemple de configuration où le volume supplémentaire nvme1n1 sur un nœud de cluster n’est pas formaté, et où FSTYPE est vide :
Dans l’onglet Data Connect, sous Pools, cliquez sur Nouveau pool. Dans la boîte de dialogue Nouveau pool, entrez un nom de pool, puis cliquez sur Créer.
Dans l’onglet Data Connect, sous Cluster et nœuds, cliquez sur Nouveau cluster. Dans la fenêtre Nouveau cluster, entrez un nom de cluster, puis cliquez sur Créer.
Sur le cluster que vous venez de créer, cliquez sur la colonne Actions puis sur Nouveau nœud. Dans la fenêtre Ajouter un nouveau nœud, cliquez sur Télécharger le fichier.
Un fichier cluster.tar est téléchargé dans votre dossier Downloads. Ce fichier contient les scripts d’amorçage que vous allez exécuter sur le nœud.
Copiez le fichier cluster.tar sur votre ordinateur. L’exemple suivant montre comment copier le fichier tar, extraire les fichiers, transformer le script en fichier exécutable, puis exécuter le script. L’exemple montre le processus dans le contexte d’AWS. Modifiez le chemin d’accès des fichiers en fonction de votre environnement.
Exécutez les commandes suivantes en tant qu’utilisateur root ou sudo, en remplaçant <key-name> et <IP-address> par vos valeurs :
> scp -i <key-name>.pem /Downloads/cluster.tar ec2-user@ip-<IP-address>.us-west-2compute.internal:~/
> ssh -i <key-name>.pem ex2-user@ip-<IP-address>.us-west-2compute.internal
> tar -xvf clustertar.tar
> chmod +x onboard_node.sh preflight_check.sh
> ./onboard_node.sh
Une fois le script exécuté, le message Successfully performed all operations s’affiche dans la fenêtre du terminal et l’équipe Tableau démarre le processus de mise en service.
Si vous rencontrez une erreur, vérifiez que votre déploiement répond à la configuration matérielle minimale requise et aux spécifications réseau décrites dans Programmer votre déploiement Data Connect.
Dans l’onglet Data Connect de votre site, recherchez le pool que vous avez créé à l’étape 2. Sous la colonne Actions, cliquez sur Attribuer le cluster puis sélectionnez le cluster que vous avez créé à l’étape 3.
Cliquez sur le chevron (⌄) sur le cluster pour voir le nom d’hôte et les actions disponibles. Si ces informations ne s’affichent pas, vous devrez peut-être recharger la page. Après avoir vérifié que le nom d’hôte est le nœud cible, cliquez sur Accepter le nœud puis cliquez sur Confirmer.
Le nœud du cluster passe ensuite à l’état de mise en service. La mise en service du nœud peut prendre une heure ou plus.
Lorsque le statut de votre nœud passe à Disponible, accédez au pool auquel vous avez attribué le cluster et cliquez sur le bouton Actions (...), puis sur Jetons d’actualisation. Vérifiez que vous actualisez les jetons pour le pool correct, puis cliquez sur Confirmer.
Attendez que l’actualisation du jeton soit terminée. Une fois l’opération terminée, l’état du pool est défini sur Disponible. Revenez au cluster et cliquez sur le chevron (⌄) pour réduire la section du nom du cluster. Cliquez sur le bouton Actions pour le cluster (...) puis sur Obtenir les informations du registre du conteneur.
- Si une erreur s’affiche lorsque vous tentez cette étape, le registre n’est pas encore déployé et le processus de mise en service est peut-être encore en cours de finalisation. Patientez quelques minutes puis réessayez.
- Lorsque les informations du registre (nom du serveur, nom d’utilisateur et mot de passe) s’affichent, copiez-les en vue de l’étape suivante.

Étape 2 : Créer et publier votre image de base

À cette étape, vous allez créer votre image de base avec les pilotes nécessaires, puis publier l’image sur votre registre de conteneurs Docker. Avant de commencer :

Vérifiez que vous disposez des informations de votre registre de conteneurs Docker de l’étape précédente.
Chaque pool peut avoir sa propre image de base et son propre ensemble de pilotes.
Si vous prévoyez de vous connecter à l’aide d’un fichier TDC, vous devrez inclure ce fichier dans votre image de base. L’utilisateur du système, tableau, doit avoir un accès en lecture à ce fichier. Pour plus d’informations sur la création et le stockage de ce fichier, consultez la rubrique d’aide de Tableau Desktop Personnaliser et ajuster une connexion(Le lien s’ouvre dans une nouvelle fenêtre).

Créer le conteneur

La procédure suivante montre un exemple sur une distribution RHEL. Vous devrez peut-être installer des outils de gestion de packages ou d’autres outils spécifiques à votre distribution.

Connectez-vous à n’importe quel nœud de votre cluster Kubernetes. Installez Docker et les outils de support selon vos besoins :
```
#RedHat
sudo dnf install -y container-tools podman-docker
#Ubuntu
sudo apt-get update -y
sudo apt-get install -y docker.io
```
Créez le Dockerfile :
```
touch Dockerfile
```
Mettez à jour le Dockerfile de manière à inclure les pilotes prenant en charge vos connexions. Les commandes spécifiées dans ce Dockerfile s’exécuteront pendant la création de votre image de base. Par exemple :
```
# example base 
FROM registry.access.redhat.com/ubi8
RUN yum -y update
WORKDIR /
# Go to https://tableau.com/support/drivers
# Follow the instructions to install your drivers for linux
CMD [“/bin/bash”]
```
Le répertoire cible des fichiers du pilote peut varier. Voir Téléchargement de pilotes Tableau(Le lien s’ouvre dans une nouvelle fenêtre) pour plus de détails.
Remarque : Data Connect prend en charge les connecteurs Exchange dotés d’un pilote Linux et étiquetés « Focntionne avec Tableau Cloud via Bridge ». Pour en savoir plus, consultez la rubrique Connecteurs Tableau Exchange(Le lien s’ouvre dans une nouvelle fenêtre).
Exemple de lignes Dockerfile pour le pilote JDBC public, en utilisant la commande curl pour télécharger le pilote :
```
RUN mkdir -p /opt/tableau/tableau_driver/jdbc
RUN curl --location --output /opt/tableau/tableau_driver/jdbc/<file> <URL>
				
```
Exemple de lignes Dockerfile pour un pilote JDBC non public, en utilisant la copie :
```
RUN mkdir -p /opt/tableau/tableau_driver/jdbc
COPY  <file> /opt/tableau/tableau_driver/jdbc
```
Exemple de lignes Dockerfile pour un pilote taco, en utilisant la copie :
```
RUN mkdir -p /home/tableau/Documents/My_Tableau_Bridge_Repository/Connectors
COPY  <file> /home/tableau/Documents/My_Tableau_Bridge_Repository/Connectors
```
Alors que vous êtes encore connecté à votre nœud de cluster Kubernetes, définissez la variable POOL_ID avec la valeur de votre identifiant de pool. Pour afficher cette valeur, ouvrez l’onglet Data Connect et cliquez sur le nom du pool.
- Définissez la valeur de registre que vous avez copiée sur les valeurs respectives.
```
REGISTRY_HOSTNAME=registry_host_name_you_copied
REGISTRY_USERNAME=registry_user_name_you_copied
REGISTRY_PASSWORD=registry_password_you_copied
```
- Définissez la valeur de l’ID du pool :
```
POOL_ID=<pool_id_value>
```

Créez le conteneur qui sera utilisé comme image de base.

docker build -f <path_to_dockerfile> -t $REGISTRY_HOSTNAME/bridge-base:$POOL_ID .

Connectez-vous à votre nœud Kubernetes existant et envoyez l’image au registre du conteneur local.

docker login --username $REGISTRY_USERNAME $REGISTRY_HOSTNAME
docker push $REGISTRY_HOSTNAME/bridge-base:$POOL_ID

Sous le pool que vous configurez, cliquez sur le bouton Actions (...), puis sur Actualiser l’image de base. Cette action lance un déploiement à l’aide de l’image de base, ce qui peut prendre 10 minutes environ.
Remarque : chaque fois qu’une nouvelle image de base est créée et actualisée, un nouveau déploiement est créé. L’agent Bridge utilisé pour l’image de base précédente persistera en tant que ressource non attribuée. Ne supprimez pas les agents Bridge non affectés.

Étape 3 : Mapper un domaine à un pool

Les noms de domaine que vous spécifiez dans la liste d’autorisations sont les noms de serveur utilisés dans la connexion de source de données.

Dans l’onglet Data Connect, sous la section de liste d’autorisations Pool et Réseau privé, sélectionnez le pool que vous avez attribué et cliquez sur Nouveau domaine dans la colonne Actions.
Dans la zone de texte Domaine, saisissez l’URI du domaine à l’aide des informations décrites dans Règles du registre de la liste d’autorisations. L’URI de domaine que vous spécifiez sera limité au pool que vous êtes en train de configurer.
Sous Autorisations de domaine, vérifiez que la case d’option Autoriser est sélectionnée.
Une fois que vous avez terminé, cliquez sur Enregistrer.

Résoudre les problèmes de connexion

Vous devez configurer votre infrastructure réseau afin que Data Connect puisse accéder à toutes les sources de données requises auxquelles vous souhaitez vous connecter. Pour vérifier que Data Connect peut accéder à vos sources de données, exécutez la commande curl suivante depuis les nœuds sur lesquels Data Connect s’exécutera :

$ curl -v $DB_HOSTNAME:$DB_PORT

Si vous avez réussi à configurer votre connexion, vous devriez voir une collection de réponses. En voici quelques exemples :

Host $DB_HOSTNAME:$DB_PORT was resolved : confirme que les serveurs DNS ont résolu avec succès le nom d’hôte.
Connected to $DB_HOSTNAME : confirme que le nœud dispose d’une connexion réseau.
Empty reply from server. Closing connection : ce message est attendu puisque curl n’est pas un client de base de données.
Could not resolve host: $DB_HOSTNAME : il y a un problème avec la résolution DNS.
Trying $DB_IP_ADDRESS:$DB_PORT : si ce message est suivi d’un résultat bloqué, il y a un problème de réseau.

Si vous utilisez un tiers pour l’infrastructure de connexion de données, assurez-vous que la logique réseau n’est pas perturbée par le tiers.

(Facultatif) Étape 4 : Partager les clusters entre les sites

Par défaut, les clusters Data Connect et leurs nœuds correspondants sont utilisés uniquement par le site sur lequel ils ont été créés à l’origine. Les clusters Data Connect peuvent toutefois être partagés sur tous les sites de votre locataire Tableau Cloud Manager. Le partage de clusters permet aux requêtes sur différents sites au sein du locataire d’utiliser la même infrastructure de nœud.

Pour garantir la confidentialité des données sur les sites, aucune donnée relative à votre cluster partagé n’est disponible pour les autres sites de votre locataire.

Remarque : le partage d’un cluster est une opération permanente. Si vous souhaitez annuler le partage d’un cluster, vous devrez supprimer le cluster et en réinstaller un.

Les clusters ne peuvent être partagés qu’après avoir été acceptés avec succès sur le site d’origine où ils ont été créés.

Pour partager un cluster Data Connect :

Accédez au cluster que vous souhaitez partager, cliquez sur les points de suspension d’action (...), puis sur l’option Partager.

Une fois le cluster partagé, les administrateurs de site sur d’autres sites au sein de votre locataire peuvent utiliser le cluster avec tous les pools qu’ils créent sur leur site.

(Facultatif) Étape 5 : Création d’un pool sur un cluster partagé en tant que destinataire du cluster

Avant de créer votre pool en tant que destinataire sur un cluster partagé, vérifiez les points suivants :

Le cluster partagé dispose d’une connectivité réseau aux bases de données utilisées par votre site
Tous les pilotes de base de données requis par la base de données de votre site doivent être installés sur le cluster

Pour commencer à utiliser un cluster partagé comme destinataire de cluster, vous devez communiquer avec le propriétaire du cluster pour demander l’ajout de l’image de base de votre pool au cluster :

Dans l’onglet Data Connect, sous Pools, cliquez sur Nouveau pool.
Dans la boîte de dialogue Nouveau pool, entrez un nom de pool, puis cliquez sur Créer.
Dans le nouveau pool, cliquez sur Affecter un cluster, sélectionnez le cluster partagé, cliquez sur les points de suspension d’action (...), puis cliquez sur Jetons d’actualisation.
Vérifiez que vous actualisez les jetons pour le pool correct, puis cliquez sur Confirmer.
Lorsque le statut du pool est défini sur Disponible, copiez la valeur Pool_ID de votre pool. Pour afficher la valeur Pool_ID, cliquez sur le nom du pool.
Ajoutez une image de base pour votre site. Consultez Étape 2 : Créer et publier votre image de base ci-dessus.
L’administrateur ayant accès au cluster devra créer un nouveau conteneur avec la valeur Pool_ID dans le cadre de l’ajout de l’image de base. Vous aurez également besoin des valeurs de registre sur le site qui a créé le cluster à l’origine, lesquelles peuvent être fournies par le propriétaire du cluster.
Une fois l’image de base publiée dans le registre du conteneur local, accédez au pool sur le site de partage, puis cliquez sur Actualiser l’image de base.
Pour terminer la configuration, consultez Étape 3 : Mapper un domaine à un pool ci-dessus.

Ajouter un nœud depuis un cluster existant

Accédez au cluster et cliquez sur Nouveau nœud.
Suivez les étapes 4, 5, 7, 8, 9 de la procédure ci-dessus, Étape 1 : Configurer votre cluster. Omettez l’étape 6 car vous n’aurez pas besoin d’attribuer le cluster.
Une fois l’étape du jeton d’actualisation terminée, accédez au pool associé au cluster et cliquez sur Actualiser l’image de base.

Remarque : chaque fois qu’une nouvelle image de base est créée et actualisée, un nouveau déploiement est créé. Le client Bridge utilisé pour l’image de base précédente persistera en tant que ressource non affectée. Ne supprimez pas les clients Bridge non affectés.

Supprimer un nœud d’un cluster existant

Une fois qu’un nœud est supprimé d’un cluster, le client Bridge n’est plus accessible par Tableau Cloud. Tous les travaux exécutés sur Data Connect au moment de la suppression du nœud échoueront. Par contre, aucun travail supplémentaire ne sera transmis à ces clients Bridge.

Pour supprimer un nœud, accédez au cluster, cliquez sur les points de suspension d’action (...), puis sélectionnez Supprimer.

Mise à jour des images de base pour les pools existants

Si vous décidez d’utiliser une nouvelle base de données ou de mettre à jour un pilote que votre cluster Data Connect utilisera, vous pouvez apporter des modifications aux images de base existantes pour prendre en compte ces modifications. Pour ce faire, mettez à jour le fichier de conteneur avec les modifications comme expliqué dans l’Étape 2 : Créer et publier votre image de base. Après avoir mis à jour le fichier de conteneur, cliquez sur Actualiser l’image de base. Votre image de base précédente sera utilisée jusqu’à ce que la nouvelle image de base soit déployée avec succès.

Résoudre les problèmes de connectivité aux bases de données

Commencez par vérifier que vos domaines respectent les règles du registre de la liste d’autorisations. Consultez Configurer les pools

Vérifiez ensuite que vous avez configuré votre infrastructure réseau de manière à ce que Data Connect puisse accéder à toutes les sources de données requises auxquelles vous souhaitez vous connecter. Pour vérifier que Data Connect peut accéder à vos sources de données, exécutez la commande curl suivante depuis les nœuds sur lesquels Data Connect s’exécutera :

$ curl -v $DB_HOSTNAME:$DB_PORT

Si vous avez réussi à configurer votre connexion, vous devriez voir une collection de réponses. En voici quelques exemples :

Host $DB_HOSTNAME:$DB_PORT was resolved : confirme que les serveurs DNS ont résolu avec succès le nom d’hôte.
Connected to $DB_HOSTNAME : confirme que le nœud dispose d’une connexion réseau.
Empty reply from server. Closing connection : ce paramètre est attendu puisque curl n’est pas un client de base de données.
Could not resolve host: $DB_HOSTNAME : problème avec la résolution DNS.
Trying $DB_IP_ADDRESS:$DB_PORT : lorsque ce message est suivi d’un résultat bloqué, il y a un problème de réseau.

Si vous utilisez un tiers pour l’infrastructure de connexion de données, assurez-vous que la logique réseau n’est pas perturbée par le tiers.

Retour en haut

Merci de vos commentaires !

Avis correctement envoyé. Merci

Aide de Tableau Cloud