Documentation of Werf comprises ~100 articles which include common use cases (getting started, deploy to Kubernetes, CI/CD integration and more), comprehensive description of its functions & architecture, as well as CLI, commands.

We recommend to start discovering from our Guides section:

The next step is Configuration section.

To use Werf an application should be configured in werf.yaml file. This configuration includes:

  1. Definition of project meta information such as project name, which will affect build, deploy and other commands.
  2. Definition of the images to be built.

In the Overview article you can find information about:

  • Structure and config sections.
  • Organization approaches.
  • Config processing steps.
  • Supported Go templates functions.

Other section articles give detailed information about Dockerfile Image, Stapel Image and Stapel Artifact directives and their features of usage.

Reference section is dedicated to Werf main processes:

Each article describes a certain process: process composition, available options and features.

Also, this section includes articles with base primitives and general tools:

Werf is a CLI utility, so if you want to find a description of both basic commands needed to provide the CI/CD process and service commands that provide advanced functionality — use CLI Commands section.

Development section contains service and maintenance manuals and other docs which help developers to understand how some werf subsystem works, how to maintain some subsystem in the actual state, how to write and build new code for the werf, etc.