Розгортання системи K2 ERP Python для розробників

Під час подальшої роботи потрібно регулярно отримувати зміни з віддаленого репозиторію:

.git

Завантажити PyCharm можна з офіційної сторінки:

Приклад:

7. Підключення компонент через auto_update

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

критично. Для локальної розробки потрібно перевірити, що domain_protocol змінено з https на http.== Коротко ==

python git_cmd.py pull

sudo apt install default-jdk

Linux:

Для розробки застосовують, коли потрібно середовище '''PyCharm'''.<pre>

<pre>

потрібно додати в словник ключі потрібних компонент.<pre>

<pre>

! sudo apt update

<pre>

<pre>

!

./first_run.bat
git checkout -b main

=== Встановлення PyCharm у Linux з архіву ===

Приклад файлу:

Документ призначений для розробників, які підключаються до Python-версії K2 ERP, працюють із компонентами системи, вносять зміни в код і передають нові версії на сервер оновлень. .gitignore


=== Linux ===

components/k2adm
Створення локальної гілки <code>main</code> і перемикання на неї:


== 14. Тестування на deb1–deb3 ==
token.txt
Порядок дій:

<pre>

Перевірка віддаленого репозиторію:
== 2. Встановлення PyCharm ==

sudo apt install git

git config --global user.name "Ваше Ім'я"

Загальна схема роботи

Після оновлення версій необхідно перевірити функції ERP, який був змінений або залежить від оновленої компоненти. | На тестових доменах deb1, deb2, deb3 |}


* [[K2 Cloud ERP|K2 ERP]]
* [[K2 Cloud ERP Python для розробників|K2 ERP Python для розробників]]
* [[Python]]
* [[PyCharm]]
* [[Git]]
* [[Розгортання системи K2 Cloud ERP PHP|Розгортання системи K2 ERP PHP]]
* [[Розгортання K2 ERP]]
* [[Компоненти K2 ERP]]
* [[Сервер оновлень K2 ERP]]

https://git.corp2.eu/k2erp/python/k2/base/client/auto_update Отриманий публічний ключ потрібно скопіювати та додати у віддалений Git-репозиторій.=== Встановлення PyCharm у Windows === bash run.sh

== Контрольний чек-лист розгортання ==
Коміт змін:

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

builder/config Після завантаження потрібно запустити інсталятор і встановити середовище розробки згідно з інструкціями майстра встановлення. У файлі: Для Windows шлях здатна мати вигляд:

Git потрібен для роботи з репозиторіями компонент K2 ERP, отримання оновлень, комітів і публікації змін.<pre>

* компонента оновилася коректно;
* новий функції ERP функціонує;
* старий функції ERP не зламався;
* помилки не відтворюються;
* зміни можна передавати далі. Якщо компоненти підключені через <code>auto_update</code>, робота виконується з каталогу:


python git_cmd.py push

== 3. Відкриття проєкту в PyCharm ==

У каталозі:

domain_protocol = "https"

У файлі:

sudo snap install pycharm-community --classic git add .=== Ручна активація віртуального середовища ===

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

Windows

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


Приклад:

ssh-add ~/.ssh/id_rsa
Додати зміни:

Запуск ssh-agent:


git status

component-list.txt

== 4. Встановлення Git ==

# відкрити проєкт у PyCharm;
# у правому нижньому куті вибрати '''Python Interpreter''';
# натиснути '''Add New Interpreter''';
# у полі '''Location''' вказати шлях до локальної папки <code>venv</code>;
# у полі '''Base Interpreter''' вказати шлях до виконуваного Python-файлу з поточного віртуального середовища.[[Категорія:Python]]

<pre>

setup.py

/K2CloudERP/cfg/k2/k2/k2cfg.py

pycharm-community


ej2.min.js

git pull

cat ~/.ssh/id_rsa.pub

9. Коміт змін через auto_update


app.py

[[Категорія:Git]]
app.py

Файл так само знаходиться в корені каталогу компоненти. Помилка

Ініціалізація Git у поточній директорії: Клонування компонент: ./run.bat

Після конфігурація інтерпретатора проєкт можна запускати в режимі debug або з консолі PyCharm. Питання

Для локального запуску змінити параметр: cd auto_update


Створити коміт:

deb2

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

Можна використовувати PyCharm Community або іншу редакцію, яка підходить для роботи з Python-проєктами. | PyCharm

Де налаштовується локальний Python? Після конфігурація можна запускати застосунок.


version = "2.0.4.43"

git status

{{DISPLAYTITLE:Розгортання системи K2 ERP Python для розробників}}
<div style="border:3px solid #1565c0; background:#e3f2fd; padding:14px; margin:16px 0;">
! Інакше локальний запуск здатна працювати некоректно. history.txt

=== Linux ===

12. Підготовка нової версії компоненти

Ця команда клонує компоненти та перейменовує каталоги поточних версій компонент.=== Windows === source venv/bin/activate

settings_example.py


Після завантаження потрібно запустити інсталятор і встановити Git згідно з інструкціями. sudo rm /etc/apt/preferences.d/nosnap.pref

<pre>
<pre>
<pre>

<pre>

<pre>

sudo apt install snapd

Linux:

Типові помилки

python git_cmd.py clone

version_type = "testing"

git push

Для тестової версії можна використовувати:

<pre>

Завантажити Git можна зі сторінки:

deb3
sudo apt update
У PyCharm потрібно налаштувати Python Interpreter для поточного проєкту.== 6. конфігурація SSH-ключа ==
Додавання ключа:

Windows:

/K2CloudERP

Для публікації компонент на сервер оновлень застосовується для конфігурація в каталозі: Публікація змін у віддалений репозиторій:

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

domain_protocol = "http"
python k2update_push.py
Приклад переходу:

.\venv\Scripts\activate

<pre>

Тестування має підтвердити, що:

settings.py
cd k2

components/k2update

eval "$(ssh-agent -s)"
[[Категорія:Компоненти K2 ERP]]

<pre>

cd auto_update

Створення SSH-ключа:

Завантаження компонент, зазначених у файлі builder/config/component-list.txt, виконується командою:

Окремо варто відзначити конфігурація Git, роботи з компонентами і публікації оновлень виступає ключовою рисою розробників. Після копіювання потрібно перейти в каталог: Репозиторій скрипта:

Повний приклад доступний у файлі:

Для роботи зі списком компонент можна використовувати скрипт auto_update. | Через auto_update або вручну через Git

Як публікувати зміни? Він адаптує віртуальне середовище до поточного локального розташування проєкту. Що перевірити


'''критично.''' Перед комітом потрібно перевірити <code>git status</code>, щоб випадково не відправити службові файли, локальні конфігурація, тимчасові файли або зайві каталоги. Для клонування актуальних версій компонент виконується команда:

=== Запуск з консолі PyCharm ===

k2site.txt

=== Linux ===
<pre>
git remote -v


</div>
__pycache__
Після встановлення PyCharm потрібно відкрити локально скопійований проєкт K2 ERP. це інструкція з локального запуску робочого проєкту [[K2 ERP]] забезпечується через '''Розгортання системи K2 ERP Python; так само реалізовано підключення середовища розробки.

Спочатку потрібно скопіювати існуючий робочий проєкт K2 ERP з віддаленого сервера по FTP. ! Перевірка статусу: потрібно вказати список компонент, які будуть завантажуватися на сервер оновлень. Відповідь

|-
| 1
| Проєкт скопійовано з віддаленого сервера по FTP
|-
| 2
| Виконано <code>first_run.sh</code> або <code>first_run.bat</code>
|-
| 3
| У <code>k2cfg.py</code> змінено <code>domain_protocol</code> з <code>https</code> на <code>http</code>
|-
| 4
| Проєкт запускається через <code>run.sh</code> або <code>run.bat</code>
|-
| 5
| У PyCharm налаштовано Python Interpreter на локальне <code>venv</code>
|-
| 6
| Встановлено та налаштовано Git
|-
| 7
| Налаштовано SSH або інший спосіб авторизації в репозиторії
|-
| 8
| Підключено потрібні компоненти вручну або через <code>auto_update</code>
|-
| 9
| Перевірено роботу <code>git status</code>, <code>git pull</code>, <code>git push</code>
|-
| 10
| Налаштовано <code>builder/config/component-list.txt</code>
|-
| 11
| Налаштовано файли <code>ignore</code> для компонент
|-
| 12
| Додано токен у <code>token.txt</code>
|-
| 13
| Оновлено версію компоненти в <code>setup.py</code>
|-
| 14
| Додано SEO-опис змін у <code>history.txt</code>
|-
| 15
| Виконано <code>python k2update_push.py</code>
|-
| 16
| Оновлено компоненти на <code>deb1</code>–<code>deb3</code>
|-
| 17
| Перевірено функції ERP після оновлення версій
|}

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

components/k2site
bash first_run.sh
<pre>
Завантажити PyCharm можна з офіційної сторінки:
|-
| Проєкт не запускається локально
| Не виконано <code>first_run</code> або неправильно налаштоване середовище
| Повторити <code>first_run</code>, перевірити <code>venv</code>
|-
| Локальний запуск відкривається через HTTPS
| Не змінено <code>domain_protocol</code>
| Перевірити <code>k2cfg.py</code>
|-
| PyCharm не бачить залежності
| Не вибрано правильний Python Interpreter
| Перевірити шлях до <code>venv</code>
|-
| Git не пушить зміни
| Не налаштовано авторизацію або немає прав
| Перевірити SSH-ключ, remote URL і доступи
|-
| На сервер оновлень потрапляють зайві файли
| Не налаштовано <code>ignore</code>
| Перевірити файл компоненти в <code>builder/config/ignore</code>
|-
| Компонента не оновлюється на тестовому домені
| Не змінено версію або не завантажено оновлення версій
| Перевірити <code>setup.py</code>, <code>history.txt</code>, <code>k2update_push.py</code>
|}

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

bash run.sh
|-
| З чого почати? Кожна компонента записується з нового рядка. Перевірка
Відправити зміни у віддалений репозиторій:


python git_cmd.py commit
./pycharm.sh
../K2CloudERP/venv/bin/python3.12

python git_cmd.py status

builder/config/ignore

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

<pre>

<pre>
Перевірка статусу:
Для роботи з віддаленими репозиторіями здатна використовуватися SSH-авторизація. | У Python Interpreter через локальний <code>venv</code>
|-
| Як працювати з компонентами? # копіювання робочого проєкту з віддаленого сервера;
# первинне конфігурація локального середовища;
# запуск системи;
# відкриття проєкту в PyCharm;
# конфігурація Python Interpreter;
# встановлення та конфігурація Git;
# підключення репозиторіїв компонент;
# коміт і публікація змін;
# підготовка компонент до сервера оновлень;
# тестування на тестових доменах. ./run.bat

Отримання змін із віддаленого сервера:

git pull origin main

git init

5. Базове конфігурація Git

2.0.4.43 - додавання додаткового поля у форму реєстрації

{| class="wikitable" style="width:100%;"
Додавання віддаленого репозиторію:
Отримання даних із віддаленого репозиторію без зміни поточної гілки:
git fetch origin
<pre>

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

https://www.jetbrains.com/pycharm/download/?section=linux

на:

..\K2CloudERP\venv\Scripts\python.exe

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

python git_cmd.py clone У цьому каталозі запускається файл первинного конфігурація. Причина


! Приклад шляху:
[[Категорія:Розгортання K2 ERP]]
Перемикання на іншу локальну гілку, якщо потрібно:

== Див. так само ==

Приклад вмісту:

<pre>
Після встановлення Git потрібно вказати ім’я користувача та email. | Через Git-коміт і <code>python k2update_push.py</code>
|-
| Де тестувати оновлення версій? ! №

<pre>
sudo apt update
<pre>

<div style="border:3px solid #b71c1c; background:#ffebee; padding:14px; margin:16px 0;">

Якщо потрібно підключити лише одну компоненту вручну, потрібно перейти в каталог потрібної компоненти.

cd components/k2site

Після зміни версії потрібно додати SEO-опис змін у файл:

Перегляд публічного ключа:


=== Windows ===

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


== 1. Копіювання проєкту і перший запуск ==
Після завантаження нової версії потрібно оновити змінені компоненти на тестових доменах:
Після цього потрібно відкрити файл налаштувань:

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


<div style="border:2px solid #f57c00; background:#fff3e0; padding:14px; margin:16px 0;">

Windows:

Отримання змін і автоматичне об’єднання з локальною гілкою:
<pre>

'''Коротко.''' Щоб почати роботу, потрібно скопіювати проєкт, виконати первинне конфігурація через <code>first_run</code>, запустити систему локально, підключити PyCharm, налаштувати Git і працювати з компонентами через репозиторії або скрипт <code>auto_update</code>. git checkout master
потрібно вказати токен доступу до сервера оновлень. | Скопіювати проєкт, виконати <code>first_run</code>, змінити <code>domain_protocol</code> і запустити <code>run</code>
|-
| Яке середовище розробки застосовується для? Каталог зі скриптом потрібно скопіювати в корінь проєкту на рівень із файлом:

</div>
Після підготовки версії потрібно перейти в корінь застосунку, на рівень із файлом:


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

потрібно створити файл із назвою компоненти та вказати файли або папки, які не потрібно завантажувати.<pre>

У файлі:
Файл знаходиться в корені каталогу компоненти.https://git-scm.com/downloads/win

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

Розгортання локального середовища K2 ERP складається з кількох основних етапів:

як приклад:
git remote add origin http://git.corp2.eu/k2erp/python/k2/base/site/k2site.git
'''Практична порада.''' Для стабільної роботи з Git краще налаштувати SSH-доступ один раз і далі працювати з репозиторіями без постійного введення логіна та пароля. version_type = "stable"
== 11. конфігурація завантаження компонент на сервер оновлень ==