plugin-drone-diagnostics/README.md

drone-diagnostics

A plugin with cli tools to diagnose issues in a build. Available here https://hub.docker.com/r/plugins/drone-diagnostics

Usage

This plugin has a number of diagnosic tools installed, use the command syntax to access them.

Installed tools:

• ping
• traceroute
• dig

Example 1

The below example skips the implicit clone step. Then displays the environment variables, then checks access to github. With ping and traceroute.

kind: pipeline
name: default

clone:
  disable: true

steps:
- name: run plugins/drone-diagnostics plugin
  image: plugins/drone-diagnostics
  pull: if-not-exists
  commands:
    - env
    - ping www.github.com -w 5
    - traceroute -T -p 443 www.github.com
    - dig www.apple.com
    - echo "end of test"

Example 2

If the ftp upload fails, check connectivity to the ftp server. Useful for flakey networks.

kind: pipeline
name: default

steps:
- name: upload to ftp server
  image: alpine
  commands:
    - echo 'ftp rules' # perform some ftp commands
- name: run plugins/drone-diagnostics plugin
  image: plugins/drone-diagnostics
  pull: if-not-exists
  commands:
    - ping ftp.server
    - echo "end of test"
  when:
    status:
    - failure

Building

Build the plugin image:

docker build -t plugins/drone-diagnostics -f docker/Dockerfile .