Creazione di un'istanza di servizio per DataStage con il cpd-cli service-instance create comando

Informazioni necessarie per completare questa operazione

Prima di creare un'istanza di servizio per DataStage, consultare le seguenti informazioni:

Requisiti di versione

Tutti i componenti associati a un'istanza di IBM Software Hub devono essere installati o creati nella stessa versione. Ad esempio, se DataStage è installato alla versione 5.3.1, è necessario creare l'istanza del servizio alla versione 5.3.1.

Variabili di ambiente

I comandi in questa attività utilizzano variabili d'ambiente, in modo da poterli eseguire esattamente come sono scritti.

• Se non disponi dello script che definisce le variabili d'ambiente, consulta la sezione "Configurazione delle variabili d'ambiente di installazione".
• Per utilizzare le variabili d'ambiente dallo script, è necessario caricare le variabili d'ambiente prima di eseguire i comandi di questa attività. Ad esempio, esegui:

  source ./cpd_vars.sh

Prima di iniziare

Per eseguire questa operazione è necessario che siano soddisfatti i seguenti prerequisiti:

Procedura

Per creare un'istanza di servizio, eseguire le seguenti operazioni:

1. Creazione di un'istanza di servizio
2. Verifica della creazione dell'istanza del servizio
3. Cosa fare adesso

Creazione di un'istanza del servizio

Per creare un'istanza di servizio:

1. Passa alla directory della tua workstation in cui desideri creare il file JSON che definisce il payload dell'istanza del servizio.
2. Imposta le variabili d'ambiente utilizzate per compilare il payload JSON dell'istanza del servizio:
   1. Imposta la variabile INSTANCE_NAME d'ambiente con il nome univoco che desideri utilizzare come nome visualizzato per l'istanza del servizio:

      export INSTANCE_NAME="<display-name>"

      Questo nome viene visualizzato nella pagina "Istituzioni" del client IBM Software Hub web.

      Il nome visualizzato è un string e può contenere caratteri alfanumerici (a-z, A-Z, 0-9), spazi ( ), trattini (-), caratteri di sottolineatura (_) e punti (.). Assicurati di racchiudere il nome visualizzato tra virgolette, come mostrato nel comando export precedente.

   2. Imposta la variabile INSTANCE_DESCRIPTION d'ambiente con la descrizione che desideri utilizzare per l'istanza del servizio:

      export INSTANCE_DESCRIPTION="<description>"

      Questa descrizione viene visualizzata nella pagina "Istituzioni" del client IBM Software Hub web.

      La descrizione è una stringa string e può contenere caratteri alfanumerici, spazi, trattini, caratteri di sottolineatura e punti. Assicurati di racchiudere il nome visualizzato tra virgolette, come mostrato nel comando export precedente.

   3. Imposta INSTANCE_VERSION sulla versione corrispondente a quella di IBM Software Hub sul tuo cluster:

      export INSTANCE_VERSION=<version>

      Utilizza la tabella seguente per determinare il valore corretto:

      IBM Software Hub Versione	Versione istanza servizio
      5.3.1	5.3.1
      5.3.0	5.3.0

   4. Impostare la variabile di ambiente INSTANCE_SIZE. La dimensione determina le risorse assegnate all'istanza del servizio.

      export INSTANCE_SIZE=<size>

      I valori validi sono:

      • small
      • medium
      • large

      Per ulteriori informazioni sulle risorse associate a ciascuna dimensione, consultare il documento PDF contenente le linee guida sul ridimensionamento dei componenti, scaricabile dal sito IBM Entitled Registry.

3. Creare il file datastage-instance.json di payload:

   cat << EOF > ./datastage-instance.json
   {
       "display_name": "${INSTANCE_NAME}",
       "namespace": "${PROJECT_CPD_INST_OPERANDS}",
       "addon_type": "datastage",
       "addon_version": "${INSTANCE_VERSION}",
       "create_arguments": {
           "description": "${INSTANCE_DESCRIPTION}",
           "metadata": {
               "storageClass": "${STG_CLASS_FILE}",
               "scaleConfig": "${INSTANCE_SIZE}"
           },
           "owner_username": "admin",
           "parameters": {
               "storageClass": "${STG_CLASS_FILE}",
               "scaleConfig": "${INSTANCE_SIZE}"
           },
           "resources": {}
       },
       "preExistingOwner": "false",
       "transientFields": {}
   }
   EOF

   Le seguenti variabili d'ambiente utilizzano i valori già definiti nello script delle variabili d'ambiente dell'installazione:

   • ${PROJECT_CPD_INST_OPERANDS}
   • ${STG_CLASS_FILE}
4. Imposta la variabile PAYLOAD_FILE d'ambiente con il nome completo del file di payload JSON presente sulla tua workstation:

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

5. Crea l'istanza del servizio dal file di payload:

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

Verifica della creazione dell'istanza del servizio

Per verificare che l'istanza del servizio sia stata creata, eseguire il seguente comando:

cpd-cli service-instance status ${INSTANCE_NAME} \
--profile=${CPD_PROFILE_NAME} \
--output=json

• Se il comando restituisce un PROVISIONEDrisultato positivo, l'istanza del servizio è stata creata correttamente.
• Se il comando restituisce un errore PROVISION_IN_PROGRESS, attendere qualche minuto ed eseguire nuovamente il comando.
• Se il comando restituisce un errore FAILED, controlla i log dei pod e per zen-watcher individuare zen-core-api le possibili cause.

Cosa fare successivamente

È necessario concedere agli utenti l'accesso all'istanza del servizio. Per ulteriori informazioni, consultare la sezione "Creazione di un'istanza di servizio per DataStage ".