Comandos do IBM Cloud CLI Developer Tools (ibmcloud dev)

A interface de linha de comando IBM Cloud® inclui os comandos Developer Tools (ibmcloud dev) para gerenciar pipelines clássicos, pipelines Tekton e cadeias de ferramentas.

help

Por padrão, se nenhuma ação ou argumento for passado ou se a ação 'help' for fornecida, esse comando mostrará um texto de "Ajuda" geral. A ajuda geral exibida inclui uma descrição dos argumentos base e uma listagem das ações disponíveis.

Execute o comando a seguir para exibir informações da ajuda Geral:

ibmcloud dev help

pipeline-get

Visualize os detalhes de um Pipeline clássico.

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

Parâmetros do comando pipeline-get

json

  • O parâmetro que é usado para a saída dos detalhes do pipeline no formato JSON.
  • Uso: ibmcloud dev pipeline-get [PIPELINE_ID] --output JSON

O parâmetro a seguir pode ser usado com o comando pipeline-get ou atualizando o arquivo cli-config.yml do app diretamente.

Os parâmetros de comando que são inseridos na linha de comandos têm precedência sobre a configuração cli-config.yml.

trace

  • Use esse parâmetro para fornecer saída detalhada.
  • Uso: ibmcloud dev pipeline-get [PIPELINE_ID] --trace

pipeline-run

Execute um Pipeline clássico.

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

Parâmetros do comando pipeline-run

Os parâmetros a seguir podem ser usados com o comando pipeline-run ou atualizando o arquivo cli-config.yml do app diretamente.

Os parâmetros de comando que são inseridos na linha de comandos têm precedência sobre a configuração cli-config.yml.

stage-id

  • Parâmetro opcionalmente usado para selecionar o estágio de um pipeline a ser executado
  • Uso: ibmcloud dev pipeline-run [PIPELINE_ID] --stage-id [stageID]

json

  • O parâmetro que é usado para a saída dos detalhes de chamada do pipeline no formato JSON.
  • Uso: ibmcloud dev pipeline-run [PIPELINE_ID] --output JSON

trace

  • Use esse parâmetro para fornecer saída detalhada.
  • Uso: ibmcloud dev pipeline-run [PIPELINE_ID] --trace

pipeline-log

Visualize logs de Pipeline clássico recentes usando o comando pipeline-log.

  • Se o ID do pipeline for especificado como um argumento, todos os logs para todas as tarefas em todos os estágios serão impressos para esse pipeline.
  • Se o sinalizador de ID do estágio for preenchido, os logs serão filtrados por esse estágio no pipeline.
  • Se o ID da tarefa for especificado com o ID do estágio, os logs serão filtrados para apenas a tarefa no estágio.
  • Se o ID de execução da tarefa for especificado juntamente com o ID do estágio e o ID da tarefa, uma procura será feita entre todos os logs disponíveis que correspondam ao ID de execução de tarefa especificado.

Uso:

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

Parâmetros do comando pipeline-log

Os parâmetros a seguir podem ser usados com o comando pipeline-log ou atualizando o arquivo cli-config.yml do app diretamente.

Os parâmetros de comando que são inseridos na linha de comandos têm precedência sobre a configuração cli-config.yml.

job-id

  • O parâmetro que é usado para filtrar os logs pelo ID da tarefa.
  • Requer o sinalizador stage-id.
  • Uso: ibmcloud dev pipeline-log [PIPELINE_ID] --stage-id [stageID] --job-id [jobID]

job-exec-id

  • O parâmetro que é usado para filtrar os logs pelo ID de execução da tarefa.
  • Requer o sinalizador stage-id.
  • Requer o sinalizador job-id.
  • Uso: ibmcloud dev pipeline-log [PIPELINE_ID] --stage-id [stageID] --job-id [jobID] --job-exec-id [jobExecutionID]

stage-id

  • O parâmetro que é usado para filtrar os logs pelo ID do estágio.
  • Uso: ibmcloud dev pipeline-log [PIPELINE_ID] --stage-id [stageID]

trace

  • Use esse parâmetro para fornecer saída detalhada.
  • Uso: ibmcloud dev pipeline-log [PIPELINE_ID] --trace

pipeline-open

Visualize a URL para o Pipeline clássico por meio do comando pipeline-open. O comando pipeline-open também abre a URL em seu navegador padrão.

ibmcloud dev pipeline-open [PIPELINE_ID]

Parâmetros de comando pipeline-open

O parâmetro a seguir pode ser usado com o comando pipeline-open ou atualizando o arquivo cli-config.yml do app diretamente.

Os parâmetros de comando que são inseridos na linha de comandos têm precedência sobre a configuração cli-config.yml.

trace

  • Use esse parâmetro para fornecer saída detalhada.
  • Uso: ibmcloud dev pipeline-open [PIPELINE_ID] --trace

tekton-info

Visualize os detalhes de um pipeline de Tekton.

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

parâmetros do comando tekton-info

Os parâmetros a seguir podem ser usados com o comando tekton-info.

verbose

  • Use este parâmetro para fornecer todos os detalhes de um pipeline no formato JSON.
  • Uso: ibmcloud dev tekton-info [PIPELINE_ID] --verbose

json

  • O parâmetro que é usado para a saída dos detalhes do pipeline no formato JSON.
  • Uso: ibmcloud dev tekton-info [PIPELINE_ID] --output JSON

trace

  • Use esse parâmetro para fornecer saída detalhada.
  • Uso: ibmcloud dev tekton-info [PIPELINE_ID] --trace

tekton-logs

Veja os logs de execução do pipeline Tekton recentes usando o comando tekton-logs.

  • O ID de execução do pipeline é um argumento obrigatório.
  • Se o nome da tarefa for especificado como um argumento, apenas os logs para esta tarefa serão recuperados.

Uso:

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

Parâmetros do comando tekton-logs

Os parâmetros a seguir podem ser usados com o comando tekton-logs.

run-id(obrigatório)

  • Um parâmetro que identifica a execução do pipeline para a recuperação do registro.
  • Uso: ibmcloud dev tekton-logs [PIPELINE_ID] --run-id [pipelinerunID]

task-name

  • Parâmetro usado para filtrar os logs pelo nome da tarefa de execução do pipeline.
  • Uso: ibmcloud dev tekton-logs [PIPELINE_ID] --run-id [pipelinerunID] --task-name [taskName]

json

  • Parâmetro que é usado para produzir os detalhes do log no formato JSON.
  • Uso: ibmcloud dev tekton-logs [PIPELINE_ID] --run-id [pipelinerunID] --output JSON

trace

  • Use esse parâmetro para fornecer saída detalhada.
  • Uso: ibmcloud dev tekton-logs [PIPELINE_ID] --run-id [pipelinerunID] --trace

tekton-pipeline-cancelar

Cancele uma execução de pipeline do Tekton em andamento

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

parâmetros do comando tekton-pipeline-cancel

Os parâmetros a seguir podem ser usados com o comando tekton-pipeline-cancel.

run-id(obrigatório)

  • Um parâmetro que identifica a execução do pipeline a ser cancelada.
  • Uso: ibmcloud dev tekton-pipeline-cancel [PIPELINE_ID] --run-id [pipelinerunID]

trace

  • Use esse parâmetro para fornecer saída detalhada.
  • Uso: ibmcloud dev tekton-pipeline-cancel [PIPELINE_ID] --run-id [pipelinerunID] --trace

tekton-pipelinerun

Visualize os detalhes de uma execução de pipeline Tekton ou use o parâmetro ls para listar todas as execuções de pipeline para o pipeline.

Uso:

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

Parâmetros dp comando tekton-pipelinerun

Os parâmetros a seguir podem ser usados com o comando tekton-pipelinerun.

run-id(obrigatório)

  • Parâmetro que identifica a execução do pipeline a ser recuperado.
  • Uso: ibmcloud dev tekton-pipelinerun [PIPELINE_ID] --run-id [pipelinerunID]

json

  • Parâmetro que é usado para produzir os detalhes de execução do pipeline no formato JSON.
  • Uso: ibmcloud dev tekton-pipelinerun [PIPELINE_ID] --run-id [pipelinerunID] --output JSON

trace

  • Use esse parâmetro para fornecer saída detalhada.
  • Uso: ibmcloud dev tekton-pipelinerun [PIPELINE_ID] --run-id [pipelinerunID] --trace

tekton-pipelineruns

Visualize uma lista de execuções de pipeline para um pipeline de Tekton.

Uso:

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

tekton-pipelineruns command parameters

Os parâmetros a seguir podem ser usados com o comando tekton-pipelineruns.

json

  • O parâmetro usado para a saída do pipeline é executado no formato JSON.
  • Uso: ibmcloud dev tekton-pipelineruns [PIPELINE_ID] --output JSON

trace

  • Use esse parâmetro para fornecer saída detalhada.
  • Uso: ibmcloud dev tekton-pipelineruns [PIPELINE_ID] --trace

tekton-trigger

Execute um pipeline de 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 do comando tekton-trigger

Os parâmetros a seguir podem ser usados com o comando tekton-trigger.

trigger-name(obrigatório)

  • Use este parâmetro para indicar o acionador a ser executado.
  • Uso: ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName

description (opcional)

  • Opcional. Use esse parâmetro para especificar uma descrição para o Tekton pipelineRun criado.
  • Uso: ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --description "My description"

trigger-properties (opcional)

  • Opcional. Use este parâmetro para substituir ou anexar às propriedades de acionador definidas. Por exemplo, '{"pipeline-debug":"true"}'.
  • Uso: ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --trigger-properties propertiesJSON

secure-trigger-properties (opcional)

  • Opcional. Use este parâmetro para substituir ou anexar a propriedades de disparo definidas cujos valores devem ser ocultados atrás de pontos ou asteriscos em saídas posteriores. Por exemplo,'{"deployer-api-key":"s0mEThING_v3Ry_s3CReT"}'
  • Uso: ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --secure-trigger-properties securePropertiesJSON

trigger-headers (opcional)

  • Opcional. Use esse parâmetro para especificar os cabeçalhos que são usados em triggerBinding de um Tekton pipelineRun. Por exemplo, '{"source":"cli","flag":"enable"}'.
  • Uso: ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --trigger-headers headerJSON

trigger-body (opcional)

  • Opcional. Use este parâmetro para especificar o corpo que é usado no triggerBinding de um Tekton pipelineRun. Por exemplo, '{"message":"hello world","flag":"enable"}'.
  • Uso: ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --trigger-body bodyJSON

json

  • Use este parâmetro para gerar os resultados do acionador no formato JSON.
  • Uso: ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --output JSON

trace

  • Use esse parâmetro para fornecer saída detalhada.
  • Uso: ibmcloud dev tekton-trigger PIPELINE_ID --trigger-name triggerName --trace

toolchain-delete

Exclua uma cadeia de ferramentas. Se nenhum nome de cadeia de ferramentas for fornecido, será possível selecionar um em uma lista. A lista de cadeias de ferramentas depende dos atuais grupo de recursos e região de destino.

O grupo de recursos de destino está localizado no IBMCLOUD API Key. Para obter mais informações, consulte Configurar ou visualizar a conta, a região ou o grupo de recursos de destino.

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

Parâmetros do comando toolchain-delete

Os parâmetros a seguir podem ser usados com o comando toolchain-delete ou atualizando o arquivo cli-config.yml do app diretamente.

Os parâmetros de comando que são inseridos na linha de comandos têm precedência sobre a configuração cli-config.yml.

force

  • O parâmetro que é usado para ignorar a confirmação do prompt para exclusão de uma cadeia de ferramentas.
  • Uso: ibmcloud dev toolchain-delete [toolchainName] --force

trace

  • Use esse parâmetro para fornecer saída detalhada.
  • Uso: ibmcloud dev toolchain-delete [toolchainName] --trace

toolchain-get

Visualize os detalhes de uma cadeia de ferramentas. Se nenhum nome de cadeia de ferramentas for fornecido, será possível selecionar um em uma lista.

Usa o grupo de recursos de destino no IBMCLOUD API Key. Para obter mais informações, consulte Configurar ou visualizar a conta, a região ou o grupo de recursos de destino.

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

Parâmetros do comando toolchain-get

Os parâmetros a seguir podem ser usados com o comando toolchain-get ou atualizando o arquivo cli-config.yml do app diretamente.

Os parâmetros de comando que são inseridos na linha de comandos têm precedência sobre a configuração cli-config.yml.

json

  • O parâmetro que é usado para a saída dos detalhes da cadeia de ferramentas no formato JSON.
  • Uso: ibmcloud dev toolchain-get [toolchainName] --output JSON

trace

  • Use esse parâmetro para fornecer saída detalhada.
  • Uso: ibmcloud dev toolchain-get [toolchainName] --trace

toolchain-open

Visualize a URL para a cadeia de ferramentas por meio do comando toolchain-open. O comando toolchain-open também abre a URL em seu navegador padrão. Se nenhum nome de cadeia de ferramentas for fornecido, uma lista de cadeias de ferramentas será fornecida para seleção.

ibmcloud dev toolchain-open [toolchainName]

Parâmetros de comando toolchain-open

O parâmetro a seguir pode ser usado com o comando toolchain-open ou atualizando o arquivo cli-config.yml do app diretamente.

Os parâmetros de comando que são inseridos na linha de comandos têm precedência sobre a configuração cli-config.yml.

trace

  • Use esse parâmetro para fornecer saída detalhada.
  • Uso: ibmcloud dev toolchain-open [toolchainName] --trace

cadeias de ferramentas

Visualize uma lista de cadeias de ferramentas no grupo de recursos atual.

Usa o grupo de recursos de destino no IBMCLOUD API Key. Para obter mais informações, consulte Configurar ou visualizar a conta, a região ou o grupo de recursos de destino.

ibmcloud dev toolchains [--output JSON]

Parâmetros do comando toolchains

Os parâmetros a seguir podem ser usados com o comando toolchains ou atualizando o arquivo cli-config.yml do app diretamente.

Os parâmetros de comando que são inseridos na linha de comandos têm precedência sobre a configuração cli-config.yml.

json

  • O parâmetro que é usado para a saída das cadeias de ferramentas no formato JSON.
  • Uso: ibmcloud dev toolchains --output JSON

trace

  • Use esse parâmetro para fornecer saída detalhada.
  • Uso: ibmcloud dev toolchains --trace