FerryDocs

Which services a push deploys

A push deploys each service that tracks the repository and the branch, with auto-deploy on.

Edit on GitHub
Push to maingithub.com/you/apiapibranch mainworkerbranch mainbetabranch develop

A push to main comes in. Three services use this repository.

1 / 3

The four conditions

A push deploys each service that obeys all of these:

  1. Its git has a URL that matches the repository of the push.
  2. It tracks the of the push (refs/heads/<branch>).
  3. is on.
  4. You did not suspend it.

One push can match more than one service, for example the services of a with different . The answer of Ferry lists the deploys in the queue.

Turn auto-deploy off or on

Terminal
ferry update api --no-auto-deploy   # off
ferry update api --auto-deploy      # on again

--no-auto-deploy also works on ferry create.

What Ferry ignores

  • A push of a tag or of a ref that is not a branch, and a push that deletes a branch.
  • A delivery that Ferry processed before: the same body, or the same X-GitHub-Delivery id. Ferry remembers the last 256 of each.
  • Each event that is not push or ping. Ferry answers 200 with {"ignored":true}.

If you send an old event again from GitHub, Ferry does not deploy it again.

On this page