Skip to content

[chore] Enhance the Makefile to improve local development workflow#156

Merged
z9r5 merged 1 commit into
mainfrom
chore-fix-local-run
Apr 6, 2026
Merged

[chore] Enhance the Makefile to improve local development workflow#156
z9r5 merged 1 commit into
mainfrom
chore-fix-local-run

Conversation

@z9r5
Copy link
Copy Markdown
Member

@z9r5 z9r5 commented Apr 6, 2026

This pull request enhances the Makefile to improve local development workflow, particularly around managing Docker containers and port usage. The most significant change is the addition of a mechanism to automatically free up commonly used ports before starting the development environment, reducing conflicts and setup errors.

Docker and port management improvements:

  • Added a free-ports target that detects and stops any running Docker containers occupying ports listed in the new PORTS_TO_FREE variable (defaults to ports 80, 1313, and 1314). This helps prevent port conflicts when starting the environment. [1] [2]
  • Modified the up target to first bring down any running containers and then invoke free-ports before starting up, ensuring a clean and conflict-free environment.
  • Updated the down target to also run docker compose down --remove-orphans, ensuring all orphaned containers are removed.

Makefile maintenance:

  • Declared free-ports as a .PHONY target for proper Makefile behavior.
  • Minor formatting clean-up at the end of the file.

- Introduce a free-ports target that discovers and stops any
  containers occupying configurable published ports before the
  service stack is brought up, preventing bind-address conflicts
- Chain down and free-ports as prerequisites of the up target
  to guarantee a clean environment on every invocation
- Extend the down target with orphan removal to ensure no
  stale containers persist across successive runs
@z9r5 z9r5 force-pushed the chore-fix-local-run branch from 4998264 to 17069cb Compare April 6, 2026 14:11
@z9r5 z9r5 changed the title Chore fix local run [chore] Enhance the Makefile to improve local development workflow Apr 6, 2026
@z9r5 z9r5 merged commit fede4f9 into main Apr 6, 2026
3 checks passed
@z9r5 z9r5 deleted the chore-fix-local-run branch April 6, 2026 14:13
Avtandilko added a commit that referenced this pull request Apr 29, 2026
* docs: Add github actions widget

* Minor language correction (#149)

Signed-off-by: Lada <lada7878@Ladas-MacBook-Pro.local>

* docs: Edit github tags widget (Review PR 126) (#148)

* docs: add Go template support for repository ignore rules (#146)

Co-authored-by: pavel.korolkov <pavel.korolkov@flant.com>

* processes error element (#151)

* processes error element

* minor edit

Signed-off-by: Lada7878 <ladalada7878@gmail.com>

---------

Signed-off-by: Lada7878 <ladalada7878@gmail.com>
Co-authored-by: Nikita Velgin <nikita.velgin@flant.com>
Co-authored-by: Lada7878 <ladalada7878@gmail.com>

* change release date (#154)

Co-authored-by: Nikita Velgin <nikita.velgin@flant.com>

* [frontend] Harden upstream resilience and startup (#155)

- Add DNS readiness loop and upstream cache-warming
  entrypoint to ensure external backends are resolvable
  and responsive before nginx begins accepting traffic
- Introduce dedicated includes location block with
  non-intercepting error handling and strict proxy
  timeouts, separating static asset proxying from the
  default fallback-to-hugo routing logic
- Enable dynamic DNS resolution on upstream definitions
  via resolve flag and shared memory zones, replacing
  static resolution that broke on address changes
- Restore default upstream mapping to the international
  endpoint, removing temporary override to the Russian
  locale
- Disable git-info via environment variable for the
  static site generator to avoid build-time penalties
  in local development

* [build] Add port-freeing and clean teardown to up (#156)

- Introduce a free-ports target that discovers and stops any
  containers occupying configurable published ports before the
  service stack is brought up, preventing bind-address conflicts
- Chain down and free-ports as prerequisites of the up target
  to guarantee a clean environment on every invocation
- Extend the down target with orphan removal to ensure no
  stale containers persist across successive runs

* AI-assistant chats and context (#153)

* AI-assistant chats and context

* add breaking changes

* fix list

Signed-off-by: sidorok <a.sidorok@me.com>

---------

Signed-off-by: sidorok <a.sidorok@me.com>
Co-authored-by: Nikita Velgin <nikita.velgin@flant.com>
Co-authored-by: sidorok <a.sidorok@me.com>

* update process loop element description (#147)

* update process loop element description

* add note element description

* add note element description

* fix release notes

* fix release notes

* add deprecation notice

* add deprecation notice

* fix release notes

* gitlab contributors widget

* fix rn 1.3

* fix tupes_ru

Signed-off-by: sidorok <a.sidorok@me.com>

* Update types.ru.md

Signed-off-by: Anastasia Sidorok <a.sidorok@me.com>

* Update types.ru.md

Signed-off-by: Anastasia Sidorok <a.sidorok@me.com>

* Update types.ru.md

Signed-off-by: Anastasia Sidorok <a.sidorok@me.com>

* Update types.ru.md

GitLab

Signed-off-by: Anastasia Sidorok <a.sidorok@me.com>

* Update v1.4.0.ru.md

Signed-off-by: Anastasia Sidorok <a.sidorok@me.com>

* Update v1.3.0.ru.md

Signed-off-by: Anastasia Sidorok <a.sidorok@me.com>

* Apply suggestions from code review

Co-authored-by: Lada Lysenko <127337005+Lada7878@users.noreply.github.com>
Signed-off-by: Anastasia Sidorok <a.sidorok@me.com>

---------

Signed-off-by: Nikita Velgin <direct.vegas@gmail.com>
Signed-off-by: sidorok <a.sidorok@me.com>
Signed-off-by: Anastasia Sidorok <a.sidorok@me.com>
Co-authored-by: Nikita Velgin <nikita.velgin@flant.com>
Co-authored-by: sidorok <a.sidorok@me.com>
Co-authored-by: Lada Lysenko <127337005+Lada7878@users.noreply.github.com>

* add codescoring secrets widget (#157)

Co-authored-by: Nikita Velgin <nikita.velgin@flant.com>

* docs: Action CreateVaultSecret: add merge_or_create (#145)

Co-authored-by: pavel.korolkov <pavel.korolkov@flant.com>

* Decrecation: remove specific kubernetes datasources (#158)

Co-authored-by: Nikita Velgin <nikita.velgin@flant.com>

* Mcp tools tuning 1 (#160)

* mcp tools tuning

* mcp tools tuning

* mcp tools tuning

---------

Co-authored-by: Nikita Velgin <nikita.velgin@flant.com>

* Release v1.4.0 (#162)

* Release v1.4.0

* Release v1.4.0

---------

Co-authored-by: Nikita Velgin <nikita.velgin@flant.com>

* docs: Mcp tools tunung and AI-assistant review (#166)

* Updates for links in release notes and other edits

Signed-off-by: Valeria Brazhnikova <valeria.brazhnikova@flant.com>

* ai-assistant doc fixes

Signed-off-by: Valeria Brazhnikova <valeria.brazhnikova@flant.com>

* mcp-server fixes

Signed-off-by: Valeria Brazhnikova <valeria.brazhnikova@flant.com>

* fix of domain example

Signed-off-by: Valeria Brazhnikova <valeria.brazhnikova@flant.com>

* one number fix

Signed-off-by: Valeria Brazhnikova <valeria.brazhnikova@flant.com>

* Apply suggestions from code review

Co-authored-by: Denis Rebenok <60424108+denmaloyreb@users.noreply.github.com>
Co-authored-by: Valeria Brazhnikova <valeria.brazhnikova@flant.com>
Signed-off-by: Valeria Brazhnikova <valeria.brazhnikova@flant.com>

* Apply suggestions from code review

Co-authored-by: Denis Rebenok <60424108+denmaloyreb@users.noreply.github.com>
Signed-off-by: Valeria Brazhnikova <valeria.brazhnikova@flant.com>

* Added what instructions returns

Signed-off-by: Valeria Brazhnikova <valeria.brazhnikova@flant.com>

* Apply suggestions from code review

Co-authored-by: Denis Rebenok <60424108+denmaloyreb@users.noreply.github.com>
Signed-off-by: Valeria Brazhnikova <valeria.brazhnikova@flant.com>

* Removed bold text

Signed-off-by: Valeria Brazhnikova <valeria.brazhnikova@flant.com>

---------

Signed-off-by: Valeria Brazhnikova <valeria.brazhnikova@flant.com>
Co-authored-by: Denis Rebenok <60424108+denmaloyreb@users.noreply.github.com>

* add entity cards view (#167)

* add entity cards view

* fix

Signed-off-by: sidorok <a.sidorok@me.com>

* Update catalog.ru.md

Signed-off-by: Anastasia Sidorok <a.sidorok@me.com>

* Update catalog.ru.md

Signed-off-by: Anastasia Sidorok <a.sidorok@me.com>

* Update catalog.ru.md

Signed-off-by: Anastasia Sidorok <a.sidorok@me.com>

* Update catalog.ru.md

Signed-off-by: Anastasia Sidorok <a.sidorok@me.com>

* Update catalog.ru.md

Signed-off-by: Anastasia Sidorok <a.sidorok@me.com>

* Update catalog.ru.md

Signed-off-by: Anastasia Sidorok <a.sidorok@me.com>

* Apply suggestions from code review

Co-authored-by: Lada Lysenko <127337005+Lada7878@users.noreply.github.com>
Signed-off-by: Anastasia Sidorok <a.sidorok@me.com>

---------

Signed-off-by: sidorok <a.sidorok@me.com>
Signed-off-by: Anastasia Sidorok <a.sidorok@me.com>
Co-authored-by: Nikita Velgin <nikita.velgin@flant.com>
Co-authored-by: sidorok <a.sidorok@me.com>
Co-authored-by: Lada Lysenko <127337005+Lada7878@users.noreply.github.com>

* add rrpo section (#171)

* add rrpo section

* fixes

* add tech-support and licensing

* fix

---------

Co-authored-by: Nikita Velgin <nikita.velgin@flant.com>

* change hugo version to v0.159.2 (#172)

* change hugo-web-product-module version to v0.1.12

Signed-off-by: Aleksandr Radchenko <dacetascien@gmail.com>

* change hugo version to v0.159.2

Signed-off-by: Aleksandr Radchenko <dacetascien@gmail.com>

---------

Signed-off-by: Aleksandr Radchenko <dacetascien@gmail.com>

* change naming (#175)

Co-authored-by: Nikita Velgin <nikita.velgin@flant.com>

* Release notes v1.5.0 (#170)

* new relations graph

* new relations graph

* Query changes

* fixes

* fixes

* add users sorting fix

* add favorites

* fix markdown-lint

* types

Signed-off-by: sidorok <a.sidorok@me.com>

* types-health

Signed-off-by: sidorok <a.sidorok@me.com>

* v1.5.0

Signed-off-by: sidorok <a.sidorok@me.com>

* catalog

Signed-off-by: sidorok <a.sidorok@me.com>

* types2

Signed-off-by: sidorok <a.sidorok@me.com>

* types3

Signed-off-by: sidorok <a.sidorok@me.com>

* Apply suggestions from code review

Co-authored-by: Lada Lysenko <127337005+Lada7878@users.noreply.github.com>
Signed-off-by: Anastasia Sidorok <a.sidorok@me.com>

* fix type4

Signed-off-by: sidorok <a.sidorok@me.com>

---------

Signed-off-by: Nikita Velgin <direct.vegas@gmail.com>
Signed-off-by: sidorok <a.sidorok@me.com>
Signed-off-by: Anastasia Sidorok <a.sidorok@me.com>
Co-authored-by: Nikita Velgin <nikita.velgin@flant.com>
Co-authored-by: sidorok <a.sidorok@me.com>
Co-authored-by: Lada Lysenko <127337005+Lada7878@users.noreply.github.com>

---------

Signed-off-by: Lada <lada7878@Ladas-MacBook-Pro.local>
Signed-off-by: Lada7878 <ladalada7878@gmail.com>
Signed-off-by: sidorok <a.sidorok@me.com>
Signed-off-by: Nikita Velgin <direct.vegas@gmail.com>
Signed-off-by: Anastasia Sidorok <a.sidorok@me.com>
Signed-off-by: Valeria Brazhnikova <valeria.brazhnikova@flant.com>
Signed-off-by: Aleksandr Radchenko <dacetascien@gmail.com>
Co-authored-by: pavel.korolkov <pavel.korolkov@flant.com>
Co-authored-by: Lada Lysenko <127337005+Lada7878@users.noreply.github.com>
Co-authored-by: Anastasia Sidorok <a.sidorok@me.com>
Co-authored-by: Nikita Velgin <direct.vegas@gmail.com>
Co-authored-by: Nikita Velgin <nikita.velgin@flant.com>
Co-authored-by: Lada7878 <ladalada7878@gmail.com>
Co-authored-by: Artem Kladov <6360800+z9r5@users.noreply.github.com>
Co-authored-by: Valeria Brazhnikova <valeria.brazhnikova@flant.com>
Co-authored-by: Denis Rebenok <60424108+denmaloyreb@users.noreply.github.com>
Co-authored-by: Aleksandr Radchenko <102186217+dacetascien@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant