Skip to main content

Use Drone plugins

Drone plugins are Docker containers that perform predefined tasks. You can use the Plugin step to run plugins from the Drone Plugins Marketplace in your Harness CI pipelines. You can also write your own custom plugins. For more information about plugins, go to Explore plugins.

This topic assumes you're familiar with pipeline creation. If you haven't created a pipeline before, try one of the CI tutorials.

About Drone

Drone was acquired by Harness in 2020 and is part of Harness CI.

For more information on the acquisition of Drone, go to the following blog posts:

Add a plugin to a Harness CI pipeline​

To demonstrate how to add a Drone plugin to a Harness CI pipeline, these steps use the Download plugin as an example. This plugin downloads an archive to the stage workspace.

Add the Plugin step to your CI stage with the following settings:

The following examples show the YAML definition for a Plugin step configured for the Download plugin.

This example downloads the Drone Linux amd64 tarball. It provides a username and password for authentication to GitHub.

              - step:
                  type: Plugin
                  name: drone plugin
                  identifier: drone_plugin
                  spec:
                    connectorRef: account.docker
                    image: plugins/download
                    settings:
                      source: https://github.com/drone/drone-cli/releases/download/v0.8.5/drone_linux_amd64.tar.gz ## Target to download
                      username: my-username ## Username for authentication to the source
                      password: `<+secrets.getValue("mygithubpersonalaccesstoken")>` ## Password for authentication to the source
Tips

You can use variable expressions for Settings values, such as credentials: <+stage.variables.[TOKEN_SECRET]>, which uses a stage variable.

Create text secrets for sensitive information, such as passwords and tokens, required by the plugin.

When you run the pipeline, check the log output to verify that the plugin works as intended.

Plugin settings​

For information about a plugin's settings, go to the plugin's page on the Drone Plugins Marketplace. In addition to the settings described on a plugin's Marketplace page, each plugin has a README where you can read about the plugin's settings in detail. The README can include additional or uncommon settings that aren't described on the Marketplace page or the Harness CI documentation. You can find README links at the top of each plugin's Marketplace page.

The README link is at the top of each plugin's Drone Plugin Marketplace page.

Output variables​

For information about output variables produced by plugins, refer to Output variables in the Plugin step settings reference.

Plugin configuration examples​

Here are some YAML examples and additional information about specific Drone plugins.

Artifact Metadata Publisher plugin

Use the artifact-metadata-publisher plugin to publish a URL of an artifact file to the Artifacts tab.

An example of the Plugin step configuration is provided below; however your pipeline must also include steps to upload the file that you want to link to on the Artifacts tab, as demonstrated in the Publish any URL to the Artifacts tab tutorial.

               - step:
                  type: Plugin
                  name: metadata publisher plugin
                  identifier: metadata_publisher_plugin
                  spec:
                    connectorRef: account.harnessImage ## A Docker connector ID
                    image: plugins/artifact-metadata-publisher
                    settings:
                      file_urls: https://storage.googleapis.com/.../index.html ## URL for the storage location where the data file is located.
                      artifact_file: artifact.txt ## The name of the artifact file
GitHub Actions plugin
Jira plugin
Slack plugin

Harness has built-in notifications for email, Microsoft Teams, and Slack.

Convert Drone YAML to Harness YAML​

The YAML examples in the Drone Plugins Marketplace can help you configure settings for a Plugin step in Harness CI. Many plugins offer both Harness and standalone Drone YAML samples, as indicated by the Drone/Harness toggle in the Example section.

You can switch between Drone YAML and Harness YAML in the Drone Plugins Marketplace.

Because Drone plugins can be used outside Harness CI, there are some differences, as explained below, in the YAML format when using Drone plugins in Harness CI versus outside Harness CI. This information focuses on the step YAML definition.

Step structure​

The following examples compare the YAML structure for a step when a Drone plugin is used in a Drone pipeline and a Harness CI pipeline.

steps:
- name: download ## Step name
  image: plugins/download ## Plugin's Docker image
  settings: ## Plugin settings
    source: https://github.com/drone/drone-cli/releases/download/v0.8.5/drone_linux_amd64.tar.gz

Listed and nested settings​

To convert list-formatted settings from Drone Plugin YAML to Harness CI YAML, merge them with comma separation.

Settings:
  tags:
    - latest
    - '1.0.1'
    - '1.0'

For nested settings, maintain key-value pair definitions, as shown in the following Harness CI YAML example:

settings:
  mynestedsetting:
    nextlevel:
      varname: 100
  mylistsetting:
   - itemone
   - itemtwo

It's often easier to define complex settings in the Harness Pipeline Studio's YAML editor, rather than the Visual editor.

Using the Visual editor to configure Plugin settings.

Text secrets​

The following snippets illustrate the different ways that Drone and Harness CI handle text secrets.

steps:
    - name: download
      image: plugins/download
      settings:
        username:
            from_secret: username
        password:
            from_secret: password
        source: https://github.com/drone/drone-cli/releases/download/v0.8.5/drone_linux_amd64.tar.gz