Déploiement de Data Connect

S’applique à : Tableau Cloud

Avant de déployer Data Connect dans votre organisation, vérifiez que vous disposez de la configuration requise :

La personne ou l’équipe responsable du déploiement de Data Connect doit savoir utiliser 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.
Matériel minimum requis tel que spécifié dans Planification de votre déploiement Data Connect.
Caractéristiques de mise en réseau et accès à la base de données tel que spécifié dans Planification de votre déploiement Data Connect.

Étape 1 : Configurer votre groupement

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

L’infrastructure, le groupement et le conteneur Data Connect nécessitent 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 groupement, le conteneur et l’agent Data Connect nécessitent un accès réseau à votre base de données (#6).

Consultez Caractéristiques de mise en réseau.

Déploiement et configuration

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

Vérifiez que votre volume secondaire n’est pas formaté. Sur le nœud Linux, exécutez la commande suivante :
lsblk -f
Dans l’image qui suit, vous voyez que le volume supplémentaire nvme1n1 sur un nœud du groupement n’est pas formaté et que FSTYPE est vide :
Dans l’onglet Data Connect, sous Pools, cliquez sur Nouveau pool. Dans le volet Nouveau pool, entrez un nom de pool et cliquez sur Créer.
Dans l’onglet Data Connect, sous Groupement et Nœuds, cliquez sur Groupement. Dans le volet Nouveau groupement, entrez un nom de groupement, puis cliquez sur Créer.
Sur le groupement que vous venez de créer, cliquez sur la colonne Actions, puis sur Nouveau nœud. Dans le volet 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 de démarrage que vous devez exécuter sur le nœud.
Copiez le fichier .tar du groupement sur votre ordinateur personnel. L’exemple suivant montre comment copier le fichier .tar, extraire les fichiers, modifier le script en fichier exécutable, et exécuter ensuite le script. Cet exemple le décrit dans le contexte d’AWS. Modifiez les chemins d’accès du fichier pour 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é avec succès, le message Successfully performed all operations s’affiche dans le volet du terminal, et l’équipe Tableau lance le processus de mise en service.
Si vous rencontrez une erreur, vérifiez que votre déploiement remplit les critères de matériel minimum requis et les caractéristiques de mise en réseau décrits dans Planification de votre déploiement Data Connect.
Dans l’onglet Data Connect de votre site, trouvez le pool que vous avez créé à l’étape 2. Sous la colonne Actions, cliquez sur Affecter un groupement, puis sélectionnez le groupement que vous avez créé à l’étape 3.
Cliquez sur le chevron (⌄) figurant sur le groupement pour afficher 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 confirmé que le nom d’hôte est le nœud cible, cliquez sur Accepter le nœud, puis sur Confirmer.
Le nœud du groupement passe à l’état Mise en service. La mise en service du nœud peut prendre une heure ou plus.
Lorsque le nœud passe à l’état Disponible, accédez au pool auquel vous avez affecté le groupement, cliquez sur le bouton Actions (...), puis cliquez sur Actualiser les jetons. Vérifiez que vous actualisez les jetons du pool approprié, puis cliquez sur Confirmer.
Attendez la fin de l’actualisation des jetons. Une fois terminé, le pool passe à l’état Disponible. Accédez à nouveau au groupement et cliquez sur le chevron (⌄) pour réduire la section du nom du groupement. Cliquez sur le bouton Actions pour le groupement (...), puis cliquez sur Obtenir les informations du registre de conteneurs.
- Si une erreur survient 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. Attendez quelques minutes, puis réessayez.
- Lorsque les informations du registre (nom du serveur, nom d’utilisateur et mot de passe) s’affichent, copiez-les pour l’étape suivante.

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

Dans cette étape, vous devrez créer votre image de base avec les pilotes requis, puis publier l’image dans votre registre de conteneurs Docker. Avant de commencer :

Vérifiez que vous disposez des informations du registre de conteneurs Docker que vous avez obtenues à l’étape précédente.
Chaque pool peut avoir sa propre image de base et son propre ensemble de pilotes.
Si vous souhaitez vous connecter à l’aide d’un fichier TDC, vous devrez inclure ce fichier dans votre image de base. L’utilisateur 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, Personnalisation et optimisation d’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 du gestionnaire de packages ou d’autres outils spécifiques à votre distribution.

Connectez-vous à n’importe quel nœud de votre groupement Kubernetes. Installez Docker et les outils d’assistance 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 afin d’inclure les pilotes permettant de prendre 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. Consultez Téléchargement du pilote 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 « Fonctionne avec Tableau Cloud via Bridge. » Pour plus d’informations, consultez Connecteurs Tableau Exchange(Le lien s’ouvre dans une nouvelle fenêtre).
Exemple de lignes du Dockerfile pour un pilote JDBC public, 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 du Dockerfile pour un pilote JDBC non public, utilisant la copie :
```
RUN mkdir -p /opt/tableau/tableau_driver/jdbc
COPY  <file> /opt/tableau/tableau_driver/jdbc
```
Exemple de lignes du Dockerfile pour un pilote taco, utilisant la copie :
```
RUN mkdir -p /home/tableau/Documents/My_Tableau_Bridge_Repository/Connectors
COPY  <file> /home/tableau/Documents/My_Tableau_Bridge_Repository/Connectors
```
En étant toujours connecté au nœud de votre groupement Kubernetes, définissez la variable POOL_ID avec la valeur de l’identifiant de votre pool. Pour afficher la valeur de l’identifiant du pool, 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’identifiant 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 transmettez l’image au registre de conteneurs 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 cliquez sur Actualiser l’image de base. Cette action déclenche un déploiement à l’aide de l’image de base et peut prendre quelques dix minutes.
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 sera conservé comme un actif non affecté. 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 pour la connexion à la source de données.

Dans l’onglet Data Connect, sous la section Liste d’autorisations de pools et de réseaux privés, sélectionnez le pool que vous avez affecté et cliquez sur Nouveau domaine dans la colonne Actions.
Dans la zone de texte Domaine, entrez l’URI du domaine à l’aide des informations décrites dans Règles de registre de liste d’autorisations. L’URI de domaine que vous spécifiez sera limité au pool que vous configurez.
Sous Autorisations de domaine, confirmez que la case d’option Autoriser est cochée.
Lorsque vous avez terminé, cliquez sur Enregistrer.

Résoudre les problèmes liés aux erreurs de connexion

Vous devez configurer votre infrastructure réseau afin que Data Connect puisse atteindre toutes les sources de données requises auxquelles vous souhaitez vous connecter. Pour vérifier que Data Connect peut atteindre vos sources de données, exécutez la commande curl suivante à partir des 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. Voici quelques exemples ci-après :

Host $DB_HOSTNAME:$DB_PORT was resolved : confirme que les serveurs DNS ont correctement résolu 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 : cette réponse est attendue puisque curl n’est pas un client de base de données.
Could not resolve host: $DB_HOSTNAME : un problème est survenu au niveau de 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 cette tierce partie.

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

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

Pour garantir la confidentialité des données sur les sites, aucune donnée concernant votre groupement partagé n’est accessible par les autres sites de votre locataire.

Remarque : Le partage d’un groupement fonctionne en continu. Pour annuler le partage d’un groupement, vous devrez le supprimer et le réinstaller.

Les groupements ne peuvent être partagés qu’après avoir été acceptés sur le site où ils ont été initialement créés.

Pour partager un groupement Data Connect :

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

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

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

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

Le groupement 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 groupement

Pour commencer à utiliser un groupement partagé en tant que destinataire du groupement, vous devrez communiquer avec le propriétaire du groupement pour que l'image de base de votre pool soit ajoutée au groupement :

Dans l’onglet Data Connect, sous Pools, cliquez sur Nouveau pool.
Dans le volet Nouveau pool, entrez un nom de pool et cliquez sur Créer.
Dans le nouveau pool, cliquez sur Attribuer un groupement, sélectionnez le groupement partagé, cliquez sur les points de suspension d’action (...), puis cliquez sur Jetons d’actualisation.
Vérifiez que vous actualisez les jetons du pool approprié, puis cliquez sur Confirmer.
Lorsque le pool passe au statut Disponible, copiez le 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 l’Étape 2 : Créer et publier votre image de base ci-dessus.
L’administrateur ayant accès au groupement 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 initialement créé le groupement, qui peuvent être fournies par le propriétaire du groupement.
Une fois l’image de base publiée dans le registre de conteneurs local, accédez au pool sur le site de partage, puis cliquez sur Actualiser l’image de base.
Pour terminer la configuration, consultez l’Étape 3 : Mapper un domaine à un pool, ci-dessus.

Ajouter un nœud à partir d’un groupement existant

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

Remarque : Lorsqu’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 sera conservé comme un actif non attribué. Ne supprimez pas les clients Bridge non attribués.

Supprimer un nœud à partir d’un groupement existant

Une fois qu’un nœud est supprimé d’un groupement, le client Bridge ne sera plus accessible par Tableau Cloud. Toutes les tâches exécutées sur Data Connect au moment de la suppression du nœud échoueront. Cependant, aucune tâche supplémentaire ne sera acheminée vers ces clients Bridge.

Pour supprimer un nœud, accédez au groupement, cliquez sur les points de suspension d’action (...), et 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 groupement 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 conteneur avec les modifications comme décrit dans l’Étape 2 : Créer et publier votre image de base. Après avoir mis à jour le fichier 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 correctement déployée.

Résoudre les problèmes de connectivité de la base de données

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

Ensuite, confirmez que vous avez configuré votre infrastructure réseau afin que Data Connect puisse atteindre toutes les sources de données requises auxquelles vous souhaitez vous connecter. Pour vérifier que Data Connect peut atteindre vos sources de données, exécutez la commande curl suivante à partir des 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. Voici quelques exemples ci-après :

Host $DB_HOSTNAME:$DB_PORT was resolved : confirme que les serveurs DNS ont correctement résolu 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 : cette réponse est attendue puisque curl n’est pas un client de base de données.
Could not resolve host: $DB_HOSTNAME : un problème est survenu au niveau de 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 cette tierce partie.

Retour en haut

Merci de vos commentaires!

Votre commentaire s été envoyé avec succès. Merci!

Aide de Tableau Cloud