Utilice objetos globales para crear constantes configurables para configurar el conducto en tiempo de ejecución. Utilice parámetros o variables de usuario en interconexiones para especificar valores en tiempo de ejecución, en lugar de codificar los valores. A diferencia de los parámetros de interconexión, las variables de usuario se pueden establecer dinámicamente durante el flujo.
Aprenda a crear:
Parámetros de interconexión
Utilice los parámetros de interconexión para especificar un valor en el tiempo de ejecución de interconexión. Por ejemplo, si desea que un usuario especifique un espacio de despliegue para la salida de interconexión, utilice un parámetro para solicitar el nombre de espacio que se utilizará cuando se ejecute la interconexión. La especificación del valor del parámetro cada vez que ejecute el trabajo le ayudará a utilizar los recursos correctos.
Acerca de los parámetros de interconexión:
- se puede asignar como un valor de nodo o asignarlo para el trabajo de interconexión.
- se puede asignar a cualquier nodo y un indicador de estado le avisa.
- se puede utilizar para varios nodos.
Definición de un parámetro de interconexión
- Cree un parámetro de interconexión desde el panel de configuración de nodo de la barra de herramientas.
- Especifique un nombre y una descripción opcional. El nombre debe estar en minúsculas serpiente con letras minúsculas, números y subrayados. Por ejemplo,
lower_snake_case_with_numbers_123
es un nombre válido. El nombre debe empezar por una letra. Si el nombre no cumple, obtendrá un error 404 cuando intente ejecutar la interconexión. - Asigne un tipo de parámetro. Dependiendo del tipo de parámetro, deberá proporcionar detalles o asignar un valor predeterminado.
- Pulse Añadir a la lista para guardar el parámetro de interconexión.
-Puede definir un parámetro individual o crear un conjunto de parámetros. Los parámetros que defina individualmente también se pueden añadir a un conjunto.
-Es posible utilizar un parámetro de interconexión de formas que pueden producir resultados no soportados en una interconexión. Si asigna un parámetro con un activo genérico como su valor, puede seleccionar un activo como el valor de parámetro no soportado por el nodo Copiar activo .
Tipos de parámetros
Los tipos de parámetro se categorizan como:
- Básico: incluidos tipos de datos para estructurar la entrada a una interconexión o las opciones para manejar la creación de un activo o espacio duplicado.
- Recurso: para seleccionar un proyecto, catálogo, espacio o activo.
- Instancia: para seleccionar una instancia de aprendizaje automático o una instancia de Cloud Object Storage .
- Otros: para especificar detalles, como la modalidad de creación o la política de error.
Ejemplo de utilización de tipos de interconexión
Para crear un parámetro del tipo Vía de acceso:
- Cree un conjunto de parámetros denominado MASTER_PARAMETER_SET.
- Cree un parámetro denominado
file_path
y establezca el tipo en Vía de acceso. - Establezca el valor de
file_path
enmnts/workspace/masterdir
. Hay varias formas en las que puede establecer el valor:- Seleccionar recurso: busque el archivo en los ámbitos con la interfaz de usuario.
- Especifique el valor: un texto válido para la vía de acceso relativa del archivo, por ejemplo,
/mnts/sender.txt
.
- Arrastre el nodo Esperar archivo al lienzo y establezca el valor Ubicación de archivo en
MASTER_PARAMETER_SET.file_path
. - Conecte el archivo de espera con el nodo Ejecutar script de Bash para que el último nodo se ejecute después del primero.
- Opcional: Pruebe la variable de parámetro:
- Añada el parámetro de variable de entorno al conjunto de parámetros MASTER_PARAMETER_SET , por ejemplo
FILE_PATH
. - Pegue el mandato siguiente en el Código de script del Ejecutar script de Bash:
echo File: $FILE_PATH cat $FILE_PATH
- Añada el parámetro de variable de entorno al conjunto de parámetros MASTER_PARAMETER_SET , por ejemplo
- Ejecute el pipeline. La vía de acceso
mnts/workspace/masterdir
se encuentra en los dos registros de ejecución de los nodos para ver que se han pasado correctamente.
Configuración de un nodo con un parámetro de interconexión
Cuando configura un nodo con un parámetro de interconexión, puede elegir un parámetro de interconexión existente o crear uno nuevo como parte de la configuración de un nodo.
Por ejemplo:
- Cree un parámetro de interconexión denominado creationmode y guárdelo en la lista de parámetros.
- Configure un nodo Crear espacio de despliegue y pulse para abrir el panel de configuración.
- Elija el Parámetro de interconexión como entrada para la opción Modalidad de creación .
- Elija el parámetro de interconexión creationmode y guarde la configuración.
Cuando ejecuta el flujo, el parámetro de interconexión se asigna cuando se crea el espacio.
Conjuntos de parámetros
Los conjuntos de parámetros son un grupo de parámetros relacionados que se utilizan en una interconexión. Por ejemplo, puede crear un conjunto de parámetros para utilizarlos en un entorno de prueba y otro para utilizarlo en un entorno de producción.
Los conjuntos de parámetros se pueden crear como un activo de proyecto. A continuación, los conjuntos de parámetros creados en el proyecto están disponibles para su uso en interconexiones en dicho proyecto.
Creación de un conjunto de parámetros como un activo de proyecto
Puede crear un conjunto de parámetros como un activo de proyecto reutilizable para utilizarlo en interconexiones.
- Abra un proyecto existente o cree un proyecto.
- Hacer clic Nuevo activo > Definir conjuntos de parámetros reutilizables .
- Asigne un nombre para el conjunto y especifique los detalles de cada parámetro del conjunto, incluidos:
- Nombre del parámetro
- Tipo de datos
- Solicitud
- Valor predeterminado
- Opcionalmente, cree conjuntos de valores para los parámetros en el conjunto de parámetros. Los conjuntos de valores pueden ser los distintos valores para distintos contextos. Por ejemplo, puede crear un conjunto de valores de prueba con valores para un entorno de prueba y un conjunto de producción para valores de producción.
- Guarde el conjunto de parámetros después de crear todos los parámetros, s. Pasa a estar disponible para su uso en interconexiones que se crean en ese proyecto.
Adición de un conjunto de parámetros para su uso en una interconexión
Para añadir un conjunto de parámetros desde un proyecto:
- Pulse el icono de objetos globales y cambie a la pestaña Conjuntos de parámetros.
- Pulse Añadir conjunto de parámetros para añadir conjuntos de parámetros del proyecto que desea utilizar en el conducto.
- Puede añadir o eliminar conjuntos de parámetros de la lista. Los conjuntos de parámetros que especifique para su uso en el conducto pasan a estar disponibles cuando asigna parámetros como entrada en el conducto.
Creación de un conjunto de parámetros a partir de la lista de parámetros en la interconexión
Puede crear un conjunto de parámetros a partir de la lista de parámetros para la interconexión
- Pulse el icono de objetos globales y abra los parámetros de interconexión.
- Seleccione los parámetros que desea en el conjunto y, a continuación, pulse el icono Guardar como conjunto de parámetros .
- Especifique un nombre y una descripción opcional para el conjunto.
- Guarde para añadir el conjunto de parámetros para su uso en la interconexión.
Utilización de un conjunto de parámetros en una interconexión
Para utilizar un conjunto de parámetros:
- Elija Asignar parámetro de interconexión como tipo de entrada de una hoja de propiedades de nodo.
- Elija el parámetro que desea asignar. Una lista muestra todos los parámetros disponibles del tipo para esa entrada. Los parámetros disponibles pueden ser parámetros individuales y parámetros definidos como parte de un conjunto. El nombre del conjunto de parámetros precede al nombre del parámetro. Por ejemplo, Parameter_set_name.Parameter_name.
- Ejecute la interconexión y seleccione un valor establecido para el valor correspondiente (si está disponible), asigne un valor para el parámetro o acepte el valor predeterminado.
Utilización de los conjuntos de parámetros por defecto del proyecto
Un proyecto puede tener un conjunto de parámetros denominado PROJDEF. Este conjunto de parámetros contiene un conjunto global de propiedades a las que se puede hacer referencia desde un flujo DataStage o un flujo Pipelines. Dado que se trata de un conjunto de parámetros, puede utilizar la interfaz de usuario existente del conjunto de parámetros para gestionar estas variables.
Tenga cuidado con los PROJDEF:
- Puede hacer referencia a un valor del grupo de parámetros PROJDEF con el valor PROJDEF del parámetro pipeline.
- El valor PROJDEF se admite para parámetros de todos los tipos excepto los parámetros encriptados.
- Los parámetros del conjunto de parámetros PROJDEF deben utilizar el mismo nombre que los parámetros de la tubería que tienen el valor PROJDEF.
Para utilizar PROJDEF en un proyecto:
- Cree el conjunto de parámetros PROJDEF.
- Añada cualquier parámetro a su conjunto de parámetros PROJDEF, por ejemplo
SOME_DATE
. - Haga clic en Objetos globales en la barra de herramientas.
- Haga clic en Añadir parámetro PROJDEF.
- Seleccione el parámetro de la lista.
Edición de un conjunto de parámetros en un trabajo
Si utiliza un conjunto de parámetros al definir un trabajo, puede elegir un conjunto de valores para rellenar las variables con los valores de ese conjunto. Si cambia y guarda los valores, edite el trabajo y guarde los cambios, los valores del conjunto de parámetros se restablecerán a los valores predeterminados.
Variables de usuario
Cree variables de usuario para asignar valores cuando se ejecute el flujo. A diferencia de los parámetros de interconexión, las variables de usuario pueden modificarse durante el proceso.
Definición de una variable de usuario
Puede crear variables de usuario para utilizarlas en la interconexión. Las variables de usuario, como los parámetros, se definen a nivel global y no son específicas de ningún nodo. El valor inicial de una variable de usuario debe establecerse cuando lo defina y no se puede establecer dinámicamente como resultado de cualquier salida de nodo. Cuando define una variable de usuario, puede utilizar el nodo Establecer variables de usuario para actualizarla con la salida de nodo.
Para crear una variable de usuario:
- Cree una variable desde el panel de configuración del nodo Actualizar variable o desde la barra de herramientas.
- Especifique un nombre y una descripción opcional. El nombre debe estar en minúsculas serpiente con letras minúsculas, números y subrayados. Por ejemplo, lower_snake_case_with_numbers_123 es un nombre válido. El nombre debe empezar por una letra. Si el nombre no cumple, obtendrá un error 404 cuando intente ejecutar la interconexión.
- Complete la definición de la variable, incluida la elección de un tipo de variable y un tipo de entrada.
- Pulse Añadir para añadir la variable a la lista. Ahora está disponible para su uso en un nodo.
Establecer una zona horaria
Puedes configurar la zona horaria en tu configmap.
- Abra su configmap ejecutando el comando
kubectl edit -n <namespace> configmap watson-pipelines-config
dondenamespace
es su espacio de nombres de instancia Cloud Pak for Data. - Establezca el valor de su zona horaria con el siguiente ejemplo de código:
apiVersion: v1 kind: ConfigMap metadata: name: watson-pipelines-config namespace: zen data: default_container_env: | - name: TZ value: America/New_York
- Establezca el valor de su zona horaria en Pipelines CR:
oc patch wspipelines wspipelines-cr -p '{"spec":{"timezone":"America/New_York"}}' --type=merge
- Espere a que se complete la reconciliación con:
oc get wspipelines wspipelines-cr
Tema padre: Creación de un conducto