Розгортання K2 ERP: відмінності між версіями

Поточна версія на 19:11, 2 травня 2026

5. Коміт змін на віддалений Git-репозиторій

bash run.sh

Запушити зміни на віддалений репозиторій:

<syntaxhighlight lang="text">

=== конфігурація token. 6.3.txt ===

git add . Четверта помилка — працювати з компонентами без Git або без перевірки git status.<syntaxhighlight lang="text">

* [[K2 ERP]]
* [[K2 Cloud ERP]]
* [[Архітектура K2 ERP]]
* [[Розгортання K2 ERP]]
* [[Партнерська хмара K2]]
* [[Магазин доповнень K2]]
* [[Сертифікація K2]]
* [[Партнерська програма K2]]
* [[Впровадження ERP]]
* [[Навчання ERP]]
* [[Міграція з 1С]]
* [[Міграція з BAS]]
* [[Українська ERP]]
* [[Українське програмне забезпечення]]

<syntaxhighlight lang="bash">

cat ~/.ssh/id_rsa.pub

[[Категорія:Python]]

1.5. Запустити додаток

Закомітити зміни: </syntaxhighlight> ./pycharm.sh source venv/bin/activate

У файл settings.py потрібно додати в словник ключі з потрібними компонентами.

# Скопіювати проєкт по FTP. * У k2cfg.py змінено domain_protocol з https на http.

</syntaxhighlight>

</syntaxhighlight> sudo rm /etc/apt/preferences.d/nosnap.pref

Перейдіть у каталог локального проєкту:

Після завантаження нових версій компонент у систему оновлення версій потрібно оновити змінені компоненти на тестових доменах:

cd auto_update

<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
Після внесення змін у код потрібно перевірити статус:

<syntaxhighlight lang="bash">

Оновити пакети:
і запустити PyCharm:

Для запуску в debug-режимі потрібно скористатися кнопкою запуску в правому верхньому куті PyCharm.

<syntaxhighlight lang="bat">

Показати публічний ключ: </syntaxhighlight>

ssh-keygen -t rsa -b 4096 -C "ваша_електронна_пошта@example.com"

components/k2site

Додати ключ:

git fetch origin

python git_cmd.py commit

Пов’язані сторінки

</syntaxhighlight>

У правому нижньому куті PyCharm потрібно вибрати: version_type = "testing"

Змінити версію компоненти в setup. 7.1.py

Перевірити встановлення: Розгортання системи K2 Cloud ERP Python для розробників — це технічний бізнес-процес, який дає можливість розробнику отримати локальну копію проєкту, налаштувати віртуальне середовище, запустити K2 Cloud ERP, підключити PyCharm, налаштувати Git, працювати з компонентами, комітити зміни та публікувати нові версії компонент у систему оновлень. Потрібно скопіювати каталог зі скриптом і вставити його в корінь проєкту на рівні з виконуваним файлом:

components/k2update

</syntaxhighlight> https://www.jetbrains.com/pycharm/download/?section=windows </syntaxhighlight>

Перший етап — отримати локальну копію вже існуючого робочого проєкту K2 Cloud ERP. * Встановлено PyCharm. * Проєкт запускається через run.sh або run.bat.

=== 3.2. Встановлення Git для Windows ===

* автоматизовано через auto_update;
* вручну через стандартні команди Git. ej2.min.js
Встановити PyCharm Community:

<syntaxhighlight lang="text">

Запушити зміни на віддалений репозиторій:
'''Головна ідея:''' ця інструкція потрібна не кінцевому користувачу ERP, а розробнику або технічному партнеру K2, який має локально запустити K2 Cloud ERP, підключити компоненти, працювати з Git і готувати зміни до системи оновлень.<syntaxhighlight lang="bash">

<syntaxhighlight lang="text">

<syntaxhighlight lang="bash">

Потрібно відкрити файл:

Для Windows:

./pycharm.sh </syntaxhighlight> Після цього потрібно запустити SSH-agent:

</syntaxhighlight>

ssh-add ~/.ssh/id_rsa

cd auto_update

cd k2

https://git-scm.com/downloads/win

git pull origin main

Додати віддалений репозиторій:

Для stable-версії:

При подальшій роботі потрібно отримувати зміни з віддаленого репозиторію командою:

git checkout master

.\venv\Scripts\activate </syntaxhighlight>

3.1. Встановлення Git для Linux

Передумови

SEO-призначення сторінки

sudo apt install git .gitignore

</syntaxhighlight>

domain_protocol = "https"

Для ручного підключення однієї компоненти потрібно перейти в папку потрібної компоненти.</syntaxhighlight>

git checkout -b main

Для створення SSH-ключа потрібно виконати команду:

Після копіювання на локальному комп’ютері має з’явитися каталог: </syntaxhighlight> Приклад:

Після завантаження потрібно розпакувати архів, перейти в папку:

Після відкриття проєкту потрібно налаштувати змінне середовище для поточного проєкту. # Оновити компоненти на deb1, deb2, deb3. * Перевірено git status. # Налаштувати Python Interpreter на локальний venv. # Підключити потрібні компоненти через auto_update або вручну. * Зміни закомічено й запушено. # Виконати first_run.sh або first_run.bat. # Перевірити git status. як приклад, для k2site:

Зміни можна комітити двома способами:

Клонувати компоненти з віддаленого сервера:

Для роботи з кодом K2 Cloud ERP рекомендується використовувати PyCharm. * Налаштовано SSH-ключ або інший спосіб авторизації. Після завантаження потрібно розпакувати архів або запустити файл встановлення та встановити PyCharm згідно з інструкціями інсталятора. version = "2.0.4.43"

2.2. Встановлення PyCharm для Linux через архів

2.5. конфігурація Python Interpreter

sudo apt update

sudo apt install snapd

3.5. конфігурація SSH-ключа

У полі Base Interpreter потрібно додати шлях до поточного виконуваного Python-файлу. # Запустити проєкт через run.sh або run.bat. Якщо IDE використовує не той venv, залежності можуть не збігатися з проєктом. # Відкрити проєкт у PyCharm.

робочий комп’ютер на Linux або Windows;
доступ до FTP;
Python-середовище, яке застосовується для проєктом;
PyCharm Community або іншу сумісну IDE;
Git;
SSH-ключ або логін і пароль для репозиторію;
доступ до тестових доменів deb1, deb2, deb3;
токен доступу до сервера оновлення версій. Для Linux:

python git_cmd.py push components/k2adm /K2CloudERP/cfg/k2/k2/k2cfg.py

Для Linux:

Приклад для Windows: bash run.sh python git_cmd.py clone

git status

4.2. Підключення однієї компоненти вручну

Потрібно скопіювати з віддаленого сервера існуючий проєкт по FTP. # Налаштувати SSH-ключ або інший спосіб авторизації. Через це можуть виникати конфлікти або втрата актуального коду. # Виконати python k2update_push.py.=== 5.1. Коміт змін через auto_update ===

Створити локальну гілку main і перемкнутися на неї:

[[Категорія:Українське програмне забезпечення]]

builder/config

<syntaxhighlight lang="bat">

Перевірити зміни локально скопійованої копії проєкту з віддаленим репозиторієм:
sudo apt install default-jdk

Для Windows:

<syntaxhighlight lang="text">
<syntaxhighlight lang="python">

builder/config/token.txt

Перша помилка — не виконати first_run після копіювання проєкту. Це ускладнює контроль змін. cd /K2CloudERP у корені каталогу компоненти. Приклад вмісту:

3. Встановлення та конфігурація Git

1.3. Виконати перший запуск

</syntaxhighlight>

Сьома помилка — завантажити компоненту на сервер оновлення версій й не перевірити її на тестових доменах deb1-deb3.[[Категорія:Українська ERP]]

Вона покриває запити: “K2 Cloud ERP Python розгортання”, “локальне розгортання K2 ERP”, “K2 ERP для розробників”, “first_run.sh K2”, “run.sh K2 ERP”, “PyCharm K2 Cloud ERP”, “Git компоненти K2 ERP”, “auto_update K2”, “k2update_push.py”, “сервер оновлень K2”, “deb1 deb2 deb3 K2”.<syntaxhighlight lang="bash">

bin

Коротко

Приклад для Linux:

</syntaxhighlight> У цей файл потрібно додати файли й папки, які не потрібно завантажувати на сервер оновлення версій. Можливі два варіанти авторизації:

git config --global user.email "ваша_електронна_пошта@example.com"

5.2. Коміт змін вручну

7.4. Завантажити компоненти на сервер оновлення версій

Приклад:

python git_cmd.py clone Потрібно завантажити архів PyCharm для Linux із сайту JetBrains:

Це потрібно для локального запуску проєкту в режимі розробки. * Виконано first_run.sh або first_run.bat.

Для testing/beta-версії:
так само потрібно вказати тип версії. Встановити Git:

Далі вибрати:

Сторінка '''Розгортання системи K2 Cloud ERP Python для розробників''' має допомагати розробникам, технічним партнерам і командам впровадження знаходити повну інструкцію з локального запуску K2 Cloud ERP, конфігурація PyCharm, Git, компонентів, сервера оновлень і тестових доменів.=== Додати SEO-опис змін у history. 7.2.txt ===
Повний список компонент можна дивитися у файлі:

Ця команда завантажує в систему оновлення версій компоненти, вказані у списку. * Налаштовано builder/config/component-list.txt. * Виконано python k2update_push.py.<syntaxhighlight lang="text">
Мета цього етапу — перевірити, що нова реліз системи компоненти:
<syntaxhighlight lang="bash">

Для завантаження компонент на сервер оновлення версій потрібно налаштувати конфігурацію в каталозі:

Отримати інформаційні дані з віддаленого репозиторію та автоматизовано об’єднати їх із поточною локальною гілкою:
<syntaxhighlight lang="bash">
Після завантаження потрібно розпакувати архів або запустити файл встановлення та встановити Git згідно з інструкціями.

</syntaxhighlight> Приклад:

Контрольний чек-лист розробника

Потрібно відкрити файл:

</syntaxhighlight>

</syntaxhighlight> git push так само бажано заздалегідь підготувати:

git init

6.2. конфігурація ignore для компонент

git status </syntaxhighlight> domain_protocol = "http"

builder/config/ignore

У файл:

</syntaxhighlight> </syntaxhighlight>

</syntaxhighlight>

Оновити пакети:

</syntaxhighlight> </syntaxhighlight> Компоненти K2 можна підключати двома способами:

Після встановлення бажано перевірити Git у консолі:

cd components/k2site
Після конфігурація потрібно виконати команду для клонування актуальних версій компонент і перейменування каталогів поточних версій компонент:
git --version
=== 2.6. Запуск проєкту в debug-режимі ===
Встановити snapd:
https://www.jetbrains.com/pycharm/download/?section=linux

<syntaxhighlight lang="bash">

Див. так само

sudo apt update </syntaxhighlight>

[[Категорія:Корпоративна Wiki]]

== 6. конфігурація завантаження компонент на сервер оновлення версій ==

settings_example.py

</syntaxhighlight>

конфігурація component-list. 6.1.txt

Для Windows потрібно завантажити PyCharm із сайту JetBrains:

За потреби можна перемкнутися на іншу локальну гілку, як приклад master:

Для Windows:

<syntaxhighlight lang="bash">
== Типові помилки під час локального розгортання ==
builder/config/component-list.txt

builder/config/component-list.txt

bash first_run.sh

<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
k2site.txt

=== 3.4. Авторизація в Git ===

== Рекомендований порядок роботи розробника ==
провідний результат інструкції — правильна технічна дисципліна розробника K2: локальний запуск, окремий venv, контроль Git, робота з компонентами, версіонування, сервер оновлень і обов’язкове тестування на deb1-deb3 перед використанням змін у ширшому середовищі. # Змінити domain_protocol з https на http.[[Категорія:Магазин доповнень K2]]

git commit -m "Назва комміту"

Для створення нової версії компоненти потрібно підготувати її як stable або beta/testing-версію.<syntaxhighlight lang="text">

./run.bat

Якщо під час запуску виникла помилка, потрібно встановити JRE/JDK:

</syntaxhighlight>

history.txt

Третя помилка — підключити в PyCharm неправильний Python Interpreter. * Відкрито локальний проєкт у PyCharm. # Налаштувати ignore для компонент. Для Linux:

Проєкт скопійовано по FTP. git remote add origin http://git.corp2.eu/k2erp/python/k2/base/site/k2site.git

git pull

4. Підключення віддаленого Git-репозиторію для компоненти або списку компонент

на:

Отримати інформаційні дані з віддаленого репозиторію, але не змінювати поточну робочу гілку:
У файлі потрібно змінити версію в полі version. Перший запуск потрібен для конфігурація параметрів віртуального середовища в поточному локальному розташуванні. * Налаштовано ignore для компонент. .git

Перевірити підключений remote:
python git_cmd.py status
У цьому файлі потрібно додати список компонент, які будуть завантажуватися на сервер оновлення версій. # Протестувати функції ERP.[[Категорія:K2 Cloud ERP]]

/K2CloudERP

=== 2.7. Ручна активація віртуального середовища ===

* відкрити PyCharm;
* вибрати відкриття існуючого проєкту;
* відкрити локально завантажений каталог K2CloudERP. * Підключено потрібні компоненти через auto_update або вручну.<syntaxhighlight lang="bat">

<syntaxhighlight lang="python">

Запустити PyCharm:

Після того як компоненти додані в:

<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
=== 1.2. Перейти в каталог проєкту ===

<syntaxhighlight lang="bash">

</syntaxhighlight>

== 7. Завантаження нової версії компоненти в систему оновлення версій ==

<syntaxhighlight lang="text">

Потрібно вказати email:
../K2CloudERP/venv/bin/python3.12
Для Linux:

Шоста помилка — оновити версію компоненти в setup.py, але забути SEO-опис змін у history.txt. Отримати зміни з віддаленого сервера:
Після оновлення версій потрібно протестувати функції ERP. У такому разі віртуальне середовище здатна залишитися прив’язаним до старого шляху. * Налаштовано Python Interpreter на локальний venv.<syntaxhighlight lang="text">

У першому рядку потрібно додати SEO-опис змін. потрібно додати токен доступу до сервера оновлення версій. * Додано токен у token.txt. Окремо варто відзначити перший запуск, конфігурація конфігурації, відкриття проєкту в PyCharm, підключення Python Interpreter, встановлення Git, авторизацію через SSH, підключення репозиторіїв компонентів, роботу зі скриптом auto_update, коміт змін, конфігурація завантаження компонент на сервер оновлення версій, створення нової версії компоненти і тестування на доменах deb1-deb3. це технічна інструкція для підготовки локального робочого середовища розробника забезпечується через '''Розгортання системи K2 Cloud ERP Python; так само реалізовано який функціонує з проєктом [[K2 Cloud ERP]] на Python виступає ключовою рисою розробників'''. Через це локальний запуск здатна працювати некоректно. * Налаштовано user.name і user.email. # Внести зміни в код.

Add new Interpreter settings.py

1. Копіювання існуючого проєкту по FTP і перший запуск

Python Interpreter

1.4. Змінити протокол домену в конфігурації

</syntaxhighlight>

У папці:

Створити коміт:
python git_cmd.py pull
<syntaxhighlight lang="bash">

Перевірити конфігурація можна командою:

як приклад: Ініціалізувати Git у поточній директорії:

Після цього локальний додаток K2 Cloud ERP має запуститися в робочому середовищі розробника. У цьому файлі потрібно змінити значення параметра:

Для списку компонент застосовують, коли потрібно скрипт auto_update.=== 2.3. Встановлення PyCharm для Windows ===

Після копіювання потрібно відкрити проєкт у консолі й перейти в каталог:

version_type = "stable"

Цей токен застосовується для для авторизації під час завантаження компонент. * Оновлено версію в setup.py. # Додати SEO-опис змін у history.txt.[[Категорія:Розробка K2 ERP]]

Потрібно відкрити проєкт у консолі й перейти в каталог: git config --global user.name "Ваше Ім'я"

</syntaxhighlight>

Потрібно відкрити файл: </syntaxhighlight> у корені каталогу компоненти.=== 7.3. Перейти в корінь додатку ===

* коректно встановлюється;
* не ламає наявний функції ERP;
* сумісна з поточним середовищем;
* не створює помилок у залежних модулях;
* функціонує відповідно до опису змін у history.txt.

2. Встановлення PyCharm і відкриття проєкту

Потрібно вказати ім’я користувача:

4.1. Підключення списку компонент через auto_update

</syntaxhighlight>

[[Категорія:PyCharm]]

Приклад:
<syntaxhighlight lang="bash">
Кожна компонента додається з нового рядка.

потрібно створити файл із назвою компоненти. # Налаштувати builder/config/component-list.txt.== 8. оновлення версій компонент на тестових доменах deb1-deb3 == </syntaxhighlight>

П’ята помилка — пушити зміни без попереднього pull.

pycharm-community

Після конфігурація інтерпретатора PyCharm має використовувати віртуальне середовище саме цього локального проєкту. # Оновити версію в setup.py. Після цього повторити запуск:

* автоматизовано через скрипт auto_update;
* вручну для однієї конкретної компоненти.=== 2.4. Відкриття проєкту в PyCharm ===
<syntaxhighlight lang="bash">
git --version

Далі потрібно відкрити файл:

Додати зміни:
Після активації середовища команди Python і pip будуть виконуватися в межах локального venv цього проєкту.<syntaxhighlight lang="bash">

* авторизація за допомогою логіна і пароля;
* авторизація через SSH. Інструкція описує повний базовий цикл: копіювання існуючого проєкту з віддаленого сервера.

Git потрібен для роботи з компонентами K2, отримання змін із віддалених репозиторіїв, фіксації локальних змін і публікації змін у віддалений репозиторій. 2.0.4.43 - додавання додаткового поля в форму реєстрації потрібно виконати команду:

./first_run.bat

2.1. Встановлення PyCharm для Linux через snap

Для Windows потрібно завантажити Git: git config --global --list

</syntaxhighlight>

3.3. конфігурація користувача Git

Потрібно перейти в корінь додатку на рівні з виконуваним файлом app.py.</syntaxhighlight>

https://git.corp2.eu/k2erp/python/k2/base/client/auto_update

deb1;
deb2;
deb3. * Git встановлено. # Додати токен у token.txt.SEO title: Розгортання системи K2 Cloud ERP Python для розробників — локальний запуск, PyCharm, Git, компоненти та сервер оновлень

SEO keywords: K2 Cloud ERP Python, розгортання K2 Cloud ERP, K2 ERP для розробників, локальне розгортання K2 ERP, PyCharm K2 ERP, Git K2 ERP, auto_update K2, компоненти K2 ERP, k2update_push.py, first_run.sh, first_run.bat, run.sh, run.bat, сервер оновлень K2, deb1 deb2 deb3, українська ERP, K2 ERP

</noinclude>
 {{SEO
Шаблон для службового SEO-опису сторінки.

}}

setup.py

Після першого запуску потрібно перейти у файл налаштувань:

Для Windows:

так само можна запускати проєкт із консолі PyCharm. * Додано SEO-опис змін у history.txt.

[[Категорія:Розгортання K2 ERP]]
python k2update_push.py

Після встановлення потрібно:

[[Категорія:Компоненти K2 ERP]]

<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
sudo snap install pycharm-community --classic

=== 1.1. Скопіювати проєкт з віддаленого сервера ===

Друга помилка — не змінити domain_protocol з https на http для локальної роботи. # Встановити й налаштувати Git. # Закомітити й запушити зміни. * Компоненти перевірено на deb1, deb2, deb3. app.py

eval "$(ssh-agent -s)"

./run.bat Спочатку потрібно видалити обмеження для snap, якщо воно виступає як:

Перевірити статус:

Перед початком розгортання розробнику потрібно мати доступ до існуючого проєкту K2 Cloud ERP на віддаленому сервері, FTP-доступ для копіювання файлів, доступ до репозиторіїв Git, права на роботу з потрібними компонентами та технічні параметри для сервера оновлень, якщо планується публікація нових версій компонент. __pycache__

</syntaxhighlight> git remote -v

Отриманий ключ потрібно скопіювати й додати у віддалений Git-репозиторій.<syntaxhighlight lang="text">

sudo apt update

У полі Location потрібно додати шлях до поточної папки venv. ..\K2CloudERP\venv\Scripts\python.exe Репозиторій скрипта: