Création d'une instance de service pour Data Virtualization avec la cpd-cli service-instance create commande

1. Définissez la variable INSTANCE_SHORT_NAME d'environnement sur le nom unique que vous souhaitez utiliser pour identifier l'instance de service :

   export INSTANCE_SHORT_NAME="<display-name>"

   Le nom court est un string et peut contenir des caractères alphanumériques (a-z, A-Z, 0-9), des tirets (-) et des traits de soulignement (_).

2. Définissez le INSTANCE_PROJECT sur le projet dans lequel vous souhaitez créer l'instance de service :

   ---

   Créer l'instance de service dans le projet operands

   export INSTANCE_PROJECT=${PROJECT_CPD_INST_OPERANDS}

   La commande utilise la PROJECT_CPD_INST_OPERANDS variable, qui est déjà définie dans votre script de variables d'environnement d'installation.

   ---

   Créer l'instance de service dans un projet lié

   Important : si plusieurs projets liés sont associés à cette instance de IBM Software Hub, assurez-vous que la variable ${PROJECT_CPD_INSTANCE_TETHERED} d'environnement est définie sur le nom de projet correct avant d'exécuter la export commande :

   echo $PROJECT_CPD_INSTANCE_TETHERED

   export INSTANCE_PROJECT=${PROJECT_CPD_INSTANCE_TETHERED}

   ---

   Rappel : vous ne pouvez créer qu'une seule instance de service dans chaque projet.
3. Définissez la variable INSTANCE_NAME d'environnement :

   export INSTANCE_NAME="watson-query-${INSTANCE_PROJECT}-${INSTANCE_SHORT_NAME}"

4. Définissez la variable INSTANCE_DESCRIPTION d'environnement sur la description que vous souhaitez utiliser pour l'instance de service :

   export INSTANCE_DESCRIPTION="<description>"

   Cette description s'affiche sur la page Instances du client IBM Software Hub Web.

   La description est un string et peut contenir des caractères alphanumériques, des espaces, des tirets, des traits de soulignement et des points. Veillez à mettre le nom d'affichage entre guillemets, comme indiqué dans la commande export précédente.

5. Définissez la variable INSTANCE_VERSION d'environnement sur la version qui correspond à la version de IBM Software Hub sur votre cluster :

   export INSTANCE_VERSION=<version>

   Utilisez le tableau suivant pour déterminer la valeur appropriée :

   IBM Software Hubversion	Version d'instance de service
   5.3.1	3.3.1
   5.3.0	3.3.0

6. Définissez la variable INSTANCE_AUTOSCALING d'environnement base selon que vous souhaitez que l'instance s'adapte automatiquement en augmentant ou en diminuant le nombre de pods en fonction de la consommation du processeur ou de la mémoire.

   Mise à l'échelle automatique de l'instance

   Si vous souhaitez mettre à l'échelle automatiquement l'instance de service, exécutez :

   export INSTANCE_AUTOSCALING=true

   Important : si vous dimensionnez automatiquement le service, vous devez utiliser une taille prédéfinie pour la variable INSTANCE_PREDEFINED_SIZE d'environnement.

   Utilisation exclusive des ressources spécifiées

   Si vous ne souhaitez pas que l'instance de service s'adapte automatiquement, exécutez :

   export INSTANCE_AUTOSCALING=false

7. Définissez la variable d'environnement INSTANCE_PREDEFINED_SIZE.

   Utilisation des paramètres personnalisés

   Si vous souhaitez utiliser des paramètres personnalisés plutôt qu'une taille prédéfinie, exécutez :

   export INSTANCE_PREDEFINED_SIZE=""

   Utilisation d'une taille prédéfinie

   Si vous souhaitez utiliser une taille prédéfinie pour l'instance, exécutez :

   export INSTANCE_PREDEFINED_SIZE=<size>

   Les valeurs valides sont :

   • extrasmall
   • small
   • medium
   • large

   Pour plus d'informations sur les ressources associées à chaque taille, consultez le guide PDF sur la mise à l'échelle des composants, que vous pouvez télécharger à partir du registre intitulé « IBM ».

   Important : vous devez définir les variables d'environnement INSTANCE_CPUINSTANCE_MEMORY et même si vous souhaitez utiliser une taille prédéfinie. Si vous ne spécifiez pas de valeur pour ces variables d'environnement, le provisionnement de l'instance de service échouera.

8. Définissez la variable INSTANCE_CPU d'environnement sur la quantité de CPU à allouer à l'instance de service :

   export INSTANCE_CPU=<integer>

   Spécifiez une valeur comprise entre 4 et 64.

   Conseil : si vous utilisez une taille d'instance prédéfinie, définissez ce paramètre sur 4.

   Dimensionnez l'instance en fonction de votre charge de travail. Pour plus d'informations sur le nombre de CPU à allouer à l'instance de service, consultez le guide PDF sur la mise à l'échelle des composants, que vous pouvez télécharger à partir du IBM Entitled Registry.

9. Définissez la variable INSTANCE_MEMORY d'environnement sur la quantité de mémoire à allouer à l'instance de service :

   export INSTANCE_MEMORY=<integer>

   Spécifiez une valeur comprise entre 16 Gio et 512 Gio. Spécifiez la valeur sous forme d'entier. Omettre l'unité de mesure.

   Conseil : si vous utilisez une taille d'instance prédéfinie, définissez ce paramètre sur 16.

   Dimensionnez l'instance en fonction de votre charge de travail. Pour plus d'informations sur la quantité de mémoire à allouer à l'instance de service, consultez le guide PDF sur la mise à l'échelle des composants, que vous pouvez télécharger à partir du IBM Entitled Registry.

10. Définissez la variable INSTANCE_WORKERS d'environnement sur le nombre de nœuds de travail sur lesquels exécuter l'instance de service :

    export INSTANCE_WORKERS=<integer>

    Le nombre maximal de travailleurs que vous pouvez spécifier dépend de la Db2U configuration pour fonctionner avec des privilèges élevés :

    • Si Db2U est configuré pour s'exécuter avec des privilèges limités, vous pouvez spécifier une valeur comprise entre 1 et le nombre total de nœuds de travail sur le cluster.
    • Si Db2U est configuré pour s'exécuter avec des privilèges élevés, vous pouvez spécifier une valeur comprise entre 1 et 999.

    La plupart des charges de travail peuvent être exécutées sur 1 à 3 nœuds. Pour plus d'informations sur le nombre de nœuds recommandé en fonction de votre charge de travail, consultez le guide PDF sur la mise à l'échelle des composants, que vous pouvez télécharger à partir du IBM Entitled Registry.

11. Définissez la variable PV_SIZE d'environnement sur la quantité de stockage que vous souhaitez allouer à l'instance de service :

    export PV_SIZE=<integer>

    Spécifiez une valeur comprise entre 50 Gio et 10240 Gio. La recommandation par défaut est de 50 Gi. Spécifiez la valeur sous forme d'entier. Omettre l'unité de mesure.

    Dimensionnez le volume en fonction de la taille des requêtes que vous prévoyez d'exécuter. Pour plus d'informations, consultez le guide PDF sur la mise à l'échelle des composants, que vous pouvez télécharger à partir du IBM Entitled Registry.

12. Définissez la variable PV_SIZE_CACHE d'environnement sur la quantité de stockage que vous souhaitez allouer à la mise en cache pour l'instance de service :

    export PV_SIZE_CACHE=<integer>

    Spécifiez une valeur comprise entre 100 Gio et 10240 Gio. La recommandation par défaut est de 100 Gi. Spécifiez la valeur sous forme d'entier. Omettre l'unité de mesure.

    Dimensionnez le volume en fonction de la taille du cache de données. Pour plus d'informations, consultez le guide PDF sur la mise à l'échelle des composants, que vous pouvez télécharger à partir du IBM Entitled Registry.

13. Définissez la variable PV_SIZE_AUDITING d'environnement sur la quantité de stockage que vous souhaitez allouer aux journaux d'audit pour l'instance de service :

    export PV_SIZE_AUDITING=<integer>

    Spécifiez une valeur comprise entre 1 Gio et 10240 Gio. La recommandation par défaut est de 30 Gi. Spécifiez la valeur sous forme d'entier. Omettre l'unité de mesure.

    Dimensionnez le volume en fonction du nombre d'événements auditables enregistrés. Pour plus d'informations, consultez le guide PDF sur la mise à l'échelle des composants, que vous pouvez télécharger à partir du IBM Entitled Registry.

La commande que vous devez exécuter dépend du type de stockage utilisé dans votre cluster.

cat << EOF > ./data-virtualization-instance.json
{
    "addon_type": "dv",
    "display_name": "${INSTANCE_NAME}",
    "addon_version": "${INSTANCE_VERSION}",
    "namespace": "${INSTANCE_PROJECT}",
    "create_arguments": {
        "description": "${INSTANCE_DESCRIPTION}",
        "metaData": {},
        "parameters" : {
            "autoscaling": ${INSTANCE_AUTOSCALING},
            "tshirtsize": "${INSTANCE_PREDEFINED_SIZE}",
            "resources.dv.requests.cpu": "${INSTANCE_CPU}",
            "resources.dv.requests.memory": "${INSTANCE_MEMORY}Gi",
            "image.pullPolicy": "IfNotPresent",
            "workerCount": "${INSTANCE_WORKERS}",
            "persistence.storageClass": "portworx-db2-rwo-sc",
            "persistence.size": "${PV_SIZE}Gi",
            "persistence.cachingpv.storageClass": "portworx-db2-rwx-sc",
            "persistence.cachingpv.size": "${PV_SIZE_CACHE}Gi",
            "persistence.auditpv.storageClass": "portworx-db2-rwx-sc",
            "persistence.auditpv.size": "${PV_SIZE_AUDITING}Gi"
        },
    "resources": {
        "cpu": "$(( (${INSTANCE_WORKERS} + 1) * ${INSTANCE_CPU} ))",
        "memory": "$(( (${INSTANCE_WORKERS} + 1) * ${INSTANCE_MEMORY} ))"
    },
    "transientFields": {}
  }
}
EOF

cat << EOF > ./data-virtualization-instance.json
{
    "addon_type": "dv",
    "display_name": "${INSTANCE_NAME}",
    "addon_version": "${INSTANCE_VERSION}",
    "namespace": "${INSTANCE_PROJECT}",
    "create_arguments": {
        "description": "${INSTANCE_DESCRIPTION}",
        "metaData": {},
        "parameters" : {
            "autoscaling": ${INSTANCE_AUTOSCALING},
            "tshirtsize": "${INSTANCE_PREDEFINED_SIZE}",
            "resources.dv.requests.cpu": "${INSTANCE_CPU}",
            "resources.dv.requests.memory": "${INSTANCE_MEMORY}Gi",
            "image.pullPolicy": "IfNotPresent",
            "workerCount": "${INSTANCE_WORKERS}",
            "persistence.storageClass": "${STG_CLASS_FILE}",
            "persistence.size": "${PV_SIZE}Gi",
            "persistence.cachingpv.storageClass": "${STG_CLASS_FILE}",
            "persistence.cachingpv.size": "${PV_SIZE_CACHE}Gi",
            "persistence.auditpv.storageClass": "${STG_CLASS_FILE}",
            "persistence.auditpv.size": "${PV_SIZE_AUDITING}Gi"
        },
    "resources": {
        "cpu": "$(( (${INSTANCE_WORKERS} + 1) * ${INSTANCE_CPU} ))",
        "memory": "$(( (${INSTANCE_WORKERS} + 1) * ${INSTANCE_MEMORY} ))"
    },
    "transientFields": {}
  }
}
EOF

cat << EOF > ./data-virtualization-instance.json
{
    "addon_type": "dv",
    "display_name": "${INSTANCE_NAME}",
    "addon_version": "${INSTANCE_VERSION}",
    "namespace": "${INSTANCE_PROJECT}",
    "create_arguments": {
        "description": "${INSTANCE_DESCRIPTION}",
        "metaData": {},
        "parameters" : {
            "autoscaling": ${INSTANCE_AUTOSCALING},
            "tshirtsize": "${INSTANCE_PREDEFINED_SIZE}",
            "resources.dv.requests.cpu": "${INSTANCE_CPU}",
            "resources.dv.requests.memory": "${INSTANCE_MEMORY}Gi",
            "image.pullPolicy": "IfNotPresent",
            "workerCount": "${INSTANCE_WORKERS}",
            "persistence.storageClass": "${STG_CLASS_BLOCK}",
            "persistence.size": "${PV_SIZE}Gi",
            "persistence.cachingpv.storageClass": "${STG_CLASS_BLOCK}",
            "persistence.cachingpv.size": "${PV_SIZE_CACHE}Gi",
            "persistence.auditpv.storageClass": "${STG_CLASS_FILE}",
            "persistence.auditpv.size": "${PV_SIZE_AUDITING}Gi"
        },
    "resources": {
        "cpu": "$(( (${INSTANCE_WORKERS} + 1) * ${INSTANCE_CPU} ))",
        "memory": "$(( (${INSTANCE_WORKERS} + 1) * ${INSTANCE_MEMORY} ))"
    },
    "transientFields": {}
  }
}
EOF

export PAYLOAD_FILE=<fully-qualified-JSON-file-name>

cpd-cli service-instance create \
--profile=${CPD_PROFILE_NAME} \
--from-source=${PAYLOAD_FILE}