mirror of
https://github.com/drone-plugins/drone-diagnostics.git
synced 2026-06-16 14:49:36 +08:00
TP Honey
67 lines
1.2 KiB
Markdown
67 lines
1.2 KiB
Markdown
# drone-diagnostics
|
|
|
|
A plugin with cli tools to diagnose issues in a build.
|
|
|
|
## Usage
|
|
|
|
This plugin has a number of diagnosic tools installed, use the command syntax to access them.
|
|
|
|
Installed tools:
|
|
|
|
- ping
|
|
- traceroute
|
|
|
|
### Example 1
|
|
|
|
The below example skips the implicit clone step. Then displays the environment variables, then checks access to github. With ping and traceroute.
|
|
|
|
```yaml
|
|
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
|
|
- echo "end of test"
|
|
```
|
|
|
|
### Example 2
|
|
|
|
If the ftp upload fails, check connectivity to the ftp server. Useful for flakey networks.
|
|
|
|
```yaml
|
|
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:
|
|
|
|
```text
|
|
docker build -t plugins/drone-diagnostics -f docker/Dockerfile .
|
|
```
|