Installation d'un connecteur

Vous pouvez installer votre connecteur personnalisé dans votre instance Discovery en procédant comme suit.

1. Vérifiez que vous avez effectué toutes les étapes permettant de créer un connecteur personnalisé jusqu'à la procédure indiquée dans la section Compilation et conditionnement de l'exemple de connecteur.

2. Exécutez la commande suivante à partir du répertoire de votre machine locale où vous avez créé et compilé votre connecteur personnalisé :

   bash scripts/manage_custom_crawler.sh --endpoint {endpoint} --token {access token} deploy -n {crawler name} -f {built_connector_zip_file}
   

   où vous spécifiez les valeurs des variables suivantes :

   • endpoint : URL pour votre instance de service. Vous pouvez obtenir cette valeur dans la section Informations d'accès de la page d'aperçu de l'instance de service dans la console d'administration IBM Cloud Pak for Data.
   • jeton d'accès : jeton de support nécessaire pour accéder au point final. Vous pouvez obtenir cette valeur à partir de la même page que le point d'accès.
   • crawler name : (Facultatif) Nom que vous avez spécifié pour le crawler.
   • {built_connector_zip_file} est le nom du fichier que vous avez créé dans Compiler et empaqueter le connecteur d'exemple.

   Par exemple :

   bash scripts/manage_custom_crawler.sh --endpoint https://mycpd.wd40.example.com/discovery/zen40-wd/instances/1638165624521059/api --token eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6ImVKcV9HY29NcHF5WUFJcVByZ0x0cERRZDNQcmRiTWo5TGg0X09WOEU4MlkifP.eyJ1aXQiOiIxMDAwMzMwOTk5IiwidXNlcm5hbWUiOiJhZG1pbiIsInJvbGUiOiJBZG1pbiIsInBlcm1pc3Npb25zIjpbImFkbWluaXN0cmF0b3IiLCJjYW5fcHJvdmlzaW9uIl0sImdyb3VwcyI6WzEwMDAwXSwic3ViIjoiYWRtaW4iLCJpc3MiOiJLTk9YU1NPIiwiYXVkIjoiRFNYIiwiaWF0IjoxNjQyNzAyMDA3fQ.5oymGw7pi6tAbTMW9rcdb62G95teR2-tKyznA_wjk_G698fbx1Zl73KZKyEWcTKtyX7IJ1Px5DPdophcqS9i3bPJowHy-ioVp6DML02mscZImhvZPra-e6gwUdhSB64KArmMClo1-kZG20EclNh6-oxR447Bjdsgp7IYpkmynmw0K6vPIqmzwEhr9gAK1vWLOoVd4EoiYNuxZaSFL5byJ0mnQxXzM14w3lKQHZ91WYVKc4JnuJiSVsdpGqVz1JNFmT8D9FBqJQ4uxtshnii0f1Yh-USKCbJmMPXicU8cDtJIfheBejwenfvejUTz5rgZgymYWrGvw3G2oOx_L1Yg-Q deploy -n awesome_crawler -f awesome_crawler.zip
   

   Au lieu de spécifier un jeton d'accès pour l'authentification, vous pouvez spécifier des paramètres de nom d'utilisateur et de mot de passe. Pour plus d'informations, voir Comprendre le manage_custom_crawler.sh script.

Lorsque le crawler personnalisé est déployé, un identifiant de ressource est attribué au connecteur.

Vérification d'un connecteur installé

Vérifiez que le connecteur a été déployé dans l'instance Discovery en vous connectant à l'outil Discovery et en vous assurant que votre connecteur est affiché en tant qu'option sur la page Configurer la collection.

Utilisation d'un connecteur installé sur Discovery

Pour utiliser le connecteur personnalisé installé, suivez les étapes répertoriées dans Création d'une collection. Le connecteur personnalisé apparaît dans la liste des connecteurs fournis à la rubrique Configuration des sources de données Cloud Pak for Data. Pour plus d'informations, voir Utilisation d'un connecteur personnalisé avec l'outil Discovery.

Désinstallation d'un connecteur

Pour désinstaller un connecteur personnalisé d'une instance Discovery, procédez comme suit :

1. Facultatif : si vous ne connaissez pas l'identifiant de la ressource, exécutez la commande suivante pour dresser la liste des connecteurs personnalisés. Les identifiants des ressources des connecteurs sont renvoyés.

   scripts/manage_custom_crawler.sh --endpoint {endpoint} --token {token} list
   

2. Exécutez la commande suivante à partir du répertoire où vous avez extrait le fichier ZIP de votre connecteur personnalisé pour désinstaller le connecteur :

   scripts/manage_custom_crawler.sh --endpoint {endpoint} --token {token} undeploy --id {crawler_resource_id}
   

   où {crawler-resource-id} est l'identifiant généré pour le crawler lors de son déploiement.

   scripts/manage_custom_crawler.sh --endpoint {endpoint} --token {token} undeploy --id {crawler_resource_id}
   

Au lieu de spécifier un jeton d'accès pour l'authentification, vous pouvez spécifier des paramètres de nom d'utilisateur et de mot de passe. Pour plus d'informations, voir Comprendre le manage_custom_crawler.sh script.

Compréhension du script manage_custom_crawler.sh

Le script manage_custom_crawler.sh contient la documentation interne suivante :

Watson Discovery Custom Crawler Manager

This script will help you deploy, manage, and undeploy your custom crawler for
Watson Discovery.

Subcommands:
  deploy        Add a new Custom Crawler to your Watson Discovery instance.
  undeploy      Undeploy your Custom Crawler by name.
  list          List all Custom Crawlers for your Watson Discovery instance.

Options:
  -e --endpoint         The endpoint URL for your cluster and add-on service instance
                        (`https://{cpd_cluster_host}:{port}/discovery/{release}/instances/{instance_id}/api`)
  -t --token            The authorization token of your Cloud Pak instance
  -u --user             The user name of your Cloud Pak instance
  -p --password         The user password of your Cloud Pak instance
                        If the password is not specified, the command line prompts to input
  -n --name             The name of the custom crawler to upload (deploy only)
  -f --file             The path of the custom crawler package to upload (deploy only)
  -i --id               The crawler_resource_id value to delete the custom crawler (undeploy only)
  --help                Show this message.

4.0.5 et versions antérieures uniquement

bash scripts/manage_custom_crawler.sh undeploy -n {built_connector_name}

bash scripts/manage_custom_crawler.sh undeploy -n {built_connector_name} -o true

Usage: ${BASH_SOURCE[0]} [--pathToZip PATH] [--properties PROPERTIES] [--xml XML]

Watson Discovery Custom Crawler Manager

This script will help you deploy, manage, and undeploy your custom crawler for
Watson Discovery.

Subcommands:
  deploy        Add a new Custom Crawler to your Watson Discovery instance.
  properties    Generate the properties file for your crawler.
  undeploy      Undeploy your Custom Crawler by name.
  list          List all Custom Crawlers for your Watson Discovery instance.

Options:
  -d --discovery        The name of the Watson Discovery instance
  -z --zipfile          The path to the zip file to be uploaded.
                        For deploy only.
  -x --xml              The path to the XML file to be uploaded.
                        For deploy only.
  -n --name             The name of the Custom Crawler to undeploy.
  -m --messages         The path to the properties file, used when doing a two part deploy.
                        For properties only.
  -o --openshift        Set flag to true if this is an OpenShift Cluster
  --help                Show this message.