[EDP-DDM-0000] updated special-steps.adoc

Change-Id: Idcd5b0229fbb1a0fa58e93cfcfac5e4708591bca
(cherry picked from commit 2fe2a76216d0cb28c25e9606082816bb2453ed08)

docs/ua/modules/admin/pages/update/special-steps-for-update/special-steps.adoc

@@ -36,6 +36,14 @@ IMPORTANT: Виправлення стосується лише реєстрів
 
 image:admin:infrastructure/special-steps/special-steps-1-9-6-1.png[image,width=467,height=271]
 
+=== Встановлення актуального розміру диска Nexus для control-plane-nexus
+
+WARNING: Ця інструкція стосується кластерів, що оновлюються _НЕ_ через пайплайн *platform-deploy* у Jenkins CICD2.
+
+Якщо розмір вашого диска Nexus у проєкті *`control-plane-nexus`* відрізняється від стандартних `100GB`, необхідно встановити актуальний розмір диска.
+
+Для цього у конфігураційному файлі  _repositories/components/infra/control-plane-nexus.git/deploy-templates/values.gotmpl_ встановіть значення параметра *`nexus.storage.size`*, яке дорівнює вашому поточному розміру диска.
+
 [#update-platform]
 == Оновлення Платформи
 
@@ -220,8 +228,6 @@ soap-api-core-base-image-1-9-6-hotfix:1.9.4-1.9.6-HOTFIX-SNAPSHOT.1
 
 Застосуйте наступні hotfix-образи для відповідних компонентів реєстру у _helmfile.yaml_ реєстру.
 
-TIP: Завантажити образи можна за посиланням: https://hub.docker.com/u/uss2jelastic[].
-
 bpms: ::
 +
 [source,text]
@@ -243,6 +249,135 @@ common-web-app: ::
 1.9.6-MDTUDDM-27852-HOT-FIX-SNAPSHOT.3
 ----
 
+=== Послідовність роботи з `pull` і `push` хотфікс-образів
+
+[NOTE]
+Завантажити образи можна за посиланням: https://hub.docker.com/u/uss2jelastic[]. Для цього потрібно мати встановлений Docker https://docs.docker.com/engine/install/[].
+
+Послідовність роботи з `pull` і `push` хотфікс-образів:
+
+. Виконайте `pull`.
++
+----
+docker pull <your-repo-name>/<image-name>:tag
+----
++
+Наприклад:
++
+----
+docker pull uss2jelastic/kafka-api-core-base-image-1-9-6-hotfix
+----
++
+TIP: У *Dockerhub* кожний репозиторій надає приклад, як робити `pull`.
++
+image:admin:infrastructure/special-steps/special-steps-1-9-6-13.png[]
+
+. Після `pull` на локальну машину, змініть тег образа.
++
+----
+docker image tag <your-repo-name>/<image-name>:tag localregistry:5000/control-plane/<image-name>:tag
+----
++
+.Список тегів для хотфіксів даного релізу
+----
+docker image tag uss2jelastic/model-core-base-image-1-9-6-hotfix:1.9.4-1.9.6-HOTFIX-SNAPSHOT.1 localregistry:5000/control-plane/model-core-base-image-1-9-6-hotfix:1.9.4-1.9.6-HOTFIX-SNAPSHOT.1
+docker image tag uss2jelastic/kafka-api-core-base-image-1-9-6-hotfix:1.9.4-1.9.6-HOTFIX-SNAPSHOT.1 localregistry:5000/control-plane/kafka-api-core-base-image-1-9-6-hotfix:1.9.4-1.9.6-HOTFIX-SNAPSHOT.1
+docker image tag uss2jelastic/rest-api-core-base-image-1-9-6-hotfix:1.9.6-1.9.6-HOTFIX-SNAPSHOT.1 localregistry:5000/control-plane/rest-api-core-base-image-1-9-6-hotfix:1.9.6-1.9.6-HOTFIX-SNAPSHOT.1
+docker image tag uss2jelastic/soap-api-core-base-image-1-9-6-hotfix:1.9.4-1.9.6-HOTFIX-SNAPSHOT.1 localregistry:5000/control-plane/soap-api-core-base-image-1-9-6-hotfix:1.9.4-1.9.6-HOTFIX-SNAPSHOT.1
+docker image tag uss2jelastic/bpms-1-9-6-hotfix:1.9.7-1.9.6-HOTFIX-SNAPSHOT.1 localregistry:5000/control-plane/bpms-1-9-6-hotfix:1.9.7-1.9.6-HOTFIX-SNAPSHOT.1
+docker image tag uss2jelastic/dataplatform-jenkins-agent-1-9-6-hotfix:1.9.6-1.9.6-HOTFIX-SNAPSHOT.5 localregistry:5000/control-plane/dataplatform-jenkins-agent-1-9-6-hotfix:1.9.6-1.9.6-HOTFIX-SNAPSHOT.5
+docker image tag uss2jelastic/common-web-app-master:1.9.6-MDTUDDM-27852-HOT-FIX-SNAPSHOT.3 localregistry:5000/control-plane/common-web-app-master:1.9.6-MDTUDDM-27852-HOT-FIX-SNAPSHOT.3
+----
+
+. Після встановлення тегу виконайте `push`.
+
+.. Виконайте вхід до Платформи за допомогою `oc cli`. Токен можна отримати через Openshift-консоль, у секції *Copy login command*.
++
+image:admin:infrastructure/special-steps/special-steps-1-9-6-14.png[]
+
+.. Якщо ви користуєтеся Windows, то внесіть наступний запис до файлу _C:\Windows\System32\drivers\etc\hosts_, якщо linux -- то запис потрібно зробити в _/etc/hosts_.
++
+----
+127.0.0.1 localregistry
+----
+
+.. Відкрийте декілька терміналів, в одному переадресуйте порти на под `nexus`, який можна знайти у проєкті `control-plane-nexus` в *Openshift* > *Workloads* > *Pods*.
++
+----
+oc port-forward <nexus-pod-name> 5000:5000 -n control-plane-nexus
+----
+
+.. Виконайте вхід в `nexus`.
++
+TIP: Пароль можна знайти у секреті *nexus-admin-password* проєкту `control-plane-nexus`.
++
+----
+docker login -u admin -p <secret-password> localregistry:5000
+----
+
+.. Переконайтеся, що вхід успішний. Після цього можна виконати `push`. Це може зайняти певний час.
++
+NOTE: Пам'ятайте, що в іншому терміналі повинна бути активною переадресація портів.
++
+----
+docker push localregistry:5000/control-plane/image_name:tag
+----
+
+.. Після цього ваш образ з'явиться в `nexus`. Туди можна перейти через *Openshift* > *Networking* > *Routes* > *`nexus`* у проєкті `control-plane-nexus`. Всі образи знаходяться у *Browse* > *docker-registry*.
++
+image:admin:infrastructure/special-steps/special-steps-1-9-6-15.png[]
+
+. Застосуйте необхідні `nexus`-образи до реєстру.
++
+У `control-plane-gerrit` знайдіть репозиторій реєстру і в його гілці `master` внесіть зміни до файлу _deploy-templates/helmfile.yaml_. При зміні образа вкажіть версію і шлях до папки з образом, як в `nexus`:
+
+bpms: ::
++
+image:admin:infrastructure/special-steps/special-steps-1-9-6-16.png[]
+
+common-web-app: ::
++
+image:admin:infrastructure/special-steps/special-steps-1-9-6-17.png[]
+
+dataplatform-jenkins-agent: ::
++
+image:admin:infrastructure/special-steps/special-steps-1-9-6-18.png[]
+
++
+[%collapsible]
+._Приклад deploy-templates/helmfile.yaml для компонента dataplatform-jenkins-agent_
+====
+[source,yaml]
+----
+- name: dataplatform-jenkins-agent
+  namespace: '{{ env "NAMESPACE" }}'
+  labels:
+    type: remote
+    update_scc: false
+    repoURL: ssh://[email protected]:32114/mdtu-ddm/data-architecture/devops-application/dataplatform-jenkins-agent.git
+    path: components/registry/
+    branch: 1.9.6.24
+  chart: /opt/repositories/dataplatform-jenkins-agent/deploy-templates
+  version: 1.9.6-1.9.6-HOTFIX-SNAPSHOT.2
+  values:
+  - values.yaml
+  - values.gotmpl
+  - image:
+      name: '{{ env "edpComponentDockerRegistryUrl" }}/{{ env "globalEDPProject" }}/dataplatform-jenkins-agent-1-9-6-hotfix'
+      version: 1.9.6-1.9.6-HOTFIX-SNAPSHOT.2
+  missingFileHandler: Warn
+  needs:
+  - '{{ env "NAMESPACE" }}/istio-configuration'
+  - '{{ env "NAMESPACE" }}/network-management'
+  - '{{ env "NAMESPACE" }}/keycloak-operator'
+  - '{{ env "NAMESPACE" }}/gerrit-operator'
+  - '{{ env "NAMESPACE" }}/jenkins-operator'
+  - '{{ env "NAMESPACE" }}/registry-configuration'
+----
+====
+
+NOTE: У цьому релізі при зміні образу гілки міняти НЕ ПОТРІБНО.
+
 WARNING: Після встановлення хотфіксів потрібно перезібрати модель даних реєстру.
 
 == Відомі проблеми