title	permalink	description
Быстрый старт	quickstart.html	Разверните ваше первое приложение с werf

В этой статье мы покажем, как развернуть простое приложение (для голосования в нашем случае) с помощью werf. Прежде всего рекомендуем ознакомиться с кратким введением, если вы этого еще не сделали.

Чтобы повторить все шаги, изложенные в этом кратком руководстве, необходимо установить werf.

Подготовьте вашу систему

Установите зависимости.
Установите trdl и werf.

Прежде чем переходить к следующим шагам, надо убедиться что команда werf доступна в вашем shell:

werf version

Подготовьте свою инсталляцию Kubernetes и container registry

У вас должен быть доступ к кластеру Kubernetes и возможность push'ить образы в container registry. Container registry также должен быть доступен из кластера для извлечения образов.

Если кластер Kubernetes и container registry у вас уже настроены и работают, достаточно:

Выполнить стандартный вход в container registry со своего хоста.
Убедиться, что кластер Kubernetes доступен с хоста (дополнительная настройка werf, скорее всего, не потребуется, если у вас уже установлен и работает kubectl).

В ином случае выполните одну из следующих инструкций, чтобы настроить локальный кластер Kubernetes и container registry в вашей системе:

Windows — minikube

1. Установите [minikube](https://github.com/kubernetes/minikube#installation). 2. Установите [kubectl](https://kubernetes.io/ru/docs/tasks/tools/install-kubectl/#%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-kubectl-%D0%B2-windows). 3. Запустите minikube:

{% raw %}

minikube start --driver=docker --insecure-registry registry.example.com:80

{% endraw %}

ВАЖНО. С параметром --insecure-registry мы подготавливаем такое окружение, которое сможет работать с Container Registry без TLS. В нашем случае для упрощения настройка TLS отсутствует.

Установка NGINX Ingress Controller:

{% raw %}
```
minikube addons enable ingress
```
{% endraw %}

Установка Container Registry для хранения образов:

{% raw %}

minikube addons enable registry

{% endraw %}

Создадим Ingress для доступа к Container Registry.

{% raw %}

@"
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: registry
  namespace: kube-system
  annotations:
    nginx.ingress.kubernetes.io/proxy-body-size: "0"
spec:
  rules:
  - host: registry.example.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: registry
            port:
              number: 80
"@ | kubectl apply -f -

{% endraw %}

Разрешаем доступ в Container Registry без TLS для Docker:

Через меню Docker Desktop -> Settings -> Docker Engine добавим новый ключ в конфигурацию:
```
{
   "insecure-registries": ["registry.example.com:80"]
}
```
Перезапустим Docker Desktop через меню, открывающееся правым кликом по иконке Docker Desktop в трее.

Затем снова запустим minikube:
```
minikube start --driver=docker --insecure-registry registry.example.com:80
```
Разрешаем доступ в Container Registry без TLS для werf:

В терминале где будет запускаться werf установим переменную окружения WERF_INSECURE_REGISTRY=1.

Для cmd.exe:
```
set WERF_INSECURE_REGISTRY=1
```
Для bash:
```
export WERF_INSECURE_REGISTRY=1
```
Для PowerShell:
```
$Env:WERF_INSECURE_REGISTRY = "1"
```
Мы будем использовать домены vote.quickstart-application.example.com и result.quickstart-application.example.com для доступа к приложению и домен registry.example.com для доступа к Container Registry.

Обновим файл hosts. Сначала получите IP-адрес minikube:
```
minikube ip
```
Используя полученный выше IP-адрес minikube, добавьте в конец файла C:\Windows\System32\drivers\etc\hosts следующую строку:
```
<IP-адрес minikube>    vote.quickstart-application.example.com result.quickstart-application.example.com registry.example.com
```
Должно получиться примерно так:
```
192.168.99.99          vote.quickstart-application.example.com result.quickstart-application.example.com registry.example.com
```
Также делаем доступ к домену registry.example.com из minikube node:
```
minikube ssh -- "echo $(minikube ip) registry.example.com | sudo tee -a /etc/hosts"
```

MacOS — minikube

1. Установите [minikube](https://github.com/kubernetes/minikube#installation). 2. Установите [kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl-macos/). 3. Запустите minikube:

{% raw %}

minikube start --vm=true --insecure-registry registry.example.com:80

{% endraw %}

ВАЖНО. С параметром --insecure-registry мы подготавливаем такое окружение, которое сможет работать с Container Registry без TLS. В нашем случае для упрощения настройка TLS отсутствует.

Установка NGINX Ingress Controller:

{% raw %}
```
minikube addons enable ingress
```
{% endraw %}

Установка Container Registry для хранения образов:

{% raw %}

minikube addons enable registry

{% endraw %}

Создадим Ingress для доступа к Container Registry:

{% raw %}

kubectl apply -f - << EOF
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: registry
  namespace: kube-system
  annotations:
    nginx.ingress.kubernetes.io/proxy-body-size: "0"
spec:
  rules:
  - host: registry.example.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: registry
            port:
              number: 80
EOF

{% endraw %}

Разрешаем доступ в Container Registry без TLS для docker:

Через меню Docker Desktop -> Settings -> Docker Engine добавим новый ключ в конфигурацию:
```
{
"insecure-registries": ["registry.example.com:80"]
}
```
Перезапустим Docker Desktop через меню, открывающееся правым кликом по иконке Docker Desktop в трее.

Затем снова запустим minikube:

{% raw %}
```
minikube start --vm=true --insecure-registry registry.example.com:80
```
{% endraw %}
Разрешаем доступ в Container Registry без TLS для werf:

В терминале где будет запускаться werf установим переменную окружения WERF_INSECURE_REGISTRY=1. Для bash:
```
export WERF_INSECURE_REGISTRY=1
```
Чтобы опция автоматически устанавливалась в новых bash-сессиях, добавим её в .bashrc:
```
echo export WERF_INSECURE_REGISTRY=1 | tee -a ~/.bashrc
```
Мы будем использовать домены vote.quickstart-application.example.com и result.quickstart-application.example.com для доступа к приложению и домен registry.example.com для доступа к Container Registry.

Обновим файл hosts. Выполните команду в терминале:
```
echo "$(minikube ip) vote.quickstart-application.example.com result.quickstart-application.example.com registry.example.com" | sudo tee -a /etc/hosts
```
Также делаем доступ к домену registry.example.com из minikube node:
```
minikube ssh -- "echo $(minikube ip) registry.example.com | sudo tee -a /etc/hosts"
```

Linux — minikube

Установите minikube по инструкции (достаточно выполнить только первый пункт этих инструкций под названием Installation).
Запустите minikube:

{% raw %}
```
minikube start --driver=docker --insecure-registry registry.example.com:80
```
{% endraw %}

ВАЖНО. С параметром --insecure-registry мы подготавливаем такое окружение, которое сможет работать с Container Registry без TLS. В нашем случае для упрощения настройка TLS отсутствует.
Если вы не устанавливали отдельно утилиту kubectl, можно создать alias на kubectl, поставляемую с munikube:
```
alias kubectl="minikube kubectl --"
echo 'alias kubectl="minikube kubectl --"' >> ~/.bash_aliases
```
Установка NGINX Ingress Controller:

{% raw %}
```
minikube addons enable ingress
```
{% endraw %}

Установка Container Registry для хранения образов:

{% raw %}

minikube addons enable registry

{% endraw %}

Создадим Ingress для доступа к Container Registry:

{% raw %}

kubectl apply -f - << EOF
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: registry
  namespace: kube-system
  annotations:
    nginx.ingress.kubernetes.io/proxy-body-size: "0"
spec:
  rules:
  - host: registry.example.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: registry
            port:
              number: 80
EOF

{% endraw %}

Разрешаем доступ в Container Registry без TLS для Docker:

В файл, по умолчанию находящийся в /etc/docker/daemon.json, добавим новый ключ:
```
{
"insecure-registries": ["registry.example.com:80"]
}
```
Если такого файла в каталоге нет, его нужно создать и вставить в него указанные выше строки. Обратите внимание, что для доступа к изменению файлов в каталоге /etc нужны права суперпользователя (root).

Перезапустим Docker:
```
sudo systemctl restart docker
```
Затем снова запустим minikube:

{% raw %}
```
minikube start --driver=docker --insecure-registry registry.example.com:80
```
{% endraw %}
Разрешаем доступ в Container Registry без TLS для werf:

В терминале где будет запускаться werf установим переменную окружения WERF_INSECURE_REGISTRY=1.

Для bash:
```
export WERF_INSECURE_REGISTRY=1
```
Чтобы опция автоматически устанавливалась в новых bash-сессиях, добавим её в .bashrc:
```
echo export WERF_INSECURE_REGISTRY=1 | tee -a ~/.bashrc
```
Мы будем использовать домены vote.quickstart-application.example.com и result.quickstart-application.example.com для доступа к приложению и домен registry.example.com для доступа к Container Registry.

Обновим файл hosts. Убедитесь, что minikube запущен и работает:
```
echo "$(minikube ip)
```
Если в результате был показан IP-адрес кластера, значит кластер запущен и работает.

Выполните команду в терминале:
```
echo "$(minikube ip) vote.quickstart-application.example.com result.quickstart-application.example.com registry.example.com" | sudo tee -a /etc/hosts
```
Также делаем доступ к домену registry.example.com из minikube node:
```
minikube ssh -- "echo $(minikube ip) registry.example.com | sudo tee -a /etc/hosts"
```

Разверните приложение-пример

Склонируйте репозиторий нашего приложения-примера:

{% raw %}
```
git clone https://github.com/werf/quickstart-application
cd quickstart-application
```
{% endraw %}
Запустите команду converge, которая использует Container Registry для хранения образов:

{% raw %}
```
werf converge --repo registry.example.com:80/quickstart-application
```
{% endraw %}

Примечание: для подключения к кластеру Kubernetes werf использует те же настройки, что и kubectl: файл ~/.kube/config и переменную среды KUBECONFIG. Также поддерживаются флаги --kube-config и --kube-config-base64 - с их помощью можно указывать кастомные файлы kubeconfig.

Проверьте результаты

После успешного завершения команды converge можно считать, что наше приложение развернуто и работает.

Как вы помните, наше приложение представляет собой простую голосовалку. Давайте его проверим!

Чтобы принять участие в голосовании, перейдите по ссылке: vote.quickstart-application.example.com
Чтобы увидеть результаты голосования, перейдите по ссылке: result.quickstart-application.example.com

Принципы работы

Чтобы развернуть приложение с помощью werf, необходимо описать желаемое состояние в Git (как описано во введении).

В нашем репозитории имеются следующие Dockerfile'ы:

{% raw %}
```
vote/Dockerfile
result/Dockerfile
worker/Dockerfile
```
{% endraw %}

В werf.yaml на них прописаны соответствующие ссылки:

{% raw %}

configVersion: 1
project: quickstart-application
---
image: vote
dockerfile: vote/Dockerfile
context: vote
---
image: result
dockerfile: result/Dockerfile
context: result
---
image: worker
dockerfile: worker/Dockerfile
context: worker

{% endraw %}

Шаблоны для компонентов приложения vote, db, redis, result и worker описаны в каталоге .helm/templates/. Схема ниже показывает, как компоненты взаимодействуют между собой:

![Схема взаимодействия компонентов]({{ "images/quickstart-architecture.svg" | true_relative_url }})

Фронтенд-приложение на Python или ASP.NET Core позволяет пользователю проголосовать за один из двух вариантов;
Очередь на базе Redis или NATS получает новые голоса;
Worker на основе .NET Core, Java или .NET Core 2.1 собирает голоса и сохраняет их в...
Базу данных Postgres или TiDB в томе Docker;
Веб-приложение на Node.js или ASP.NET Core SignalR в реальном времени показывает результаты голосования.

Что дальше?

Рекомендуем ознакомиться со статьей "Использование werf с системами CI/CD" или обратиться к соответствующим руководствам.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

quickstart.md

quickstart.md

Подготовьте вашу систему

Подготовьте свою инсталляцию Kubernetes и container registry

Разверните приложение-пример

Проверьте результаты

Принципы работы

Что дальше?

Files

quickstart.md

Latest commit

History

quickstart.md

File metadata and controls

Подготовьте вашу систему

Подготовьте свою инсталляцию Kubernetes и container registry

Разверните приложение-пример

Проверьте результаты

Принципы работы

Что дальше?