Skip to content

Commit

Permalink
fix(docs): Add 1.1 adoption notice about release existance
Browse files Browse the repository at this point in the history
Signed-off-by: Timofey Kirillov <timofey.kirillov@flant.com>
  • Loading branch information
distorhead committed May 24, 2022
1 parent 4a25681 commit 2f81633
Show file tree
Hide file tree
Showing 2 changed files with 4 additions and 0 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -133,6 +133,8 @@ NOTE that `WERF_THREE_WAY_MERGE_MODE` setting does not affect resources adoption

#### Three way merge patches and adoption

**NOTE** In the 1.1 version it is possible to adopt resource only into the release, which was successfully deployed into the cluster. It is impossible to adopt a resource into the release during this release first installation. This is related to the limitations of release storage mechanics used in the helm 2. This problem was fixed in the helm 3 and werf 1.2. So in 1.1 version to adopt resource one must first successfully deploy release without this resource, then perform adoption procedure as described below.

Three way merge patches are always used when adopting already existing resource into the release (`WERF_THREE_WAY_MERGE_MODE` setting does not affect resources adopter).

**NOTE** After adoption live resource manifest may not fully match resource manifest in the chart. In the cases when additional fields are defined in the live resource — these fields will not be deleted and stay in the live resource version.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -135,6 +135,8 @@ kubectl -n mynamespace patch cm/myconfigmap '{"data":{"node.conf":"PROPER CONTEN

#### Патчи трехстороннего слияния и принятие ресурса

**ЗАМЕЧАНИЕ** В версии 1.1 принятие ресурса возможно лишь в релиз, который уже был успешно задеплоен в кластер. Нет возможности принять ресурс в релиз, который вновь создаётся, это связано с техническими ограничениями механизма хранения релизов в helm 2. Данная проблема была решена в helm 3 и в версии werf 1.2. Таким образом для версии 1.1, чтобы принять ресурс в релиз сначала необходимо **успешно** задеплоить релиз без этого ресурса, а уже затем выполнить все описанние ниже действия.

При принятии существующего ресурса в релиз, всегда используются патчи трехстороннего слияния (параметр `WERF_THREE_WAY_MERGE_MODE` не влияют на это поведение).

**ЗАМЕЧАНИЕ** После принятия ресурса его действующий манифест может не полностью соответствовать конфигурации ресурса в чарте.
Expand Down

0 comments on commit 2f81633

Please sign in to comment.