Comandos do IBM Cloud CLI Developer Tools (ibmcloud dev
)
A interface da linha de comandos IBM Cloud® inclui os comandos Developer Tools (ibmcloud dev
) ou (ic dev
) para gerenciar pipelines clássicos, pipelines do 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 [--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
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 pipePIPELINE_IDlineID --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 pipePIPELINE_IDlineID --trigger-name triggerName --secure-trigger-properties securePropertiesJSON
trigger-headers
(opcional)
- Opcional. Use esse parâmetro para especificar os cabeçalhos que são usados no triggerBinding de um pipelineRun da Tekton. 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