Към съдържанието
Съдържание на курса

Урок 00 — Средата е готова

От · съосновател и 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 с редактора си. Това е списъкът на системите, които ще вдигнеш. Без да пускаш нищо, отговори на лист хартия:

  1. Колко услуги има и как се казва всяка?
  2. Кой номер на порт използва всяка на твоята машина? (Подсказка: потърси ports:. Числото отляво е това на твоята машина; това отдясно — вътре в контейнера.)
  3. Коя според теб ще се забави най-много при първото стартиране и защо?

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/, а всеки урок ти дава връзка към своята. Днес още няма нито една: средата е основата, а не дизайнерско решение.

Преговор

  1. Какво прави всяка от четирите части в историята на магазина?
  2. Какво означават up, -d и --wait?
  3. Защо е добре, че ERP отхвърля поръчка, която не съществува?
  4. Защо базата на състоянието използва порт 15432 на твоята машина, а не обичайния 5432? Какво би станало, ако използваше 5432, а ти вече имаш инсталиран PostgreSQL?
  5. Какво става с данните в ERP, когато изключиш средата с down и я включиш отново? Защо това е удобно в един учебен курс?

Следва: в урок 01 пускаш първия си маршрут на Camel. Той още не използва тези системи: мести един файл от една папка в друга.

Да обсъдим вашия проект

Предпочитате имейл? Пишете ни на hola@habil.mx