Mandatos de la CLI de IBM Cloud Developer Tools (ibmcloud dev)

La interfaz de línea de comando IBM Cloud® incluye los comandos Developer Tools (ibmcloud dev) para gestionar pipelines clásicos, pipelines Tekton y cadenas de herramientas.

help

De forma predeterminada, si no se pasa ninguna acción ni argumento, o si se proporciona la acción 'help', este mandato muestra un texto de ayuda general. La ayuda general mostrada incluye una descripción de los argumentos base, así como una lista de las acciones disponibles.

Ejecute el siguiente mandato para visualizar la información de ayuda general:

ibmcloud dev help

pipeline-get

Ver los detalles de un conducto Clásico.

ibmcloud dev pipeline-get [PIPELINE_ID] [--output JSON]

Parámetros del mandato pipeline-get

json

  • Parámetro que sirve para mostrar los detalles del conducto en formato JSON.
  • Uso:ibmcloud dev pipeline-get [PIPELINE_ID] --output JSON

El siguiente parámetro se puede utilizar con el mandato pipeline-get o actualizando el archivo cli-config.yml de la app directamente.

Los parámetros de mandatos especificados en la línea de mandatos tienen prioridad sobre la configuración cli-config.yml.

trace

  • Utilice este parámetro para proporcionar una salida detallada.
  • Uso:ibmcloud dev pipeline-get [PIPELINE_ID] --trace

pipeline-run

Ejecutar un conducto Clásico.

ibmcloud dev pipeline-run [PIPELINE_ID] [--stage-id stageID] [--output JSON]

Parámetros del mandato pipeline-run

Los siguientes parámetros se pueden utilizar con el mandato pipeline-run o actualizando el archivo cli-config.yml de la app directamente.

Los parámetros de mandatos especificados en la línea de mandatos tienen prioridad sobre la configuración cli-config.yml.

stage-id

  • Parámetro que se utiliza opcionalmente para seleccionar la etapa del conducto que se va a ejecutar
  • Uso:ibmcloud dev pipeline-run [PIPELINE_ID] --stage-id [stageID]

json

  • Parámetro que sirve para mostrar los detalles de invocación del conducto en formato JSON.
  • Uso:ibmcloud dev pipeline-run [PIPELINE_ID] --output JSON

trace

  • Utilice este parámetro para proporcionar una salida detallada.
  • Uso:ibmcloud dev pipeline-run [PIPELINE_ID] --trace

pipeline-log

Ver los registros recientes del conducto Clásico mediante el mandato pipeline-log.

  • Si se especifica el ID del conducto como argumento, se muestran todos los registros de todos los trabajos de todas las etapas para dicho conducto.
  • Si el distintivo de ID de etapa contiene información, los registros se filtran por dicha etapa en el conducto.
  • Si el ID de trabajo se especifica con el ID de etapa, los registros se limitan al trabajo de la etapa.
  • Si se especifica el ID de ejecución de trabajo junto con el ID de etapa y el ID de trabajo, se realiza una búsqueda entre todos los registros disponibles que coinciden con el ID de ejecución de trabajo especificado.

Uso:

ibmcloud dev pipeline-log [PIPELINE_ID] [--stage-id stageID] [--job-id jobID] [--job-exec-id jobExecutionID]

Parámetros del mandato pipeline-log

Los siguientes parámetros se pueden utilizar con el mandato pipeline-log o actualizando el archivo cli-config.yml de la app directamente.

Los parámetros de mandatos especificados en la línea de mandatos tienen prioridad sobre la configuración cli-config.yml.

job-id

  • Parámetro utilizado para filtrar los registros por el ID de trabajo.
  • Necesita el distintivo stage-id.
  • Uso:ibmcloud dev pipeline-log [PIPELINE_ID] --stage-id [stageID] --job-id [jobID]

job-exec-id

  • Parámetro utilizado para filtrar los registros por el ID de ejecución de trabajo.
  • Necesita el distintivo stage-id.
  • Necesita el distintivo job-id.
  • Uso:ibmcloud dev pipeline-log [PIPELINE_ID] --stage-id [stageID] --job-id [jobID] --job-exec-id [jobExecutionID]

stage-id

  • Parámetro utilizado para filtrar los registros por el ID de etapa.
  • Uso:ibmcloud dev pipeline-log [PIPELINE_ID] --stage-id [stageID]

trace

  • Utilice este parámetro para proporcionar una salida detallada.
  • Uso:ibmcloud dev pipeline-log [PIPELINE_ID] --trace

pipeline-open

Ver el URL correspondiente al conducto Clásico mediante el mandato pipeline-open. El mandato pipeline-open también abre el URL en el navegador predeterminado.

ibmcloud dev pipeline-open [PIPELINE_ID]

Parámetros del mandato pipeline-open

El siguiente parámetro se puede utilizar con el mandato pipeline-open o actualizando el archivo cli-config.yml de la app directamente.

Los parámetros de mandatos especificados en la línea de mandatos tienen prioridad sobre la configuración cli-config.yml.

trace

  • Utilice este parámetro para proporcionar una salida detallada.
  • Uso:ibmcloud dev pipeline-open [PIPELINE_ID] --trace

tekton-info

Ver los detalles de una interconexión de Tekton.

ibmcloud dev tekton-info [PIPELINE_ID] [--verbose][--output JSON]

Parámetros del mandato tekton-info

Los parámetros siguientes se pueden utilizar con el mandato tekton-info.

verbose

  • Utilice este parámetro para proporcionar todos los detalles de una interconexión en formato JSON.
  • Uso:ibmcloud dev tekton-info [PIPELINE_ID] --verbose

json

  • Parámetro que sirve para mostrar los detalles del conducto en formato JSON.
  • Uso:ibmcloud dev tekton-info [PIPELINE_ID] --output JSON

trace

  • Utilice este parámetro para proporcionar una salida detallada.
  • Uso:ibmcloud dev tekton-info [PIPELINE_ID] --trace

tekton-logs

Ver los registros de ejecución de la interconexión de Tekton recientes utilizando el mandato tekton-logs.

  • El ID de ejecución de interconexión es un argumento necesario.
  • Si el nombre de la tarea se especifica como argumento, sólo se recuperan los registros de esta tarea.

Uso:

ibmcloud dev tekton-logs [PIPELINE_ID] --run-id [pipelinerunID] [--task-name taskName] [--output JSON]

Parámetros del mandato tekton-logs

Los parámetros siguientes se pueden utilizar con el mandato tekton-logs.

run-id (obligatorio)

  • Un parámetro que identifica la canalización ejecutada para la recuperación del registro.
  • Uso:ibmcloud dev tekton-logs [PIPELINE_ID] --run-id [pipelinerunID]

task-name

  • Parámetro que se utiliza para filtrar los registros por el nombre de tarea de ejecución de interconexión.
  • Uso:ibmcloud dev tekton-logs [PIPELINE_ID] --run-id [pipelinerunID] --task-name [taskName]

json

  • Parámetro que se utiliza para generar los detalles de registro en formato JSON.
  • Uso:ibmcloud dev tekton-logs [PIPELINE_ID] --run-id [pipelinerunID] --output JSON

trace

  • Utilice este parámetro para proporcionar una salida detallada.
  • Uso:ibmcloud dev tekton-logs [PIPELINE_ID] --run-id [pipelinerunID] --trace

tekton-pipeline-cancelar

Cancelar una ejecución de interconexión de Tekton en curso.

ibmcloud dev tekton-pipeline-cancel [PIPELINE_ID] --run-id [pipelinerunID] [--trace]`

Parámetros del mandato tekton-pipeline-cancel

Los parámetros siguientes se pueden utilizar con el mandato tekton-pipeline-cancel.

run-id (obligatorio)

  • Un parámetro que identifica la ejecución del pipeline a cancelar.
  • Uso:ibmcloud dev tekton-pipeline-cancel [PIPELINE_ID] --run-id [pipelinerunID]

trace

  • Utilice este parámetro para proporcionar una salida detallada.
  • Uso:ibmcloud dev tekton-pipeline-cancel [PIPELINE_ID] --run-id [pipelinerunID] --trace

tekton-pipelinerun

Ver los detalles de una ejecución de interconexión de Tekton o utilizar el parámetro ls para listar todas las ejecuciones de interconexión para la interconexión.

Uso:

ibmcloud dev tekton-pipelinerun [PIPELINE_ID] --run-id [pipelinerunID] [--output JSON]
ibmcloud dev tekton-pipelinerun ls [PIPELINE_ID]

Parámetros del mandato tekton-pipelinerun

Los parámetros siguientes se pueden utilizar con el mandato tekton-pipelinerun.

run-id (obligatorio)

  • Parámetro que identifica la ejecución de interconexión para recuperar.
  • Uso:ibmcloud dev tekton-pipelinerun [PIPELINE_ID] --run-id [pipelinerunID]

json

  • Parámetro que se utiliza para generar detalles de ejecución de interconexión en formato JSON.
  • Uso:ibmcloud dev tekton-pipelinerun [PIPELINE_ID] --run-id [pipelinerunID] --output JSON

trace

  • Utilice este parámetro para proporcionar una salida detallada.
  • Uso:ibmcloud dev tekton-pipelinerun [PIPELINE_ID] --run-id [pipelinerunID] --trace

tekton-pipelineruns

Ver una lista de ejecuciones de interconexión para interconexión Tekton.

Uso:

ibmcloud dev tekton-pipelineruns [PIPELINE_ID] [--output JSON]

Parámetros del mandato tekton-pipelineruns

Los parámetros siguientes se pueden utilizar con el mandato tekton-pipelineruns.

json

  • Parámetro que se utiliza para generar la salida de las ejecuciones de la interconexión en formato JSON.
  • Uso:ibmcloud dev tekton-pipelineruns [PIPELINE_ID] --output JSON

trace

  • Utilice este parámetro para proporcionar una salida detallada.
  • Uso:ibmcloud dev tekton-pipelineruns [PIPELINE_ID] --trace

tekton-trigger

Ejecutar una interconexión Tekton.

Uso:

ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName [--description "a description"] [--trigger-properties propertiesJSON] [--secure-trigger-properties securePropertiesJSON] [--trigger-headers headerJSON] [--trigger-body bodyJSON] [--output JSON]

Parámetros del mandato tekton-trigger

Los parámetros siguientes se pueden utilizar con el mandato tekton-trigger.

trigger-name (obligatorio)

  • Utilice este parámetro para indicar el desencadenante que se debe ejecutar.
  • Uso:ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName

description (opcional)

  • Opcional. Utilice este parámetro para especificar una descripción para el Tekton creado pipelineRun.
  • Uso:ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --description "My description"

trigger-properties (opcional)

  • Opcional. Utilice este parámetro para modificar o añadir propiedades de desencadenante definidas. Por ejemplo,'{"pipeline-debug":"true"}'.
  • Uso:ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --trigger-properties propertiesJSON

secure-trigger-properties (opcional)

  • Opcional. Utilice este parámetro para alterar temporalmente o añadir a propiedades de desencadenante definidas cuyos valores deben ocultarse detrás de puntos o asteriscos en salidas posteriores. Por ejemplo, '{"deployer-api-key":"s0mEThING_v3Ry_s3CReT"}'
  • Uso:ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --secure-trigger-properties securePropertiesJSON

trigger-headers (opcional)

  • Opcional. Utilice este parámetro para especificar las cabeceras que se utilizan en triggerBinding de un Tekton pipelineRun. Por ejemplo,'{"source":"cli","flag":"enable"}'.
  • Uso:ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --trigger-headers headerJSON

trigger-body (opcional)

  • Opcional. Utilice este parámetro para especificar el cuerpo que se utiliza en triggerBinding de un Tekton pipelineRun. Por ejemplo,'{"message":"hello world","flag":"enable"}'.
  • Uso:ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --trigger-body bodyJSON

json

  • Utilice este parámetro para generar los resultados del desencadenante en formato JSON.
  • Uso:ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --output JSON

trace

  • Utilice este parámetro para proporcionar una salida detallada.
  • Uso:ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --trace

toolchain-delete

Suprimir una cadena de herramientas. Si no se proporciona ningún nombre de cadena de herramientas, puede seleccionar uno en una lista. La lista de cadenas de herramientas depende del grupo de recursos y de la región de destino actuales.

El grupo de recursos de destino se encuentra en la IBMCLOUD API Key. Para obtener más información, consulte Establecimiento o visualización de la cuenta, la región o el grupo de recursos de destino.

ibmcloud dev toolchain-delete [toolchainName] [--force,-f]

Parámetros del mandato toolchain-delete

Los siguientes parámetros se pueden utilizar con el mandato toolchain-delete o actualizando el archivo cli-config.yml de la app directamente.

Los parámetros de mandatos especificados en la línea de mandatos tienen prioridad sobre la configuración cli-config.yml.

force

  • Parámetro que se utiliza para omitir la confirmación de solicitud para suprimir una cadena de herramientas.
  • Uso:ibmcloud dev toolchain-delete [toolchainName] --force

trace

  • Utilice este parámetro para proporcionar una salida detallada.
  • Uso:ibmcloud dev toolchain-delete [toolchainName] --trace

toolchain-get

Ver los detalles de una cadena de herramientas. Si no se proporciona ningún nombre de cadena de herramientas, puede seleccionar uno en una lista.

Utiliza el grupo de recursos de destino de la IBMCLOUD API Key. Para obtener más información, consulte Establecimiento o visualización de la cuenta, la región o el grupo de recursos de destino.

ibmcloud dev toolchain-get [toolchainName] [--output JSON]

Parámetros del mandato toolchain-get

Los siguientes parámetros se pueden utilizar con el mandato toolchain-get o actualizando el archivo cli-config.yml de la app directamente.

Los parámetros de mandatos especificados en la línea de mandatos tienen prioridad sobre la configuración cli-config.yml.

json

  • Parámetro que sirve para mostrar los detalles de la cadena de herramientas en formato JSON.
  • Uso:ibmcloud dev toolchain-get [toolchainName] --output JSON

trace

  • Utilice este parámetro para proporcionar una salida detallada.
  • Uso:ibmcloud dev toolchain-get [toolchainName] --trace

toolchain-open

Ver el URL correspondiente a la cadena de herramientas mediante el mandato toolchain-open. El mandato toolchain-open también abre el URL en el navegador predeterminado. Si no se proporciona ningún nombre de cadena de herramientas, se proporciona una lista de cadenas de herramientas para que pueda seleccionar una.

ibmcloud dev toolchain-open [toolchainName]

Parámetros del mandato toolchain-open

El siguiente parámetro se puede utilizar con el mandato toolchain-open o actualizando el archivo cli-config.yml de la app directamente.

Los parámetros de mandatos especificados en la línea de mandatos tienen prioridad sobre la configuración cli-config.yml.

trace

  • Utilice este parámetro para proporcionar una salida detallada.
  • Uso:ibmcloud dev toolchain-open [toolchainName] --trace

cadenas de herramientas

Visualice una lista de las cadenas de herramientas del grupo de recursos actual.

Utiliza el grupo de recursos de destino de la IBMCLOUD API Key. Para obtener más información, consulte Establecimiento o visualización de la cuenta, la región o el grupo de recursos de destino.

ibmcloud dev toolchains [--output JSON]

Parámetros del mandato toolchains

Los siguientes parámetros se pueden utilizar con el mandato toolchains o actualizando el archivo cli-config.yml de la app directamente.

Los parámetros de mandatos especificados en la línea de mandatos tienen prioridad sobre la configuración cli-config.yml.

json

  • Parámetro que sirve para mostrar las cadenas de herramientas en formato JSON.
  • Uso:ibmcloud dev toolchains --output JSON

trace

  • Utilice este parámetro para proporcionar una salida detallada.
  • Uso:ibmcloud dev toolchains --trace