Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc(v2): sync RU documentation for v2 #6099

Merged
merged 6 commits into from
Apr 26, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/pages_ru/resources/comparison.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ GitOps требует разделять разработку и эксплуа

Helm используется только для развертывания и дистрибуции чартов, а werf ещё и для разработки, сборки, тестирования, дистрибуции образов и бандлов, а также очистки container registry.

В werf встроен Helm с дополнительными возможностями: продвинутым отслеживанием, порядком развертывания не только для хуков, но и для обычных ресурсов, и другими.
Для развертывания чартов и их дистрибуции мы используем Nelm: совместимую с Helm альтернативу, которая предоставляет множество новых возможностей и улучшений, таких как продвинутое отслеживание ресурсов, гибкий порядок выката ресурсов во время развертывания, Server-Side Apply вместо 3-Way Merge, `terraform plan`-подобные возможности и многое другое.

## werf vs Argo CD

Expand Down
41 changes: 0 additions & 41 deletions docs/pages_ru/usage/deploy/deployment_order.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,45 +48,6 @@ werf converge

По умолчанию werf объединяет все основные ресурсы (основные — не являющиеся хуками или CRDs из `crds/*.yaml`) в одну группу, создаёт ресурсы этой группы, а затем отслеживает их готовность.

Создание ресурсов группы происходит в следующем порядке:

- Namespace;
- NetworkPolicy;
- ResourceQuota;
- LimitRange;
- PodSecurityPolicy;
- PodDisruptionBudget;
- ServiceAccount;
- Secret;
- SecretList;
- ConfigMap;
- StorageClass;
- PersistentVolume;
- PersistentVolumeClaim;
- CustomResourceDefinition;
- ClusterRole;
- ClusterRoleList;
- ClusterRoleBinding;
- ClusterRoleBindingList;
- Role;
- RoleList;
- RoleBinding;
- RoleBindingList;
- Service;
- DaemonSet;
- Pod;
- ReplicationController;
- ReplicaSet;
- Deployment;
- HorizontalPodAutoscaler;
- StatefulSet;
- Job;
- CronJob;
- Ingress;
- APIService.

Отслеживание готовности включается для всех ресурсов группы одновременно сразу после создания *всех* ресурсов группы.

Для изменения порядка развертывания ресурсов можно создать *новые группы ресурсов* через задание ресурсам *веса*, отличного от веса по умолчанию `0`. Все ресурсы с одинаковым весом объединяются в группы, а затем группы ресурсов развертываются по очереди, от группы с меньшим весом к большему, например:

```
Expand Down Expand Up @@ -264,5 +225,3 @@ metadata:
secret.external-dependency.werf.io/resource: secret/my-dynamic-vault-secret
secret.external-dependency.werf.io/namespace: my-namespace
```

*Обратите внимание, что ожидать готовность внешнего ресурса будут и все другие ресурсы релиза с тем же весом, так как ресурсы объединяются по весу в группы и развертываются именно группами.*
2 changes: 1 addition & 1 deletion docs/pages_ru/usage/deploy/deployment_scenarios.md
Original file line number Diff line number Diff line change
Expand Up @@ -159,7 +159,7 @@ kubectl apply -f manifests.yaml
werf build --repo example.org/mycompany/myapp
```

```
```shell
werf render --require-built-images --output manifests.yaml --repo example.org/mycompany/myapp
```

Expand Down
6 changes: 4 additions & 2 deletions docs/pages_ru/usage/deploy/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,17 +5,19 @@ permalink: usage/deploy/overview.html

При организации доставки приложения в Kubernetes необходимо определиться с тем, какой формат выбрать для управления конфигурацией развёртывания (параметризации, управления зависимостями, конфигурации под различные окружения и т.д.), а также способом применения этой конфигурации – непосредственно механизмом развёртывания.

В werf встроен Helm, и именно он используется для решения перечисленных задач. Разработка и сопровождение конфигурации реализуется с помощью Helm-чарта, а для процесса развёртывания предлагается Helm c дополнительными возможностями:
Nelm — обратно-совместимая с Helm альтернатива — встроена в werf и используется для решения перечисленных задач. Разработка и сопровождение конфигурации реализуется с помощью Helm-чартов, а для процесса развёртывания предлагается Nelm c дополнительными возможностями:

- отслеживание состояния выкатываемых ресурсов (с возможностью изменения поведения [для каждого ресурса]({{ "/reference/deploy_annotations.html" | true_relative_url }})):
- умное ожидание готовности ресурсов;
- мгновенное завершение проблемного развертывания без необходимости ожидания таймаута;
- прогресс развёртывания, логи, системные события и ошибки приложения.
- использование произвольного порядка развертывания для любых ресурсов, а не только для хуков;
- ожидание создания и готовности ресурсов, не принадлежащих релизу;
- использование более надежного метода Server-Side Apply для обновления ресурсов вместо 3-Way Merge;
- возможности по типу `terraform plan`, доступные "из коробки";
- интеграция сборки и развертывания и многое другое.

werf стремится сделать работу с Helm более простой, удобной и гибкой, при этом не ломая обратную совместимость с Helm-чартами, Helm-шаблонами и Helm-релизами.
werf стремится сделать работу с Helm-развертываниями более простой, удобной и гибкой, при этом не ломая обратную совместимость с Helm-чартами, Helm-шаблонами и Helm-релизами.

## Простой пример развертывания

Expand Down
24 changes: 0 additions & 24 deletions docs/pages_ru/usage/deploy/releases.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,30 +58,6 @@ werf converge --release backend-production # или $WERF_RELEASE=...

Вручную отформатировать любую строку согласно формату RFC 1123 Label Names можно командой `werf slugify -f helm-release`.

## Добавление в релиз уже существующих в кластере ресурсов

werf не позволяет развернуть новый ресурс релиза поверх уже существующего в кластере ресурса, если ресурс в кластере *не является частью текущего релиза*. Такое поведение предотвращает случайные обновления ресурсов, принадлежащих другому релизу или развернутых без werf. Если все же попытаться это сделать, то отобразится следующая ошибка:

```
Error: helm upgrade have failed: UPGRADE FAILED: rendered manifests contain a resource that already exists...
```

Чтобы добавить ресурс в кластере в текущий релиз и разрешить его обновление, выставьте ресурсу в кластере аннотации `meta.helm.sh/release-name: <имя текущего релиза>`, `meta.helm.sh/release-namespace: <Namespace текущего релиза>` и лейбл `app.kubernetes.io/managed-by: Helm`, например:

```shell
kubectl annotate deploy/myapp meta.helm.sh/release-name=myapp-production
kubectl annotate deploy/myapp meta.helm.sh/release-namespace=myapp-production
kubectl label deploy/myapp app.kubernetes.io/managed-by=Helm
```

... после чего перезапустите развертывание:

```shell
werf converge
```

Результат: ресурс релиза `myapp` успешно обновил ресурс `myapp` в кластере и теперь ресурс в кластере является частью текущего релиза.

## Автоматическое аннотирование выкатываемых ресурсов релиза

werf автоматически выставляет следующие аннотации всем ресурсам чарта в процессе развёртывания:
Expand Down