werf
✕
Join the party at CNCF Slack
Step 1:
Get an invite to CNCF Slack
Step 2:
Join #werf channel
We've chosen CNCF Slack since most of the Kubernetes community members are there.
Version
1.2 1.1
Stability channel
Rock-Solid Stable Early-Access Beta Alpha
OS
Linux Mac OS Windows
Installation method
using multiwerf (recommended) downloading binary package compiling from source

Install werf
for by

Install dependencies

Docker

Docker CE installation guide.

Manage Docker as a non-root user. Create the docker group and add your user to the group:

sudo groupadd docker
sudo usermod -aG docker $USER

Git command line utility

Git installation guide.

  • Minimum required version is 2.18.0.

Install werf

Installing multiwerf

# add ~/bin into PATH
export PATH=$PATH:$HOME/bin
echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

# install multiwerf into ~/bin directory
mkdir -p ~/bin
cd ~/bin
curl -L https://raw.githubusercontent.com/werf/multiwerf/master/get.sh | bash
Using werf in the current shell

This will create werf shell function which calls to the werf binary which multiwerf has been prepared for your session:

source $(multiwerf use 1.2 alpha --as-file)
werf version
...
Optional: activate werf on terminal startup
echo '. $(multiwerf use 1.2 alpha --as-file)' >> ~/.bashrc

How to use in the CI/CD system?

First ensure that multiwerf exists and is executable, use the type command. The command prints a message to stderr if multiwerf is not found. Thus, diagnostics in a CI/CD environment becomes simpler. Second enable werf in the CI/CD shell.

type multiwerf && . $(multiwerf use 1.2 alpha --as-file)
# We can use werf now
werf ...

# add ~/bin into PATH
export PATH=$PATH:$HOME/bin
echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

# install multiwerf into ~/bin directory
mkdir -p ~/bin
cd ~/bin
curl -L https://raw.githubusercontent.com/werf/multiwerf/master/get.sh | bash
Using werf in the current shell

This will create werf shell function which calls to the werf binary which multiwerf has been prepared for your session:

source $(multiwerf use 1.2 beta --as-file)
werf version
...
Optional: activate werf on terminal startup
echo '. $(multiwerf use 1.2 beta --as-file)' >> ~/.bashrc

How to use in the CI/CD system?

First ensure that multiwerf exists and is executable, use the type command. The command prints a message to stderr if multiwerf is not found. Thus, diagnostics in a CI/CD environment becomes simpler. Second enable werf in the CI/CD shell.

type multiwerf && . $(multiwerf use 1.2 beta --as-file)
# We can use werf now
werf ...

# add ~/bin into PATH
export PATH=$PATH:$HOME/bin
echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

# install multiwerf into ~/bin directory
mkdir -p ~/bin
cd ~/bin
curl -L https://raw.githubusercontent.com/werf/multiwerf/master/get.sh | bash
Using werf in the current shell

This will create werf shell function which calls to the werf binary which multiwerf has been prepared for your session:

source $(multiwerf use 1.2 ea --as-file)
werf version
...
Optional: activate werf on terminal startup
echo '. $(multiwerf use 1.2 ea --as-file)' >> ~/.bashrc

How to use in the CI/CD system?

First ensure that multiwerf exists and is executable, use the type command. The command prints a message to stderr if multiwerf is not found. Thus, diagnostics in a CI/CD environment becomes simpler. Second enable werf in the CI/CD shell.

type multiwerf && . $(multiwerf use 1.2 ea --as-file)
# We can use werf now
werf ...

# add ~/bin into PATH
export PATH=$PATH:$HOME/bin
echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

# install multiwerf into ~/bin directory
mkdir -p ~/bin
cd ~/bin
curl -L https://raw.githubusercontent.com/werf/multiwerf/master/get.sh | bash
Using werf in the current shell

This will create werf shell function which calls to the werf binary which multiwerf has been prepared for your session:

source $(multiwerf use 1.2 stable --as-file)
werf version
...
Optional: activate werf on terminal startup
echo '. $(multiwerf use 1.2 stable --as-file)' >> ~/.bashrc

How to use in the CI/CD system?

First ensure that multiwerf exists and is executable, use the type command. The command prints a message to stderr if multiwerf is not found. Thus, diagnostics in a CI/CD environment becomes simpler. Second enable werf in the CI/CD shell.

type multiwerf && . $(multiwerf use 1.2 stable --as-file)
# We can use werf now
werf ...

# add ~/bin into PATH
export PATH=$PATH:$HOME/bin
echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

# install multiwerf into ~/bin directory
mkdir -p ~/bin
cd ~/bin
curl -L https://raw.githubusercontent.com/werf/multiwerf/master/get.sh | bash
Using werf in the current shell

This will create werf shell function which calls to the werf binary which multiwerf has been prepared for your session:

source $(multiwerf use 1.2 rock-solid --as-file)
werf version
...
Optional: activate werf on terminal startup
echo '. $(multiwerf use 1.2 rock-solid --as-file)' >> ~/.bashrc

How to use in the CI/CD system?

First ensure that multiwerf exists and is executable, use the type command. The command prints a message to stderr if multiwerf is not found. Thus, diagnostics in a CI/CD environment becomes simpler. Second enable werf in the CI/CD shell.

type multiwerf && . $(multiwerf use 1.2 rock-solid --as-file)
# We can use werf now
werf ...

# add ~/bin into PATH
export PATH=$PATH:$HOME/bin
echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

# install multiwerf into ~/bin directory
mkdir -p ~/bin
cd ~/bin
curl -L https://raw.githubusercontent.com/werf/multiwerf/master/get.sh | bash
Using werf in the current shell

This will create werf shell function which calls to the werf binary which multiwerf has been prepared for your session:

source $(multiwerf use 1.1 alpha --as-file)
werf version
...
Optional: activate werf on terminal startup
echo '. $(multiwerf use 1.1 alpha --as-file)' >> ~/.bashrc

How to use in the CI/CD system?

First ensure that multiwerf exists and is executable, use the type command. The command prints a message to stderr if multiwerf is not found. Thus, diagnostics in a CI/CD environment becomes simpler. Second enable werf in the CI/CD shell.

type multiwerf && . $(multiwerf use 1.1 alpha --as-file)
# We can use werf now
werf ...

# add ~/bin into PATH
export PATH=$PATH:$HOME/bin
echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

# install multiwerf into ~/bin directory
mkdir -p ~/bin
cd ~/bin
curl -L https://raw.githubusercontent.com/werf/multiwerf/master/get.sh | bash
Using werf in the current shell

This will create werf shell function which calls to the werf binary which multiwerf has been prepared for your session:

source $(multiwerf use 1.1 beta --as-file)
werf version
...
Optional: activate werf on terminal startup
echo '. $(multiwerf use 1.1 beta --as-file)' >> ~/.bashrc

How to use in the CI/CD system?

First ensure that multiwerf exists and is executable, use the type command. The command prints a message to stderr if multiwerf is not found. Thus, diagnostics in a CI/CD environment becomes simpler. Second enable werf in the CI/CD shell.

type multiwerf && . $(multiwerf use 1.1 beta --as-file)
# We can use werf now
werf ...

# add ~/bin into PATH
export PATH=$PATH:$HOME/bin
echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

# install multiwerf into ~/bin directory
mkdir -p ~/bin
cd ~/bin
curl -L https://raw.githubusercontent.com/werf/multiwerf/master/get.sh | bash
Using werf in the current shell

This will create werf shell function which calls to the werf binary which multiwerf has been prepared for your session:

source $(multiwerf use 1.1 ea --as-file)
werf version
...
Optional: activate werf on terminal startup
echo '. $(multiwerf use 1.1 ea --as-file)' >> ~/.bashrc

How to use in the CI/CD system?

First ensure that multiwerf exists and is executable, use the type command. The command prints a message to stderr if multiwerf is not found. Thus, diagnostics in a CI/CD environment becomes simpler. Second enable werf in the CI/CD shell.

type multiwerf && . $(multiwerf use 1.1 ea --as-file)
# We can use werf now
werf ...

# add ~/bin into PATH
export PATH=$PATH:$HOME/bin
echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

# install multiwerf into ~/bin directory
mkdir -p ~/bin
cd ~/bin
curl -L https://raw.githubusercontent.com/werf/multiwerf/master/get.sh | bash
Using werf in the current shell

This will create werf shell function which calls to the werf binary which multiwerf has been prepared for your session:

source $(multiwerf use 1.1 stable --as-file)
werf version
...
Optional: activate werf on terminal startup
echo '. $(multiwerf use 1.1 stable --as-file)' >> ~/.bashrc

How to use in the CI/CD system?

First ensure that multiwerf exists and is executable, use the type command. The command prints a message to stderr if multiwerf is not found. Thus, diagnostics in a CI/CD environment becomes simpler. Second enable werf in the CI/CD shell.

type multiwerf && . $(multiwerf use 1.1 stable --as-file)
# We can use werf now
werf ...

# add ~/bin into PATH
export PATH=$PATH:$HOME/bin
echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

# install multiwerf into ~/bin directory
mkdir -p ~/bin
cd ~/bin
curl -L https://raw.githubusercontent.com/werf/multiwerf/master/get.sh | bash
Using werf in the current shell

This will create werf shell function which calls to the werf binary which multiwerf has been prepared for your session:

source $(multiwerf use 1.1 rock-solid --as-file)
werf version
...
Optional: activate werf on terminal startup
echo '. $(multiwerf use 1.1 rock-solid --as-file)' >> ~/.bashrc

How to use in the CI/CD system?

First ensure that multiwerf exists and is executable, use the type command. The command prints a message to stderr if multiwerf is not found. Thus, diagnostics in a CI/CD environment becomes simpler. Second enable werf in the CI/CD shell.

type multiwerf && . $(multiwerf use 1.1 rock-solid --as-file)
# We can use werf now
werf ...

# add ~/bin into PATH
export PATH=$PATH:$HOME/bin
echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

# enable ~/.bashrc bash startup script in your ~/.bash_profile bash login startup script
echo 'if [ -f "$HOME/.bashrc" ]; then' >> ~/.bash_profile
echo '  . "$HOME/.bashrc"' >> ~/.bash_profile
echo 'fi' >> ~/.bash_profile

# install multiwerf into ~/bin directory
mkdir -p ~/bin
cd ~/bin
curl -L https://raw.githubusercontent.com/werf/multiwerf/master/get.sh | bash
Using werf in the current shell

This will create werf shell function which calls to the werf binary which multiwerf has been prepared for your session:

source $(multiwerf use 1.2 alpha --as-file)
werf version
...
Optional: activate werf on terminal startup
echo '. $(multiwerf use 1.2 alpha --as-file)' >> ~/.bashrc

How to use in the CI/CD system?

First ensure that multiwerf exists and is executable, use the type command. The command prints a message to stderr if multiwerf is not found. Thus, diagnostics in a CI/CD environment becomes simpler. Second enable werf in the CI/CD shell.

type multiwerf && . $(multiwerf use 1.2 alpha --as-file)
# We can use werf now
werf ...

# add ~/bin into PATH
export PATH=$PATH:$HOME/bin
echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

# enable ~/.bashrc bash startup script in your ~/.bash_profile bash login startup script
echo 'if [ -f "$HOME/.bashrc" ]; then' >> ~/.bash_profile
echo '  . "$HOME/.bashrc"' >> ~/.bash_profile
echo 'fi' >> ~/.bash_profile

# install multiwerf into ~/bin directory
mkdir -p ~/bin
cd ~/bin
curl -L https://raw.githubusercontent.com/werf/multiwerf/master/get.sh | bash
Using werf in the current shell

This will create werf shell function which calls to the werf binary which multiwerf has been prepared for your session:

source $(multiwerf use 1.2 beta --as-file)
werf version
...
Optional: activate werf on terminal startup
echo '. $(multiwerf use 1.2 beta --as-file)' >> ~/.bashrc

How to use in the CI/CD system?

First ensure that multiwerf exists and is executable, use the type command. The command prints a message to stderr if multiwerf is not found. Thus, diagnostics in a CI/CD environment becomes simpler. Second enable werf in the CI/CD shell.

type multiwerf && . $(multiwerf use 1.2 beta --as-file)
# We can use werf now
werf ...

# add ~/bin into PATH
export PATH=$PATH:$HOME/bin
echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

# enable ~/.bashrc bash startup script in your ~/.bash_profile bash login startup script
echo 'if [ -f "$HOME/.bashrc" ]; then' >> ~/.bash_profile
echo '  . "$HOME/.bashrc"' >> ~/.bash_profile
echo 'fi' >> ~/.bash_profile

# install multiwerf into ~/bin directory
mkdir -p ~/bin
cd ~/bin
curl -L https://raw.githubusercontent.com/werf/multiwerf/master/get.sh | bash
Using werf in the current shell

This will create werf shell function which calls to the werf binary which multiwerf has been prepared for your session:

source $(multiwerf use 1.2 ea --as-file)
werf version
...
Optional: activate werf on terminal startup
echo '. $(multiwerf use 1.2 ea --as-file)' >> ~/.bashrc

How to use in the CI/CD system?

First ensure that multiwerf exists and is executable, use the type command. The command prints a message to stderr if multiwerf is not found. Thus, diagnostics in a CI/CD environment becomes simpler. Second enable werf in the CI/CD shell.

type multiwerf && . $(multiwerf use 1.2 ea --as-file)
# We can use werf now
werf ...

# add ~/bin into PATH
export PATH=$PATH:$HOME/bin
echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

# enable ~/.bashrc bash startup script in your ~/.bash_profile bash login startup script
echo 'if [ -f "$HOME/.bashrc" ]; then' >> ~/.bash_profile
echo '  . "$HOME/.bashrc"' >> ~/.bash_profile
echo 'fi' >> ~/.bash_profile

# install multiwerf into ~/bin directory
mkdir -p ~/bin
cd ~/bin
curl -L https://raw.githubusercontent.com/werf/multiwerf/master/get.sh | bash
Using werf in the current shell

This will create werf shell function which calls to the werf binary which multiwerf has been prepared for your session:

source $(multiwerf use 1.2 stable --as-file)
werf version
...
Optional: activate werf on terminal startup
echo '. $(multiwerf use 1.2 stable --as-file)' >> ~/.bashrc

How to use in the CI/CD system?

First ensure that multiwerf exists and is executable, use the type command. The command prints a message to stderr if multiwerf is not found. Thus, diagnostics in a CI/CD environment becomes simpler. Second enable werf in the CI/CD shell.

type multiwerf && . $(multiwerf use 1.2 stable --as-file)
# We can use werf now
werf ...

# add ~/bin into PATH
export PATH=$PATH:$HOME/bin
echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

# enable ~/.bashrc bash startup script in your ~/.bash_profile bash login startup script
echo 'if [ -f "$HOME/.bashrc" ]; then' >> ~/.bash_profile
echo '  . "$HOME/.bashrc"' >> ~/.bash_profile
echo 'fi' >> ~/.bash_profile

# install multiwerf into ~/bin directory
mkdir -p ~/bin
cd ~/bin
curl -L https://raw.githubusercontent.com/werf/multiwerf/master/get.sh | bash
Using werf in the current shell

This will create werf shell function which calls to the werf binary which multiwerf has been prepared for your session:

source $(multiwerf use 1.2 rock-solid --as-file)
werf version
...
Optional: activate werf on terminal startup
echo '. $(multiwerf use 1.2 rock-solid --as-file)' >> ~/.bashrc

How to use in the CI/CD system?

First ensure that multiwerf exists and is executable, use the type command. The command prints a message to stderr if multiwerf is not found. Thus, diagnostics in a CI/CD environment becomes simpler. Second enable werf in the CI/CD shell.

type multiwerf && . $(multiwerf use 1.2 rock-solid --as-file)
# We can use werf now
werf ...

# add ~/bin into PATH
export PATH=$PATH:$HOME/bin
echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

# enable ~/.bashrc bash startup script in your ~/.bash_profile bash login startup script
echo 'if [ -f "$HOME/.bashrc" ]; then' >> ~/.bash_profile
echo '  . "$HOME/.bashrc"' >> ~/.bash_profile
echo 'fi' >> ~/.bash_profile

# install multiwerf into ~/bin directory
mkdir -p ~/bin
cd ~/bin
curl -L https://raw.githubusercontent.com/werf/multiwerf/master/get.sh | bash
Using werf in the current shell

This will create werf shell function which calls to the werf binary which multiwerf has been prepared for your session:

source $(multiwerf use 1.1 alpha --as-file)
werf version
...
Optional: activate werf on terminal startup
echo '. $(multiwerf use 1.1 alpha --as-file)' >> ~/.bashrc

How to use in the CI/CD system?

First ensure that multiwerf exists and is executable, use the type command. The command prints a message to stderr if multiwerf is not found. Thus, diagnostics in a CI/CD environment becomes simpler. Second enable werf in the CI/CD shell.

type multiwerf && . $(multiwerf use 1.1 alpha --as-file)
# We can use werf now
werf ...

# add ~/bin into PATH
export PATH=$PATH:$HOME/bin
echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

# enable ~/.bashrc bash startup script in your ~/.bash_profile bash login startup script
echo 'if [ -f "$HOME/.bashrc" ]; then' >> ~/.bash_profile
echo '  . "$HOME/.bashrc"' >> ~/.bash_profile
echo 'fi' >> ~/.bash_profile

# install multiwerf into ~/bin directory
mkdir -p ~/bin
cd ~/bin
curl -L https://raw.githubusercontent.com/werf/multiwerf/master/get.sh | bash
Using werf in the current shell

This will create werf shell function which calls to the werf binary which multiwerf has been prepared for your session:

source $(multiwerf use 1.1 beta --as-file)
werf version
...
Optional: activate werf on terminal startup
echo '. $(multiwerf use 1.1 beta --as-file)' >> ~/.bashrc

How to use in the CI/CD system?

First ensure that multiwerf exists and is executable, use the type command. The command prints a message to stderr if multiwerf is not found. Thus, diagnostics in a CI/CD environment becomes simpler. Second enable werf in the CI/CD shell.

type multiwerf && . $(multiwerf use 1.1 beta --as-file)
# We can use werf now
werf ...

# add ~/bin into PATH
export PATH=$PATH:$HOME/bin
echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

# enable ~/.bashrc bash startup script in your ~/.bash_profile bash login startup script
echo 'if [ -f "$HOME/.bashrc" ]; then' >> ~/.bash_profile
echo '  . "$HOME/.bashrc"' >> ~/.bash_profile
echo 'fi' >> ~/.bash_profile

# install multiwerf into ~/bin directory
mkdir -p ~/bin
cd ~/bin
curl -L https://raw.githubusercontent.com/werf/multiwerf/master/get.sh | bash
Using werf in the current shell

This will create werf shell function which calls to the werf binary which multiwerf has been prepared for your session:

source $(multiwerf use 1.1 ea --as-file)
werf version
...
Optional: activate werf on terminal startup
echo '. $(multiwerf use 1.1 ea --as-file)' >> ~/.bashrc

How to use in the CI/CD system?

First ensure that multiwerf exists and is executable, use the type command. The command prints a message to stderr if multiwerf is not found. Thus, diagnostics in a CI/CD environment becomes simpler. Second enable werf in the CI/CD shell.

type multiwerf && . $(multiwerf use 1.1 ea --as-file)
# We can use werf now
werf ...

# add ~/bin into PATH
export PATH=$PATH:$HOME/bin
echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

# enable ~/.bashrc bash startup script in your ~/.bash_profile bash login startup script
echo 'if [ -f "$HOME/.bashrc" ]; then' >> ~/.bash_profile
echo '  . "$HOME/.bashrc"' >> ~/.bash_profile
echo 'fi' >> ~/.bash_profile

# install multiwerf into ~/bin directory
mkdir -p ~/bin
cd ~/bin
curl -L https://raw.githubusercontent.com/werf/multiwerf/master/get.sh | bash
Using werf in the current shell

This will create werf shell function which calls to the werf binary which multiwerf has been prepared for your session:

source $(multiwerf use 1.1 stable --as-file)
werf version
...
Optional: activate werf on terminal startup
echo '. $(multiwerf use 1.1 stable --as-file)' >> ~/.bashrc

How to use in the CI/CD system?

First ensure that multiwerf exists and is executable, use the type command. The command prints a message to stderr if multiwerf is not found. Thus, diagnostics in a CI/CD environment becomes simpler. Second enable werf in the CI/CD shell.

type multiwerf && . $(multiwerf use 1.1 stable --as-file)
# We can use werf now
werf ...

# add ~/bin into PATH
export PATH=$PATH:$HOME/bin
echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

# enable ~/.bashrc bash startup script in your ~/.bash_profile bash login startup script
echo 'if [ -f "$HOME/.bashrc" ]; then' >> ~/.bash_profile
echo '  . "$HOME/.bashrc"' >> ~/.bash_profile
echo 'fi' >> ~/.bash_profile

# install multiwerf into ~/bin directory
mkdir -p ~/bin
cd ~/bin
curl -L https://raw.githubusercontent.com/werf/multiwerf/master/get.sh | bash
Using werf in the current shell

This will create werf shell function which calls to the werf binary which multiwerf has been prepared for your session:

source $(multiwerf use 1.1 rock-solid --as-file)
werf version
...
Optional: activate werf on terminal startup
echo '. $(multiwerf use 1.1 rock-solid --as-file)' >> ~/.bashrc

How to use in the CI/CD system?

First ensure that multiwerf exists and is executable, use the type command. The command prints a message to stderr if multiwerf is not found. Thus, diagnostics in a CI/CD environment becomes simpler. Second enable werf in the CI/CD shell.

type multiwerf && . $(multiwerf use 1.1 rock-solid --as-file)
# We can use werf now
werf ...
PowerShell
$MULTIWERF_BIN_PATH = "C:\ProgramData\multiwerf\bin"
mkdir $MULTIWERF_BIN_PATH

Invoke-WebRequest -Uri https://storage.yandexcloud.net/multiwerf/targets/releases/v1.4.7/multiwerf-windows-amd64-v1.4.7.exe -OutFile $MULTIWERF_BIN_PATH\multiwerf.exe

[Environment]::SetEnvironmentVariable(
    "Path",
    [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::Machine) + "$MULTIWERF_BIN_PATH",
    [EnvironmentVariableTarget]::Machine)

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
Using werf in the current shell
Invoke-Expression -Command "multiwerf use 1.2 alpha --as-file --shell powershell" | Out-String -OutVariable WERF_USE_SCRIPT_PATH
. $WERF_USE_SCRIPT_PATH.Trim()
cmd.exe

Run cmd.exe as Administrator and then do the following:

set MULTIWERF_BIN_PATH="C:\ProgramData\multiwerf\bin"
mkdir %MULTIWERF_BIN_PATH%
bitsadmin.exe /transfer "multiwerf" https://storage.yandexcloud.net/multiwerf/targets/releases/v1.4.7/multiwerf-windows-amd64-v1.4.7.exe %MULTIWERF_BIN_PATH%\multiwerf.exe
setx /M PATH "%PATH%;%MULTIWERF_BIN_PATH%"

Next it is required to open new cmd.exe session to start using werf.

Using werf in the current shell
FOR /F "tokens=*" %g IN ('multiwerf use 1.2 alpha --as-file --shell cmdexe') do (SET WERF_USE_SCRIPT_PATH=%g)
%WERF_USE_SCRIPT_PATH%
PowerShell
$MULTIWERF_BIN_PATH = "C:\ProgramData\multiwerf\bin"
mkdir $MULTIWERF_BIN_PATH

Invoke-WebRequest -Uri https://storage.yandexcloud.net/multiwerf/targets/releases/v1.4.7/multiwerf-windows-amd64-v1.4.7.exe -OutFile $MULTIWERF_BIN_PATH\multiwerf.exe

[Environment]::SetEnvironmentVariable(
    "Path",
    [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::Machine) + "$MULTIWERF_BIN_PATH",
    [EnvironmentVariableTarget]::Machine)

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
Using werf in the current shell
Invoke-Expression -Command "multiwerf use 1.2 beta --as-file --shell powershell" | Out-String -OutVariable WERF_USE_SCRIPT_PATH
. $WERF_USE_SCRIPT_PATH.Trim()
cmd.exe

Run cmd.exe as Administrator and then do the following:

set MULTIWERF_BIN_PATH="C:\ProgramData\multiwerf\bin"
mkdir %MULTIWERF_BIN_PATH%
bitsadmin.exe /transfer "multiwerf" https://storage.yandexcloud.net/multiwerf/targets/releases/v1.4.7/multiwerf-windows-amd64-v1.4.7.exe %MULTIWERF_BIN_PATH%\multiwerf.exe
setx /M PATH "%PATH%;%MULTIWERF_BIN_PATH%"

Next it is required to open new cmd.exe session to start using werf.

Using werf in the current shell
FOR /F "tokens=*" %g IN ('multiwerf use 1.2 beta --as-file --shell cmdexe') do (SET WERF_USE_SCRIPT_PATH=%g)
%WERF_USE_SCRIPT_PATH%
PowerShell
$MULTIWERF_BIN_PATH = "C:\ProgramData\multiwerf\bin"
mkdir $MULTIWERF_BIN_PATH

Invoke-WebRequest -Uri https://storage.yandexcloud.net/multiwerf/targets/releases/v1.4.7/multiwerf-windows-amd64-v1.4.7.exe -OutFile $MULTIWERF_BIN_PATH\multiwerf.exe

[Environment]::SetEnvironmentVariable(
    "Path",
    [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::Machine) + "$MULTIWERF_BIN_PATH",
    [EnvironmentVariableTarget]::Machine)

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
Using werf in the current shell
Invoke-Expression -Command "multiwerf use 1.2 ea --as-file --shell powershell" | Out-String -OutVariable WERF_USE_SCRIPT_PATH
. $WERF_USE_SCRIPT_PATH.Trim()
cmd.exe

Run cmd.exe as Administrator and then do the following:

set MULTIWERF_BIN_PATH="C:\ProgramData\multiwerf\bin"
mkdir %MULTIWERF_BIN_PATH%
bitsadmin.exe /transfer "multiwerf" https://storage.yandexcloud.net/multiwerf/targets/releases/v1.4.7/multiwerf-windows-amd64-v1.4.7.exe %MULTIWERF_BIN_PATH%\multiwerf.exe
setx /M PATH "%PATH%;%MULTIWERF_BIN_PATH%"

Next it is required to open new cmd.exe session to start using werf.

Using werf in the current shell
FOR /F "tokens=*" %g IN ('multiwerf use 1.2 ea --as-file --shell cmdexe') do (SET WERF_USE_SCRIPT_PATH=%g)
%WERF_USE_SCRIPT_PATH%
PowerShell
$MULTIWERF_BIN_PATH = "C:\ProgramData\multiwerf\bin"
mkdir $MULTIWERF_BIN_PATH

Invoke-WebRequest -Uri https://storage.yandexcloud.net/multiwerf/targets/releases/v1.4.7/multiwerf-windows-amd64-v1.4.7.exe -OutFile $MULTIWERF_BIN_PATH\multiwerf.exe

[Environment]::SetEnvironmentVariable(
    "Path",
    [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::Machine) + "$MULTIWERF_BIN_PATH",
    [EnvironmentVariableTarget]::Machine)

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
Using werf in the current shell
Invoke-Expression -Command "multiwerf use 1.2 stable --as-file --shell powershell" | Out-String -OutVariable WERF_USE_SCRIPT_PATH
. $WERF_USE_SCRIPT_PATH.Trim()
cmd.exe

Run cmd.exe as Administrator and then do the following:

set MULTIWERF_BIN_PATH="C:\ProgramData\multiwerf\bin"
mkdir %MULTIWERF_BIN_PATH%
bitsadmin.exe /transfer "multiwerf" https://storage.yandexcloud.net/multiwerf/targets/releases/v1.4.7/multiwerf-windows-amd64-v1.4.7.exe %MULTIWERF_BIN_PATH%\multiwerf.exe
setx /M PATH "%PATH%;%MULTIWERF_BIN_PATH%"

Next it is required to open new cmd.exe session to start using werf.

Using werf in the current shell
FOR /F "tokens=*" %g IN ('multiwerf use 1.2 stable --as-file --shell cmdexe') do (SET WERF_USE_SCRIPT_PATH=%g)
%WERF_USE_SCRIPT_PATH%
PowerShell
$MULTIWERF_BIN_PATH = "C:\ProgramData\multiwerf\bin"
mkdir $MULTIWERF_BIN_PATH

Invoke-WebRequest -Uri https://storage.yandexcloud.net/multiwerf/targets/releases/v1.4.7/multiwerf-windows-amd64-v1.4.7.exe -OutFile $MULTIWERF_BIN_PATH\multiwerf.exe

[Environment]::SetEnvironmentVariable(
    "Path",
    [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::Machine) + "$MULTIWERF_BIN_PATH",
    [EnvironmentVariableTarget]::Machine)

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
Using werf in the current shell
Invoke-Expression -Command "multiwerf use 1.2 rock-solid --as-file --shell powershell" | Out-String -OutVariable WERF_USE_SCRIPT_PATH
. $WERF_USE_SCRIPT_PATH.Trim()
cmd.exe

Run cmd.exe as Administrator and then do the following:

set MULTIWERF_BIN_PATH="C:\ProgramData\multiwerf\bin"
mkdir %MULTIWERF_BIN_PATH%
bitsadmin.exe /transfer "multiwerf" https://storage.yandexcloud.net/multiwerf/targets/releases/v1.4.7/multiwerf-windows-amd64-v1.4.7.exe %MULTIWERF_BIN_PATH%\multiwerf.exe
setx /M PATH "%PATH%;%MULTIWERF_BIN_PATH%"

Next it is required to open new cmd.exe session to start using werf.

Using werf in the current shell
FOR /F "tokens=*" %g IN ('multiwerf use 1.2 rock-solid --as-file --shell cmdexe') do (SET WERF_USE_SCRIPT_PATH=%g)
%WERF_USE_SCRIPT_PATH%
PowerShell
$MULTIWERF_BIN_PATH = "C:\ProgramData\multiwerf\bin"
mkdir $MULTIWERF_BIN_PATH

Invoke-WebRequest -Uri https://storage.yandexcloud.net/multiwerf/targets/releases/v1.4.7/multiwerf-windows-amd64-v1.4.7.exe -OutFile $MULTIWERF_BIN_PATH\multiwerf.exe

[Environment]::SetEnvironmentVariable(
    "Path",
    [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::Machine) + "$MULTIWERF_BIN_PATH",
    [EnvironmentVariableTarget]::Machine)

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
Using werf in the current shell
Invoke-Expression -Command "multiwerf use 1.1 alpha --as-file --shell powershell" | Out-String -OutVariable WERF_USE_SCRIPT_PATH
. $WERF_USE_SCRIPT_PATH.Trim()
cmd.exe

Run cmd.exe as Administrator and then do the following:

set MULTIWERF_BIN_PATH="C:\ProgramData\multiwerf\bin"
mkdir %MULTIWERF_BIN_PATH%
bitsadmin.exe /transfer "multiwerf" https://storage.yandexcloud.net/multiwerf/targets/releases/v1.4.7/multiwerf-windows-amd64-v1.4.7.exe %MULTIWERF_BIN_PATH%\multiwerf.exe
setx /M PATH "%PATH%;%MULTIWERF_BIN_PATH%"

Next it is required to open new cmd.exe session to start using werf.

Using werf in the current shell
FOR /F "tokens=*" %g IN ('multiwerf use 1.1 alpha --as-file --shell cmdexe') do (SET WERF_USE_SCRIPT_PATH=%g)
%WERF_USE_SCRIPT_PATH%
PowerShell
$MULTIWERF_BIN_PATH = "C:\ProgramData\multiwerf\bin"
mkdir $MULTIWERF_BIN_PATH

Invoke-WebRequest -Uri https://storage.yandexcloud.net/multiwerf/targets/releases/v1.4.7/multiwerf-windows-amd64-v1.4.7.exe -OutFile $MULTIWERF_BIN_PATH\multiwerf.exe

[Environment]::SetEnvironmentVariable(
    "Path",
    [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::Machine) + "$MULTIWERF_BIN_PATH",
    [EnvironmentVariableTarget]::Machine)

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
Using werf in the current shell
Invoke-Expression -Command "multiwerf use 1.1 beta --as-file --shell powershell" | Out-String -OutVariable WERF_USE_SCRIPT_PATH
. $WERF_USE_SCRIPT_PATH.Trim()
cmd.exe

Run cmd.exe as Administrator and then do the following:

set MULTIWERF_BIN_PATH="C:\ProgramData\multiwerf\bin"
mkdir %MULTIWERF_BIN_PATH%
bitsadmin.exe /transfer "multiwerf" https://storage.yandexcloud.net/multiwerf/targets/releases/v1.4.7/multiwerf-windows-amd64-v1.4.7.exe %MULTIWERF_BIN_PATH%\multiwerf.exe
setx /M PATH "%PATH%;%MULTIWERF_BIN_PATH%"

Next it is required to open new cmd.exe session to start using werf.

Using werf in the current shell
FOR /F "tokens=*" %g IN ('multiwerf use 1.1 beta --as-file --shell cmdexe') do (SET WERF_USE_SCRIPT_PATH=%g)
%WERF_USE_SCRIPT_PATH%
PowerShell
$MULTIWERF_BIN_PATH = "C:\ProgramData\multiwerf\bin"
mkdir $MULTIWERF_BIN_PATH

Invoke-WebRequest -Uri https://storage.yandexcloud.net/multiwerf/targets/releases/v1.4.7/multiwerf-windows-amd64-v1.4.7.exe -OutFile $MULTIWERF_BIN_PATH\multiwerf.exe

[Environment]::SetEnvironmentVariable(
    "Path",
    [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::Machine) + "$MULTIWERF_BIN_PATH",
    [EnvironmentVariableTarget]::Machine)

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
Using werf in the current shell
Invoke-Expression -Command "multiwerf use 1.1 ea --as-file --shell powershell" | Out-String -OutVariable WERF_USE_SCRIPT_PATH
. $WERF_USE_SCRIPT_PATH.Trim()
cmd.exe

Run cmd.exe as Administrator and then do the following:

set MULTIWERF_BIN_PATH="C:\ProgramData\multiwerf\bin"
mkdir %MULTIWERF_BIN_PATH%
bitsadmin.exe /transfer "multiwerf" https://storage.yandexcloud.net/multiwerf/targets/releases/v1.4.7/multiwerf-windows-amd64-v1.4.7.exe %MULTIWERF_BIN_PATH%\multiwerf.exe
setx /M PATH "%PATH%;%MULTIWERF_BIN_PATH%"

Next it is required to open new cmd.exe session to start using werf.

Using werf in the current shell
FOR /F "tokens=*" %g IN ('multiwerf use 1.1 ea --as-file --shell cmdexe') do (SET WERF_USE_SCRIPT_PATH=%g)
%WERF_USE_SCRIPT_PATH%
PowerShell
$MULTIWERF_BIN_PATH = "C:\ProgramData\multiwerf\bin"
mkdir $MULTIWERF_BIN_PATH

Invoke-WebRequest -Uri https://storage.yandexcloud.net/multiwerf/targets/releases/v1.4.7/multiwerf-windows-amd64-v1.4.7.exe -OutFile $MULTIWERF_BIN_PATH\multiwerf.exe

[Environment]::SetEnvironmentVariable(
    "Path",
    [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::Machine) + "$MULTIWERF_BIN_PATH",
    [EnvironmentVariableTarget]::Machine)

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
Using werf in the current shell
Invoke-Expression -Command "multiwerf use 1.1 stable --as-file --shell powershell" | Out-String -OutVariable WERF_USE_SCRIPT_PATH
. $WERF_USE_SCRIPT_PATH.Trim()
cmd.exe

Run cmd.exe as Administrator and then do the following:

set MULTIWERF_BIN_PATH="C:\ProgramData\multiwerf\bin"
mkdir %MULTIWERF_BIN_PATH%
bitsadmin.exe /transfer "multiwerf" https://storage.yandexcloud.net/multiwerf/targets/releases/v1.4.7/multiwerf-windows-amd64-v1.4.7.exe %MULTIWERF_BIN_PATH%\multiwerf.exe
setx /M PATH "%PATH%;%MULTIWERF_BIN_PATH%"

Next it is required to open new cmd.exe session to start using werf.

Using werf in the current shell
FOR /F "tokens=*" %g IN ('multiwerf use 1.1 stable --as-file --shell cmdexe') do (SET WERF_USE_SCRIPT_PATH=%g)
%WERF_USE_SCRIPT_PATH%
PowerShell
$MULTIWERF_BIN_PATH = "C:\ProgramData\multiwerf\bin"
mkdir $MULTIWERF_BIN_PATH

Invoke-WebRequest -Uri https://storage.yandexcloud.net/multiwerf/targets/releases/v1.4.7/multiwerf-windows-amd64-v1.4.7.exe -OutFile $MULTIWERF_BIN_PATH\multiwerf.exe

[Environment]::SetEnvironmentVariable(
    "Path",
    [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::Machine) + "$MULTIWERF_BIN_PATH",
    [EnvironmentVariableTarget]::Machine)

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
Using werf in the current shell
Invoke-Expression -Command "multiwerf use 1.1 rock-solid --as-file --shell powershell" | Out-String -OutVariable WERF_USE_SCRIPT_PATH
. $WERF_USE_SCRIPT_PATH.Trim()
cmd.exe

Run cmd.exe as Administrator and then do the following:

set MULTIWERF_BIN_PATH="C:\ProgramData\multiwerf\bin"
mkdir %MULTIWERF_BIN_PATH%
bitsadmin.exe /transfer "multiwerf" https://storage.yandexcloud.net/multiwerf/targets/releases/v1.4.7/multiwerf-windows-amd64-v1.4.7.exe %MULTIWERF_BIN_PATH%\multiwerf.exe
setx /M PATH "%PATH%;%MULTIWERF_BIN_PATH%"

Next it is required to open new cmd.exe session to start using werf.

Using werf in the current shell
FOR /F "tokens=*" %g IN ('multiwerf use 1.1 rock-solid --as-file --shell cmdexe') do (SET WERF_USE_SCRIPT_PATH=%g)
%WERF_USE_SCRIPT_PATH%

How it works?

The command multiwerf use MAJOR.MINOR CHANNEL allows using the actual werf binary and to be always up-to-date. You can use this command both in CI/CD system and on the local machine. The command returns a script or a path to the script file (when used with an --as-file option) that must be used as an argument to the source statement in the case of using shell. As a result, the current version of werf will be available during the shell session.

The script can be divided into two logic parts: updating and creating werf alias or the definition of the function depending on shell type. The update part performs multiwerf self-update and gets the actual werf binary for the specified MAJOR.MINOR version and CHANNEL (read more about werf versioning in the Backward Compatibility Promise section). The update is performed by the multiwerf update command.

If the script is launched for the first time or there is no suitable werf binary found locally, this script will wait until multiwerf downloads new werf binary. Otherwise, the update runs in the background, and werf alias or a function binds to the existing werf binary based on local channel mapping.

Unix shell PowerShell cmd.exe 
if multiwerf werf-path MAJOR.MINOR CHANNEL >~/.multiwerf/multiwerf_use_first_werf_path.log 2>&1; then
    multiwerf update MAJOR.MINOR CHANNEL --in-background --output-file=~/.multiwerf/multiwerf_use_background_update.log --with-cache
else
    multiwerf update MAJOR.MINOR CHANNEL
fi

WERF_PATH=$(multiwerf werf-path MAJOR.MINOR CHANNEL)
WERF_FUNC=$(cat <<EOF
werf()
{
    $WERF_PATH "\$@"
}
EOF
)

eval "$WERF_FUNC"

if ((Invoke-Expression -Command "multiwerf werf-path MAJOR.MINOR CHANNEL" | Out-String -OutVariable WERF_PATH) -and ($LastExitCode -eq 0)) {
    multiwerf update MAJOR.MINOR CHANNEL --in-background --output-file=~\.multiwerf\multiwerf_use_background_update.log --with-cache
} else {
    multiwerf update MAJOR.MINOR CHANNEL
    Invoke-Expression -Command "multiwerf werf-path MAJOR.MINOR CHANNEL" | Out-String -OutVariable WERF_PATH
}

function werf { & $WERF_PATH.Trim() $args }

FOR /F "tokens=*" %%g IN ('multiwerf werf-path MAJOR.MINOR CHANNEL') do (SET WERF_PATH=%%g)

IF %ERRORLEVEL% NEQ 0 (
    multiwerf update MAJOR.MINOR CHANNEL
    FOR /F "tokens=*" %%g IN ('multiwerf werf-path MAJOR.MINOR CHANNEL') do (SET WERF_PATH=%%g)
) ELSE (
    multiwerf update MAJOR.MINOR CHANNEL --in-background --output-file=~\.multiwerf\multiwerf_use_background_update.log --with-cache
)

DOSKEY werf=%WERF_PATH% $*

During the update, multiwerf tries to download the desirable werf version based on a channel mapping. The channel mapping is a special file that keeps relations between channels and werf versions. By default, multiwerf uses the mapping file which is maintained in the werf repository: https://github.com/werf/werf/blob/multiwerf/multiwerf.json. You can always use --channel-mapping-url option and specify arbitrary url with channel mapping which you can control by yourself.

Such an approach allows a user not to worry about updates and use the same werf binary version on CI and the local machine. We create new releases with fixes and features and manage channels while you simply use a single command everywhere.

The latest release can be found at this page

curl -L https://storage.yandexcloud.net/werf/targets/releases/v1.2.12+fix2/werf-linux-amd64-v1.2.12+fix2 -o /tmp/werf
chmod +x /tmp/werf
sudo mv /tmp/werf /usr/local/bin/werf

curl -L https://storage.yandexcloud.net/werf/targets/releases/v1.2.11+fix15/werf-linux-amd64-v1.2.11+fix15 -o /tmp/werf
chmod +x /tmp/werf
sudo mv /tmp/werf /usr/local/bin/werf

curl -L https://storage.yandexcloud.net/werf/targets/releases/v1.2.11+fix10/werf-linux-amd64-v1.2.11+fix10 -o /tmp/werf
chmod +x /tmp/werf
sudo mv /tmp/werf /usr/local/bin/werf

curl -L https://storage.yandexcloud.net/werf/targets/releases//werf-linux-amd64- -o /tmp/werf
chmod +x /tmp/werf
sudo mv /tmp/werf /usr/local/bin/werf

curl -L https://storage.yandexcloud.net/werf/targets/releases//werf-linux-amd64- -o /tmp/werf
chmod +x /tmp/werf
sudo mv /tmp/werf /usr/local/bin/werf

curl -L https://storage.yandexcloud.net/werf/targets/releases/v1.1.23+fix47/werf-linux-amd64-v1.1.23+fix47 -o /tmp/werf
chmod +x /tmp/werf
sudo mv /tmp/werf /usr/local/bin/werf

curl -L https://storage.yandexcloud.net/werf/targets/releases/v1.1.23+fix47/werf-linux-amd64-v1.1.23+fix47 -o /tmp/werf
chmod +x /tmp/werf
sudo mv /tmp/werf /usr/local/bin/werf

curl -L https://storage.yandexcloud.net/werf/targets/releases/v1.1.23+fix47/werf-linux-amd64-v1.1.23+fix47 -o /tmp/werf
chmod +x /tmp/werf
sudo mv /tmp/werf /usr/local/bin/werf

curl -L https://storage.yandexcloud.net/werf/targets/releases/v1.1.23+fix47/werf-linux-amd64-v1.1.23+fix47 -o /tmp/werf
chmod +x /tmp/werf
sudo mv /tmp/werf /usr/local/bin/werf

curl -L https://storage.yandexcloud.net/werf/targets/releases/v1.1.23+fix41/werf-linux-amd64-v1.1.23+fix41 -o /tmp/werf
chmod +x /tmp/werf
sudo mv /tmp/werf /usr/local/bin/werf

curl -L https://storage.yandexcloud.net/werf/targets/releases/v1.2.12+fix2/werf-darwin-amd64-v1.2.12+fix2 -o /tmp/werf
chmod +x /tmp/werf
sudo mv /tmp/werf /usr/local/bin/werf

curl -L https://storage.yandexcloud.net/werf/targets/releases/v1.2.11+fix15/werf-darwin-amd64-v1.2.11+fix15 -o /tmp/werf
chmod +x /tmp/werf
sudo mv /tmp/werf /usr/local/bin/werf

curl -L https://storage.yandexcloud.net/werf/targets/releases/v1.2.11+fix10/werf-darwin-amd64-v1.2.11+fix10 -o /tmp/werf
chmod +x /tmp/werf
sudo mv /tmp/werf /usr/local/bin/werf

curl -L https://storage.yandexcloud.net/werf/targets/releases//werf-darwin-amd64- -o /tmp/werf
chmod +x /tmp/werf
sudo mv /tmp/werf /usr/local/bin/werf

curl -L https://storage.yandexcloud.net/werf/targets/releases//werf-darwin-amd64- -o /tmp/werf
chmod +x /tmp/werf
sudo mv /tmp/werf /usr/local/bin/werf

curl -L https://storage.yandexcloud.net/werf/targets/releases/v1.1.23+fix47/werf-darwin-amd64-v1.1.23+fix47 -o /tmp/werf
chmod +x /tmp/werf
sudo mv /tmp/werf /usr/local/bin/werf

curl -L https://storage.yandexcloud.net/werf/targets/releases/v1.1.23+fix47/werf-darwin-amd64-v1.1.23+fix47 -o /tmp/werf
chmod +x /tmp/werf
sudo mv /tmp/werf /usr/local/bin/werf

curl -L https://storage.yandexcloud.net/werf/targets/releases/v1.1.23+fix47/werf-darwin-amd64-v1.1.23+fix47 -o /tmp/werf
chmod +x /tmp/werf
sudo mv /tmp/werf /usr/local/bin/werf

curl -L https://storage.yandexcloud.net/werf/targets/releases/v1.1.23+fix47/werf-darwin-amd64-v1.1.23+fix47 -o /tmp/werf
chmod +x /tmp/werf
sudo mv /tmp/werf /usr/local/bin/werf

curl -L https://storage.yandexcloud.net/werf/targets/releases/v1.1.23+fix41/werf-darwin-amd64-v1.1.23+fix41 -o /tmp/werf
chmod +x /tmp/werf
sudo mv /tmp/werf /usr/local/bin/werf
PowerShell
$WERF_BIN_PATH = "C:\ProgramData\werf\bin"
mkdir $WERF_BIN_PATH

Invoke-WebRequest -Uri https://storage.yandexcloud.net/werf/targets/releases/v1.2.12+fix2/werf-windows-amd64-v1.2.12+fix2.exe -OutFile $WERF_BIN_PATH\werf.exe

[Environment]::SetEnvironmentVariable(
    "Path",
    [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::Machine) + "$WERF_BIN_PATH",
    [EnvironmentVariableTarget]::Machine)

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
cmd.exe (run as Administrator)
set WERF_BIN_PATH="C:\ProgramData\werf\bin"
mkdir %WERF_BIN_PATH%
bitsadmin.exe /transfer "werf" https://storage.yandexcloud.net/werf/targets/releases/v1.2.12+fix2/werf-windows-amd64-v1.2.12+fix2.exe %WERF_BIN_PATH%\werf.exe
setx /M PATH "%PATH%;%WERF_BIN_PATH%"
PowerShell
$WERF_BIN_PATH = "C:\ProgramData\werf\bin"
mkdir $WERF_BIN_PATH

Invoke-WebRequest -Uri https://storage.yandexcloud.net/werf/targets/releases/v1.2.11+fix15/werf-windows-amd64-v1.2.11+fix15.exe -OutFile $WERF_BIN_PATH\werf.exe

[Environment]::SetEnvironmentVariable(
    "Path",
    [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::Machine) + "$WERF_BIN_PATH",
    [EnvironmentVariableTarget]::Machine)

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
cmd.exe (run as Administrator)
set WERF_BIN_PATH="C:\ProgramData\werf\bin"
mkdir %WERF_BIN_PATH%
bitsadmin.exe /transfer "werf" https://storage.yandexcloud.net/werf/targets/releases/v1.2.11+fix15/werf-windows-amd64-v1.2.11+fix15.exe %WERF_BIN_PATH%\werf.exe
setx /M PATH "%PATH%;%WERF_BIN_PATH%"
PowerShell
$WERF_BIN_PATH = "C:\ProgramData\werf\bin"
mkdir $WERF_BIN_PATH

Invoke-WebRequest -Uri https://storage.yandexcloud.net/werf/targets/releases/v1.2.11+fix10/werf-windows-amd64-v1.2.11+fix10.exe -OutFile $WERF_BIN_PATH\werf.exe

[Environment]::SetEnvironmentVariable(
    "Path",
    [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::Machine) + "$WERF_BIN_PATH",
    [EnvironmentVariableTarget]::Machine)

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
cmd.exe (run as Administrator)
set WERF_BIN_PATH="C:\ProgramData\werf\bin"
mkdir %WERF_BIN_PATH%
bitsadmin.exe /transfer "werf" https://storage.yandexcloud.net/werf/targets/releases/v1.2.11+fix10/werf-windows-amd64-v1.2.11+fix10.exe %WERF_BIN_PATH%\werf.exe
setx /M PATH "%PATH%;%WERF_BIN_PATH%"
PowerShell
$WERF_BIN_PATH = "C:\ProgramData\werf\bin"
mkdir $WERF_BIN_PATH

Invoke-WebRequest -Uri https://storage.yandexcloud.net/werf/targets/releases//werf-windows-amd64-.exe -OutFile $WERF_BIN_PATH\werf.exe

[Environment]::SetEnvironmentVariable(
    "Path",
    [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::Machine) + "$WERF_BIN_PATH",
    [EnvironmentVariableTarget]::Machine)

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
cmd.exe (run as Administrator)
set WERF_BIN_PATH="C:\ProgramData\werf\bin"
mkdir %WERF_BIN_PATH%
bitsadmin.exe /transfer "werf" https://storage.yandexcloud.net/werf/targets/releases//werf-windows-amd64-.exe %WERF_BIN_PATH%\werf.exe
setx /M PATH "%PATH%;%WERF_BIN_PATH%"
PowerShell
$WERF_BIN_PATH = "C:\ProgramData\werf\bin"
mkdir $WERF_BIN_PATH

Invoke-WebRequest -Uri https://storage.yandexcloud.net/werf/targets/releases//werf-windows-amd64-.exe -OutFile $WERF_BIN_PATH\werf.exe

[Environment]::SetEnvironmentVariable(
    "Path",
    [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::Machine) + "$WERF_BIN_PATH",
    [EnvironmentVariableTarget]::Machine)

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
cmd.exe (run as Administrator)
set WERF_BIN_PATH="C:\ProgramData\werf\bin"
mkdir %WERF_BIN_PATH%
bitsadmin.exe /transfer "werf" https://storage.yandexcloud.net/werf/targets/releases//werf-windows-amd64-.exe %WERF_BIN_PATH%\werf.exe
setx /M PATH "%PATH%;%WERF_BIN_PATH%"
PowerShell
$WERF_BIN_PATH = "C:\ProgramData\werf\bin"
mkdir $WERF_BIN_PATH

Invoke-WebRequest -Uri https://storage.yandexcloud.net/werf/targets/releases/v1.1.23+fix47/werf-windows-amd64-v1.1.23+fix47.exe -OutFile $WERF_BIN_PATH\werf.exe

[Environment]::SetEnvironmentVariable(
    "Path",
    [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::Machine) + "$WERF_BIN_PATH",
    [EnvironmentVariableTarget]::Machine)

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
cmd.exe (run as Administrator)
set WERF_BIN_PATH="C:\ProgramData\werf\bin"
mkdir %WERF_BIN_PATH%
bitsadmin.exe /transfer "werf" https://storage.yandexcloud.net/werf/targets/releases/v1.1.23+fix47/werf-windows-amd64-v1.1.23+fix47.exe %WERF_BIN_PATH%\werf.exe
setx /M PATH "%PATH%;%WERF_BIN_PATH%"
PowerShell
$WERF_BIN_PATH = "C:\ProgramData\werf\bin"
mkdir $WERF_BIN_PATH

Invoke-WebRequest -Uri https://storage.yandexcloud.net/werf/targets/releases/v1.1.23+fix47/werf-windows-amd64-v1.1.23+fix47.exe -OutFile $WERF_BIN_PATH\werf.exe

[Environment]::SetEnvironmentVariable(
    "Path",
    [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::Machine) + "$WERF_BIN_PATH",
    [EnvironmentVariableTarget]::Machine)

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
cmd.exe (run as Administrator)
set WERF_BIN_PATH="C:\ProgramData\werf\bin"
mkdir %WERF_BIN_PATH%
bitsadmin.exe /transfer "werf" https://storage.yandexcloud.net/werf/targets/releases/v1.1.23+fix47/werf-windows-amd64-v1.1.23+fix47.exe %WERF_BIN_PATH%\werf.exe
setx /M PATH "%PATH%;%WERF_BIN_PATH%"
PowerShell
$WERF_BIN_PATH = "C:\ProgramData\werf\bin"
mkdir $WERF_BIN_PATH

Invoke-WebRequest -Uri https://storage.yandexcloud.net/werf/targets/releases/v1.1.23+fix47/werf-windows-amd64-v1.1.23+fix47.exe -OutFile $WERF_BIN_PATH\werf.exe

[Environment]::SetEnvironmentVariable(
    "Path",
    [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::Machine) + "$WERF_BIN_PATH",
    [EnvironmentVariableTarget]::Machine)

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
cmd.exe (run as Administrator)
set WERF_BIN_PATH="C:\ProgramData\werf\bin"
mkdir %WERF_BIN_PATH%
bitsadmin.exe /transfer "werf" https://storage.yandexcloud.net/werf/targets/releases/v1.1.23+fix47/werf-windows-amd64-v1.1.23+fix47.exe %WERF_BIN_PATH%\werf.exe
setx /M PATH "%PATH%;%WERF_BIN_PATH%"
PowerShell
$WERF_BIN_PATH = "C:\ProgramData\werf\bin"
mkdir $WERF_BIN_PATH

Invoke-WebRequest -Uri https://storage.yandexcloud.net/werf/targets/releases/v1.1.23+fix47/werf-windows-amd64-v1.1.23+fix47.exe -OutFile $WERF_BIN_PATH\werf.exe

[Environment]::SetEnvironmentVariable(
    "Path",
    [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::Machine) + "$WERF_BIN_PATH",
    [EnvironmentVariableTarget]::Machine)

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
cmd.exe (run as Administrator)
set WERF_BIN_PATH="C:\ProgramData\werf\bin"
mkdir %WERF_BIN_PATH%
bitsadmin.exe /transfer "werf" https://storage.yandexcloud.net/werf/targets/releases/v1.1.23+fix47/werf-windows-amd64-v1.1.23+fix47.exe %WERF_BIN_PATH%\werf.exe
setx /M PATH "%PATH%;%WERF_BIN_PATH%"
PowerShell
$WERF_BIN_PATH = "C:\ProgramData\werf\bin"
mkdir $WERF_BIN_PATH

Invoke-WebRequest -Uri https://storage.yandexcloud.net/werf/targets/releases/v1.1.23+fix41/werf-windows-amd64-v1.1.23+fix41.exe -OutFile $WERF_BIN_PATH\werf.exe

[Environment]::SetEnvironmentVariable(
    "Path",
    [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::Machine) + "$WERF_BIN_PATH",
    [EnvironmentVariableTarget]::Machine)

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
cmd.exe (run as Administrator)
set WERF_BIN_PATH="C:\ProgramData\werf\bin"
mkdir %WERF_BIN_PATH%
bitsadmin.exe /transfer "werf" https://storage.yandexcloud.net/werf/targets/releases/v1.1.23+fix41/werf-windows-amd64-v1.1.23+fix41.exe %WERF_BIN_PATH%\werf.exe
setx /M PATH "%PATH%;%WERF_BIN_PATH%"

go get github.com/werf/werf/cmd/werf

All changes in werf
go through all stability channels

  • Alpha
    can bring new features
    but can be unstable
  • Beta
    for more broad testing
    of new features to catch
    regressions
  • Early-Access
    is mostly safe and can be used
    in non-critical environments
    or for local development
  • Stable
    is mostly safe and we
    encourage you to use
    this version everywhere
  • Rock-Solid
    the most stable channel
    and recommended for usage
    in critical environments with tight SLA

When using release channels, you do not specify a version, because the version is managed automatically within the channel Stability channels and frequent releases allow receiving continuous feedback on new changes, quickly rolling problem changes back, ensuring the high stability of the software, and preserving an acceptable development speed at the same time.

The relations between channels and werf releases are described in multiwerf.json.

We guarantee that Early-Access release should become Stable not earlier than 1 week after internal tests.
We guarantee that Stable release should become Rock-Solid release not earlier than after 2 weeks of extensive testing.

Backward compatibility promise

werf follows a versioning strategy called Semantic Versioning. It means that major releases (1.0, 2.0) can break backward compatibility. In the case of werf, an update to the next major release may require to do a full re-deploy of applications or to perform other non-scriptable actions.

Minor releases (1.1, 1.2, etc.) may introduce new global features, but have to do so without significant backward compatibility breaks with a major branch (1.x). In the case of werf, this means that an update to the next minor release goes smoothly most of the time. However, it may require running a provided upgrade script.

Patch releases (1.1.0, 1.1.1, 1.1.2) may introduce new features, but must do so without breaking backward compatibility within the minor branch (1.1.x). In the case of werf, this means that an update to the next patch release should be smooth and can be done automatically.

  • We do not guarantee backward compatibility between:
    • alpha releases;
    • beta releases;
    • ea releases.
  • We guarantee backward compatibility between:
    • stable releases within the minor branch (1.1.x);
    • rock-solid releases within the minor branch (1.1.x).
Changelog history of releases within channels
Release
1.2 1.1
Channel
Early-Access Beta Alpha

For use in non critical environments or local development

These releases are mostly safe to use and can even be used in non critical environments or for local development. We do not guarantee backward compatibility between Early-Access releases.

v1.2.11+fix10
Jun 25, 2021 at 10:58 +0300

[dev] Fix incorrect behavior when project repository has a dirty submodule

Error: unable to sync staged changes: git command /usr/local/bin/git -C ~/.werf/local_cache/git_worktrees/9/local/9787063286a09974befa8dc3de81e63edb79c5304621035136d181f2ca792dd7/worktree -c core.autocrlf=false -c user.email=werf@werf.io -c user.name=werf commit -m 2021-06-03 20:00:52.409615 +0400 +04 m=+1.173176433 failed: exit status 1  
On branch werf-dev-b90c24d97bcca2b4a69c4f78e85507fe925ab3f0  
nothing to commit, working tree clean

Fix werf resources tracker exits before resources are ready

Fixed in kubedog, updated werf to use latest kubedog.

Docs

[docs] Overview: fix punctuation
[docs] Channel info: fix stable channel
[docs] Update werf compose commands help: added full example

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.11+fix7
Jun 10, 2021 at 12:03 +0300

Docs and site

[docs] Fix quickstart minikube start command

[site][landing] Reword GitOps section

  • Use Giterminism instead of GitOps in title.
  • Add usage workflows supported by the werf (converge and bundles).
  • Add note about the way werf used (manually, CI/CD, etc.).

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix31
May 30, 2021 at 20:26 +0300

Docs and site

[docs] Fix quickstart minikube start command

[site][landing] Reword GitOps section

  • Use Giterminism instead of GitOps in title.
  • Add usage workflows supported by the werf (converge and bundles).
  • Add note about the way werf used (manually, CI/CD, etc.).

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix30
May 28, 2021 at 23:46 +0300

Docs

Fix quickstart minikube setup guides: use registry.example.com through ingress.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix27
May 12, 2021 at 17:40 +0300

Features

  • [compose] docker-compose run command support

  • [compose] Support for positional arguments to build and forward

specific images

If one or more IMAGE_NAME parameters specified, werf will build and

forward only these images

  
  werf compose up [IMAGE_NAME...] [options] [--docker-compose-options="OPTIONS"] [--docker-compose-command-options="OPTIONS"] [--] [SERVICE...]

Fixes

  • [compose] Fix certain service names specified by the user are ignored

  • [container registry] Fix processing of reference with digest

    The user may have encountered related issues when using the base image

(from) with digest (REPO@DIGEST, REPO:TAG@DIGEST).

  
  WARNING: cannot get base image id (alpine@sha256:69e70a79f2d41ab5d637de98c1e0b055206ba40a8145e7bddb55ccc04e13cf8f): can not get base image id from registry (alpine@sha256:69e70a79f2d41ab5d637de98c1e0b055206ba40a8145e7bddb55ccc04e13cf8f): repository can only contain the runes `abcdefghijklmnopqrstuvwxyz0123456789_-./`: alpine@sha256
  
  WARNING: using existing image alpine@sha256:69e70a79f2d41ab5d637de98c1e0b055206ba40a8145e7bddb55ccc04e13cf8f without pull

Documentation

  • [docs] CI/CD / GitHub Actions: update taking off label step

Internals

  • [git_repo] Move common methods from git_repo local/remote to base

  • [conveyor] Refactoring of werf config images processing

  • Improvements related to tests, coverage, and GitHub Actions workflows

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix25
Apr 21, 2021 at 15:03 +0300

Docs

Fix manual werf-host-cleanup instruction: remove /var/log/werf-host-cleanup.log, because:

  1. This file should be created and chown-ned to the right user by the system administrator manually.
  2. Separate log file should be rotated.

Thus standard /var/log/syslog file will be used instead.

Fix werf-render command suppresses errors

[logging] Update the processing of logging modes

Fix object-not-found error when using submodules

[git_repo] Switch to repo handle working with ls tree

[git_repo] Implement git repository handle
A solution to get away from the worktree when working with the git repository, caching the necessary data from the worktree during initialization, and then working exclusively with git objects.

Other fixes

[path_matcher] Fix incorrect path matcher IDs

[git_repo] Fix checksum calculation locking

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix24
Apr 14, 2021 at 16:52 +0300

Performance fix

[helm2to3] Fix maintenance helper release exists checking procedure performance
Use history command instead of listing of all releases

Docs

[docs] Reference/werf.yaml template engine: up function syntax examples
[docs] Sidebar: rename Bundles
[docs] typofix
[docs] Advanced/Helm/Overview: delete irrelevant text

Update logging library

[go.mod] github.com/werf/logboek v0.5.4

  • [fitter] Fix unpredictable behavior when using a logger by several processes
  • Fix streams mute mode

Internals

[ci] Fix release message template
[ci] Enable release publisher into bintray to support older multiwerf clients
[ci] Add build release scripts

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix22
Apr 2, 2021 at 21:41 +0300

Docs

[docs, ru] Advanced/Cleanup: actualize
[docs] Internal/Stages and storage: actualize
[docs] What’s new in v1.2/Changelog: cleaning commands
[docs] Internal/Build process: fix typo
[docs] Fix broken quickstart macos instructions
[docs] Fix v1.1 to v1.2 instruction: wrong images report usage
[docs] Fix v1.1 to v1.2 instruction: more correct report usage: pull images before usage
[docs] advanced/cleanup: added info about werf host cleanup GC

  • Only in russian.
  • Also added a helper table with all cleanup commands.
    [docs] Fixed some grammar in v1.1 to v1.2 migration guide (RU)
    [docs] Fix bundles translation to RU

Fixes

[dockerfile] Automatically reset the Dockerfile exception by .dockerignore
file rules

There is no way to ignore the Dockerfile due to docker limitation when building an image for a compressed context that reads fro
m STDIN.

Add an exception and warning message.

[GC] Fix werf-host-cleanup default percentage and margin values (always use 70% and 5% margin).

[helm] Werf-helm fixes

  • Fix panic on werf-helm-dep-update when secret-values are used (fixes https://github.com/werf/werf/issues/3443).
  • Set .Values.werf.env=”” stub werf service value in werf-helm-* commands.

Internals

  • [web] Add view page source button (#3428)
    [web] Add page source button
  • [ci] Switch to GHCR (#3441).
  • Fix README werf logo path.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.9+fix10
Mar 18, 2021 at 10:19 +0300

Fixes

[bundle] Fix werf-bundle-apply command does not use –env param

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.8+fix13
Mar 9, 2021 at 15:56 +0300

Fixes

[bundles] Fix bundle-publish command ignoring .helm/values.yaml and publishing .helm/secret-values.yaml

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.8+fix12
Mar 5, 2021 at 15:21 +0300

Fixes

[helm] Fix chart dependencies loader missing error reports

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.8+fix11
Mar 5, 2021 at 14:08 +0300

Docs

[docs] What’s new in v1.2: describe mounts rejection cases
[docs] Advanced/bundles: added supported registry implementations

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.8+fix10
Mar 4, 2021 at 20:21 +0300

Docs: refine whats_new_in_v1_2 documentation chapter and translate to russian (2)

  • en: https://werf.io/documentation/whats_new_in_v1_2/how_to_migrate_from_v1_1_to_v1_2.html
  • ru: https://ru.werf.io/documentation/whats_new_in_v1_2/how_to_migrate_from_v1_1_to_v1_2.html

(links will be available very soon)

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.8+fix9
Mar 4, 2021 at 20:02 +0300

Docs: refine whats_new_in_v1_2 documentation chapter and translate to russian

  • en: https://werf.io/documentation/whats_new_in_v1_2/how_to_migrate_from_v1_1_to_v1_2.html
  • ru: https://ru.werf.io/documentation/whats_new_in_v1_2/how_to_migrate_from_v1_1_to_v1_2.html

(links will be available very soon)

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.8+fix8
Mar 3, 2021 at 22:32 +0300

Add WERF_DISABLE_RESOURCES_WAITER=1 support

Specify env var to fully disable kubedog waiter.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.8+fix7
Mar 3, 2021 at 12:10 +0300

Fix “Error: unable to locate chart directory: the directory “.helm” not found in the project git repository”

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.8+fix2
Feb 27, 2021 at 21:00 +0300

New site infra

Fix CI.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.7+fix6
Feb 25, 2021 at 11:36 +0300

Docs

[docs] Fix version menu

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.7+fix5
Feb 24, 2021 at 23:19 +0300

Docs

[docs] Basic bundles article in advanced documentation section

https://werf.io/v1.2-alpha/documentation/advanced/bundles.html

Internals

Rework ls tree and path matcher interface

[ls_tree] Change the LsTree function interface

// LsTree returns the Result with tree entries that satisfy the passed pathMatcher.  
// The function works lazily and does not go through a tree directory unnecessarily.  
// If the result should contain only regular files (without directories and submodules), you should use the allFiles parameter.  
LsTree(ctx context.Context, repository *git.Repository, commit string, pathMatcher path_matcher.PathMatcher) (*Result, error) -> LsTree(ctx context.  
Context, repository *git.Repository, commit string, pathMatcher path_matcher.PathMatcher, allFiles bool) (*Result, error)

[path_matcher] Remove the greedySearch parameter and change interface

There are the following changes in the PathMatcher interface:

  • Rename the MatchPath method to IsPathMatched
  • Split the ProcessDirOrSubmodulePath method into ShouldGoThrough and IsDirOrSubmodulePathMatched methods
// IsPathMatched checks for a complete matching of the path  
IsPathMatched(string) bool  
  
// ShouldGoThrough indicates that the directory or submodule path is not completely matched but may include matching files among the child files.  
// The method returns false if the path is completely matched.  
ShouldGoThrough(string) bool  
  
// IsDirOrSubmodulePathMatched returns true if IsPathMatched or ShouldGoThrough.  
// The method returns true if there is a possibility of containing the matching files among the child files.  
IsDirOrSubmodulePathMatched(string) bool

[ls_tree] Remove the strict option in LsTree function

The option allowed to run ls tree for work tree with uninitialized submodules. In current versions, we always work with the service work tree, where the submodules must be initialized.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.7+fix2
Feb 19, 2021 at 20:02 +0300

Automigration helm 2 to 3 fixes

[helm 2 to 3] Fix: ignore resources from helm 2 release which do not exist in kubernetes

Changed order of migration steps: first set annotations and labels, then create helm 3 release.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.7
Feb 18, 2021 at 21:10 +0300

New giterminism documentation!

  • https://werf.io/documentation/advanced/giterminism.html

  • https://werf.io/documentation/reference/werf_giterminism_yaml.html

  • https://werf.io/documentation/reference/werf_yaml_template_engine.html

[docs] Overview: giterminism

[docs] Advanced/Configuration/Template engine: move to reference

[giterminism] Update error messages

[docs] Advanced/Giterminism

[docs] Reference/werf-giterminism.yaml

[docs] Advanced/Configuration/Template engine

[docs] Reference/werf.yaml: refactor and update

  • change the structure of werf yaml data file

  • add get_lang_field_or_raise_error filter to work effectively with new data structure

  • update directives descriptions

[ci] Fix Documentation Validation

  
There was an error while trying to write to `/__w/werf/werf/docs/Gemfile.lock`.
  
It is likely that you need to grant write permissions for that path.

[docs] Fix table line counter does not work properly

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.5+fix12
Feb 16, 2021 at 10:42 +0300

Fixes

[win][git] Fix CRLF issues and patch-does-not-apply errors

The root of the issue: werf have added file converted from LF to CRLF into built image under windows due to some local git autocrlf settings. Then werf cannot apply patch to the file with CRLF’s inside the build container.

  1. Fix werf to always add files into image from git without any conversions from LF to CRLF, or from CRLF to LF. Take files from the git as-is.
  2. Fix patches applier for files with CRLF already added into the built images for some reason (images built with an older werf version with this bug).

[docs] Fix incorrect link to Go guide

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.4+fix18
Feb 2, 2021 at 12:08 +0300

Docs

  • Update guides template and overview page.
  • Correct a grammar mistake.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.4+fix17
Feb 1, 2021 at 22:53 +0300

Fixes

[giterminism] Fix env allowance check

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.4+fix15
Jan 29, 2021 at 22:04 +0300

Docs

Preparations for guides integration:

  • https://werf.io/documentation/guides.html
  • https://ru.werf.io/documentation/guides.html

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.4+fix13
Jan 28, 2021 at 16:56 +0300

Fixes

[follow] Fix follow mode does not reinitialize giterminism manager

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.4+fix12
Jan 27, 2021 at 21:19 +0300

Giterminism

[giterminism] Refactoring: simplify error messages and the corresponding code

the '' not found in the project git repository => unable to read : the file "" not found in the project git repository

the uncommitted configuration found in the project directory: the '' must be committed => unable to read : the file "" must be committed

[giterminism] Fix doublestar.Match matches system-dependent path

Custom project-dir related fixes

Fix dockerfile-not-found error when running werf not from the root of the git work tree

\# docs/werf.yaml  
configVersion: 1  
project: docs  
---  
image: docs  
dockerfile: ./Dockerfile

When running werf from docs folder werf’s dockerfile builder will use docs dir — project dir — as build dockerfile build context root for the
ont
ext tar archive, not git work tree root.

[project-dir] Fix helm-chart-dir related errors when running werf with custom –dir.
[project-dir] Fix .git lookup should use –dir or process cwd.

Fixes and other

[doc] Fix the “Documentation” link in the site header. Fix jekyll custom filter.

Internals

[tests] Giterminism Suite: actualize tests
[giterminism] Remove unused giterminism inspector

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.4+fix11
Jan 27, 2021 at 11:00 +0300

Fixes

[deploy] werf_image and nameless image deprecation fix

Pass nameless image as .Values.werf.nameless_image instead of .Values.werf.image.

.Values.werf.image is always map[string]string and will only contain named images names.

As nameless image is being deprecated in the v1.2 there is no “normal” way to get nameless image from values, that’s why we use “special” value .Values.werf.nameless_image for now. In the v1.3 nameless images will be completely removed.

Installation

Linux amd64

Darwin amd64

Windows amd64

For more broad testing of new features

These releases are for more broad testing of new features to catch regressions. We do not guarantee backward compatibility between Beta releases.

v1.2.11+fix15
Jul 22, 2021 at 18:58 +0300

Fixes

fix(render): insert stub images names when rendering a project without –repo param, remove debug printf
docs: fix config version documentation descriptions
fix(build): fix error “lstree result is empty when writing tar archive”

Internals

cleanup(build): unused ArchiveDescriptor
infra(release_publisher): upload built binaries to S3

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.11+fix14
Jul 20, 2021 at 19:48 +0300

Fixes

  • fix(kubedog): add support for ErrImageNeverPull;
  • fix(host cleanup GC): enable auto cleanup in werf-compose commands;
  • fix(host cleanup GC): Do not print wrongly estimated size of images before delete performed;
  • fix(build): print store stage message when pushing a stage into repo;
  • fix(werf.yaml): fix default path to .helm;
    • should be relative to werf.yaml location so that custom werf.yaml location also specifies custom .helm path automatically.

Docs

  • docs: fix docs installation for macos;

Internals

  • fix(helm): remove usage of ghodss yaml, use sigs.k8s.io/yaml instead;
    • only for helm-related part, do not change legacy ansible pkg which uses ghodss.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.11+fix12
Jul 2, 2021 at 18:54 +0300

Add ability to publish miscellaneous files for bundles

feat(bundles): add ability to publish miscellaneous files existing in .helm dir

.helm/files for example will be published into the bundle.

Fixes https://github.com/werf/werf/issues/3593

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.11+fix10
Jun 15, 2021 at 11:19 +0300

[dev] Fix incorrect behavior when project repository has a dirty submodule

Error: unable to sync staged changes: git command /usr/local/bin/git -C ~/.werf/local_cache/git_worktrees/9/local/9787063286a09974befa8dc3de81e63edb79c5304621035136d181f2ca792dd7/worktree -c core.autocrlf=false -c user.email=werf@werf.io -c user.name=werf commit -m 2021-06-03 20:00:52.409615 +0400 +04 m=+1.173176433 failed: exit status 1  
On branch werf-dev-b90c24d97bcca2b4a69c4f78e85507fe925ab3f0  
nothing to commit, working tree clean

Fix werf resources tracker exits before resources are ready

Fixed in kubedog, updated werf to use latest kubedog.

Docs

[docs] Overview: fix punctuation
[docs] Channel info: fix stable channel
[docs] Update werf compose commands help: added full example

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.11+fix7
May 30, 2021 at 20:26 +0300

Docs and site

[docs] Fix quickstart minikube start command

[site][landing] Reword GitOps section

  • Use Giterminism instead of GitOps in title.
  • Add usage workflows supported by the werf (converge and bundles).
  • Add note about the way werf used (manually, CI/CD, etc.).

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix30
May 28, 2021 at 23:46 +0300

Docs

Fix quickstart minikube setup guides: use registry.example.com through ingress.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix29
May 12, 2021 at 17:40 +0300

Fixes

Fix werf-render command error shadowing and logging

  • Internal helm-dependency-build process error was shadowed and not affected anything.
  • werf render (--verbose|--debug) should enable verbose or debug mode, but it was not happened.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix27
May 11, 2021 at 19:06 +0300

Features

  • [compose] docker-compose run command support

  • [compose] Support for positional arguments to build and forward

specific images

If one or more IMAGE_NAME parameters specified, werf will build and

forward only these images

  
  werf compose up [IMAGE_NAME...] [options] [--docker-compose-options="OPTIONS"] [--docker-compose-command-options="OPTIONS"] [--] [SERVICE...]

Fixes

  • [compose] Fix certain service names specified by the user are ignored

  • [container registry] Fix processing of reference with digest

    The user may have encountered related issues when using the base image

(from) with digest (REPO@DIGEST, REPO:TAG@DIGEST).

  
  WARNING: cannot get base image id (alpine@sha256:69e70a79f2d41ab5d637de98c1e0b055206ba40a8145e7bddb55ccc04e13cf8f): can not get base image id from registry (alpine@sha256:69e70a79f2d41ab5d637de98c1e0b055206ba40a8145e7bddb55ccc04e13cf8f): repository can only contain the runes `abcdefghijklmnopqrstuvwxyz0123456789_-./`: alpine@sha256
  
  WARNING: using existing image alpine@sha256:69e70a79f2d41ab5d637de98c1e0b055206ba40a8145e7bddb55ccc04e13cf8f without pull

Documentation

  • [docs] CI/CD / GitHub Actions: update taking off label step

Internals

  • [git_repo] Move common methods from git_repo local/remote to base

  • [conveyor] Refactoring of werf config images processing

  • Improvements related to tests, coverage, and GitHub Actions workflows

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix26
May 6, 2021 at 13:42 +0300

Features

  • [dockerfile] Add dockerignore override support

First, check for

<DOCKERFILE_DIR>/<DOCKERFILE_BASENAME>.dockerignore, and if it is

found it will be used instead of the .dockerignore from the context

root.

  • [logging] Improve live output of parallel tasks

Output the log of parallel tasks sequentially, after completing a

task redirect the output of the next one to stdout.

Documentation

  • [readme] Fix documentation links

  • [docs] Advanced/Cleanup: fix cron job for host cleaning

  • [docs] Advanced/ CI/CD / GitLab: change api call to CI variable

  • [docs] refactoring to use .base_werf in ci

  • [docs] Fix links to binaries on the Installation page

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix25
Apr 21, 2021 at 15:03 +0300

Docs

Fix manual werf-host-cleanup instruction: remove /var/log/werf-host-cleanup.log, because:

  1. This file should be created and chown-ned to the right user by the system administrator manually.
  2. Separate log file should be rotated.

Thus standard /var/log/syslog file will be used instead.

Fix werf-render command suppresses errors

[logging] Update the processing of logging modes

Fix object-not-found error when using submodules

[git_repo] Switch to repo handle working with ls tree

[git_repo] Implement git repository handle
A solution to get away from the worktree when working with the git repository, caching the necessary data from the worktree during initialization, and then working exclusively with git objects.

Other fixes

[path_matcher] Fix incorrect path matcher IDs

[git_repo] Fix checksum calculation locking

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix24
Apr 14, 2021 at 16:52 +0300

Performance fix

[helm2to3] Fix maintenance helper release exists checking procedure performance
Use history command instead of listing of all releases

Docs

[docs] Reference/werf.yaml template engine: up function syntax examples
[docs] Sidebar: rename Bundles
[docs] typofix
[docs] Advanced/Helm/Overview: delete irrelevant text

Update logging library

[go.mod] github.com/werf/logboek v0.5.4

  • [fitter] Fix unpredictable behavior when using a logger by several processes
  • Fix streams mute mode

Internals

[ci] Fix release message template
[ci] Enable release publisher into bintray to support older multiwerf clients
[ci] Add build release scripts

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix22
Apr 2, 2021 at 21:07 +0300

Docs

[docs, ru] Advanced/Cleanup: actualize
[docs] Internal/Stages and storage: actualize
[docs] What’s new in v1.2/Changelog: cleaning commands
[docs] Internal/Build process: fix typo
[docs] Fix broken quickstart macos instructions
[docs] Fix v1.1 to v1.2 instruction: wrong images report usage
[docs] Fix v1.1 to v1.2 instruction: more correct report usage: pull images before usage
[docs] advanced/cleanup: added info about werf host cleanup GC

  • Only in russian.
  • Also added a helper table with all cleanup commands.
    [docs] Fixed some grammar in v1.1 to v1.2 migration guide (RU)
    [docs] Fix bundles translation to RU

Fixes

[dockerfile] Automatically reset the Dockerfile exception by .dockerignore
file rules

There is no way to ignore the Dockerfile due to docker limitation when building an image for a compressed context that reads fro
m STDIN.

Add an exception and warning message.

[GC] Fix werf-host-cleanup default percentage and margin values (always use 70% and 5% margin).

[helm] Werf-helm fixes

  • Fix panic on werf-helm-dep-update when secret-values are used (fixes https://github.com/werf/werf/issues/3443).
  • Set .Values.werf.env=”” stub werf service value in werf-helm-* commands.

Internals

  • [web] Add view page source button (#3428)
    [web] Add page source button
  • [ci] Switch to GHCR (#3441).
  • Fix README werf logo path.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix20
Mar 29, 2021 at 10:50 +0300

[dockerfile] Support dirs in contextAddFiles

  • Add an ability to specify directories along with files in contextAddFile(s) directive.
    Directories will be added recursively to the current Docker context.
  • Rename contextAddFile to contextAddFiles throughout the code and in werf.yaml, but
    keep contextAddFile supported as an alias for contextAddFiles for backwards compatibility.

Cleanup improvements

[cleaning] More detailed cleaning logging
[cleaning] Remove werf-host-project commands
[cleaning] werf host purge command: add the –project-name option to remove project images
[cleaning] werf host cleanup command: add the stub –project-name option (without implementation)
[cleaning] Remove the local storage support for cleanup and purge commands
[storage] Disable handling of image metadata in the local storage
[storage] Disable handling of managed images in the local storage
Remove the local storage support for managed-images commands

[GC] Host cleanup improvements

  • Cleanup service meta images: commit-metadata images, client-id images, managed-images records, import-metadata records, rejected-images records.
  • Save “werf” service image label into all service images created by the werf for future usage.
  • Calculate image size in cleanup GC algorithm as VIRTUAL_SIZE-SHARED_SIZE.

Builder fixes

  • Fix: print rsync server docker run command on failure.
  • [stapel] Fix: fetch artifact/image stage before running imports rsync server
    Fetch operation will check that image exists correctly and will reset stages building conveyor to rebuild this stage if needed.
  • Support for rejected stages in the stages storage
    Reject stage when docker-pull have failed with the “blob unknown” error.
    Add special record into the stages-storage for such rejected stages.
  • Fix saving stages-ids into the stages-storage-cache
    When some stage has appeared in the repository tags list, but stage image is invalid (due to MANIFEST_UNKNOWN or BLOB_UNKNOWN container registry err
    ors), werf ignores such stage. But this stage-id of such broken stage has been saved into the stages-storage-cache anyway, which is wrong.

Docs

[docs] What’s new in v1.2/Changelog: herebyIAdmitThatFromLatestMightBreakReproducibility/herebyIAdmitThatBranchMightBreakReproducibility

Internals

[web] Add guides sitemap (#3420)

[tests] Cleanup Suite: remove the local storage tests
[tests] Cleanup Suite: werf host purge command tests
[tests] Replace werf purge after callback to werf host purge –project-name
[tests] container_registry_per_implementation set: the optional local container registry support
[tests] Cleanup Suite: code generalization
[tests] container_registry_per_implementation set: the optional local container registry support

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.9+fix10
Mar 16, 2021 at 18:07 +0300

Fixes

[bundle] Fix werf-bundle-apply command does not use –env param

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.9+fix9
Mar 12, 2021 at 20:07 +0300

Docs

[docs] Advanced/Supported container registries

[docs] Advanced/Bundles: update supported container registries section

[docs] Using the term container registry instead of docker registry implementation

  • rename Advanced/Supported registry implementations to Advanced/Supported container registries
    • /documentation/advanced/supported_registry_implementations.html -> /documentation/advanced/supported_container_registries.html
  • correct all occurrences

[docs] Fix russian bundles doc

[docs] Exclude 404 pages from sitemaps (#3330)

Internals

[ci] More convenient job names (#3332)

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.9+fix8
Mar 12, 2021 at 20:06 +0300

Fixes

[helm] Enable secret-values in ‘werf helm *’ commands, fix lint command

  • Refactored pkg/deploy/helm/chart_extender.
    • Separation of chart-extenders itself and helpers.
    • Common code for secret loader.
  • Refactored secrets-manager: accept working dir param only when reading secret-key.
  • Fixed ‘werf helm lint’ command (disabled linting of an optional .helm/Chart.yaml file).
    • Refs https://github.com/werf/helm/pull/89

[helm] Fix additional –secret-values param files should redefine previously defined secret-values

Internals

[ci] Don’t deploy backend to the test env (#3327)

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.8+fix13
Mar 9, 2021 at 15:56 +0300

Fixes

[bundles] Fix bundle-publish command ignoring .helm/values.yaml and publishing .helm/secret-values.yaml

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.8+fix12
Mar 5, 2021 at 15:21 +0300

Fixes

[helm] Fix chart dependencies loader missing error reports

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.8+fix11
Mar 5, 2021 at 14:08 +0300

Docs

[docs] What’s new in v1.2: describe mounts rejection cases
[docs] Advanced/bundles: added supported registry implementations

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.8+fix10
Mar 4, 2021 at 20:21 +0300

Docs: refine whats_new_in_v1_2 documentation chapter and translate to russian (2)

  • en: https://werf.io/documentation/whats_new_in_v1_2/how_to_migrate_from_v1_1_to_v1_2.html
  • ru: https://ru.werf.io/documentation/whats_new_in_v1_2/how_to_migrate_from_v1_1_to_v1_2.html

(links will be available very soon)

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.8+fix9
Mar 4, 2021 at 20:02 +0300

Docs: refine whats_new_in_v1_2 documentation chapter and translate to russian

  • en: https://werf.io/documentation/whats_new_in_v1_2/how_to_migrate_from_v1_1_to_v1_2.html
  • ru: https://ru.werf.io/documentation/whats_new_in_v1_2/how_to_migrate_from_v1_1_to_v1_2.html

(links will be available very soon)

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.8+fix8
Mar 3, 2021 at 22:32 +0300

Add WERF_DISABLE_RESOURCES_WAITER=1 support

Specify env var to fully disable kubedog waiter.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.8+fix7
Mar 3, 2021 at 12:10 +0300

Fix “Error: unable to locate chart directory: the directory “.helm” not found in the project git repository”

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.8+fix2
Feb 27, 2021 at 21:00 +0300

New site infra

Fix CI.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.7+fix6
Feb 25, 2021 at 11:36 +0300

Docs

[docs] Fix version menu

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.7+fix5
Feb 24, 2021 at 23:19 +0300

Docs

[docs] Basic bundles article in advanced documentation section

https://werf.io/v1.2-alpha/documentation/advanced/bundles.html

Internals

Rework ls tree and path matcher interface

[ls_tree] Change the LsTree function interface

// LsTree returns the Result with tree entries that satisfy the passed pathMatcher.  
// The function works lazily and does not go through a tree directory unnecessarily.  
// If the result should contain only regular files (without directories and submodules), you should use the allFiles parameter.  
LsTree(ctx context.Context, repository *git.Repository, commit string, pathMatcher path_matcher.PathMatcher) (*Result, error) -> LsTree(ctx context.  
Context, repository *git.Repository, commit string, pathMatcher path_matcher.PathMatcher, allFiles bool) (*Result, error)

[path_matcher] Remove the greedySearch parameter and change interface

There are the following changes in the PathMatcher interface:

  • Rename the MatchPath method to IsPathMatched
  • Split the ProcessDirOrSubmodulePath method into ShouldGoThrough and IsDirOrSubmodulePathMatched methods
// IsPathMatched checks for a complete matching of the path  
IsPathMatched(string) bool  
  
// ShouldGoThrough indicates that the directory or submodule path is not completely matched but may include matching files among the child files.  
// The method returns false if the path is completely matched.  
ShouldGoThrough(string) bool  
  
// IsDirOrSubmodulePathMatched returns true if IsPathMatched or ShouldGoThrough.  
// The method returns true if there is a possibility of containing the matching files among the child files.  
IsDirOrSubmodulePathMatched(string) bool

[ls_tree] Remove the strict option in LsTree function

The option allowed to run ls tree for work tree with uninitialized submodules. In current versions, we always work with the service work tree, where the submodules must be initialized.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.7+fix2
Feb 19, 2021 at 17:15 +0300

Automigration helm 2 to 3 fixes

[helm 2 to 3] Fix: ignore resources from helm 2 release which do not exist in kubernetes

Changed order of migration steps: first set annotations and labels, then create helm 3 release.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.7
Feb 18, 2021 at 21:05 +0300

New giterminism documentation!

  • https://werf.io/documentation/advanced/giterminism.html

  • https://werf.io/documentation/reference/werf_giterminism_yaml.html

  • https://werf.io/documentation/reference/werf_yaml_template_engine.html

[docs] Overview: giterminism

[docs] Advanced/Configuration/Template engine: move to reference

[giterminism] Update error messages

[docs] Advanced/Giterminism

[docs] Reference/werf-giterminism.yaml

[docs] Advanced/Configuration/Template engine

[docs] Reference/werf.yaml: refactor and update

  • change the structure of werf yaml data file

  • add get_lang_field_or_raise_error filter to work effectively with new data structure

  • update directives descriptions

[ci] Fix Documentation Validation

  
There was an error while trying to write to `/__w/werf/werf/docs/Gemfile.lock`.
  
It is likely that you need to grant write permissions for that path.

[docs] Fix table line counter does not work properly

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.5+fix12
Feb 12, 2021 at 13:46 +0300

Fixes

[win][git] Fix CRLF issues and patch-does-not-apply errors

The root of the issue: werf have added file converted from LF to CRLF into built image under windows due to some local git autocrlf settings. Then werf cannot apply patch to the file with CRLF’s inside the build container.

  1. Fix werf to always add files into image from git without any conversions from LF to CRLF, or from CRLF to LF. Take files from the git as-is.
  2. Fix patches applier for files with CRLF already added into the built images for some reason (images built with an older werf version with this bug).

[docs] Fix incorrect link to Go guide

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.5+fix11
Feb 11, 2021 at 17:43 +0300

Fixes

[bundles] Fix “unable to create bundle: unable to write … no such file or directory”
[giterminism] Fix broken symlinks are processed incorrectly
[stapel, git] Fix adding a broken symlink does not work

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.5+fix10
Feb 11, 2021 at 12:25 +0300

Fixes

[doc] Fix incorrect Liquid syntax

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.5+fix8
Feb 9, 2021 at 21:30 +0300

Fixes

Fix interactive werf run session (–shell/–bash) works not properly

  • Fix proxy stream data formatting enabled mode

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.5+fix4
Feb 9, 2021 at 15:59 +0300

Fixes

[giterminism] Fix processing of an invalid submodule state

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.5+fix1
Feb 8, 2021 at 11:19 +0300

Giterminism refinements: full git-submodules support, better custom project dir support

[giterminism] Improve feedback if a related submodule is not clean or has changes

  • Ignore user work tree submodule directory if a submodule “.git” directory not found

  • Return a detailed error if a work tree submodule directory is not clean:

     the submodule "<submodule path>" is not clean and must be committed. Do not forget to push the current commit to the submodule remote If this commit exists only locally  
  
 Details:  
     commit:                 "0000000000000000000000000000000000000000"  
     currentWorktreeCommit:  "d9243a9a45b10e6b7d985322b8108897626a25a6"  
     expectedWorktreeCommit: "d9243a9a45b10e6b7d985322b8108897626a25a6"  
  
 You might also be interested in developer mode (activated with --dev option) that allows you to work with staged changes without doing redundant commits. Just use "git add <file>..." to include the changes that should be used.

  • Return a detailed error if a work tree submodule directory has changes:

     the submodule "<submodule path>" has modified files and these changes must be committed (do not forget to push new changes to the submodule remote) or discarded:  
  
     - file1  
     - file2

[giterminism] Support for configuration files outside the project directory

Internals:

  • [tests] Giterminism Suite: test custom project directory
  • [giterminism] Refactor symlink check code

Docs

[doc] Add Rails guide

Internals

[tests] Fix daily tests, not compiling and failing tests, refactor tests precompile

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.4+fix18
Feb 2, 2021 at 12:08 +0300

Docs

  • Update guides template and overview page.
  • Correct a grammar mistake.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.4+fix17
Feb 1, 2021 at 22:53 +0300

Fixes

[giterminism] Fix env allowance check

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.4+fix15
Jan 29, 2021 at 22:04 +0300

Docs

Preparations for guides integration:

  • https://werf.io/documentation/guides.html
  • https://ru.werf.io/documentation/guides.html

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.4+fix13
Jan 28, 2021 at 16:56 +0300

Fixes

[follow] Fix follow mode does not reinitialize giterminism manager

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.4+fix12
Jan 27, 2021 at 21:19 +0300

Giterminism

[giterminism] Refactoring: simplify error messages and the corresponding code

the '' not found in the project git repository => unable to read : the file "" not found in the project git repository

the uncommitted configuration found in the project directory: the '' must be committed => unable to read : the file "" must be committed

[giterminism] Fix doublestar.Match matches system-dependent path

Custom project-dir related fixes

Fix dockerfile-not-found error when running werf not from the root of the git work tree

\# docs/werf.yaml  
configVersion: 1  
project: docs  
---  
image: docs  
dockerfile: ./Dockerfile

When running werf from docs folder werf’s dockerfile builder will use docs dir — project dir — as build dockerfile build context root for the
ont
ext tar archive, not git work tree root.

[project-dir] Fix helm-chart-dir related errors when running werf with custom –dir.
[project-dir] Fix .git lookup should use –dir or process cwd.

Fixes and other

[doc] Fix the “Documentation” link in the site header. Fix jekyll custom filter.

Internals

[tests] Giterminism Suite: actualize tests
[giterminism] Remove unused giterminism inspector

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.4+fix11
Jan 27, 2021 at 10:16 +0300

Fixes

[deploy] werf_image and nameless image deprecation fix

Pass nameless image as .Values.werf.nameless_image instead of .Values.werf.image.

.Values.werf.image is always map[string]string and will only contain named images names.

As nameless image is being deprecated in the v1.2 there is no “normal” way to get nameless image from values, that’s why we use “special” value .Values.werf.nameless_image for now. In the v1.3 nameless images will be completely removed.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.3+fix12
Jan 26, 2021 at 18:35 +0300

Guides has been translated to English

Fixed all links to guides: https://werf.io/applications_guide

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.3+fix10
Dec 28, 2020 at 22:23 +0300

Fixes

[cleanup] Fix goroutine stack exceeds limit

One checksum can be associated with many stages, so it is necessary to exclude the stage itself before processing linked imports

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.3+fix9
Dec 24, 2020 at 20:07 +0300

Fixes

Fix deadline-exceeded when hook job took more than 5 min:

  • Fix default helm 5 min timeout => infinite.
  • Fix any timeout other than default results in ‘context deadline’ error.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.3+fix8
Dec 24, 2020 at 19:14 +0300

Fixes

  • Fix Chart.lock file not unpacked when applying bundle.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.3+fix6
Dec 21, 2020 at 20:53 +0300

Fixes

Fix “unable to create registry client” error when DOCKER_CONFIG variable is set

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.3+fix4
Dec 21, 2020 at 19:05 +0300

New bundle commands and fix bundle registry authentication

  • werf bundle export — creates resulting bundle chart directory without publishing this chart into the docker registr
    .
  • werf bundle download — downloads previously published chart into the directory without applying it into the kubernete
    .

Use default ~/.docker/config.json authentication data when publishing and applying bundles.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.3+fix2
Dec 18, 2020 at 14:14 +0300

Fix error: unable to resolve docker endpoint: open …/ca.pem: no such file or directory

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.2+fix6
Dec 17, 2020 at 18:29 +0300

Dev mode internal improvements and fixes

[dev] Apply a patch with staged changes also in index.
[true git] Reset worktree/staging changes when detaching commit.
[tests] Build/Stapel/Git: active developer mode tests.
[status] Check worktree and staging changes separately with options.
[status] Remove unused code.
[dev] Support staged binary files.

Dockerfile builder improvements

[dockerfile] Add project repo commit label.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.2+fix4
Dec 15, 2020 at 17:03 +0300

Fixes

  • [dockerfile] Temporarily force BuildKit deactivation due to the bug in the docker client when used as a go library
  • Fix ‘werf render’ uses kubernetes based lock due to typo.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.2+fix3
Dec 15, 2020 at 13:02 +0300

Fixes

  • [dev] Fix not initialized true git package.
  • [stapel, dev] Fix adding dev label to the building image.
  • [giterminism] Check untracked .helm/Chart.yaml exists in the chart.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.2+fix1
Dec 14, 2020 at 18:12 +0300

Rework dev mode for stapel and dockerfile

  • Werf creates temporary commits in the dev-mode.
  • Files from the git index used in the dev-mode.
  • Support dev-mode in conjunction with the follow-mode.
  • Commit staged files to dev branch werf-dev-<commit>.
  • Add werf-dev label to git stage images.

Change default werf images storage for GitLab CI/CD and GitHub Actions

  • Remove /werf repo suffix for GitLab CI/CD;
  • Remove -werf repo suffix for GitHub Actions.

NOTE. This is breaking change, incompatible with the previous werf versions.

Other

  • Fix “list event error: context cancelled” log messages.
  • [web] Update metainfo in page template.
  • More fixes for werf-related ci tests.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.0+fix9
Nov 23, 2020 at 15:02 +0300

Fix report-related panic on werf-run command

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.0+fix7
Nov 23, 2020 at 14:33 +0300

Docs

[docs] Reform build-proces and stages-and-storage articles

  • Move articles one level up.
  • Rename “Images storage” article to “Stages and storage”.
  • Reorganize and actualize articles.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.0+fix8
Nov 23, 2020 at 11:16 +0300

Build images report rework

  • Fix build images report not working.
  • Add envfile report format (–report-format=envfile).
  • Change report format structure.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.0+fix7
Nov 11, 2020 at 14:42 +0300

Docs

[docs] Reform build-proces and stages-and-storage articles

  • Move articles one level up.
  • Rename “Images storage” article to “Stages and storage”.
  • Reorganize and actualize articles.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.0+fix6
Nov 10, 2020 at 20:10 +0300

Docs and fixes

  • [docs] Remove outdated warning.
  • [docs] Add last publications.
  • [docs] Fix title generation.
  • [docs] Fix breadcrumbs.
  • [docs] Enable beta channel selected by default.
  • [docs] Eliminate werf-deploy and werf-build-and-publish commands from docs.
  • [docs] Advanced/Helm/Basics: replace werf deploy command with converge.
  • [cleanup] Delete invalid import metadata.

Installation

Linux amd64

Darwin amd64

Windows amd64

Nov 9, 2020 at 13:35 +0300
Nov 6, 2020 at 15:14 +0300
Nov 6, 2020 at 14:07 +0300
Nov 5, 2020 at 21:14 +0300
Nov 5, 2020 at 15:47 +0300

Least stable update channel

These releases can bring new features, but are unstable. We do not guarantee backward compatibility between Alpha releases.

v1.2.12+fix2
Jul 22, 2021 at 20:46 +0300

Fixes

fix: panic in ci-env, dismiss, managed-images and stage-image cmds

Fixed uninitialized –platform param setup code.

Installation

Linux amd64

Linux arm64

Darwin amd64

Darwin arm64

Windows amd64

v1.2.11+fix15
Jul 22, 2021 at 20:00 +0300

Fixes

fix(render): insert stub images names when rendering a project without –repo param, remove debug printf
docs: fix config version documentation descriptions
fix(build): fix error “lstree result is empty when writing tar archive”

Internals

cleanup(build): unused ArchiveDescriptor
infra(release_publisher): upload built binaries to S3

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.12+fix1
Jul 22, 2021 at 18:58 +0300

Support registry mirrors

feat(docker_registry): generic api with registry mirrors support
feat(docker_registry): init docker registry after docker for getting daemon info

Support arm64 builds

  • Added darwin and linux arm64 werf builds.

Support for platform=linux/amd64 emulation

  • Werf only supports building linux/amd64 images at the moment.
  • When running werf on arm64 platform werf requrires explicit param –platform=linux/arm64 (or WERF_PLATFORM, or DOCKER_DEFAULT_PLATFORM env. variable).
    • With this param werf would use buildkit to build Dockerfile-based images and also build stapel-based images using regular docker-run & docker-commit mechanics.

Other

Update Helm 3 from v3.6.0 to v3.6.3.

Fixes

fix(cleanup): host cleanup removes base images pulled by full name (REPO:TAG@DIGEST)

  • remove images that do not have any tags and digests instead of dangling

fix(compose): fix host cleanup gc panics in werf compose command

  • Added forgotten cli-options related to host cleanup procedure.

Internals

test(docker_registry): refactor
refactor(docker_registry): parse reference parts

Installation

Linux amd64

Linux arm64

Darwin amd64

Darwin arm64

Windows amd64

v1.2.11+fix15
Jul 20, 2021 at 19:48 +0300

Fixes

fix(render): insert stub images names when rendering a project without –repo param, remove debug printf
docs: fix config version documentation descriptions
fix(build): fix error “lstree result is empty when writing tar archive”

Internals

cleanup(build): unused ArchiveDescriptor
infra(release_publisher): upload built binaries to S3

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.11+fix14
Jul 2, 2021 at 18:54 +0300

Fixes

  • fix(kubedog): add support for ErrImageNeverPull;
  • fix(host cleanup GC): enable auto cleanup in werf-compose commands;
  • fix(host cleanup GC): Do not print wrongly estimated size of images before delete performed;
  • fix(build): print store stage message when pushing a stage into repo;
  • fix(werf.yaml): fix default path to .helm;
    • should be relative to werf.yaml location so that custom werf.yaml location also specifies custom .helm path automatically.

Docs

  • docs: fix docs installation for macos;

Internals

  • fix(helm): remove usage of ghodss yaml, use sigs.k8s.io/yaml instead;
    • only for helm-related part, do not change legacy ansible pkg which uses ghodss.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.11+fix12
Jun 25, 2021 at 15:17 +0300

Add ability to publish miscellaneous files for bundles

feat(bundles): add ability to publish miscellaneous files existing in .helm dir

.helm/files for example will be published into the bundle.

Fixes https://github.com/werf/werf/issues/3593

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.11+fix11
Jun 25, 2021 at 10:58 +0300

Change behaviour of .Release.IsInstall

Changed .Release.IsInstall logic for a release which has not been installed successfully yet: .Release.IsInstall will be true until we successfully installed release.

Docs

[docs] UI tweaks

Fixed error messages

[git_mapping] Verbose error when archive creation failed
[helm] Add more info about resource kind when patching of resource has failed

Update warn message when a stage dependency not found in git

Replace relative dependency path with absolute one in git repo.
Previously, the message used a relative path (stageDependencies value) and the warning was less informative.

WARNING: stage install dependency path <STAGE_DEPENDENCY_PATH> has not been found in own git

=>

WARNING: stage install dependency path "<ADD_PATH/STAGE_DEPENDENCY_PATH>" has not been found in own git

Other fixes

[process_exterminator] Fix WERF_ENABLE_PROCESS_EXTERMINATOR=0 false

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.11+fix10
Jun 9, 2021 at 21:02 +0300

[dev] Fix incorrect behavior when project repository has a dirty submodule

Error: unable to sync staged changes: git command /usr/local/bin/git -C ~/.werf/local_cache/git_worktrees/9/local/9787063286a09974befa8dc3de81e63edb79c5304621035136d181f2ca792dd7/worktree -c core.autocrlf=false -c user.email=werf@werf.io -c user.name=werf commit -m 2021-06-03 20:00:52.409615 +0400 +04 m=+1.173176433 failed: exit status 1  
On branch werf-dev-b90c24d97bcca2b4a69c4f78e85507fe925ab3f0  
nothing to commit, working tree clean

Fix werf resources tracker exits before resources are ready

Fixed in kubedog, updated werf to use latest kubedog.

Docs

[docs] Overview: fix punctuation
[docs] Channel info: fix stable channel
[docs] Update werf compose commands help: added full example

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.11+fix9
Jun 7, 2021 at 15:36 +0300

Fixes

Fix werf automatical namespace creation RBAC issue

Werf internally uses --create-namespace flag of helm, which is broken.

Fixed in the werf/helm fork for now: https://github.com/werf/helm/pull/96.

Created PR into upstream helm: https://github.com/helm/helm/pull/9775.

Site and docs

[site] Landing page refinements
[docs] Fix installation guide typo

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.11+fix8
Jun 4, 2021 at 13:27 +0300

werf.io site updates

Docs: minor tweaks for Giterminism section of landing page

[web] Fix broken links on the main page and update CLI pages (#3567)

Bundles

[bundle] Support insecure registry for bundles publishing

Update Helm to v3.6.0

Git mapping configuration section fixes

[git] add file with to: / disallowed, warning for trailing slash in to:

Docs actualization

[docs] Stapel/Advanced/Git directive: remove the old text
[docs] Advanced/Giterminism: fix link to env function

Update logging and dev mode

[dev] Use arbitrary name for dev branch (added option)

[ci_env] Default log terminal width to 130

[logging] Detailed image info

│ Use cache image for test/set  
p  
│      name: localhost:5000/test:a0ba487f58eca11aeac33046f233304901b955c7a9cf3a5c650bcdd1-16226272928  
9  
│        id: b3b86c474e  
3  
│   created: 2021-06-02 10:48:12 +0100 B  
T  
│      size: 2.7 MiB (+377   
)

[logging] Repo handle: detailed error
[logging] Debug GetStagesByDigest log message

Internals

[ci] PR Validation: remove commit type check and rename workflow
[tests][helm] Atomic resources update process tests

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.11+fix7
May 30, 2021 at 20:26 +0300

Docs and site

[docs] Fix quickstart minikube start command

[site][landing] Reword GitOps section

  • Use Giterminism instead of GitOps in title.
  • Add usage workflows supported by the werf (converge and bundles).
  • Add note about the way werf used (manually, CI/CD, etc.).

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.11+fix6
May 28, 2021 at 23:46 +0300

Docs

  • Fix quickstart minikube setup guides: use registry.example.com through ingress.
  • Reference/werf.yaml: fix allowFetchOriginBranchesAndTags directive.

Fixes

[werf run] Return docker run exit code
[werf compose] Return docker-compose exit code

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.11+fix5
May 26, 2021 at 17:46 +0300

# Fixes

[stapel] Fix imports with include paths do not work properly
[tests] Build/Stapel/Imports Suite: testing imports with include and exclude paths
[tests] Build/Stapel/Imports Suite: refactoring
[docs] .Values.global.env -> .Values.werf.env fix
[kubedog,debug] Revert: catch deployment tracker exited without resource status resolution bug

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.11+fix2
May 24, 2021 at 23:19 +0300

Fixes

  • [web] Fix details style, update dependencies (#3547).
  • [ci] Release: fix windows binary download link.
  • fix git[].add broken slashes on windows.

Tests

  • [tests] add tests for git[].add file renames

Internals

  • [ci] Added basic trdl.yaml to build releases using github.com/werf/vault-plugin-secrets-trdl tool

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.11+fix3
May 24, 2021 at 22:25 +0300

Debug

[debug] Catch deployment tracker exited without resource status resolution bug

Crash werf with panic and debug info in such case.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.11+fix2
May 21, 2021 at 19:11 +0300

Fixes

  • [web] Fix details style, update dependencies (#3547).
  • [ci] Release: fix windows binary download link.
  • fix git[].add broken slashes on windows.

Tests

  • [tests] add tests for git[].add file renames

Internals

  • [ci] Added basic trdl.yaml to build releases using github.com/werf/vault-plugin-secrets-trdl tool

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.11+fix1
May 19, 2021 at 16:41 +0300

Docs

[publication] Add recent publications

[docs] Advanced/Supported container registries: add Yandex Container Registry

Fixes

Fix werf does not load secret values files outside of helm chart dir

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.11
May 14, 2021 at 20:48 +0300

Fix git.add single file rename not working

This previously resulted in /dir/oldfilename in an image, but now results in /dir/newfilename as supposed to:

git:  
 - add: /dir/oldfilename  
   to: /dir/newfilename

Other fixes

  • [bundles] Remove secrets related options
  • Update kubedog: fix pod tracker panic

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix29
May 12, 2021 at 17:40 +0300

Fixes

Fix werf-render command error shadowing and logging

  • Internal helm-dependency-build process error was shadowed and not affected anything.
  • werf render (--verbose|--debug) should enable verbose or debug mode, but it was not happened.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix27
May 7, 2021 at 15:05 +0300

Features

  • [compose] docker-compose run command support

  • [compose] Support for positional arguments to build and forward

specific images

If one or more IMAGE_NAME parameters specified, werf will build and

forward only these images

  
  werf compose up [IMAGE_NAME...] [options] [--docker-compose-options="OPTIONS"] [--docker-compose-command-options="OPTIONS"] [--] [SERVICE...]

Fixes

  • [compose] Fix certain service names specified by the user are ignored

  • [container registry] Fix processing of reference with digest

    The user may have encountered related issues when using the base image

(from) with digest (REPO@DIGEST, REPO:TAG@DIGEST).

  
  WARNING: cannot get base image id (alpine@sha256:69e70a79f2d41ab5d637de98c1e0b055206ba40a8145e7bddb55ccc04e13cf8f): can not get base image id from registry (alpine@sha256:69e70a79f2d41ab5d637de98c1e0b055206ba40a8145e7bddb55ccc04e13cf8f): repository can only contain the runes `abcdefghijklmnopqrstuvwxyz0123456789_-./`: alpine@sha256
  
  WARNING: using existing image alpine@sha256:69e70a79f2d41ab5d637de98c1e0b055206ba40a8145e7bddb55ccc04e13cf8f without pull

Documentation

  • [docs] CI/CD / GitHub Actions: update taking off label step

Internals

  • [git_repo] Move common methods from git_repo local/remote to base

  • [conveyor] Refactoring of werf config images processing

  • Improvements related to tests, coverage, and GitHub Actions workflows

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix26
May 5, 2021 at 14:52 +0300

Features

  • [dockerfile] Add dockerignore override support

First, check for

<DOCKERFILE_DIR>/<DOCKERFILE_BASENAME>.dockerignore, and if it is

found it will be used instead of the .dockerignore from the context

root.

  • [logging] Improve live output of parallel tasks

Output the log of parallel tasks sequentially, after completing a

task redirect the output of the next one to stdout.

Documentation

  • [readme] Fix documentation links

  • [docs] Advanced/Cleanup: fix cron job for host cleaning

  • [docs] Advanced/ CI/CD / GitLab: change api call to CI variable

  • [docs] refactoring to use .base_werf in ci

  • [docs] Fix links to binaries on the Installation page

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix25
Apr 16, 2021 at 20:54 +0300

Docs

Fix manual werf-host-cleanup instruction: remove /var/log/werf-host-cleanup.log, because:

  1. This file should be created and chown-ned to the right user by the system administrator manually.
  2. Separate log file should be rotated.

Thus standard /var/log/syslog file will be used instead.

Fix werf-render command suppresses errors

[logging] Update the processing of logging modes

Fix object-not-found error when using submodules

[git_repo] Switch to repo handle working with ls tree

[git_repo] Implement git repository handle
A solution to get away from the worktree when working with the git repository, caching the necessary data from the worktree during initialization, and then working exclusively with git objects.

Other fixes

[path_matcher] Fix incorrect path matcher IDs

[git_repo] Fix checksum calculation locking

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix24
Apr 14, 2021 at 16:03 +0300

Performance fix

[helm2to3] Fix maintenance helper release exists checking procedure performance
Use history command instead of listing of all releases

Docs

[docs] Reference/werf.yaml template engine: up function syntax examples
[docs] Sidebar: rename Bundles
[docs] typofix
[docs] Advanced/Helm/Overview: delete irrelevant text

Update logging library

[go.mod] github.com/werf/logboek v0.5.4

  • [fitter] Fix unpredictable behavior when using a logger by several processes
  • Fix streams mute mode

Internals

[ci] Fix release message template
[ci] Enable release publisher into bintray to support older multiwerf clients
[ci] Add build release scripts

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix23
Apr 9, 2021 at 17:45 +0300

Internals

[CI] Documentation local development (#3457)

To run documentation locally, use:

cd docs/site &&  
werf compose up --follow --docker-compose-command-options="-d"

Open http://localhost:80

To stop:

cd docs/site &&  
werf compose down

You should commit main site files (site/*) into git to see changes.

Documentation files changes will be almost immediately available.

Docs

  • [docs] cleanup.md - translate and sync to RU version.
  • [docs] Advanced/Cleanup: update intro.
  • [docs] Reference/werf.yaml: fix broken link.
  • [docs] Reference/werf.yaml template engine: fix typo.
  • [docs] Fix helm configuration templates page (#3463)
  • [docs] Fix markup errors in advanced/helm/configuration/templates.html

Fixes

  • [helm] Force helm kube client namespace initialization.
  • [cleanup] Ignore blob-unknown errors properly.
    During cleanup operation do not raise should-reset-stages-storage-cache error when get stage manifest operation have failed with blob-unknown error.
  • [run] Fix nonexistent option in the error.
  • [follow] Fix werf run: changes cause reassembly but are not accounted for.
  • [logging] Build: add waiting for background tasks log message.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix22
Apr 2, 2021 at 21:07 +0300

Docs

[docs, ru] Advanced/Cleanup: actualize
[docs] Internal/Stages and storage: actualize
[docs] What’s new in v1.2/Changelog: cleaning commands
[docs] Internal/Build process: fix typo
[docs] Fix broken quickstart macos instructions
[docs] Fix v1.1 to v1.2 instruction: wrong images report usage
[docs] Fix v1.1 to v1.2 instruction: more correct report usage: pull images before usage
[docs] advanced/cleanup: added info about werf host cleanup GC

  • Only in russian.
  • Also added a helper table with all cleanup commands.
    [docs] Fixed some grammar in v1.1 to v1.2 migration guide (RU)
    [docs] Fix bundles translation to RU

Fixes

[dockerfile] Automatically reset the Dockerfile exception by .dockerignore
file rules

There is no way to ignore the Dockerfile due to docker limitation when building an image for a compressed context that reads fro
m STDIN.

Add an exception and warning message.

[GC] Fix werf-host-cleanup default percentage and margin values (always use 70% and 5% margin).

[helm] Werf-helm fixes

  • Fix panic on werf-helm-dep-update when secret-values are used (fixes https://github.com/werf/werf/issues/3443).
  • Set .Values.werf.env=”” stub werf service value in werf-helm-* commands.

Internals

  • [web] Add view page source button (#3428)
    [web] Add page source button
  • [ci] Switch to GHCR (#3441).
  • Fix README werf logo path.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix21
Mar 30, 2021 at 23:10 +0300

Helm update

Builtin helm updated to v3.5.3.

Fixes

[helm] Add support for oci registries in Chart.yaml: fix panic; updated helm

  • Panic was due to uninitialized helm registry client.
    Fixes https://github.com/werf/werf/issues/3415

[builder] Perform rejection of blob-unknown stages
Perform rejection of stages for which get-manifest has failed with blob-unknown error.

Internals and site

[tests] Bundle Suite: fix

Bump kramdown from 2.3.0 to 2.3.1 in /docs/documentation

Bumps kramdown from 2.3.0 to 2.3.1.

[web] Fix documentation overview assets (#3432)

[web] Use common partials for guides (#3394)

  • [web] Use common partials for guides
  • [web] Guides tiles fix

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix20
Mar 26, 2021 at 19:34 +0300

[dockerfile] Support dirs in contextAddFiles

  • Add an ability to specify directories along with files in contextAddFile(s) directive.
    Directories will be added recursively to the current Docker context.
  • Rename contextAddFile to contextAddFiles throughout the code and in werf.yaml, but
    keep contextAddFile supported as an alias for contextAddFiles for backwards compatibility.

Cleanup improvements

[cleaning] More detailed cleaning logging
[cleaning] Remove werf-host-project commands
[cleaning] werf host purge command: add the –project-name option to remove project images
[cleaning] werf host cleanup command: add the stub –project-name option (without implementation)
[cleaning] Remove the local storage support for cleanup and purge commands
[storage] Disable handling of image metadata in the local storage
[storage] Disable handling of managed images in the local storage
Remove the local storage support for managed-images commands

[GC] Host cleanup improvements

  • Cleanup service meta images: commit-metadata images, client-id images, managed-images records, import-metadata records, rejected-images records.
  • Save “werf” service image label into all service images created by the werf for future usage.
  • Calculate image size in cleanup GC algorithm as VIRTUAL_SIZE-SHARED_SIZE.

Builder fixes

  • Fix: print rsync server docker run command on failure.
  • [stapel] Fix: fetch artifact/image stage before running imports rsync server
    Fetch operation will check that image exists correctly and will reset stages building conveyor to rebuild this stage if needed.
  • Support for rejected stages in the stages storage
    Reject stage when docker-pull have failed with the “blob unknown” error.
    Add special record into the stages-storage for such rejected stages.
  • Fix saving stages-ids into the stages-storage-cache
    When some stage has appeared in the repository tags list, but stage image is invalid (due to MANIFEST_UNKNOWN or BLOB_UNKNOWN container registry err
    ors), werf ignores such stage. But this stage-id of such broken stage has been saved into the stages-storage-cache anyway, which is wrong.

Docs

[docs] What’s new in v1.2/Changelog: herebyIAdmitThatFromLatestMightBreakReproducibility/herebyIAdmitThatBranchMightBreakReproducibility

Internals

[web] Add guides sitemap (#3420)

[tests] Cleanup Suite: remove the local storage tests
[tests] Cleanup Suite: werf host purge command tests
[tests] Replace werf purge after callback to werf host purge –project-name
[tests] container_registry_per_implementation set: the optional local container registry support
[tests] Cleanup Suite: code generalization
[tests] container_registry_per_implementation set: the optional local container registry support

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix19
Mar 23, 2021 at 21:42 +0300

Docs fixes

[web] Fix 404 page (#3410)
[web] Change 404 logic (#3397)

[docs] Replace Werf with werf
[docs] Fix style, grammar, and typos

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix17
Mar 23, 2021 at 16:27 +0300

[helm] Added werf-helm-registry command

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix16
Mar 23, 2021 at 15:59 +0300

[GC] Host auto cleanup refinements

  • Enabled auto host cleanup by default.
  • –allowed-docker-storage-volume-usage and –allowed-docker-storage-volume-usage-margin to configure docker-storage host cleanup.
  • –allowed-local-cache-volume-usage and –allowed-local-cache-volume-usage-margin to configure local-storage host cleanup (including git-data).

Docs

[web] Fix installation page tab logic (#3395)
[docs] Remove 1.0 version from the installation page (#3396)

Internals

[CI] Add commit and PR tests (#3393)
[CI] Update Certificate template

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix15
Mar 22, 2021 at 21:31 +0300

[GC] Git-data repos, worktrees, archives and patches GC based on LRU algorithm

  • Remove v1.1 git-data if werf v1.1 was not started for 3 days on this build-host.
  • Remove *.tmp data from git_repos, which are git-clone temporary dirs accidentally left existing.
  • Moved gc and git-data-manager related code into the separate package gitdata inside git_repo package (refactor).
  • Fixed new bug introduced by the v1.2.10+fix14 version: assets/setup /.werf/stapel/embedded/bin/xargs: Cannot open input file '/.werf/patch/.werf/patch/0c962ed1755d99a8937abe6fe63953bf818...

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix11
Mar 22, 2021 at 17:31 +0300

[cleanup] Fix cleaning images built on a virtual merge commit

[metadata] Add image metadata for the from virtual merge commit

Deprecations

Deprecation warning for the –repo-implementation option

DEPRECATION WARNING: The option --repo-implementation ($WERF_REPO_IMPLEMENTATION) is renamed to --repo-container-registry ($WERF_REPO_CONTAINER_REGISTRY) and will be removed in v1.3!

Internals

[docs][ci] SEO improvement and ci updates (#3373)

[ci] Tests Workflow: drop out of self-hosted runners

[ci] Documentation Validation: fix `chmod: Gemfile.lock: No such file or directory

[ci] Fix tests

```  
Run # unit tests binaries  
?       github.com/werf/werf/cmd/werf   [no test files]  
go: directory integration/ci_suites/default/docs/_fixtures/cli/docs/site/backend is outside main module  
Error: Process completed with exit code 1.  
```

[ci] Workflows: replace always with success || failure condition
The always function returns true even when canceled, or the previous tasks skipped.

[ci] Documentation Validation: fix chmod: Gemfile.lock: No such file or directory

[ci] Use .Values.werf.env instead of .Values.global.env

[maintenance_helper] Fix error format

  • Errorf format %s reads arg #2, but call has 1 arg
  • Errorf format %s reads arg #3, but call has 2 args

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix14
Mar 22, 2021 at 13:14 +0300

[GC] Add support for v1.1 images into host cleanup procedure

Cleanup only those images/stages, which has been published into REPO stages-storage.

NOTE. V1.2’s werf host cleanup procedure will not cleanup –stages-storage=:local stages, because this is primary stages storage data, and it can only be cleaned by the regular per-project werf cleanup command with git-history based algorithm.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix11
Mar 20, 2021 at 17:05 +0300

[cleanup] Fix cleaning images built on a virtual merge commit

[metadata] Add image metadata for the from virtual merge commit

Deprecations

Deprecation warning for the –repo-implementation option

DEPRECATION WARNING: The option --repo-implementation ($WERF_REPO_IMPLEMENTATION) is renamed to --repo-container-registry ($WERF_REPO_CONTAINER_REGISTRY) and will be removed in v1.3!

Internals

[docs][ci] SEO improvement and ci updates (#3373)

[ci] Tests Workflow: drop out of self-hosted runners

[ci] Documentation Validation: fix `chmod: Gemfile.lock: No such file or directory

[ci] Fix tests

```  
Run # unit tests binaries  
?       github.com/werf/werf/cmd/werf   [no test files]  
go: directory integration/ci_suites/default/docs/_fixtures/cli/docs/site/backend is outside main module  
Error: Process completed with exit code 1.  
```

[ci] Workflows: replace always with success || failure condition
The always function returns true even when canceled, or the previous tasks skipped.

[ci] Documentation Validation: fix chmod: Gemfile.lock: No such file or directory

[ci] Use .Values.werf.env instead of .Values.global.env

[maintenance_helper] Fix error format

  • Errorf format %s reads arg #2, but call has 1 arg
  • Errorf format %s reads arg #3, but call has 2 args

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix10
Mar 19, 2021 at 00:28 +0300

[dockerfile] The BuildKit support with explicit user activation

  • By default werf disables BuildKit when building dockerfiles.
  • If the user explicitly activates BuildKit (DOCKER_BUILDKIT = 1), werf enables it but without output in the background builds due to https://github.com/docker/cli/issues/2889.

[GC] Rework host cleanup more

  • Run auto host cleanup only when –disable-host-cleanup=false (WERF_DISABLE_HOST_CLEANUP=false), cleanup will be enabled by default later.
  • Run auto host cleanup could run in werf-build/werf-converge and other commands as previously, BUT it will run in the end of the command.
    • Big note message is printed before running auto host cleanup.
      • This message contains info how to disable auto-host-cleanup.
  • Run /tmp/werf-config-render-* and /tmp/werf-project-data-* cleanup in the werf-host-cleanup procedure as well.
  • Removed global lock for host cleanup, added individual locks for stage-images and build-containers
  • Run auto host cleanup only when 2 hour has passed since first werf run on this host (try to determine that current host is persistent).

Fixes

[status] Fix duplications in the path list

Error: unable to read werf config: the following files must be committed:  
  
 - werf.yaml  
 - werf.yaml

Internals

[ci] Delete cleanup job (#3371)

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix8
Mar 17, 2021 at 19:10 +0300

Speeding up git-repo operations

[git_repo] Caching and optimization operations with git objects

Updated docker, buildkit and containerd go-dependencies

  • github.com/docker/cli => v20.10.5
  • github.com/docker/docker => v20.10.5
  • github.com/containerd/containerd => v1.5.0-beta.4
  • github.com/moby/buildkit => v0.8.2

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix7
Mar 17, 2021 at 18:00 +0300

[GC] Host cleaning GC refinements and fixes

[GC] Host cleaning GC refinements and fixes: correct usage of allowed-volume-usage and allowed-volume-usage-margin

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix6
Mar 17, 2021 at 16:31 +0300

Fixes

[git_repo] Invalidate archives and patches cache

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix5
Mar 17, 2021 at 12:03 +0300

[GC] Host cleanup garbage collection refinements

  • Added –allowed-volume-usage-margin param which sets target volume usage after cleanup: allowed-volume-usage - allowed-volume-usage-margin.
  • Delete 10 images minimal in each GC iteration to speed up cleanup.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix4
Mar 16, 2021 at 17:44 +0300

Internals

[web] Fix documentation-version build: increment cache version

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix3
Mar 16, 2021 at 16:56 +0300

Fixes

[git_repo] Fix LsTree/Patch/Archive cache ID
[git] Invalidate cached git-archives and git-patches: changed cache version

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10+fix1
Mar 16, 2021 at 16:13 +0300

Internals

Path matchers

  • Remove irrelevant legacy methods: TrimFileBaseFilepath and BaseFilepath
  • Redesign path matchers and divide them into simple entities
    • base path
    • include
    • exclude
    • dockerignore patterns
    • true
    • false
    • complex
    • multi
  • Add factory constructor for easy and clear use
  • Add the ID method to determine the path matcher parameters unambiguously
  • Fix multi path matcher the ShouldGoThrough method logic: the method returns true if the ShouldGoThrough method of at least one matcher returns true and the path partially or completely matched by others (IsDirOrSubmodulePathMatched returns true)
  • Complete test coverage

Git

  • Generalization of the calculating git repository files checksum
    • Simplify the GetOrCreateChecksum method
      • the method creates or gets a checksum from the cache
      • the previous logic was specific to git mapping (it is taken out and based on the new implementation)
    • The logic of stapel and dockerfile checksum calculation is reduced to one mechanism
  • Archive/Patch/LsTree: add the PathScope option to limit paths and determine the base directory/file (similar to <pathspec> in the git commands).

Other

  • [util] Fix IsSubpathOfBasePath helper
    • Incorrect processing of empty ("") and root ("/") basePath
    • Checking for identical paths returns true

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.10
Mar 15, 2021 at 23:14 +0300

[GC] Basic garbage collection for build host images and containers

  • Experimental feature: automatical host cleaning GC procedure will be activated only when WERF_ENABLE_HOST_STORAGE_GC=1 is set.
  • Werf may perform GC procedure in main commands (werf-build, werf-converge, etc.).
  • To manually call GC procedure use werf host cleanup command.
  • Algorithm and options:
    • Werf will try to maintain 80% disk usage by default and perform deletion of old images build by werf (and containers, and dangligh images as well). User may specify different threshold percentage with –allowed-volume-usage=N (WERF_ALLOWED_VOLUME_USAGE) option.
    • Werf tries to detect docker storage volume to check volume usage. User may specify –docker-server-storage-path (WERF_DOCKER_SERVER_STORAGE_PATH) option manually to specify volume where docker storage directory reside.

Fixes

[dockerfile] Skip files ignored by .dockerignore file creating a context archive
[bundle] Fix werf-bundle-apply command does not use –env param
[compose] Fetch last stages of built images before running compose
[dockerfile] Fix .dockerignore does not affect on stage digest when using a custom project directory

Docs

[web] Fix some redirects (#3347)

[docs] Update the version of werf actions
werf/actions/deploy@master -> werf/actions/deploy@v1.2

[docs] Tune sitemaps (#3337, #3336)

[docs] Renaming the translation of the term “bundle”

Internals

[git_repo] Use PatchMatcher instead of FilterOptions
[path_matcher] Update multiPathMatcher string format
[ci] Delete namespace on review dismiss (#3333)

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.9+fix10
Mar 15, 2021 at 20:08 +0300

Fixes

[bundle] Fix werf-bundle-apply command does not use –env param

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.9+fix9
Mar 12, 2021 at 20:07 +0300

Docs

[docs] Advanced/Supported container registries

[docs] Advanced/Bundles: update supported container registries section

[docs] Using the term container registry instead of docker registry implementation

  • rename Advanced/Supported registry implementations to Advanced/Supported container registries
    • /documentation/advanced/supported_registry_implementations.html -> /documentation/advanced/supported_container_registries.html
  • correct all occurrences

[docs] Fix russian bundles doc

[docs] Exclude 404 pages from sitemaps (#3330)

Internals

[ci] More convenient job names (#3332)

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.9+fix8
Mar 9, 2021 at 22:20 +0300

Fixes

[helm] Enable secret-values in ‘werf helm *’ commands, fix lint command

  • Refactored pkg/deploy/helm/chart_extender.
    • Separation of chart-extenders itself and helpers.
    • Common code for secret loader.
  • Refactored secrets-manager: accept working dir param only when reading secret-key.
  • Fixed ‘werf helm lint’ command (disabled linting of an optional .helm/Chart.yaml file).
    • Refs https://github.com/werf/helm/pull/89

[helm] Fix additional –secret-values param files should redefine previously defined secret-values

Internals

[ci] Don’t deploy backend to the test env (#3327)

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.9+fix7
Mar 9, 2021 at 16:49 +0300

Fixes

[bundles] Fix bundle-publish ignores .helm/values.yaml and uses .helm/secret-values.yaml

Update Helm

[helm] Update helm v3.5.0 -> v3.5.2

https://github.com/helm/helm/releases/tag/v3.5.2

Internals

[ci] Website review environments (#3315)

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.9+fix5
Mar 5, 2021 at 14:08 +0300

Giterminism

[giterminism] Separate processing for untracked and uncommitted files

Docs

[docs] What’s new in v1.2: describe mounts rejection cases
[docs] Advanced/bundles: added supported registry implementations

Other

Kubedog update: disable events informer with KUBEDOG_DISABLE_EVENTS=1

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.9+fix4
Mar 4, 2021 at 20:21 +0300

Docs: refine whats_new_in_v1_2 documentation chapter and translate to russian (2)

  • en: https://werf.io/documentation/whats_new_in_v1_2/how_to_migrate_from_v1_1_to_v1_2.html
  • ru: https://ru.werf.io/documentation/whats_new_in_v1_2/how_to_migrate_from_v1_1_to_v1_2.html

(links will be available very soon)

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.9+fix3
Mar 4, 2021 at 20:02 +0300

Docs: refine whats_new_in_v1_2 documentation chapter and translate to russian

  • en: https://werf.io/documentation/whats_new_in_v1_2/how_to_migrate_from_v1_1_to_v1_2.html
  • ru: https://ru.werf.io/documentation/whats_new_in_v1_2/how_to_migrate_from_v1_1_to_v1_2.html

(links will be available very soon)

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.9+fix1
Mar 4, 2021 at 16:40 +0300

Developer mode change for follow mode and docs

[docs] Actualize the developer mode references

[dev] Update the –dev option description

[follow] New following logic in development mode
The mode allows restarting the command on a new commit.
In development mode (–dev), it additionally tracks changes in the index state of the git repository, regardless of whether simple or strict development mode (–dev-mode) is used.

[dev] Change the cache logic in simple development mode
Create a single commit for changes in the worktree instead of two separate commits for index and worktree changes.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.9
Mar 3, 2021 at 22:32 +0300

Support for modified/tracked files for the dev mode

  • Introduced --dev-mode simple|strict option.
  • --dev-mode simple — default mode when --dev option has been specified, to use strict mode specify `–dev-mode strict
    .
  • In simple dev mode werf will use only files which are staged for commit (files which has been added with the git add command) and also modified files changes, which has not been staged for commit.
  • In strict mode werf will use only files which are staged for commit (files which has been added with the git add command).

Fix glob DIR/** not working in stage-dependencies

[path_matcher] Fix Simple/GitMappingPathMatcher.IsMatched method logic

Several sets of globes are used when comparing paths:

  • The globes as they are.
  • The globes without asterisks on the right (path//dir//*, path/*/dir/, path//dir///** -> path/*/dir).
  • The globes from the previous set with the universal part **/* (path//dir/**/).

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.8+fix7
Mar 3, 2021 at 11:49 +0300

Fix “Error: unable to locate chart directory: the directory “.helm” not found in the project git repository”

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.8+fix5
Mar 2, 2021 at 22:06 +0300

Docs

[docs] “What’s new in v1.2 / How to migrate from v1.1 to v1.2” guide

  • English version only, Russian coming soon.
  • https://werf.io/v1.2-alpha/documentation/whats_new_in_v1_2/how_to_migrate_from_v1_1_to_v1_2.html (link will be available very soon).

[docs] Advanced/Stapel/Mount: add giterminism note
[docs] Reference/werf.yaml: contextAddFile
[docs] Reference: rearrange menu items

Internal fixes

Fixes for new CI and new site infra.

[web] Fix topnav
[web] Fix RSS feeds and installation page
[ci] Fix web converge
[web] Fix version menu

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.8+fix6
Mar 2, 2021 at 21:27 +0300

Docs

[docs] Translate to russian and refine advanced/helm chapter
https://ru.werf.io/v1.2-alpha/documentation/advanced/helm/overview.html (ссылка начнёт работать в ближайшее время)

[docs] Introduction: add a reference to giterminism

[docs] Advanced/Giterminism: add dev mode note

[docs] Internals/Build Process

  • More details about dockerfile image
  • Parallel builds

[docs] Internals/Stages and storage: sync

[docs] Reference/werf.yaml template engine: the .Env variable

[docs] Advanced/Giterminism: small improvement

[docs] Reference/werf.yaml template engine: the template directory

[docs] Reference/werf.yaml template engine: update the tpl function

Fix stageDependencies dir/** does to work

[path_matcher] Update Simple/GitMappingPathMatcher.IsMatched method logic

Several sets of globes are used when comparing paths:

  • The universal part */ is added to all globes (as before).
  • From all globes all asterisks to the right are cut off.

Internals

[ci] Daily Tests: fix “Prepare coverage file” step
[ci] Daily Tests: disable self-hosted runners
[ci] Fix directory integration/ci_suites/default/docs/_fixtures/cli/docs/backend is outside main module

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.8+fix5
Mar 1, 2021 at 15:49 +0300

Docs

[docs] “What’s new in v1.2 / How to migrate from v1.1 to v1.2” guide

  • English version only, Russian coming soon.
  • https://werf.io/v1.2-alpha/documentation/whats_new_in_v1_2/how_to_migrate_from_v1_1_to_v1_2.html (link will be available very soon).

[docs] Advanced/Stapel/Mount: add giterminism note
[docs] Reference/werf.yaml: contextAddFile
[docs] Reference: rearrange menu items

Internal fixes

Fixes for new CI and new site infra.

[web] Fix topnav
[web] Fix RSS feeds and installation page
[ci] Fix web converge
[web] Fix version menu

Installation

Linux amd64

Darwin amd64

Windows amd64

Mar 1, 2021 at 15:03 +0300
v1.2.8+fix2
Feb 27, 2021 at 21:00 +0300

New site infra

Fix CI.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.7+fix7
Feb 26, 2021 at 19:29 +0300

Docs

[docs] Added new animation for intro scheme

[docs] Better releache channel switcher

[docs] “What’s new in v1.2” documentation chapter (part 1/2)

Chapter consists of 2 articles:

  1. Changelog — full descriptive list of key changes since v1.1, explaining what and wh
    .
  2. How to migrate from v1.1 to v1.2 — fast guide to migrate your project from v1.1 to v1.2 without excess explanations
    ‘

This change is part 1 of the following changes:

  1. english version of changelog;
  2. english and russian version of migration guide and russian version of changelog (will be available in next releases).

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.7+fix6
Feb 25, 2021 at 11:36 +0300

Docs

[docs] Fix version menu

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.7+fix5
Feb 24, 2021 at 23:19 +0300

Docs

[docs] Basic bundles article in advanced documentation section

https://werf.io/v1.2-alpha/documentation/advanced/bundles.html

Internals

Rework ls tree and path matcher interface

[ls_tree] Change the LsTree function interface

// LsTree returns the Result with tree entries that satisfy the passed pathMatcher.  
// The function works lazily and does not go through a tree directory unnecessarily.  
// If the result should contain only regular files (without directories and submodules), you should use the allFiles parameter.  
LsTree(ctx context.Context, repository *git.Repository, commit string, pathMatcher path_matcher.PathMatcher) (*Result, error) -> LsTree(ctx context.  
Context, repository *git.Repository, commit string, pathMatcher path_matcher.PathMatcher, allFiles bool) (*Result, error)

[path_matcher] Remove the greedySearch parameter and change interface

There are the following changes in the PathMatcher interface:

  • Rename the MatchPath method to IsPathMatched
  • Split the ProcessDirOrSubmodulePath method into ShouldGoThrough and IsDirOrSubmodulePathMatched methods
// IsPathMatched checks for a complete matching of the path  
IsPathMatched(string) bool  
  
// ShouldGoThrough indicates that the directory or submodule path is not completely matched but may include matching files among the child files.  
// The method returns false if the path is completely matched.  
ShouldGoThrough(string) bool  
  
// IsDirOrSubmodulePathMatched returns true if IsPathMatched or ShouldGoThrough.  
// The method returns true if there is a possibility of containing the matching files among the child files.  
IsDirOrSubmodulePathMatched(string) bool

[ls_tree] Remove the strict option in LsTree function

The option allowed to run ls tree for work tree with uninitialized submodules. In current versions, we always work with the service work tree, where the submodules must be initialized.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.7+fix4
Feb 20, 2021 at 21:13 +0300

Docs: rework advanced/helm chapter (part 1/3)

This change include only part 1 of the following steps:

  1. English version of advanced/helm chapter.
  2. Refinements for advanced/helm and new reference/helm chapter.
  3. Russian version of advanced/helm and reference/helm.

Advanced/helm chapter contains multiple sections:

  • configuration;
  • deploy process;
  • releases;

— each of which contains multiple articles, structured in sideba
.

Added giterminism article into configuration section.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.7+fix3
Feb 20, 2021 at 14:44 +0300

Fixes: giterminism and color output in CI/CD

[giterminism] Fix loose giterminism mode

Error:

unable to locate chart directory: the directory ".helm" not found in the project git repository

[tests] Giterminism Suite: actualize tests

[go.mod] github.com/werf/logboek v0.5.3

  • Fix color output in CI jobs
  • Update github.com/gookit/color v1.3.5 -> v1.3.7

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.7+fix2
Feb 19, 2021 at 15:21 +0300

Automigration helm 2 to 3 fixes

[helm 2 to 3] Fix: ignore resources from helm 2 release which do not exist in kubernetes

Changed order of migration steps: first set annotations and labels, then create helm 3 release.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.7+fix1
Feb 19, 2021 at 13:29 +0300

Automigration helm 2 to 3 fixes

[helm 2 to 3] Change migration mechanics from PATCH to REPLACE

Do not patch resources to add annotations and labels, because not all resources kinds supports strategic-merge-patch.
Use simple GET, client-side merge, then REPLACE operation (as kubectl edit use).

[migrate 2 to 3] Print warning when helm 2 and helm 3 releases exists at the same time

If for some unknown and unexpected by werf migration workflow reason there is helm 2 and helm 3 releases at the moment,
then ignore helm 2 release and continue deploy process into helm 3 release, but print a WARNING about existing helm 2 release.

To disable this warning user should possible cleanup helm 2 metadata by kubectl -n kube-system delete cm RELEASE.VERSION.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.7
Feb 18, 2021 at 21:04 +0300

New giterminism documentation!

  • https://werf.io/documentation/advanced/giterminism.html

  • https://werf.io/documentation/reference/werf_giterminism_yaml.html

  • https://werf.io/documentation/reference/werf_yaml_template_engine.html

[docs] Overview: giterminism

[docs] Advanced/Configuration/Template engine: move to reference

[giterminism] Update error messages

[docs] Advanced/Giterminism

[docs] Reference/werf-giterminism.yaml

[docs] Advanced/Configuration/Template engine

[docs] Reference/werf.yaml: refactor and update

  • change the structure of werf yaml data file

  • add get_lang_field_or_raise_error filter to work effectively with new data structure

  • update directives descriptions

[ci] Fix Documentation Validation

  
There was an error while trying to write to `/__w/werf/werf/docs/Gemfile.lock`.
  
It is likely that you need to grant write permissions for that path.

[docs] Fix table line counter does not work properly

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.6+fix6
Feb 18, 2021 at 10:51 +0300

Added support for –kube-config-base64

Ability to pass kube config in base64 encoded form using cli –kube-config-base64 or $WERF_KUBE_CONFIG_BASE64, or $WERF_KUBECONFIG_BASE64 or $KUBE_CONFIG_BASE64 or $KUBECONFIG_BASE64.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.6+fix5
Feb 16, 2021 at 16:52 +0300

Docs

[docs] Advanced/Configuration: shell examples take precedence over ansible

Fixes and other

[ci_env] Ignore the non-existent –tagging-strategy option

Ignore only if the old form of the command call is used: source <(werf ci-env gitlab --tagging-strategy=...)

[ci_env] Fix unable to create tmp docker config based on the user’s one

Error: unable to create tmp docker config: unable to copy /home/user/.docker to /tmp/werf-docker-config-780142139: open /home/user/.docker/run/docker-cli-api.sock: no such device or address

[bundles] Do not render published chart in werf-publish and bundle-export commands

Render cmd was used only to initiate loading of chart configuration.
Eliminated render cmd, use loader directly instead.

[render] Add –validate and include-crds opts for werf-render cmd

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.6+fix4
Feb 15, 2021 at 23:14 +0300

Automigration to helm 3 in werf converge command

When werf-converge command detects existing helm 2 release with the same name it will try to render current release using helm 3 with full validation,

Then if render has been succeeded werf will migrate helm 2 release to a newly created helm 3 release. Old helm 2 release will be removed.

CAUTION!

This operation cannot be undone.

Once werf v1.2 has converted your project to helm 3, it cannot be deployed by werf v1.1 anymore. Werf v1.1 will refuse to deploy your project once helm 3 release has been created.

[config] Add fromYaml function

Available in the werf.yaml and .werf/**/*.tmpl configs.

  • fromYAML(str string) (map[string]interface{}, error)
  • return error if unmarshalling failed

werf.yaml

...  
{{- $values := .Files.Get "werf_values.yaml" | fromYaml -}} // or fromYaml (.Files.Get "werf_values.yaml")  
from: {{- $values.image.from }}

werf_values.yaml

image:  
    from: alpine

Internals and fixes

[git_repo, status] Fix no error handling.

[git_repo, status] Fix the use of service work tree when the repository contains submodules
Status should always be taken for the user’s work tree

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.6+fix3
Feb 12, 2021 at 17:57 +0300

Giterminism internals improvements and fixes

Added support for .gitignore into giterminism subsystem.

[giterminism] Optimize listing fs files

Skip file if:

  • not accepted by giterminism config
  • not changed locally
  • ignored by .gitignore
  • not inside an unclean submodule repository

[giterminism] Use pathMatcher for matching paths

[path_matcher] Implement StubPathMatcher that always returns false

[git_repo] ListCommitFilesWithGlob: small improvement

The file path does not get into the result if the glob is the file path without patterns

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.6+fix2
Feb 12, 2021 at 13:46 +0300

Fixes

[win][git] Fix CRLF issues and patch-does-not-apply errors

The root of the issue: werf have added file converted from LF to CRLF into built image under windows due to some local git autocrlf settings. Then werf cannot apply patch to the file with CRLF’s inside the build container.

  1. Fix werf to always add files into image from git without any conversions from LF to CRLF, or from CRLF to LF. Take files from the git as-is.
  2. Fix patches applier for files with CRLF already added into the built images for some reason (images built with an older werf version with this bug).

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.6+fix1
Feb 11, 2021 at 19:42 +0300

Fixes

[helm 2 to 3] Fix werf helm migrate2to3 command: create helm 3 release in the first place
- Migration command should create helm 3 release object because it contains managed fields of all resources.
- It is better not lost this information about managed fields, because werf-converge will not delete fields, which has been deleted for some resource in the current repo .helm/templates in such case.

[bundles] Fix “unable to create bundle: unable to write … no such file or directory”
[giterminism] Fix broken symlinks are processed incorrectly
[stapel, git] Fix adding a broken symlink does not work
[docs] Fix incorrect link to Go guide
[docs] Updating Telegram links
[docs] Fix incorrect Liquid syntax
[werf.io landing] Index page update: new intro slides
[helm][giterminism] Cache chart dependencies by hashsum of the whole .helm/Chart.lock, not digest

Other

  • Temporarily revert custom docker images tags.
  • Added global .Values.global.werf.name value.

  • [config] .Files.Glob fails with an error instead of a warning message if no matches found

     Error: unable to load werf config: template: werfConfig:8:9: executing "werfConfig" at <.Files.Glob>: error calling Glob: {{ .Files.Glob "path" }}: no matches found
  • [giterminism] Optimize listing files with glob
    • Check each file path for the possibility of matching child files
    • Get glob prefix without patterns and use it as start directory

Internals

[tests] Giterminism Suite: disable log color
[giterminism] Refactor: WalkConfigurationFilesWithGlob returns paths relative to dir

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.5+fix11
Feb 11, 2021 at 17:43 +0300

Fixes

[bundles] Fix “unable to create bundle: unable to write … no such file or directory”
[giterminism] Fix broken symlinks are processed incorrectly
[stapel, git] Fix adding a broken symlink does not work

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.5+fix10
Feb 10, 2021 at 20:01 +0300

Fixes

[doc] Fix incorrect Liquid syntax

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.5+fix9
Feb 10, 2021 at 19:31 +0300

Giterminism and helm fixes

Cache chart dependencies by hashsum of the whole .helm/Chart.lock, not digest. This allows usage of update chart dependency when digest has not been changed.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.5+fix8
Feb 10, 2021 at 13:02 +0300

Fixes

Fix interactive werf run session (–shell/–bash) works not properly

  • Fix proxy stream data formatting enabled mode

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.6
Feb 9, 2021 at 21:30 +0300

Introduce custom build tags and migration from helm2 to helm3

  1. Custom build tags.

    • Add --add-custom-tag that can be used multiple times for build command.
    • Add --use-custom-tag for helm commands.
    • It is necessary to use the image name shortcut %image% or %image_slug% in the tag format if there is more than one image in the werf config.
    • [giterminism] Inspect custom tags: the tags should be accepted by cli.AllowCustomTags directive.
    • Should be built check: an image for a specified custom tag must exist and be the same as an image for related content-based tag.

  2. Migration from helm 2 to helm 3.

    • werf converge command will fail if it detects existing helm 2 command;
    • start a migration process with the “werf helm migrate2to3 –release HELM2_RELEASE –target-namespace TARGET_HELM3_NAMESPACE” command;
    • finish a migration process with “werf converge” command into specified release and namespace;
    • more docs are coming soon.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.5+fix8
Feb 9, 2021 at 21:23 +0300

Fixes

Fix interactive werf run session (–shell/–bash) works not properly

  • Fix proxy stream data formatting enabled mode

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.5+fix7
Feb 9, 2021 at 16:32 +0300

Fixes

Ignore BLOB_UNKNOWN registry errors. Ignore silently without warnings until werf-cleanup does not delete these broken images.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.5+fix6
Feb 9, 2021 at 15:59 +0300

Fixes

[git repo] Move cache and change checksum calculation lock logic
[status] Do not cache repository and submodules repositories in the result
[docs] Fix custom helm release name template docs example
[refactor] Container runtime pkg: remove unused code and small fixes
[ls_tree] Do not cache repository and submodule repositories in the result
[docs] Fix a single quote in flag description breaks styles on cli command page

  • [cli] Automatic replacement of single quotes (‘) with accent graves (`) in a flag description

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.5+fix4
Feb 9, 2021 at 14:37 +0300

Fixes

[giterminism] Fix processing of an invalid submodule state

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.5+fix3
Feb 8, 2021 at 13:41 +0300

Fixes

Fix logging issues in the v1.2.5+fix2.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.5+fix1
Feb 5, 2021 at 00:19 +0300

Giterminism refinements: full git-submodules support, better custom project dir support

[giterminism] Improve feedback if a related submodule is not clean or has changes

  • Ignore user work tree submodule directory if a submodule “.git” directory not found

  • Return a detailed error if a work tree submodule directory is not clean:

     the submodule "<submodule path>" is not clean and must be committed. Do not forget to push the current commit to the submodule remote If this commit exists only locally  
  
 Details:  
     commit:                 "0000000000000000000000000000000000000000"  
     currentWorktreeCommit:  "d9243a9a45b10e6b7d985322b8108897626a25a6"  
     expectedWorktreeCommit: "d9243a9a45b10e6b7d985322b8108897626a25a6"  
  
 You might also be interested in developer mode (activated with --dev option) that allows you to work with staged changes without doing redundant commits. Just use "git add <file>..." to include the changes that should be used.

  • Return a detailed error if a work tree submodule directory has changes:

     the submodule "<submodule path>" has modified files and these changes must be committed (do not forget to push new changes to the submodule remote) or discarded:  
  
     - file1  
     - file2

[giterminism] Support for configuration files outside the project directory

Internals:

  • [tests] Giterminism Suite: test custom project directory
  • [giterminism] Refactor symlink check code

Docs

[doc] Add Rails guide

Internals

[tests] Fix daily tests, not compiling and failing tests, refactor tests precompile

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.5+fix2
Feb 4, 2021 at 21:54 +0300

Support setting initial number of replicas when HPA is active for Deployment

Set "werf.io/replicas-on-creation": NUM annotation, do not set spec.replicas field in templates explicitly.

Integration test and docs included.

Configuration go-templates changes

[config] The required function to declare a variable as required

The required function gives developers the ability to declare a value entry as required for config rendering. If the value is empty, the config will not render and will return an error message supplied by the developer.

{{ required "A valid <anything> value required!" <anything> }}

[config] the env function requires the set environment variable

  • The used environment variable can be empty but must be set (ENV_NAME=””).
  • Otherwise, an error executing "werfConfig" at <env "test">: error calling env: the environment variable "<ENV_NAME>" must be set will be returned

Fixes and other

[logging] logboek v0.5.0

  • Migrate to gookit/color
  • Support for colors in WIN cmd.exe
    [win] Fix swith-work-tree occurs on every run due to backslash-slash issues

Internals

[tests] Cleanup old three_way_merge_patches_creator_* fixtures
[tests] Docs Suite: fix and add to default set

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.5+fix1
Feb 3, 2021 at 17:04 +0300

Giterminism refinements: full git-submodules support, better custom project dir support

[giterminism] Improve feedback if a related submodule is not clean or has changes

  • Ignore user work tree submodule directory if a submodule “.git” directory not found

  • Return a detailed error if a work tree submodule directory is not clean:

     the submodule "<submodule path>" is not clean and must be committed. Do not forget to push the current commit to the submodule remote If this commit exists only locally  
  
 Details:  
     commit:                 "0000000000000000000000000000000000000000"  
     currentWorktreeCommit:  "d9243a9a45b10e6b7d985322b8108897626a25a6"  
     expectedWorktreeCommit: "d9243a9a45b10e6b7d985322b8108897626a25a6"  
  
 You might also be interested in developer mode (activated with --dev option) that allows you to work with staged changes without doing redundant commits. Just use "git add <file>..." to include the changes that should be used.

  • Return a detailed error if a work tree submodule directory has changes:

     the submodule "<submodule path>" has modified files and these changes must be committed (do not forget to push new changes to the submodule remote) or discarded:  
  
     - file1  
     - file2

[giterminism] Support for configuration files outside the project directory

Internals:

  • [tests] Giterminism Suite: test custom project directory
  • [giterminism] Refactor symlink check code

Docs

[doc] Add Rails guide

Internals

[tests] Fix daily tests, not compiling and failing tests, refactor tests precompile

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.5
Feb 2, 2021 at 15:18 +0300

Giterminism refinements: full support for symlinks

[giterminism] Improve feedback messages and manager logic.

- Read the configuration file from fs if not resolved path accepted by giterminism config:  
  - the file must exist in the project git work tree directory;  
  - the path must be fully accepted by giterminism config (each resolved symlink target must be accepted).  
  
- Read the configuration file from commit:  
  - the path must not have any uncommitted changes locally (each symlink target).  
  - the file must exist in the current commit;  
  
Improve resolve symlink failed error messages:  
  - fs symlink:  
    - `unable to read <config type>: accepted symlink "<symlink path>" check failed: too many levels of symbolic links`  
    - `unable to read <config type>: accepted symlink "<symlink path>" check failed: the link target "<target path>" should be also accepted by giterminism config`  
  - commit symlink:  
        - `unable to read <config type>: symlink "<symlink path>" check failed: commit tree entry "<target path>" not found in the repository`  
        - `unable to read <config type>: symlink "<symlink path>" check failed: the file "<target path>" must be committed`

[giterminism] Check uncommitted/untracked files by git status
[giterminism] Debug with $WERF_DEBUG_GITERMINISM_MANAGER
[giterminism] Full support for symlinks

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.4+fix18
Feb 2, 2021 at 12:08 +0300

Docs

  • Update guides template and overview page.
  • Correct a grammar mistake.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.4+fix17
Feb 1, 2021 at 22:53 +0300

Fixes

[giterminism] Fix env allowance check

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.4+fix15
Jan 29, 2021 at 22:04 +0300

Docs

Preparations for guides integration:

  • https://werf.io/documentation/guides.html
  • https://ru.werf.io/documentation/guides.html

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.4+fix13
Jan 28, 2021 at 16:56 +0300

Fixes

[follow] Fix follow mode does not reinitialize giterminism manager

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.4+fix12
Jan 27, 2021 at 21:19 +0300

Giterminism

[giterminism] Refactoring: simplify error messages and the corresponding code

the '' not found in the project git repository => unable to read : the file "" not found in the project git repository

the uncommitted configuration found in the project directory: the '' must be committed => unable to read : the file "" must be committed

[giterminism] Fix doublestar.Match matches system-dependent path

Custom project-dir related fixes

Fix dockerfile-not-found error when running werf not from the root of the git work tree

\# docs/werf.yaml  
configVersion: 1  
project: docs  
---  
image: docs  
dockerfile: ./Dockerfile

When running werf from docs folder werf’s dockerfile builder will use docs dir — project dir — as build dockerfile build context root for the
ont
ext tar archive, not git work tree root.

[project-dir] Fix helm-chart-dir related errors when running werf with custom –dir.
[project-dir] Fix .git lookup should use –dir or process cwd.

Fixes and other

[doc] Fix the “Documentation” link in the site header. Fix jekyll custom filter.

Internals

[tests] Giterminism Suite: actualize tests
[giterminism] Remove unused giterminism inspector

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.4+fix11
Jan 26, 2021 at 21:45 +0300

Fixes

[deploy] werf_image and nameless image deprecation fix

Pass nameless image as .Values.werf.nameless_image instead of .Values.werf.image.

.Values.werf.image is always map[string]string and will only contain named images names.

As nameless image is being deprecated in the v1.2 there is no “normal” way to get nameless image from values, that’s why we use “special” value .Values.werf.nameless_image for now. In the v1.3 nameless images will be completely removed.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.4+fix10
Jan 26, 2021 at 18:35 +0300

Giterminism

werf-giterminism.yaml giterminsimConfigVersion could be number 1 or string “1”.

Helm update

Update helm to v3.5.0.

Guides has been translated to English

https://werf.io/guides/

Fixes

Fix WERF_SET_* arguments are not active when –set has been specified issue. Add ability to specify WERF_SET_* order of processing by sorting environment variables alphanumerically by the name.

https://github.com/werf/werf/issues/3128
https://github.com/werf/werf/issues/3137

Complete list of refactored list arguments:

  • –set + WERF_SET_*;
  • –set-string + WERF_SET_STRING_*;
  • –set-file + WERF_SET_FILE_*;
  • –add-label + WERF_ADD_LABEL_*;
  • –add-annotation + WERF_ADD_ANNOTATION_*;
  • –ssh-key + WERF_SSH_KEY_*;
  • –secondary-repo + WERF_SECONDARY_REPO_*;

Process params as follows:

  1. Sort WERF__* environment variables alphanumerically.
  2. Merge all params passed by environment variables with CLI-params (CLI-params have more priority).

DEPRECATION WARNINGS

  • werf_image will be removed in the v1.3;
  • –loose-giterminism will be removed in the v1.2.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.4+fix9
Jan 25, 2021 at 20:51 +0300

Giterminism

This release contains complete support for werf-giterminism.yaml.

  • Read the giterminism config from git.
  • Remove –non-strict-giterminism-inspection option.
  • Lookup for the .git directory in the current working dir or parent directories, or use –git-work-tree option to specify work tree manually (or WERF_GIT_WORK_TREE env var).
  • Inspect uncommitted build context files
    • implement multi path matcher
    • inspect uncommitted build context files with giterminism manager:
      • dockerfile context
      • stapel git mappings
    • status: fix untracked files not detected
    • cache git status result in git repo instance

Bundles

Add –set-docker-config-json-value option. Set .Values.dockerconfigjson value to be used in the registry Secret to pull images from the repo (https://kubernetes.io/docs/tasks/configure-pod-
container/pull-image-private-registry/#registry-secret-existing-credentials).

Other

  • [deploy] Deprecate werf_image template in favor of .Values.werf.image.NAME.
  • [dismiss] Do not lock release on dismiss when –with-namespace option has been specified for now.

Internals

[tests][ci] Disable container_registry_per_implementation matrix for implementations
Enable all implementations at the same time for each test

[tests] Fix bundles test: use –set-docker-config-json-value for registry authentication

[tests] Fix git-repo-not-found related errors for integration suites

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.4+fix8
Jan 18, 2021 at 23:07 +0300

More werf-giterminism.yaml options

  • Refactoring and fixes:
    • Update common error message
    • Update not found the werf config error message
    • Generalize code: readConfigurationFile, checkConfigurationFileExistence, isConfigurationFileExist
    • Change configurationFilesGlob method args
    • Fix error handling
    • Fix and refactor optional werf.yaml handling
  • Support for the config dockerfile allowUncommitted / allowUncommittedDockerignore.
  • Support for the helm chart files.
  • Do not wrap globes in / (/*//).

Bundles

[bundle] Add support for automatic dependencies building on bundle-apply

Internals

[tests] Giterminism Suite: config dockerfile / dockerignore tests
[tests] Giterminism Suite: helm chart files tests

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.4+fix7
Jan 17, 2021 at 16:01 +0300

Docs fixes

  • Fix links to install binary package on install page according to selected channel
  • Fix docs tests suite.
  • Fix links in topnav.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.4+fix5
Jan 12, 2021 at 20:44 +0300

New v1.2 deprecations

[config] Deprecate support for the nameless image
[config] Deprecate the fromArtifact directive

Fixes

[config] Fix werf config templates reading (.werf/*/.tmpl)

All files in the werf config templates directory (.werf by default) were treated as templates.
The template file must have .tmpl extension.

[cleanup] Cast a user regexp value to full match regexp
[giterminism] Cast a user regexp value to full match regexp

Small features

Added .Values.global.werf.version service value with werf cli util version.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.4+fix4
Jan 11, 2021 at 14:37 +0300

Fixes

Fix remote git for stapel builder error: error writing … meta.json: no such file or directory

Rework ~/.werf/local_cache/git_* caches files structure.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.4+fix3
Jan 11, 2021 at 12:57 +0300

Giterminism improvements

  • Added minimal reference of werf-giterminism.yaml configuration file at https://werf.io/v1.2-alpha/documentation/advanced/configuration/giterminism.html.
  • Added deprecation of --loose-giterminism option usage.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.4+fix2
Dec 28, 2020 at 22:23 +0300

Giterminism config extended

Giterminism config reside in werf-giterminism.yaml.

  • Allow fromLatest and branch:

     giterminismConfigVersion: "1"  
 config:  
   stapel:  
     allowFromLatest: true  
     git:  
       allowBranch: true

  • Allow uncommitted config templates:

     giterminismConfigVersion: "1"  
 config:  
   allowUncommittedTemplates:  
     - /*/**/  
     - .werf/template.tmpl

Other:

  • Do not work without project git repository.
  • Custom config path (–config) must be in project directory.

Fixes

[cleanup] Fix goroutine stack exceeds limit

One checksum can be associated with many stages, so it is necessary to exclude the stage itself before processing linked imports

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.4+fix1
Dec 24, 2020 at 20:04 +0300

Fixes

Fix deadline-exceeded when hook job took more than 5 min:

  • Fix default helm 5 min timeout => infinite.
  • Fix any timeout other than default results in ‘context deadline’ error.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.4
Dec 24, 2020 at 19:14 +0300

Introduce werf-giterminism.yaml config

Implement fine-grained giterminism config (part 1), werf-giterminism.yaml:

giterminismConfigVersion: 1  
config:  
  stapel:  
    mount:  
      allowBuildDir:  
      allowFromPaths:  
        - PATH1  
        - PATH2  
  goTemplateRendering:  
    allowEnvVariables:  
      - VARIABLE_X  
      - VARIABLE_Y  
      - /CI_*/  
  dockerfile:  
    allowContextAddFile:  
      - aaa  
      - bbb  
    allowUncommitted:  
      - **/*  
      - myapp/Dockerfile  
    allowUncommittedDockerignoreFiles:  
      - **/*  
      - myapp/.dockerignore

WERF_LOOSE_GITERMINISM=1 still working but will be removed soon.

Fixes

Fix werf-helm-template and werf-helm-lint commands try to load kube config; fix werf-render command excess options.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.3+fix8
Dec 24, 2020 at 10:47 +0300

Fixes

  • Fix Chart.lock file not unpacked when applying bundle.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.3+fix7
Dec 23, 2020 at 00:31 +0300

Giterminism fixes

Extended support for git-submodules for the giterminism mode, added ability to have werf.yaml (or any other configuration files) which is symlink to another file, which reside in a submodule.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.3+fix6
Dec 21, 2020 at 20:53 +0300

Fixes

Fix “unable to create registry client” error when DOCKER_CONFIG variable is set

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.3+fix5
Dec 21, 2020 at 20:25 +0300

Fixes

Fix panic when running ‘werf helm dependency update’ in the project with secret files

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.3+fix4
Dec 21, 2020 at 19:05 +0300

New bundle commands and fix bundle registry authentication

  • werf bundle export — creates resulting bundle chart directory without publishing this chart into the docker registr
    .
  • werf bundle download — downloads previously published chart into the directory without applying it into the kubernete
    .

Use default ~/.docker/config.json authentication data when publishing and applying bundles.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.3+fix3
Dec 18, 2020 at 22:42 +0300

Introduce initial werf bundle apply command

Publish (no kubernetes connection needed):

cd werf-project  
werf bundle publish --repo REPO --tag TAG

Apply (Kubernetes connection required, no werf project needed):

werf bundle apply --repo REPO --tag TAG

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.3+fix2
Dec 18, 2020 at 12:38 +0300

Fix error: unable to resolve docker endpoint: open …/ca.pem: no such file or directory

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.3+fix1
Dec 17, 2020 at 20:26 +0300

Support docker client compatible tls docker server settings

Support following environment variables:

  • DOCKER_TLS
  • DOCKER_TLS_VERIFY
  • DOCKER_CERT_PATH

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.3
Dec 17, 2020 at 18:29 +0300

Introduce ‘werf bundle publish’ command

werf bundle publish --repo REPO --tag TAG

Will publish current chart of the werf project with together with built images and all needed service-values as an image into the provided REPO by the provided TAG. This command does not need a connection to the Kubernetes cluster.

Published bundle can be later installed using werf bundle apply ... command, which is not implemented yet.

Dev mode improvements

[true git] Fix SyncDevBranchWithStagedFiles handles submodules changes improperly

SyncDevBranchWithStagedFiles function creates commit but does not prepare worktree for it. Staged files may include submodule changes that require special handling

[dockerfile] Remove excess git ignored files check

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.2+fix5
Dec 16, 2020 at 10:34 +0300

Fixes and tests

[dockerfile] Fix contextAddFile checksum calculation

  • Fix empty checksum
  • Fix os-sensitive contextAddFile path in the checksum

[logging] Show nameless image correctly

[tests] Build/Stapel/Git: developer mode test
[tests] Dockerfile Suite: fix project name is not set
[tests] Dockerfile Suite: upd contextAddFile test
[ci] Daily Tests: fix temporary docker config directory

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.2+fix4
Dec 15, 2020 at 17:03 +0300

Fixes

  • [dockerfile] Temporarily force BuildKit deactivation due to the bug in the docker client when used as a go library
  • Fix ‘werf render’ uses kubernetes based lock due to typo.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.2+fix3
Dec 15, 2020 at 13:02 +0300

Fixes

  • [dev] Fix not initialized true git package.
  • [stapel, dev] Fix adding dev label to the building image.
  • [giterminism] Check untracked .helm/Chart.yaml exists in the chart.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.2+fix2
Dec 14, 2020 at 18:40 +0300

Fixes

  • [web] Update metainfo in page template.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.2+fix1
Dec 14, 2020 at 12:03 +0300

Rework dev mode for stapel and dockerfile

  • Werf creates temporary commits in the dev-mode.
  • Files from the git index used in the dev-mode.
  • Support dev-mode in conjunction with the follow-mode.
  • Commit staged files to dev branch werf-dev-<commit>.
  • Add werf-dev label to git stage images.

Change default werf images storage for GitLab CI/CD and GitHub Actions

  • Remove /werf repo suffix for GitLab CI/CD;
  • Remove -werf repo suffix for GitHub Actions.

NOTE. This is breaking change, incompatible with the previous werf versions.

Other

  • Fix “list event error: context cancelled” log messages.
  • [web] Update metainfo in page template.
  • More fixes for werf-related ci tests.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.1+fix6
Dec 7, 2020 at 18:33 +0300

Support subcharts in the giterminism mode

Support subcharts loading from the local filesystem in the giterminism mode:

  • Read committed dependencies lock file (requirements.lock or Chart.lock).
  • Scan local filesystem for the charts archives specified in the lock-file and use these charts in the giterminism mode.

No auto werf helm dependency build yet.

Fixes

[deploy] Fix max releases history: use default limit = 10.
[deploy] Fix dismiss –with-namespace not waiting until namespace terminated.

Other changes

[build] Remove stages_and_images read-only lock during build process

  • stages_and_images read only lock is preventive measure against running cleanup and build commands at the same time;
  • this lock creates unnecessary load on the synchronization server, because this lock working all the time the build process is active for each build process;
  • it is mostly safe to just omit this lock completely;
  • also removed unused “image” lock from the lock manager (legacy from v1.1).
  • also renamed kubernetes-related stage and stage-cache locks to include project name (just for more correctness, incompatible with v1.1 change).

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.1+fix5
Dec 3, 2020 at 23:02 +0300

Determinism to giterminism

Renamed determinism to giterminism: git + determinism or “determinated by the git”.

--disable-determinism param renamed to --loose-giterminism (WERF_DISABLE_DETERMINSM to WERF_LOOSE_GITERMINISM).

Helm related changes

  • Update helm to v3.4.1.
  • Fix auto generation of Chart.yaml:
    • Take Chart.yaml from the repository if exists.
    • Override metadata.name field with werf project name from the werf.yaml.
    • Set metadata.version = 1.0.0 if not set.
  • Make Chart.yaml optional for all werf helm * commands.
  • Fix enable –with-namespace and –with-hooks werf-dismiss options not working.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.1+fix4
Nov 30, 2020 at 22:22 +0300

Docs

  • Fix quickstart minikube setup guides for MacOS and Windows.
    • Make a separate instructions list for Windows, MacOS and Linux OS in the quickstart guide.
    • Require for werf dependencies installation explicitly.

Werf CI and tests

[ci] Disable ECR and GitHub Packages cleanup tests more visibly.
[ci] Enable windows self hosted runners.
[ci] K8s versions: 1.16, 1.17, 1.18, 1.19.
[tests] Config Suite: fix line breaks.
[tests] Helm Suite

Fixes

[render, windows] Fix helm does not recognize chart templates.
[windows] Fix unable to read file from local git repo.
[render] Fix comment with template source path.
Fix incorrect usage of println/printf-like functions.
Clean kubedog log from klog warnings: silence klog/v2 and klog.
Fix checking existence of secret files in chart.
[logging, debug] Disable debug docker messages.

Other

[stapel] Remove the ability to cache each instruction separately with asLayers directive.
Remove unused code.
Remove samples.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.1+fix3
Nov 27, 2020 at 00:03 +0300

Docs

  • [docs] Main page: 2100 stars by default.
  • [determinism] Added basic determinism page to the advanced documentation: https://werf.io/v1.2-alpha/documentation/advanced/configuration/determinism.html (+ ru version).

Fixes

  • [windows] Fix unable to rename archive (file already use by another process).
  • [helm] Fix disable-determinism flag is not added to commands which lead to panics.
  • Fix werf helm 3 does not respect WERF_KUBE_* settings.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.1+fix2
Nov 25, 2020 at 21:43 +0300

Determinism

Determinism is enabled by default since v1.2.1 version.

  • All configuration and application files will be taken from the current git commit in this mode.
  • Usage and existance of uncommitted files in the git work tree is restricted.

What’s new in this version:

  • Pass Dockerfile builder context from the current git commit arhive, not from the current git work tree with uncommitted files.
  • Use contextAddFile directive for dockerfile builder to override and add specified uncommitted or untracked files to the context from the current git work tree:
image: X  
dockerfile: Dockerfile  
context: vote  
contextAddFile:  
 - app.py  
 - some-generated-file.tar.gz
  • contextAddFile will affect checksum calculation of the dockerfile stage during building phase.
  • Load all helm-related configuration (.helm/templates, –values, –secret-values, –set-file from the local git repo commit).

Other

  • Refactor git patches and archives generation.
    • store tmp patches and archives in the ~/.werf/local_cache/git_data/1/tmp/ instead of /tmp;
    • store patches cache in the ~/.werf/local_cache/git_data/1/patches/;
    • store archives cache in the ~/.werf/local_cache/git_data/1/archives/.
  • [docs] Refactor directive summary block for stapel.
  • [ci] Documentation Validation Workflow.

Fixes

  • Fix get-namespace, get-release and rotate-secret-key commands panics.
  • [report] Fix envfile report format
    • name:
      • use template WERF_<FORMATTED_WERF_IMAGE_NAME>_DOCKER_IMAGE_NAME instead of WERF_IMAGE_<FORMATTED_WERF_IMAGE_NAME>_NAME
      • replace charset -/ in werf image name with _
    • value: set docker image name instead of werf image name
  • Update kubedog: fix Job hanging case (https://github.com/werf/kubedog/pull/184), fix color disabled in CI/CD systems.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.1+fix1
Nov 16, 2020 at 22:26 +0300

Fixes

  • Fix –docker-options option cannot contain multiple spaces
  • Fix getting of parentID from image manifest.
  • ..

Cleanup

  • Add option to keep images that were built within period. The cleaning process skips stages (and relatives) that were built within specified period. Option –keep-stages-built-within-last-n-hours (2 hours by default).
  • Git-history based cleanup improvement. The keep policy imagesPerReference.last counts several stages that were built on the same commit as one.
    Thus, the policy may cover more tags than expected, and this behavior is correct.
  • Update log levels and messages.

Determinism mode

  • Enabled by default, to disable use option –disable-determinism or WERF_DISABLE_DETERMINISM env var;
  • mount, git.branch and fromLatest directives are available only when determinism is disabled;
  • .Files.Get and .Files.Glob read data only from the local git repo by default.

  • Define –helm-chart-dir in the werf.yaml:

     configVersion: 1  
 deploy:  
   helmChartDir: .helm

    There is no more --helm-char-dir option.

  • Add –env support to werf.yaml config render. Use {{ .Env }} to get an environment value which passed to the werf by –env option or WERF_ENV env var.

  • Move –allow-git-shallow-clone, –git-unshallow and –git-history-synchronization options into werf.yaml. Added new gitWorktree meta section:

     configVersion: 1  
 project: X  
 gitWorktree:  
   forceShallowClone: true|false (default false)  
   allowUnshallow: true|false (default true)  
   allowFetchOriginBranchesAndTags: true|false (default true)

    Disabled ci-env generation of old options. Always unshallow git clone by default.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.1
Nov 12, 2020 at 13:29 +0300

Basic docker compose support

Added compose config up down commands.

Basic determinism mode (disabled by default for now): werf.yaml from git, helm templates from git, disable env go-templates functions

  • Refactor code to use local git repo instead of filesystem to read some configs.
  • Determinism mode is disabled by default for now, because this is experimental feature which is in progress now.

Refs https://github.com/werf/werf/issues/2874

Other

  • [docs] Added seo meta tags.
  • [build] Add envfile report format (–report-format=envfile).

Fixes

  • Disable manifests cache ~/.werf/local_cache/manifests for local stages storage. Manifests cache for local stages storage causes problems when built image has been deleted accidentally or unintentionally by docker rmi or docker compose.
  • Automatically invalidate corrupted manifests cache json records.
  • [cleanup] Fix invalid import metadata found.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.0+fix7
Nov 11, 2020 at 14:42 +0300

Docs

[docs] Reform build-proces and stages-and-storage articles

  • Move articles one level up.
  • Rename “Images storage” article to “Stages and storage”.
  • Reorganize and actualize articles.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.2.0+fix6
Nov 10, 2020 at 20:10 +0300

Docs and fixes

  • [docs] Remove outdated warning.
  • [docs] Add last publications.
  • [docs] Fix title generation.
  • [docs] Fix breadcrumbs.
  • [docs] Enable beta channel selected by default.
  • [docs] Eliminate werf-deploy and werf-build-and-publish commands from docs.
  • [docs] Advanced/Helm/Basics: replace werf deploy command with converge.
  • [cleanup] Delete invalid import metadata.

Installation

Linux amd64

Darwin amd64

Windows amd64

Nov 9, 2020 at 13:35 +0300
Nov 6, 2020 at 15:14 +0300
Nov 6, 2020 at 14:07 +0300
Nov 5, 2020 at 21:14 +0300
Nov 5, 2020 at 15:47 +0300
Nov 2, 2020 at 22:54 +0300
Oct 30, 2020 at 18:06 +0300
Oct 29, 2020 at 20:27 +0300
Oct 29, 2020 at 18:47 +0300
Oct 26, 2020 at 21:31 +0300
Oct 23, 2020 at 22:17 +0300
Oct 22, 2020 at 23:59 +0300
Oct 22, 2020 at 12:32 +0300
Oct 20, 2020 at 12:45 +0300
Oct 19, 2020 at 20:11 +0300
Oct 19, 2020 at 16:35 +0300
Oct 16, 2020 at 19:32 +0300
Oct 16, 2020 at 17:29 +0300
Oct 15, 2020 at 21:20 +0300
Oct 15, 2020 at 16:09 +0300
Oct 9, 2020 at 13:05 +0300
Oct 2, 2020 at 16:01 +0300
Sep 28, 2020 at 14:22 +0300
Channel
Rock-Solid Stable Early-Access Beta Alpha

For usage in critical environments with tight SLA

This is the most stable channel and recommended for usage in critical environments with tight SLA. We guarantee backward compatibility between Rock-Solid releases within minor branch (1.1.x). We guarantee that Stable release should become a Rock-Solid release not earlier than 2 weeks of broad testing.

v1.1.23+fix41
Jun 10, 2021 at 15:24 +0300

Internals

FIX: enable release publishing into the bintray mirror to support old multiwerf versions.

Installation

Linux amd64

Darwin amd64

Windows amd64

Jun 10, 2021 at 12:03 +0300
v1.1.22+fix37
Dec 8, 2020 at 22:55 +0300

Fixes

Update kubedog: fix Job hanging case (https://github.com/werf/kubedog/pull/184), fix color disabled in CI/CD systems.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.21+fix32
Nov 26, 2020 at 01:06 +0300

Fix documentation broken links

Also:

  • [ci] Documentation Validation Workflow.
  • [docs] Refactor directive summary block for stapel.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.21+fix31
Nov 17, 2020 at 13:40 +0300

Backport fix for cli-docs broken sidebar navigation

Installation

Linux amd64

Darwin amd64

Windows amd64

Sep 25, 2020 at 14:49 +0300
Sep 1, 2020 at 19:55 +0300
Aug 11, 2020 at 12:36 +0300
Jul 3, 2020 at 18:27 +0300
May 14, 2020 at 23:41 +0300
May 14, 2020 at 20:10 +0300
Apr 30, 2020 at 14:01 +0300
Apr 23, 2020 at 13:55 +0300

Recommended channel

Stable channel releases are mostly safe to use and we encourage to use this channel everywhere. We guarantee backward compatibility between Stable releases within minor branch (1.1.x). We guarantee that Early-Access release should become Stable not earlier than 1 week after internal tests

v1.1.23+fix47
Jun 25, 2021 at 10:58 +0300

Fixes

[v1.1][helm] Fix strict values yaml parsing introduced into werf

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix41
May 21, 2021 at 18:30 +0300

Internals

FIX: enable release publishing into the bintray mirror to support old multiwerf versions.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix36
Apr 6, 2021 at 19:49 +0300

Fixes

[v1.1] Skip blob-unknown images in cleanup properly

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix6
Feb 16, 2021 at 13:26 +0300

Fixes

Fix “Error: parsing file … failed: yaml: unmarshal errors … cannot unmarshal !!map into string”

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix17
Feb 16, 2021 at 10:36 +0300

[1.1] Helm 3 release existence check

werf-converge and werf-deploy commands will refuse to work when helm 3 release with the same name as target helm 2 release exists in the current namespace.

This check protects existing helm 3 release when your project has already been migrated from helm 2 to helm 3, but for some reason werf v1.1 tries to redeploy this release.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix6
Jan 11, 2021 at 12:57 +0300

Fixes

Fix “Error: parsing file … failed: yaml: unmarshal errors … cannot unmarshal !!map into string”

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix5
Dec 7, 2020 at 18:31 +0300

Fixes

Update kubedog: fix Job hanging case (https://github.com/werf/kubedog/pull/184), fix color disabled in CI/CD systems.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.22+fix36
Nov 26, 2020 at 01:06 +0300

Fix documentation broken links

Also:

  • [ci] Documentation Validation Workflow.
  • [docs] Refactor directive summary block for stapel.

Installation

Linux amd64

Darwin amd64

Windows amd64

Nov 17, 2020 at 13:18 +0300
Nov 2, 2020 at 22:54 +0300
Oct 9, 2020 at 11:29 +0300
Oct 7, 2020 at 13:20 +0300
Sep 25, 2020 at 14:49 +0300
Sep 17, 2020 at 19:01 +0300
Sep 4, 2020 at 09:55 +0300
Sep 1, 2020 at 20:05 +0300
Aug 28, 2020 at 12:53 +0300
Aug 24, 2020 at 15:25 +0300
Aug 20, 2020 at 21:49 +0300
Aug 11, 2020 at 13:56 +0300
Aug 11, 2020 at 13:21 +0300
Aug 11, 2020 at 11:38 +0300
Aug 7, 2020 at 16:24 +0300
Aug 5, 2020 at 18:36 +0300
Aug 5, 2020 at 17:15 +0300
Jul 22, 2020 at 10:18 +0300
Jul 9, 2020 at 16:55 +0300
Jun 16, 2020 at 15:00 +0300
Jun 11, 2020 at 17:35 +0300
May 21, 2020 at 10:33 +0300
May 15, 2020 at 16:38 +0300
May 14, 2020 at 23:53 +0300
May 14, 2020 at 23:50 +0300
May 14, 2020 at 20:10 +0300
Apr 29, 2020 at 22:35 +0300
Apr 20, 2020 at 21:01 +0300
Apr 20, 2020 at 11:18 +0300
Apr 17, 2020 at 14:45 +0300
Apr 17, 2020 at 14:22 +0300
Apr 15, 2020 at 16:13 +0300
Apr 10, 2020 at 15:18 +0300
Apr 10, 2020 at 13:42 +0300

For use in non critical environments or local development

These releases are mostly safe to use and can even be used in non critical environments or for local development. We do not guarantee backward compatibility between Early-Access releases.

v1.1.23+fix47
Jun 22, 2021 at 16:02 +0300

Fixes

[v1.1][helm] Fix strict values yaml parsing introduced into werf

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix45
Jun 10, 2021 at 12:03 +0300

Fixes

Revert kubedog debug panic:

[debug] Catch deployment tracker exited without resource status resolution bug

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix41
Apr 13, 2021 at 20:16 +0300

Internals

FIX: enable release publishing into the bintray mirror to support old multiwerf versions.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix37
Apr 9, 2021 at 15:00 +0300

Fixes

[logging] Build: add waiting for background tasks log message.

[cleanup] Ignore blob-unknown errors properly.
During cleanup operation do not raise should-reset-stages-storage-cache error when get stage manifest operation have failed with
blob-unknown error.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix36
Apr 6, 2021 at 00:26 +0300

Fixes

[v1.1] Skip blob-unknown images in cleanup properly

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix34
Apr 2, 2021 at 21:07 +0300

Fixes

Automatically invalidate corrupted manifests cache json records.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix33
Mar 30, 2021 at 23:10 +0300

Fixes

[buidler] Fix panic docker_registry.IsNameUnknownError

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix30
Mar 30, 2021 at 20:13 +0300

[v1.1] Fix saving stages-ids into the stages-storage-cache

When some stage has appeared in the repository tags list, but stage image is invalid (due to MANIFEST_UNKNOWN or BLOB_UNKNOWN container registry errors), werf ignores such stage. But this stage-id of such broken stage has been saved into the stages-storage-cache anyway, which is wrong.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix32
Mar 30, 2021 at 19:34 +0300

Fixes

[builder] Proper rejection of blob-unknown stages

Do not reject stage when manifest-unknown or name-unknown errors detected. Only reject images with blob-unknown errors.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix30
Mar 25, 2021 at 18:27 +0300

[v1.1] Fix saving stages-ids into the stages-storage-cache

When some stage has appeared in the repository tags list, but stage image is invalid (due to MANIFEST_UNKNOWN or BLOB_UNKNOWN container registry errors), werf ignores such stage. But this stage-id of such broken stage has been saved into the stages-storage-cache anyway, which is wrong.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix29
Mar 25, 2021 at 13:02 +0300

[v1.1][stapel] Support for rejected stages in the stages storage

Reject stage when docker-pull have failed with the “blob unknown” error.

Add special record into the stages-storage for such rejected stages.

Other

[v1.1] Add ability to set werf-stapel image name with WERF_STAPEL_IMAGE_NAME environment variable.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix28
Mar 24, 2021 at 15:45 +0300

[stapel] Fix: fetch artifact/image stage before running imports rsync server

Fetch operation will check that image exists correctly and will reset stages building conveyor to rebuild this stage if needed.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix26
Mar 23, 2021 at 21:42 +0300

Fixes

[v1.1][GC] Fix StagesStorage ShouldFetch method: perform fresh docker-inspect, do not use cached inspection result from the previous inspect.

This fix particularly needed for the v1.2 host cleanup procedure which can remove freshly built and saved into the stages storage images. In such case should-fetch and stages-storage-manager fetch method will lock an image and perform standard fetch procedure.

[v1.1] Added stage image locking into stages-storage-manager to prevent v1.2 host cleanup procedure from deleting stages which are in use.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix25
Mar 23, 2021 at 14:22 +0300

Fixes

Completely remove redudant stages_and_images read-only shared lock usage to reduce the number of requests to lock-server.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix21
Mar 5, 2021 at 11:53 +0300

Debug release

Kubedog update: disable events informer with KUBEDOG_DISABLE_EVENTS=1

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix20
Feb 24, 2021 at 09:52 +0300

[v1.1] Helm 3 release existence checker

Add support for custom kube-context and kube-config-base64.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix16
Feb 16, 2021 at 13:26 +0300

[config] Add fromYaml function

  • fromYAML(str string) (map[string]interface{}, error)
  • return error if unmarshalling failed

werf.yaml

...  
{{- $values := .Files.Get "werf_values.yaml" | fromYaml -}} // or fromYaml (.Files.Get "werf_values.yaml")  
from: {{- $values.image.from }}

werf_values.yaml

image:  
    from: alpine

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix17
Feb 16, 2021 at 10:02 +0300

[1.1] Helm 3 release existence check

werf-converge and werf-deploy commands will refuse to work when helm 3 release with the same name as target helm 2 release exists in the current namespace.

This check protects existing helm 3 release when your project has already been migrated from helm 2 to helm 3, but for some reason werf v1.1 tries to redeploy this release.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix16
Feb 15, 2021 at 13:30 +0300

[config] Add fromYaml function

  • fromYAML(str string) (map[string]interface{}, error)
  • return error if unmarshalling failed

werf.yaml

...  
{{- $values := .Files.Get "werf_values.yaml" | fromYaml -}} // or fromYaml (.Files.Get "werf_values.yaml")  
from: {{- $values.image.from }}

werf_values.yaml

image:  
    from: alpine

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix14
Feb 9, 2021 at 21:39 +0300

Fixes

Do not print warnings for MANIFEST_UNKNOWN and BLOB_UNKNOWN registry errors until werf-cleanup does not delete these images automatically.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix13
Feb 8, 2021 at 13:40 +0300

Fixes

[BLOB_UNKNOWN] Completely ignore images with BLOB_UNKNOWN errors from the standard docker registry

  • Consider image is not exists in that case.
  • Log warnings on BLOB_UNKNOWN and MANIFEST_UNKNOWN for default docker registry impl.
  • Removed experimental WERF_EXPERIMENTAL_IGNORE_IMAGE_METADATA_BY_COMMIT_BLOB_UNKNOWN env variable.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix10
Feb 2, 2021 at 14:14 +0300

DEPRECATION WARNING

Add deprecation warning for the fromImageArtifact directive.

Fixes

Fix WERF_SET_* arguments are not active when –set has been specified issue. Add ability to specify WERF_SET_* order of processing by sorting environment variables alphanumerically by the name.

https://github.com/werf/werf/issues/3128
https://github.com/werf/werf/issues/3137

Complete list of refactored list arguments:

  • –set + WERF_SET_*;
  • –set-string + WERF_SET_STRING_*;
  • –set-file + WERF_SET_FILE_*;
  • –add-label + WERF_ADD_LABEL_*;
  • –add-annotation + WERF_ADD_ANNOTATION_*;
  • –ssh-key + WERF_SSH_KEY_*;
  • –secondary-repo + WERF_SECONDARY_REPO_*;

Process params as follows:

  1. Sort WERF__* environment variables alphanumerically.
  2. Merge all params passed by environment variables with CLI-params (CLI-params have more priority).

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix6
Dec 21, 2020 at 12:23 +0300

Fixes

Fix “Error: parsing file … failed: yaml: unmarshal errors … cannot unmarshal !!map into string”

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix5
Dec 4, 2020 at 16:37 +0300

Fixes

Update kubedog: fix Job hanging case (https://github.com/werf/kubedog/pull/184), fix color disabled in CI/CD systems.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix4
Nov 26, 2020 at 01:05 +0300

Fix documentation broken links

Also:

  • [ci] Documentation Validation Workflow.
  • [docs] Refactor directive summary block for stapel.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix3
Nov 17, 2020 at 13:18 +0300

Fix “docker: invalid reference format: repository name must be lowercase”

Fix –docker-options option cannot contain multiple spaces.

Installation

Linux amd64

Darwin amd64

Windows amd64

Nov 11, 2020 at 17:55 +0300
Nov 3, 2020 at 18:39 +0300
Nov 3, 2020 at 11:04 +0300
Oct 27, 2020 at 14:42 +0300
Oct 9, 2020 at 11:29 +0300
Oct 7, 2020 at 13:20 +0300
Oct 2, 2020 at 16:01 +0300
Sep 24, 2020 at 12:23 +0300
Sep 17, 2020 at 19:01 +0300
Sep 17, 2020 at 10:39 +0300
Sep 4, 2020 at 09:55 +0300
Sep 1, 2020 at 20:05 +0300
Aug 28, 2020 at 12:53 +0300
Aug 24, 2020 at 15:25 +0300
Aug 20, 2020 at 21:49 +0300
Aug 11, 2020 at 20:04 +0300
Aug 7, 2020 at 16:21 +0300
Aug 5, 2020 at 18:24 +0300
Aug 5, 2020 at 17:15 +0300
Jul 27, 2020 at 18:55 +0300
Jul 23, 2020 at 15:50 +0300
Jul 22, 2020 at 10:18 +0300
Jul 17, 2020 at 17:37 +0300
Jul 3, 2020 at 18:23 +0300
Jun 26, 2020 at 19:56 +0300
Jun 23, 2020 at 09:46 +0300
Jun 16, 2020 at 15:00 +0300
Jun 11, 2020 at 17:35 +0300
Jun 11, 2020 at 17:28 +0300
Jun 2, 2020 at 16:07 +0300
Jun 2, 2020 at 14:20 +0300
May 21, 2020 at 10:33 +0300
May 18, 2020 at 19:07 +0300
May 17, 2020 at 14:42 +0300
May 14, 2020 at 23:53 +0300
May 14, 2020 at 23:50 +0300
May 14, 2020 at 20:10 +0300
May 12, 2020 at 22:28 +0300
Apr 29, 2020 at 22:35 +0300
Apr 28, 2020 at 12:26 +0300
Apr 23, 2020 at 20:21 +0300
Apr 20, 2020 at 21:01 +0300
Apr 17, 2020 at 19:55 +0300
Apr 17, 2020 at 14:45 +0300
Apr 17, 2020 at 14:08 +0300
Apr 15, 2020 at 16:13 +0300
Apr 10, 2020 at 15:18 +0300
Apr 10, 2020 at 12:56 +0300
Apr 6, 2020 at 19:11 +0300
Mar 23, 2020 at 12:17 +0300

For more broad testing of new features

These releases are for more broad testing of new features to catch regressions. We do not guarantee backward compatibility between Beta releases.

v1.1.23+fix47
Jun 15, 2021 at 11:19 +0300

Fixes

[v1.1][helm] Fix strict values yaml parsing introduced into werf

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix45
Jun 7, 2021 at 16:12 +0300

Fixes

Revert kubedog debug panic:

[debug] Catch deployment tracker exited without resource status resolution bug

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix41
Apr 13, 2021 at 20:16 +0300

Internals

FIX: enable release publishing into the bintray mirror to support old multiwerf versions.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix37
Apr 9, 2021 at 15:00 +0300

Fixes

[logging] Build: add waiting for background tasks log message.

[cleanup] Ignore blob-unknown errors properly.
During cleanup operation do not raise should-reset-stages-storage-cache error when get stage manifest operation have failed with
blob-unknown error.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix36
Apr 6, 2021 at 00:26 +0300

Fixes

[v1.1] Skip blob-unknown images in cleanup properly

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix34
Apr 2, 2021 at 21:07 +0300

Fixes

Automatically invalidate corrupted manifests cache json records.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix33
Mar 30, 2021 at 23:10 +0300

Fixes

[buidler] Fix panic docker_registry.IsNameUnknownError

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix30
Mar 30, 2021 at 20:13 +0300

[v1.1] Fix saving stages-ids into the stages-storage-cache

When some stage has appeared in the repository tags list, but stage image is invalid (due to MANIFEST_UNKNOWN or BLOB_UNKNOWN container registry errors), werf ignores such stage. But this stage-id of such broken stage has been saved into the stages-storage-cache anyway, which is wrong.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix32
Mar 30, 2021 at 19:34 +0300

Fixes

[builder] Proper rejection of blob-unknown stages

Do not reject stage when manifest-unknown or name-unknown errors detected. Only reject images with blob-unknown errors.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix30
Mar 25, 2021 at 18:27 +0300

[v1.1] Fix saving stages-ids into the stages-storage-cache

When some stage has appeared in the repository tags list, but stage image is invalid (due to MANIFEST_UNKNOWN or BLOB_UNKNOWN container registry errors), werf ignores such stage. But this stage-id of such broken stage has been saved into the stages-storage-cache anyway, which is wrong.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix29
Mar 25, 2021 at 13:02 +0300

[v1.1][stapel] Support for rejected stages in the stages storage

Reject stage when docker-pull have failed with the “blob unknown” error.

Add special record into the stages-storage for such rejected stages.

Other

[v1.1] Add ability to set werf-stapel image name with WERF_STAPEL_IMAGE_NAME environment variable.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix28
Mar 24, 2021 at 15:45 +0300

[stapel] Fix: fetch artifact/image stage before running imports rsync server

Fetch operation will check that image exists correctly and will reset stages building conveyor to rebuild this stage if needed.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix26
Mar 23, 2021 at 21:42 +0300

Fixes

[v1.1][GC] Fix StagesStorage ShouldFetch method: perform fresh docker-inspect, do not use cached inspection result from the previous inspect.

This fix particularly needed for the v1.2 host cleanup procedure which can remove freshly built and saved into the stages storage images. In such case should-fetch and stages-storage-manager fetch method will lock an image and perform standard fetch procedure.

[v1.1] Added stage image locking into stages-storage-manager to prevent v1.2 host cleanup procedure from deleting stages which are in use.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix25
Mar 23, 2021 at 14:22 +0300

Fixes

Completely remove redudant stages_and_images read-only shared lock usage to reduce the number of requests to lock-server.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix21
Mar 5, 2021 at 11:53 +0300

Debug release

Kubedog update: disable events informer with KUBEDOG_DISABLE_EVENTS=1

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix20
Feb 18, 2021 at 16:22 +0300

[v1.1] Helm 3 release existence checker

Add support for custom kube-context and kube-config-base64.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix16
Feb 16, 2021 at 13:26 +0300

[config] Add fromYaml function

  • fromYAML(str string) (map[string]interface{}, error)
  • return error if unmarshalling failed

werf.yaml

...  
{{- $values := .Files.Get "werf_values.yaml" | fromYaml -}} // or fromYaml (.Files.Get "werf_values.yaml")  
from: {{- $values.image.from }}

werf_values.yaml

image:  
    from: alpine

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix17
Feb 16, 2021 at 09:43 +0300

[1.1] Helm 3 release existence check

werf-converge and werf-deploy commands will refuse to work when helm 3 release with the same name as target helm 2 release exists in the current namespace.

This check protects existing helm 3 release when your project has already been migrated from helm 2 to helm 3, but for some reason werf v1.1 tries to redeploy this release.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix16
Feb 15, 2021 at 13:30 +0300

[config] Add fromYaml function

  • fromYAML(str string) (map[string]interface{}, error)
  • return error if unmarshalling failed

werf.yaml

...  
{{- $values := .Files.Get "werf_values.yaml" | fromYaml -}} // or fromYaml (.Files.Get "werf_values.yaml")  
from: {{- $values.image.from }}

werf_values.yaml

image:  
    from: alpine

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix14
Feb 9, 2021 at 21:39 +0300

Fixes

Do not print warnings for MANIFEST_UNKNOWN and BLOB_UNKNOWN registry errors until werf-cleanup does not delete these images automatically.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix13
Feb 8, 2021 at 13:40 +0300

Fixes

[BLOB_UNKNOWN] Completely ignore images with BLOB_UNKNOWN errors from the standard docker registry

  • Consider image is not exists in that case.
  • Log warnings on BLOB_UNKNOWN and MANIFEST_UNKNOWN for default docker registry impl.
  • Removed experimental WERF_EXPERIMENTAL_IGNORE_IMAGE_METADATA_BY_COMMIT_BLOB_UNKNOWN env variable.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix10
Jan 27, 2021 at 19:20 +0300

DEPRECATION WARNING

Add deprecation warning for the fromImageArtifact directive.

Fixes

Fix WERF_SET_* arguments are not active when –set has been specified issue. Add ability to specify WERF_SET_* order of processing by sorting environment variables alphanumerically by the name.

https://github.com/werf/werf/issues/3128
https://github.com/werf/werf/issues/3137

Complete list of refactored list arguments:

  • –set + WERF_SET_*;
  • –set-string + WERF_SET_STRING_*;
  • –set-file + WERF_SET_FILE_*;
  • –add-label + WERF_ADD_LABEL_*;
  • –add-annotation + WERF_ADD_ANNOTATION_*;
  • –ssh-key + WERF_SSH_KEY_*;
  • –secondary-repo + WERF_SECONDARY_REPO_*;

Process params as follows:

  1. Sort WERF__* environment variables alphanumerically.
  2. Merge all params passed by environment variables with CLI-params (CLI-params have more priority).

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix8
Jan 12, 2021 at 20:44 +0300

Small features

Added .Values.global.werf.version service value with werf cli util version.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix7
Jan 12, 2021 at 15:44 +0300

Fixes

Fix redundant stapel container initialization for dockerfile image

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix6
Dec 10, 2020 at 10:41 +0300

Fixes

Fix “Error: parsing file … failed: yaml: unmarshal errors … cannot unmarshal !!map into string”

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix5
Nov 26, 2020 at 10:32 +0300

Fixes

Update kubedog: fix Job hanging case (https://github.com/werf/kubedog/pull/184), fix color disabled in CI/CD systems.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix4
Nov 26, 2020 at 01:05 +0300

Fix documentation broken links

Also:

  • [ci] Documentation Validation Workflow.
  • [docs] Refactor directive summary block for stapel.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix3
Nov 13, 2020 at 12:03 +0300

Fix “docker: invalid reference format: repository name must be lowercase”

Fix –docker-options option cannot contain multiple spaces.

Installation

Linux amd64

Darwin amd64

Windows amd64

Nov 11, 2020 at 17:55 +0300
Nov 6, 2020 at 12:36 +0300
Nov 3, 2020 at 18:39 +0300
Nov 3, 2020 at 11:04 +0300
Oct 27, 2020 at 14:42 +0300
Oct 13, 2020 at 11:30 +0300
Oct 9, 2020 at 11:29 +0300
Oct 7, 2020 at 13:20 +0300
Oct 2, 2020 at 16:01 +0300
Sep 24, 2020 at 12:23 +0300
Sep 21, 2020 at 12:37 +0300
Sep 17, 2020 at 10:39 +0300
Sep 10, 2020 at 13:22 +0300
Sep 4, 2020 at 09:55 +0300
Sep 2, 2020 at 20:56 +0300
Sep 2, 2020 at 20:01 +0300
Sep 1, 2020 at 18:43 +0300
Sep 1, 2020 at 15:24 +0300
Aug 31, 2020 at 20:42 +0300
Aug 28, 2020 at 12:53 +0300
Aug 24, 2020 at 16:08 +0300
Aug 24, 2020 at 14:55 +0300
Aug 20, 2020 at 21:49 +0300
Aug 11, 2020 at 20:04 +0300
Aug 11, 2020 at 19:11 +0300
Aug 7, 2020 at 16:21 +0300
Aug 5, 2020 at 17:15 +0300
Jul 27, 2020 at 19:55 +0300
Jul 27, 2020 at 11:08 +0300
Jul 27, 2020 at 10:36 +0300
Jul 23, 2020 at 22:02 +0300
Jul 23, 2020 at 18:45 +0300
Jul 22, 2020 at 10:18 +0300
Jul 20, 2020 at 15:19 +0300
Jul 17, 2020 at 17:33 +0300
Jul 16, 2020 at 22:42 +0300
Jul 15, 2020 at 15:25 +0300
Jul 13, 2020 at 23:30 +0300
Jul 13, 2020 at 21:51 +0300
Jul 13, 2020 at 21:14 +0300
Jul 13, 2020 at 17:45 +0300
Jul 3, 2020 at 18:59 +0300
Jul 3, 2020 at 18:27 +0300
Jul 3, 2020 at 18:23 +0300
Jun 25, 2020 at 17:15 +0300
Jun 19, 2020 at 10:55 +0300
Jun 18, 2020 at 17:16 +0300
Jun 16, 2020 at 14:42 +0300
Jun 16, 2020 at 13:52 +0300
Jun 11, 2020 at 17:35 +0300
Jun 8, 2020 at 13:58 +0300
Jun 2, 2020 at 16:07 +0300
May 25, 2020 at 14:13 +0300
May 20, 2020 at 12:10 +0300
May 18, 2020 at 19:07 +0300
May 17, 2020 at 15:01 +0300
May 17, 2020 at 14:42 +0300
May 14, 2020 at 23:53 +0300
May 14, 2020 at 23:50 +0300
May 14, 2020 at 20:10 +0300
May 7, 2020 at 19:03 +0300
May 6, 2020 at 20:24 +0300
May 6, 2020 at 12:46 +0300
Apr 29, 2020 at 22:35 +0300
Apr 28, 2020 at 12:26 +0300
Apr 24, 2020 at 19:37 +0300
Apr 20, 2020 at 20:55 +0300
Apr 17, 2020 at 18:44 +0300
Apr 17, 2020 at 14:45 +0300
Apr 17, 2020 at 13:39 +0300
Apr 16, 2020 at 11:58 +0300
Apr 15, 2020 at 22:18 +0300
Apr 15, 2020 at 21:44 +0300
Apr 15, 2020 at 16:13 +0300
Apr 13, 2020 at 14:42 +0300
Apr 10, 2020 at 15:18 +0300
Apr 10, 2020 at 14:03 +0300
Apr 10, 2020 at 13:01 +0300
Apr 10, 2020 at 12:56 +0300
Apr 8, 2020 at 16:22 +0300
Apr 8, 2020 at 01:05 +0300
Apr 7, 2020 at 20:30 +0300
Apr 6, 2020 at 12:39 +0300
Apr 1, 2020 at 12:51 +0300
Mar 31, 2020 at 11:43 +0300
Mar 31, 2020 at 11:17 +0300
Mar 30, 2020 at 23:32 +0300
Mar 30, 2020 at 22:44 +0300
Mar 30, 2020 at 19:16 +0300
Mar 30, 2020 at 19:05 +0300
Mar 30, 2020 at 18:59 +0300
Mar 23, 2020 at 22:05 +0300
Mar 23, 2020 at 12:17 +0300
Mar 20, 2020 at 11:38 +0300
Mar 19, 2020 at 22:50 +0300
Mar 19, 2020 at 11:12 +0300
Mar 12, 2020 at 10:25 +0300
Mar 11, 2020 at 13:51 +0300
Mar 6, 2020 at 18:06 +0300
Mar 6, 2020 at 11:41 +0300
Mar 4, 2020 at 19:09 +0300
Mar 4, 2020 at 13:14 +0300
Feb 25, 2020 at 21:32 +0300
Feb 20, 2020 at 16:49 +0300
Feb 20, 2020 at 16:47 +0300
Feb 20, 2020 at 16:17 +0300
Feb 19, 2020 at 17:26 +0300
Feb 17, 2020 at 16:08 +0300

Least stable update channel

These releases can bring new features, but are unstable. We do not guarantee backward compatibility between Alpha releases.

v1.1.23+fix47
Jun 11, 2021 at 12:52 +0300

Fixes

[v1.1][helm] Fix strict values yaml parsing introduced into werf

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix46
Jun 9, 2021 at 21:02 +0300

[v1.1] Fix werf resources tracker exits before resources are ready

Fixed in kubedog, updated werf to use latest kubedog.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix45
Jun 4, 2021 at 13:27 +0300

Fixes

Revert kubedog debug panic:

[debug] Catch deployment tracker exited without resource status resolution bug

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix41
May 24, 2021 at 23:19 +0300

Internals

FIX: enable release publishing into the bintray mirror to support old multiwerf versions.

Installation

Linux amd64

Darwin amd64

Windows amd64

May 24, 2021 at 22:25 +0300
v1.1.23+fix41
Apr 13, 2021 at 20:12 +0300

Internals

FIX: enable release publishing into the bintray mirror to support old multiwerf versions.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix40
Apr 13, 2021 at 19:52 +0300

Fixes

[go.mod] github.com/werf/logboek v0.4.7

  • [fitter] Fix unpredictable behavior when using a logger by several processes

[v1.1] Ignore broken images when checking already published images

Internals

[v1.1, ci] Disable release publisher into bintray
[v1.1,ci] Add build release scripts

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix37
Apr 9, 2021 at 15:00 +0300

Fixes

[logging] Build: add waiting for background tasks log message.

[cleanup] Ignore blob-unknown errors properly.
During cleanup operation do not raise should-reset-stages-storage-cache error when get stage manifest operation have failed with
blob-unknown error.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix36
Apr 5, 2021 at 22:50 +0300

Fixes

[v1.1] Skip blob-unknown images in cleanup properly

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix35
Apr 5, 2021 at 22:20 +0300

Fixes

[v1.1] Skip blob-unknown images in werf-cleanup procedure

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix34
Apr 2, 2021 at 21:07 +0300

Fixes

Automatically invalidate corrupted manifests cache json records.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix33
Mar 30, 2021 at 20:45 +0300

Fixes

[buidler] Fix panic docker_registry.IsNameUnknownError

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix30
Mar 30, 2021 at 20:13 +0300

[v1.1] Fix saving stages-ids into the stages-storage-cache

When some stage has appeared in the repository tags list, but stage image is invalid (due to MANIFEST_UNKNOWN or BLOB_UNKNOWN container registry errors), werf ignores such stage. But this stage-id of such broken stage has been saved into the stages-storage-cache anyway, which is wrong.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix32
Mar 30, 2021 at 19:34 +0300

Fixes

[builder] Proper rejection of blob-unknown stages

Do not reject stage when manifest-unknown or name-unknown errors detected. Only reject images with blob-unknown errors.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix30
Mar 25, 2021 at 18:27 +0300

[v1.1] Fix saving stages-ids into the stages-storage-cache

When some stage has appeared in the repository tags list, but stage image is invalid (due to MANIFEST_UNKNOWN or BLOB_UNKNOWN container registry errors), werf ignores such stage. But this stage-id of such broken stage has been saved into the stages-storage-cache anyway, which is wrong.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix29
Mar 25, 2021 at 13:02 +0300

[v1.1][stapel] Support for rejected stages in the stages storage

Reject stage when docker-pull have failed with the “blob unknown” error.

Add special record into the stages-storage for such rejected stages.

Other

[v1.1] Add ability to set werf-stapel image name with WERF_STAPEL_IMAGE_NAME environment variable.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix28
Mar 24, 2021 at 15:45 +0300

[stapel] Fix: fetch artifact/image stage before running imports rsync server

Fetch operation will check that image exists correctly and will reset stages building conveyor to rebuild this stage if needed.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix27
Mar 24, 2021 at 14:27 +0300

Fixes

Fix: print rsync server docker run command on imports server run failure

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix26
Mar 23, 2021 at 21:42 +0300

Fixes

[v1.1][GC] Fix StagesStorage ShouldFetch method: perform fresh docker-inspect, do not use cached inspection result from the previous inspect.

This fix particularly needed for the v1.2 host cleanup procedure which can remove freshly built and saved into the stages storage images. In such case should-fetch and stages-storage-manager fetch method will lock an image and perform standard fetch procedure.

[v1.1] Added stage image locking into stages-storage-manager to prevent v1.2 host cleanup procedure from deleting stages which are in use.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix25
Mar 23, 2021 at 14:22 +0300

Fixes

Completely remove redudant stages_and_images read-only shared lock usage to reduce the number of requests to lock-server.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix24
Mar 22, 2021 at 16:31 +0300

[cleanup][v1.1] Enable v1.2 werf-cleanup mode for v1.1 by default

–git-history-based-cleanup-v1.2 option has been enabled by default: use git history based cleanup and delete images tags without related image metadata (default $WERF_GIT_HISTORY_BASED_CLEANUP_v1_2).

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix23
Mar 22, 2021 at 12:28 +0300

[GC][v1.1] Save last/first werf run timestamps for v1.1

This info needed for v1.2’s host cleanup procedure.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix21
Mar 5, 2021 at 11:39 +0300

Debug release

Kubedog update: disable events informer with KUBEDOG_DISABLE_EVENTS=1

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix20
Feb 18, 2021 at 10:51 +0300

[v1.1] Helm 3 release existence checker

Add support for custom kube-context and kube-config-base64.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix16
Feb 16, 2021 at 18:06 +0300

[config] Add fromYaml function

  • fromYAML(str string) (map[string]interface{}, error)
  • return error if unmarshalling failed

werf.yaml

...  
{{- $values := .Files.Get "werf_values.yaml" | fromYaml -}} // or fromYaml (.Files.Get "werf_values.yaml")  
from: {{- $values.image.from }}

werf_values.yaml

image:  
    from: alpine

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix18
Feb 16, 2021 at 12:28 +0300

Debug release

Disable resources waiter debug env WERF_DISABLE_RESOURCES_WAITER=1

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix17
Feb 15, 2021 at 23:14 +0300

[1.1] Helm 3 release existence check

werf-converge and werf-deploy commands will refuse to work when helm 3 release with the same name as target helm 2 release exists in the current namespace.

This check protects existing helm 3 release when your project has already been migrated from helm 2 to helm 3, but for some reason werf v1.1 tries to redeploy this release.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix16
Feb 15, 2021 at 11:58 +0300

[config] Add fromYaml function

  • fromYAML(str string) (map[string]interface{}, error)
  • return error if unmarshalling failed

werf.yaml

...  
{{- $values := .Files.Get "werf_values.yaml" | fromYaml -}} // or fromYaml (.Files.Get "werf_values.yaml")  
from: {{- $values.image.from }}

werf_values.yaml

image:  
    from: alpine

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix15
Feb 9, 2021 at 21:23 +0300

[werf.yaml] Mix Sprig V2 and V3 functions for werf.yaml templating

Introduce the following list of sprig v3 functions which was not previously avaialable in the sprig v2:

add1f  
addf  
all  
any  
bcrypt  
chunk  
concat  
decryptAES  
deepCopy  
deepEqual  
dig  
divf  
duration  
durationRound  
encryptAES  
fromJson  
genCAWithKey  
genSelfSignedCertWithKey  
genSignedCertWithKey  
get  
getHostByName  
htpasswd  
maxf  
minf  
mulf  
mustAppend  
mustChunk  
mustCompact  
mustDateModify  
mustDeepCopy  
mustFirst  
mustFromJson  
mustHas  
mustInitial  
mustLast  
mustMerge  
mustMergeOverwrite  
mustPrepend  
mustPush  
mustRegexFind  
mustRegexFindAll  
mustRegexMatch  
mustRegexReplaceAll  
mustRegexReplaceAllLiteral  
mustRegexSplit  
mustRest  
mustReverse  
mustSlice  
mustToDate  
mustToJson  
mustToPrettyJson  
mustToRawJson  
mustUniq  
mustWithout  
must_date_modify  
osBase  
osClean  
osDir  
osExt  
osIsAbs  
randBytes  
randInt  
regexQuoteMeta  
seq  
subf  
toDecimal  
toRawJson  
urlJoin  
urlParse

https://github.com/werf/werf/pull/3220

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix14
Feb 9, 2021 at 16:32 +0300

Fixes

Do not print warnings for MANIFEST_UNKNOWN and BLOB_UNKNOWN registry errors until werf-cleanup does not delete these images automatically.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix13
Feb 5, 2021 at 19:57 +0300

Fixes

[BLOB_UNKNOWN] Completely ignore images with BLOB_UNKNOWN errors from the standard docker registry

  • Consider image is not exists in that case.
  • Log warnings on BLOB_UNKNOWN and MANIFEST_UNKNOWN for default docker registry impl.
  • Removed experimental WERF_EXPERIMENTAL_IGNORE_IMAGE_METADATA_BY_COMMIT_BLOB_UNKNOWN env variable.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix12
Feb 5, 2021 at 15:42 +0300

Experimental debug

Ignore image-metadata-by-commit BLOB_UNKNOWN errors when WERF_EXPERIMENTAL_IGNORE_IMAGE_METADATA_BY_COMMIT_BLOB_UNKNOWN=1 is set

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix11
Feb 2, 2021 at 14:14 +0300

Fixes

Do not parse values with strict yaml parser to allow usage of yaml-anchors

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix10
Jan 27, 2021 at 19:20 +0300

DEPRECATION WARNING

Add deprecation warning for the fromImageArtifact directive.

Fixes

Fix WERF_SET_* arguments are not active when –set has been specified issue. Add ability to specify WERF_SET_* order of processing by sorting environment variables alphanumerically by the name.

https://github.com/werf/werf/issues/3128
https://github.com/werf/werf/issues/3137

Complete list of refactored list arguments:

  • –set + WERF_SET_*;
  • –set-string + WERF_SET_STRING_*;
  • –set-file + WERF_SET_FILE_*;
  • –add-label + WERF_ADD_LABEL_*;
  • –add-annotation + WERF_ADD_ANNOTATION_*;
  • –ssh-key + WERF_SSH_KEY_*;
  • –secondary-repo + WERF_SECONDARY_REPO_*;

Process params as follows:

  1. Sort WERF__* environment variables alphanumerically.
  2. Merge all params passed by environment variables with CLI-params (CLI-params have more priority).

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix9
Jan 21, 2021 at 13:27 +0300

Add deploy values debug info

Print “Helm values params” block when –debug has been specified.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix8
Jan 12, 2021 at 20:44 +0300

Small features

Added .Values.global.werf.version service value with werf cli util version.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix7
Jan 12, 2021 at 15:44 +0300

Fixes

Fix redundant stapel container initialization for dockerfile image

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix6
Dec 8, 2020 at 22:55 +0300

Fixes

Fix “Error: parsing file … failed: yaml: unmarshal errors … cannot unmarshal !!map into string”

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix5
Nov 25, 2020 at 21:43 +0300

Fixes

Update kubedog: fix Job hanging case (https://github.com/werf/kubedog/pull/184), fix color disabled in CI/CD systems.

Installation

Linux amd64

Darwin amd64

Windows amd64

v1.1.23+fix3
Nov 13, 2020 at 12:03 +0300

Fix “docker: invalid reference format: repository name must be lowercase”

Fix –docker-options option cannot contain multiple spaces.

Installation

Linux amd64

Darwin amd64

Windows amd64

Nov 9, 2020 at 13:35 +0300
Nov 6, 2020 at 17:27 +0300
Nov 6, 2020 at 12:36 +0300
Nov 5, 2020 at 14:55 +0300
Nov 3, 2020 at 18:39 +0300
Nov 3, 2020 at 11:04 +0300
Oct 27, 2020 at 14:42 +0300
Oct 13, 2020 at 11:30 +0300
Oct 9, 2020 at 11:29 +0300
Oct 7, 2020 at 13:20 +0300
Oct 2, 2020 at 16:01 +0300
Sep 24, 2020 at 12:23 +0300
Sep 21, 2020 at 12:37 +0300
Sep 18, 2020 at 14:09 +0300
Sep 17, 2020 at 10:39 +0300
Sep 9, 2020 at 19:27 +0300
Sep 7, 2020 at 22:01 +0300
Sep 4, 2020 at 09:55 +0300
Sep 2, 2020 at 20:56 +0300
Sep 2, 2020 at 20:01 +0300
Sep 1, 2020 at 18:43 +0300
Sep 1, 2020 at 14:50 +0300
Aug 31, 2020 at 20:42 +0300
Aug 28, 2020 at 12:53 +0300
Aug 24, 2020 at 16:08 +0300
Aug 24, 2020 at 14:55 +0300
Aug 21, 2020 at 18:14 +0300
Aug 20, 2020 at 22:47 +0300
Aug 20, 2020 at 21:43 +0300
Aug 20, 2020 at 10:56 +0300
Aug 11, 2020 at 20:04 +0300
Aug 11, 2020 at 19:11 +0300
Aug 10, 2020 at 16:20 +0300
Aug 10, 2020 at 12:55 +0300
Aug 8, 2020 at 23:31 +0300
Aug 7, 2020 at 21:02 +0300
Aug 7, 2020 at 16:21 +0300
Aug 5, 2020 at 15:27 +0300
Jul 27, 2020 at 18:55 +0300
Jul 27, 2020 at 11:08 +0300
Jul 27, 2020 at 10:04 +0300
Jul 23, 2020 at 22:02 +0300
Jul 23, 2020 at 18:45 +0300
Jul 23, 2020 at 15:50 +0300
Jul 22, 2020 at 10:18 +0300
Jul 20, 2020 at 13:54 +0300
Jul 17, 2020 at 17:33 +0300
Jul 16, 2020 at 22:42 +0300
Jul 15, 2020 at 15:25 +0300
Jul 13, 2020 at 21:14 +0300
Jul 13, 2020 at 17:11 +0300
Jul 10, 2020 at 12:44 +0300
Jul 9, 2020 at 16:20 +0300
Jul 7, 2020 at 21:34 +0300
Jul 7, 2020 at 21:09 +0300
Jul 3, 2020 at 18:04 +0300
Jul 3, 2020 at 02:15 +0300
Jul 2, 2020 at 14:20 +0300
Jul 2, 2020 at 12:48 +0300
Jun 26, 2020 at 19:56 +0300
Jun 25, 2020 at 17:54 +0300
Jun 25, 2020 at 17:15 +0300
Jun 23, 2020 at 14:25 +0300
Jun 23, 2020 at 11:05 +0300
Jun 23, 2020 at 09:46 +0300
Jun 18, 2020 at 17:00 +0300
Jun 18, 2020 at 16:02 +0300
Jun 16, 2020 at 13:26 +0300
Jun 12, 2020 at 11:52 +0300
Jun 11, 2020 at 15:14 +0300
Jun 8, 2020 at 13:41 +0300
Jun 8, 2020 at 13:28 +0300
Jun 8, 2020 at 12:55 +0300
Jun 6, 2020 at 14:42 +0300
Jun 4, 2020 at 01:31 +0300
Jun 3, 2020 at 21:06 +0300
Jun 3, 2020 at 14:16 +0300
Jun 2, 2020 at 16:09 +0300
Jun 2, 2020 at 11:54 +0300
Jun 1, 2020 at 18:04 +0300
May 29, 2020 at 10:14 +0300
May 28, 2020 at 13:04 +0300
May 27, 2020 at 12:28 +0300
May 26, 2020 at 19:43 +0300
May 25, 2020 at 17:32 +0300
May 25, 2020 at 14:13 +0300
May 20, 2020 at 17:20 +0300
May 20, 2020 at 16:27 +0300
May 20, 2020 at 12:10 +0300
May 18, 2020 at 20:37 +0300
May 18, 2020 at 19:07 +0300
May 17, 2020 at 15:01 +0300
May 14, 2020 at 23:41 +0300
May 14, 2020 at 16:35 +0300
May 12, 2020 at 22:34 +0300
May 12, 2020 at 22:29 +0300
May 12, 2020 at 22:28 +0300
May 7, 2020 at 19:03 +0300
May 6, 2020 at 20:24 +0300
May 6, 2020 at 12:46 +0300
Apr 29, 2020 at 22:35 +0300
Apr 28, 2020 at 12:26 +0300
Apr 27, 2020 at 17:02 +0300
Apr 24, 2020 at 19:37 +0300
Apr 22, 2020 at 13:17 +0300
Apr 22, 2020 at 01:39 +0300
Apr 21, 2020 at 21:32 +0300
Apr 20, 2020 at 20:55 +0300
Apr 17, 2020 at 22:44 +0300
Apr 15, 2020 at 22:18 +0300
Apr 15, 2020 at 21:44 +0300
Apr 15, 2020 at 16:13 +0300
Apr 13, 2020 at 14:28 +0300
Apr 10, 2020 at 17:36 +0300
Apr 10, 2020 at 13:01 +0300
Apr 8, 2020 at 16:22 +0300
Apr 6, 2020 at 12:39 +0300
Mar 31, 2020 at 22:22 +0300
Mar 31, 2020 at 12:51 +0300
Mar 30, 2020 at 22:44 +0300
Mar 30, 2020 at 22:01 +0300
Mar 30, 2020 at 19:50 +0300
Mar 25, 2020 at 10:47 +0300
Mar 24, 2020 at 23:49 +0300
Mar 24, 2020 at 11:37 +0300
Mar 23, 2020 at 22:05 +0300
Mar 23, 2020 at 12:17 +0300
Mar 23, 2020 at 10:24 +0300
Mar 20, 2020 at 11:38 +0300
Mar 19, 2020 at 22:50 +0300
Mar 19, 2020 at 11:12 +0300
Mar 12, 2020 at 10:25 +0300
Mar 11, 2020 at 13:51 +0300
Mar 6, 2020 at 18:06 +0300
Mar 6, 2020 at 11:41 +0300
Mar 4, 2020 at 19:09 +0300
Mar 4, 2020 at 13:14 +0300
Feb 25, 2020 at 21:32 +0300
Feb 20, 2020 at 16:49 +0300
Feb 20, 2020 at 16:47 +0300
Feb 20, 2020 at 16:17 +0300
Feb 19, 2020 at 17:26 +0300
Feb 17, 2020 at 16:08 +0300
Feb 17, 2020 at 14:45 +0300
Feb 14, 2020 at 14:30 +0300
Feb 13, 2020 at 23:00 +0300
Feb 12, 2020 at 11:36 +0300
Feb 11, 2020 at 21:44 +0300
Feb 10, 2020 at 00:55 +0300
Feb 7, 2020 at 20:21 +0300
Feb 7, 2020 at 20:08 +0300
Feb 7, 2020 at 10:37 +0300
Feb 6, 2020 at 18:01 +0300
Feb 6, 2020 at 16:15 +0300
Feb 5, 2020 at 18:28 +0300
Feb 4, 2020 at 14:13 +0300
Feb 4, 2020 at 12:22 +0300
Feb 4, 2020 at 11:03 +0300
Feb 3, 2020 at 21:46 +0300
Jan 29, 2020 at 00:26 +0300
Made with by Flant
2300