Skip to main content

Use Argos with Drone CI

Configure Drone CI to send screenshots to Argos visual testing platform.

1. Install Argos CLI

npm i --save-dev @argos-ci/cli

Read the CLI documentation if you need information about advanced usages.

2. Expose ARGOS_TOKEN as environment variable

  1. Log in to Argos, navigate to your project settings and copy your ARGOS_TOKEN.
  2. In your DroneCI repository go to Secrets.
  3. Add a new secret called argos_token and paste the value you copied in the previous step.
  4. Source the environment variable from the named secret.
kind: pipeline
name: default

steps:
- name: build
image: alpine
environment:
ARGOS_TOKEN:
from_secret: argos_token

If you are not comfortable with exposing environment variables, read Drone CI documentation.

3. Upload the screenshots

Add the following command to your CI workflow to upload screenshots to Argos:

npm exec argos upload ./screenshots

Complete example

.drone.yml
kind: pipeline
type: docker
name: default

steps:
# 👉 Insert the steps required to take screenshots

- name: Upload screenshots to argos-ci.com
commands:
# 👇 change "./screenshots" by your screenshots folder path
- npm exec argos upload ./screenshots
secrets: [ARGOS_TOKEN]

For a repository examples, check out our GitHub repository.

What's next?

Congratulations on installing Argos! 🎉
The next step is to integrate visual review into your development workflow. Visit our review changes section to learn how to.