Розгортання K2 ERP
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. Запустити додаток
- K2 ERP
- K2 Cloud ERP
- Розгортання K2 ERP
- Архітектура K2 ERP
- Магазин доповнень K2
- Сертифікація K2
- Партнерська програма K2
- Українська ERP
Закомітити зміни: </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>
</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>
</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">
<syntaxhighlight lang="bash">
sudo apt update
У полі Location потрібно додати шлях до поточної папки venv. ..\K2CloudERP\venv\Scripts\python.exe Репозиторій скрипта: