Съдържание на курса
Урок 00 — Средата е готова
От Dorian Chávez · съосновател и Chief Executive Officer на Hábil ·
Какво ще постигнеш: с една-единствена команда да вдигнеш четирите системи, с които ще интегрираш през целия курс, и да провериш, че всяка от тях отговаря. Още не програмираш нищо: подготвяш работилницата.
Историята в едно изречение
Ще свържеш един онлайн магазин със системите, които са му нужни, за да продава: един API за поръчки, ERP системата на фирмата и един търговски партньор, който получава файлове. Тези системи вече съществуват и не са твои: твоята работа е информацията да пътува между тях, без да се губи. В този урок ги включваш.
Преди да започнеш, ти трябват
| Какво | За какво | Как проверяваш, че го имаш |
|---|---|---|
| Терминал | За да пишеш командите | На Mac — приложението Terminal; на Windows — Ubuntu в WSL; на Linux — този, който идва със системата |
| git | За да свалиш хранилището на курса | git --version отговаря с номер |
| Docker с Compose | За да работи всяка система в собствен контейнер, без да я инсталираш на машината си | docker compose version отговаря с номер |
| Свободна памет за Docker | Четирите системи и Camel работят едновременно | docker compose up --wait приключва, без машината ти да зацикли |
Не инсталираш Java, нито Maven, нито Camel, нито каквато и да е база данни. Всичко работи вътре в Docker.
Ако някоя от тези думи е нова за теб (терминал, git, контейнер), прочети първо картите в
conceptos/antes-de-empezar/. Кратки са.
⚠️ Работи в личната си папка (~), никога в /tmp. На Mac с colima Docker вижда само папките
в твоя home.
1. Свали курса
cd ~ # ve a tu carpeta personal
git clone https://github.com/HabilMX/ni-una-orden-perdida.git # baja una copia a tu máquina
cd ni-una-orden-perdida # entra a la carpeta que se creó
2. Предвиди
Отвори infra/compose.yaml с редактора си. Това е списъкът на системите, които ще вдигнеш. Без да пускаш нищо,
отговори на лист хартия:
- Колко услуги има и как се казва всяка?
- Кой номер на порт използва всяка на твоята машина? (Подсказка: потърси
ports:. Числото отляво е това на твоята машина; това отдясно — вътре в контейнера.) - Коя според теб ще се забави най-много при първото стартиране и защо?
3. Вдигни го
От основната папка на курса:
docker compose -f infra/compose.yaml up -d --wait
-f infra/compose.yamlказва на Docker кой списък с услуги да използва.upги стартира.-dги оставя да работят на заден план, така си връщаш терминала.--waitизчаква, докато всички кажат, че са здрави.
Първия път отнема няколко минути, най-вече заради API-то за поръчки: Docker го изгражда от кода му, преди да го
стартира. Ще разбереш, че е приключил, когато --wait ти върне терминала и docker compose ps покаже healthy при
всяка система. Следващите пъти е много по-бързо.
4. Сравни с предвиждането си
docker compose -f infra/compose.yaml ps
Трябва да видиш четири услуги, всички в healthy (здрави):
| Услуга | Какво е в историята | На твоята машина | Какво е технически |
|---|---|---|---|
api-pedidos |
Системата за поръчки на фирмата, с която се говори през интернет | localhost:8081 |
REST API, направен с Quarkus. Пази в паметта: при рестарт започва празен |
erp |
ERP системата: централната система, в която фирмата записва какво продава | localhost:13306 |
База MariaDB с две таблици (заглавна част и детайл) и една съхранена процедура (registrar_pedido): програма, записана вътре в базата |
socio-sftp |
Пощенската кутия на търговския партньор, където му се оставят файлове | localhost:2222 |
SFTP сървър за сигурно копиране на файлове, с папките entrada/ и salida/ |
estado |
Тефтерът, в който твоята интеграция записва докъде е стигнала всяка поръчка | localhost:15432 |
База PostgreSQL с три таблици. Не я пипаш до урок 15 |
Позна ли коя се бави най-много?
5. Провери
cd lecciones/00-ambiente
./verifica
Урокът е завършен, когато видиш деветте зелени отметки:
✅ estado está arriba
✅ erp está arriba
✅ socio-sftp está arriba
✅ api-pedidos está arriba
✅ La base de estado tiene sus tres tablas
✅ El ERP tiene su procedimiento registrar_pedido
✅ El ERP rechaza lo que no cuadra
✅ El SFTP del socio tiene entrada/ y salida/
✅ La API de pedidos contesta y exige su llave (400 sin ella)
Обърни внимание на седмата. verifica иска от ERP да регистрира поръчка, която не съществува, и очаква ERP да откаже. Деветата прави същото с API-то: праща му поръчка без
нейния ключ и очаква то да я отхвърли.
Системите в този курс не казват „да“ на всичко — също като истинските: валидират, отхвърлят и понякога отговарят късно.
Ако една дестинация приемаше каквото и да е, твоята интеграция щеше да изглежда, че работи, дори да е грешна.
6. Изключи го и го включи отново
docker compose -f infra/compose.yaml down # apaga y quita los contenedores
docker compose -f infra/compose.yaml up -d --wait
При изключване с down се изтрива това, което е имало вътре: средата се връща чиста всеки път. В началото на всеки
урок ще я включваш така.
Ако нещо се обърка
| Какво виждаш | Какво става | Какво правиш |
|---|---|---|
port is already allocated |
Вече имаш нещо, което ползва този порт. Затова курсът използва 15432 и 13306 вместо обичайните (5432 и 3306), но друга програма може да е на 8081 или 2222 | Спри тази програма или попитай в канала как се сменя портът |
Cannot connect to the Docker daemon |
Docker не работи | Отвори Docker Desktop, а на Mac — colima start |
Някоя услуга остава в starting |
Не ѝ стига памет или още се изгражда | Изчакай още минута; ако не се промени, docker compose -f infra/compose.yaml logs <servicio> |
Source file does not exist |
Клонирал си хранилището извън своя home (Mac с colima) | Клонирай го вътре в ~ |
Бележка за паролите
В infra/compose.yaml паролите са написани на показ (practica). Тук това е допустимо, защото е учебна среда
на твоята машина. В реална система това не се прави никога: паролите идват през променливи на
средата или от мениджър на тайни и не се пазят в хранилището.
Защо е направено така
Всяко решение в курса си има карта: какво решихме, защо, какво отхвърлихме и какво би ни накарало
да си променим мнението. Те са в decisiones/, а всеки урок ти дава връзка към своята. Днес още няма
нито една: средата е основата, а не дизайнерско решение.
Преговор
- Какво прави всяка от четирите части в историята на магазина?
- Какво означават
up,-dи--wait? - Защо е добре, че ERP отхвърля поръчка, която не съществува?
- Защо базата на състоянието използва порт 15432 на твоята машина, а не обичайния 5432? Какво би станало, ако използваше 5432, а ти вече имаш инсталиран PostgreSQL?
- Какво става с данните в ERP, когато изключиш средата с
downи я включиш отново? Защо това е удобно в един учебен курс?
Следва: в урок 01 пускаш първия си маршрут на Camel. Той още не използва тези системи: мести един файл от една папка в друга.
Предпочитате имейл? Пишете ни на hola@habil.mx