Skip to content

Conversation

@JaredforReal
Copy link
Collaborator

What type of PR is this?
refactor(chore/structure): relocate compose stacks, clean up unused assets, add tracing & observability separation

What this PR does / why we need it:
This PR restructures runtime and tooling assets to make the repository layout clearer and reduce ambiguity between production deployment artifacts and local developer utilities.

Summary of Changes:

  • Moved root docker-compose.yml to deploy/docker-compose/docker-compose.yml

  • Moved local observability compose file to tools/observability/docker-compose.obs.yml (from root)

  • Moved tracing compose from deploy/docker-compose.tracing.yamltools/tracing/docker-compose.tracing.yaml

  • Added docker-compose-tracing-up / docker-compose-tracing-down targets

  • Removed unused llm-router-dashboard.json (duplicate of existing Grafana provisioning JSON under observability)

  • Adjusted docs: network & connectivity troubleshooting pages to reflect new compose path

Signed-off-by: JaredforReal <[email protected]>
@github-actions
Copy link

github-actions bot commented Oct 9, 2025

👥 vLLM Semantic Team Notification

The following members have been identified for the changed files in this PR and have been automatically assigned:

📁 deploy

Owners: @rootfs, @Xunzhuo
Files changed:

  • deploy/docker-compose/README.md
  • deploy/docker-compose/docker-compose.yml

📁 tools

Owners: @yuluo-yx, @rootfs, @Xunzhuo
Files changed:

  • tools/tracing/README.md
  • tools/tracing/docker-compose.tracing.yaml
  • tools/make/docker.mk
  • tools/make/observability.mk
  • tools/observability/README.md
  • tools/observability/scripts/start-observability.sh
  • tools/observability/scripts/stop-observability.sh
  • tools/observability/docker-compose.obs.yml

📁 website

Owners: @Xunzhuo
Files changed:

  • website/docs/troubleshooting/container-connectivity.md
  • website/docs/troubleshooting/network-tips.md

vLLM

🎉 Thanks for your contributions!

This comment was automatically generated based on the OWNER files in the repository.

@netlify
Copy link

netlify bot commented Oct 9, 2025

Deploy Preview for vllm-semantic-router ready!

Name Link
🔨 Latest commit 0b2d0f7
🔍 Latest deploy log https://app.netlify.com/projects/vllm-semantic-router/deploys/68e7bf30094ca00008c59a83
😎 Deploy Preview https://deploy-preview-377--vllm-semantic-router.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Signed-off-by: JaredforReal <[email protected]>
@JaredforReal JaredforReal marked this pull request as ready for review October 9, 2025 07:11
@rootfs rootfs requested a review from Copilot October 9, 2025 13:19
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR restructures runtime and tooling assets to improve repository organization by relocating Docker Compose files and cleaning up unused assets. The goal is to separate production deployment artifacts from local development utilities and provide clearer separation between tracing and observability tooling.

  • Moved main docker-compose.yml from root to deploy/docker-compose/ directory
  • Relocated observability and tracing compose files to tools/ directory for development separation
  • Updated documentation and scripts to reference new file paths

Reviewed Changes

Copilot reviewed 15 out of 15 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
website/docs/troubleshooting/network-tips.md Updated references to relocated docker-compose.yml path
website/docs/troubleshooting/container-connectivity.md Updated comment to reflect new compose file location
tools/tracing/docker-compose.tracing.yaml New tracing compose file relocated from deploy/
tools/tracing/README.md New documentation for tracing development stack
tools/observability/scripts/stop-observability.sh Updated compose file paths
tools/observability/scripts/start-observability.sh Updated compose file paths
tools/observability/docker-compose.obs.yml Updated volume mount paths to be relative to new location
tools/observability/README.md Added tracing stack documentation
tools/make/observability.mk Updated compose file paths in Make targets
tools/make/docker.mk Enhanced docker compose targets with rebuild functionality
deploy/tracing/README.md Removed obsolete tracing documentation
deploy/llm-router-dashboard.json Removed duplicate Grafana dashboard file
deploy/docker-compose/docker-compose.yml Main compose file relocated with updated relative paths
deploy/docker-compose/README.md New documentation for main compose stack
deploy/docker-compose.tracing.yaml Removed obsolete tracing compose file
Comments suppressed due to low confidence (1)

tools/make/docker.mk:115

  • Missing -f deploy/docker-compose/docker-compose.yml flag to specify the relocated compose file path.
docker-compose-down:
	@$(LOG_TARGET)
	@echo "Stopping docker-compose services..."
	@docker compose down

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

rootfs
rootfs previously approved these changes Oct 9, 2025
@JaredforReal
Copy link
Collaborator Author

@rootfs it‘s ready for merge now

@rootfs rootfs merged commit 2644304 into vllm-project:main Oct 9, 2025
9 checks passed
This directory contains the primary `docker-compose.yml` used to run the semantic-router stack (router + envoy + optional mock-vllm + observability).

## Path Layout
Because this file lives under `deploy/docker-compose/`, all relative paths to repository resources go two levels up (../../) back to repo root.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

deploy/docker-compose/ maybe -> deploy/docker-compose ?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do u mean moving the docker-compose.yml out of the dir? I just wanted to keep 3 deployments parallel.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

no. What I mean is, can we remove the '/' at the end? It seems a bit counterintuitive,
but it's just a suggestion. Don't pay too much attention to it.

@@ -0,0 +1,54 @@
version: '3.8'
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Docker Compose no longer requires a version tag. This is outdated and we can remove it.

refer: https://docs.docker.com/reference/compose-file/version-and-name/

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

got u

joyful-ii-V-I pushed a commit to joyful-ii-V-I/semantic-router that referenced this pull request Oct 13, 2025
* refactor deploy and tools

Signed-off-by: JaredforReal <[email protected]>

* add rebuild option

Signed-off-by: JaredforReal <[email protected]>

* add path

Signed-off-by: JaredforReal <[email protected]>

---------

Signed-off-by: JaredforReal <[email protected]>
Co-authored-by: Huamin Chen <[email protected]>
@JaredforReal JaredforReal deleted the refactor branch October 14, 2025 05:22
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.

4 participants