Встановлення K2 ERP
6. конфігурація завантаження компонент на сервер оновлення версій
Потрібно скопіювати каталог зі скриптом і вставити його в корінь проєкту на рівні з виконуваним файлом:
Після цього потрібно розпакувати архів, запустити файл встановлення та встановити PyCharm згідно з інструкціями інсталятора. Окремо варто відзначити які отримують існуючий проєкт K2 Cloud ERP, запускають його локально, підключають віртуальне середовище, працюють із компонентами і передають зміни через Git і систему оновлення версій. Далі потрібно ініціалізувати Git у поточній директорії:
Для роботи зі списком компонент застосовується для скрипт:
Під час подальшої роботи зміни з віддаленого репозиторію отримуються командою:
git commit -m "Назва комміту"
Приклад:
Після встановлення PyCharm запускається командою:
git fetch origin git status
<pre>
Для Windows: Для створення SSH-ключа потрібно виконати команду: cat ~/.ssh/id_rsa.pub
Для роботи з компонентами потрібно встановити й налаштувати Git. |- | 4 | Підключаються віддалені репозиторії компонент через auto_update або вручну. Кожна компонента додається з нового рядка.
Для створення нової версії компоненти, stable або beta/testing, потрібно змінити версію у файлі:
Посилання на каталог:
deb3 git remote add origin http://git.corp2.eu/k2erp/python/k2/base/site/k2site.git [[Категорія:Встановлення K2 ERP]] sudo apt install default-jdk python git_cmd.py clone
python k2update_push.py settings.py Для Linux: git pull origin main Далі потрібно додати віддалений репозиторій: pycharm-community Для Windows застосовується для команда: <pre> Щоб отримати інформаційні дані з віддаленого репозиторію та автоматизовано об’єднати їх із поточною локальною гілкою, застосовується для команда: це інструкція з локального запуску робочого проєкту [[K2 Cloud ERP]] забезпечується через '''Розгортання K2 Cloud ERP Python; так само реалізовано підключення середовища розробника, конфігурація [[PyCharm]], роботи з [[Git]], підключення репозиторіїв компонент і завантаження нових версій компонент у систему оновлення версій виступає ключовою рисою розробників'''. Далі потрібно перейти в корінь додатку, на рівні з виконуваним файлом: === Відкриття проєкту в PyCharm ===
https git remote -v <pre> === Ручний коміт змін === <pre> <pre> <pre> .git
Якщо під час запуску виникає помилка, потрібно встановити JRE/JDK командами: Після встановлення потрібно відкрити середовище розробки PyCharm.[[Категорія:K2 ERP Python]] Для Linux: <pre> __pycache__ <pre>
../K2CloudERP/venv/bin.python3.12.exe
Після конфігурація інтерпретатора можна запускати проєкт у debug-режимі через кнопку у правому верхньому куті PyCharm. |- | 8 | Компоненти оновлюються на тестових доменах deb1-deb3 і тестуються. Значення потрібно змінити з:
setup.py
Після цього потрібно клонувати компоненти з віддаленого сервера: [[Категорія:Хмарна ERP]] <pre> Для Linux застосовується для команда: на: <pre> <pre> |- | 1 | Копіюється існуючий проєкт по FTP, запускається first_run і змінюється domain_protocol з https на http.<pre> python git_cmd.py commit
Авторизація в Git
Потім виконати коміт:
авторизація за допомогою логіна й пароля;
<pre> <pre> <pre> <pre>
cd k2
token.txt
cd auto_update bash run.sh
bash run.sh
4. Підключення віддаленого репозиторію Git для компоненти або списку компонент
sudo apt update
Add new Interpreter
Файл розташований у корені каталогу компоненти. Що робиться
.gitignore
Після завантаження потрібно розпакувати архів, запустити файл встановлення та встановити Git згідно з інструкціями. python git_cmd.py clone
deb2
2. Встановлення середовища розробки PyCharm та відкриття проєкту
Після оновлення версій потрібно протестувати функції ERP. git status
bash first_run.sh
app.py Після завантаження нових версій компонент потрібно оновити змінені версії компонент на тестових доменах:
history.txt
Потім: ./run.bat builder/config/component-list.txt
Отриманий ключ потрібно скопіювати й вставити у віддалений репозиторій.Після цього потрібно відкрити проєкт у консолі й перейти в каталог:
builder/config
python git_cmd.py pull
як приклад, для компоненти k2site: Для Windows потрібно завантажити архів із сайту JetBrains: version
Потрібно змінити рядок 5, поле:
Для Linux можна встановити PyCharm через snap.Підключення репозиторію можна виконувати для списку компонент або для однієї компоненти вручну. Після встановлення потрібно налаштувати ім’я користувача:
sudo apt update
https://git-scm.com/downloads/win Перевірити статус:
Після цього потрібно запустити ssh-agent: <pre> Для Linux застосовується для команда: <pre>
version_type='stable'
Після цього потрібно запушити зміни на віддалений репозиторій:
./first_run.bat і запустити файл: git push Для Windows потрібно завантажити Git за посиланням: Можливі два варіанти авторизації: Потрібно відкрити проєкт у консолі й перейти в каталог: ./pycharm.sh Для Windows: Приклад файлу: [[Категорія:ERP-системи]] <pre> <pre> ej2.min.js <pre> eval "$(ssh-agent -s)" Ця інструкція призначена для розробників. |- | 6 | Налаштовується список компонент для завантаження на сервер оновлення версій. |- | 5 | Комітяться та пушаться зміни через auto_update або вручну. |- | 3 | Встановлюється Git, налаштовується користувач системи і SSH-ключ. |- | 2 | Встановлюється PyCharm, відкривається проєкт і налаштовується Python Interpreter.<pre> <pre> Спочатку потрібно виконати команди: https://www.jetbrains.com/pycharm/download/?section=windows так само PyCharm можна встановити через завантаження архіву з офіційного сайту JetBrains: cd auto_update === конфігурація SSH-ключа === Після завантаження архів потрібно розпакувати, перейти в папку: components/k2adm sudo apt install snapd === Встановлення Git у Linux === venv .\venv\Scripts\activate Далі потрібно відкрити поточний завантажений проєкт K2 Cloud ERP і налаштувати змінне середовище для цього проєкту. Після цього потрібно завантажити компоненти, додані у файлі: auto_update Для Linux: git checkout master Після внесення змін у коді потрібно перевірити їх командою: <pre> === Підключення списку компонент через auto_update === <pre> git config --global user.name "Ваше Ім'я" ssh-add ~/.ssh/id_rsa === Встановлення PyCharm у Linux через snap === [[Категорія:Компоненти K2 ERP]] [[Категорія:K2 ERP]] або testing-версію: <pre> 2.0.4.43 - додавання додаткового поля в форму реєстрації domain_protocol Спочатку потрібно скопіювати з віддаленого сервера існуючий проєкт по FTP. так само проєкт можна запускати з консолі PyCharm. |- |
7 | Створюється нова реліз системи компоненти й завантажується через k2update_push.py. ssh-keygen -t rsa -b 4096 -C "ваша_електронна_пошта@example.com"
Після копіювання потрібно перейти в каталог: cd components/k2site SEO-опис змін додається в один рядок. За потреби можна перемкнутися на іншу локальну гілку: <pre> <pre> bin потрібно додати список компонент, які будуть завантажуватися на сервер оновлення версій. У правому нижньому куті PyCharm потрібно вибрати: https://git.corp2.eu/k2erp/python/k2/base/client/auto_update
{{SEO
|title=Розгортання K2 Cloud ERP Python для розробників — локальний запуск, PyCharm, Git, компоненти, оновлення
|description=Інструкція з локального розгортання робочого проєкту K2 Cloud ERP Python для розробників: копіювання проєкту по FTP, перший запуск, налаштування віртуального середовища, запуск K2 Cloud ERP, встановлення PyCharm, налаштування Python Interpreter, встановлення Git, підключення віддалених репозиторіїв компонент, коміт змін, завантаження компонент на сервер оновлення та тестування на deb1-deb3.
|keywords=K2 Cloud ERP Python, розгортання K2 Cloud ERP, встановлення K2 ERP Linux, K2 ERP Python, PyCharm K2 ERP, Git K2 ERP, auto_update K2 ERP, k2update_push.py, компоненти K2 ERP, локальний запуск K2 Cloud ERP, first_run.sh, run.sh, k2cfg.py, Реплікатор K2 ERP, K2 ERP для розробників
}}
<pre>
Далі потрібно відкрити файл:
/K2CloudERP/cfg/k2/k2/k2cfg.py
Виконати коміт змін:
git add .== 8. оновлення версій змінених версій компонент на тестових доменах == Отримати зміни з віддаленого сервера: Для підключення однієї компоненти потрібно перейти в папку потрібної компоненти. Повний список компонент міститься у файлі: Приклад: У папці: 5. Коміт змін на віддалений репозиторій Gitpython git_cmd.py status components/k2update |
Python Interpreter Встановлення PyCharm у Linux через архів із сайту JetBrainsgit pull так само потрібно вказати тип версії: конфігурація користувача GitПриклад: settings_example.py Встановлення Git у WindowsКоманда: == Див. так само == python git_cmd.py push У словник потрібно додати ключі з потрібними компонентами. У цьому каталозі запускається файл першого запуску '''first_run''' для конфігурація параметрів віртуального середовища в поточному локальному розташуванні.<pre> авторизація через SSH.<pre> <pre> Щоб переглянути публічний ключ, застосовується для команда: Приклад вмісту: Після зміни налаштувань можна запускати додаток. потрібно додати токен доступу до сервера оновлення версій. Після цього потрібно додати SEO-опис змін у файл: Перевірити підключений репозиторій: Ручна активація віртуального середовищаЗапушити зміни на віддалений репозиторій: Для розробки застосовують, коли потрібно середовище [[PyCharm]].== 7. Завантаження нової версії компоненти в систему оновлення версій == sudo apt update [[Категорія:K2 ERP для розробників]] Далі потрібно додати ключ: <pre> У полі '''Location''' потрібно додати шлях до поточної папки: https://www.jetbrains.com/pycharm/download/?section=linux http <pre> version=2.0.4.43 потрібно створити файл із назвою компоненти та додати в нього файли й папки, які не потрібно завантажувати на сервер оновлення версій. git init У файлі: Після цього потрібно перейти у файл налаштувань: Після цього потрібно отримати інформаційні дані з віддаленого репозиторію, але не змінювати поточну робочу гілку: Коміт змін можна виконувати автоматизовано через скрипт auto_update або вручну. так само потрібно налаштувати email: Коротко[[Категорія:K2 Cloud ERP]] git checkout -b main <pre> <pre> Далі потрібно додати зміни: === Встановлення PyCharm у Windows === <pre> У файлі: source venv/bin/activate 3. Встановлення та конфігурація GitПриклад: ignore app.py Тестування має підтвердити, що нові версії компонент працюють коректно, не ламають існуючі сценарії й можуть бути використані далі. deb1 component-list.txt Підключення однієї компоненти вручнуversion_type='testing' components/k2site sudo snap install pycharm-community --classic Файл розташований у корені каталогу компоненти. Етап Для конфігурація завантаження компонент на сервер оновлення версій потрібно відкрити папку: sudo apt install git <pre> <pre> k2site.txt У полі '''Base Interpreter''' потрібно додати шлях до поточного виконуваного Python-файлу. |} == 1. Копіювання існуючого проєкту по FTP і перший запуск == * [[K2 Cloud ERP]] * [[K2 ERP]] * [[K2 Cloud Ядро]] * [[Розгортання K2 ERP]] * [[Встановлення K2 ERP]] * [[K2 ERP для Linux]] * [[PyCharm]] * [[Git]] * [[GitLab]] * [[Розробка K2 ERP]] * [[Компоненти K2 ERP]] * [[Оновлення K2 ERP]] * [[Права доступу K2 ERP]] * [[Безпека ERP]] Створити локальну гілку main і перемкнутися на неї: sudo rm /etc/apt/preferences.d/nosnap.pref Після конфігурація потрібно виконати команду для клонування актуальних версій компонент і перейменування каталогів поточних версій компонент: === Автоматичний коміт через auto_update === git config --global user.email "ваша_електронна_пошта@example.com" Для перевірки змін локально скопійованої копії проєкту порівняно з віддаленим репозиторієм застосовується для команда: /K2CloudERP Для завантаження застосовується для команда: ./run.bat У цьому файлі потрібно змінити параметр: |
|---|