Skip to content

Conversation

@amanfrinati
Copy link
Collaborator

@amanfrinati amanfrinati commented Oct 7, 2025

List of Changes

This pull request updates the local development environment for the chatbot application, with a focus on improving Docker Compose configuration, service orchestration, and setup documentation. The most important changes include a major refactor of the docker/compose.yaml file to enhance compatibility and support for Langfuse, ClickHouse, and Minio, as well as improvements to health checks and local setup instructions.

Docker Compose service orchestration and compatibility:

  • Refactored docker/compose.yaml to split Langfuse into langfuse-web and langfuse-worker services, and added new dependencies (ClickHouse and Minio) with detailed environment configuration for Langfuse integration. This enables more advanced observability and analytics features for the chatbot.
  • Added explicit platform: linux/amd64 specification to several services (api, create-redis-index, jupyter) to improve cross-platform compatibility, especially on Apple Silicon and other non-amd64 hosts. [1] [2] [3]

Service health checks and reliability:

  • Introduced health checks for Redis and ClickHouse services to improve reliability and ensure dependent services start only when their dependencies are healthy. [1] [2]
  • Updated service dependency management, replacing the old ntw network with direct dependencies and health checks, and removing unnecessary network definitions for simpler configuration. [1] [2] [3]

Local development setup improvements:

  • Updated apps/chatbot/README.md to include instructions for copying the Google service account example file, clarifying the initial setup steps for new developers.
  • Added a Dockerfile step to automatically download and install the AWS Lambda Runtime Interface Emulator, simplifying local Lambda testing.

Documentation fixes:

  • Fixed a typo in the main README.md ("Copile" → "Compile") to improve clarity.

Motivation and Context

How Has This Been Tested?

Screenshots (if appropriate):

Types of changes

  • Chore (nothing changes by a user perspective)
  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)

Checklist:

  • My change requires a change to the documentation.
  • I have updated the documentation accordingly.

Adds AWS Lambda Runtime Interface Emulator (RIE) to the development Dockerfile for local testing purposes. Updates README to include instructions for creating and filling in the Google service account JSON file.
Added `platform` specifications and restructured services, including new `langfuse-web`, `langfuse-worker`, `clickhouse`, and `minio` setups. Removed unused `networks` references and added health checks for critical services. These changes modernize and enhance the infrastructure to support new functionality and improve service reliability.
Corrected a misspelling in the README subtitle for better clarity. Ensures professionalism and avoids confusion for users following setup instructions.
@amanfrinati amanfrinati self-assigned this Oct 7, 2025
@changeset-bot
Copy link

changeset-bot bot commented Oct 7, 2025

🦋 Changeset detected

Latest commit: f63e3ab

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
chatbot Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@amanfrinati amanfrinati changed the title Cai 302 upgrade local langfuse to v3 CAI-302 upgrade local langfuse to v3 Oct 7, 2025
@amanfrinati amanfrinati changed the title CAI-302 upgrade local langfuse to v3 WIP: CAI-302 upgrade local langfuse to v3 Oct 7, 2025
Removed obsolete variables from .env.example and updated relevant configurations in docker/compose.yaml to ensure consistency. Adjusted ports and Langfuse initialization parameters to align with the updated environment setup.
Moved sensitive and configurable environment variables to `.env` files for improved readability and security. Updated comments in `docker/compose.yaml` to suggest consolidating environment variables into a dedicated `.env.langfuse` file.
@github-actions
Copy link
Contributor

This pull request is stale because it has been open for 14 days with no activity. If the pull request is still valid, please update it within 21 days to keep it open or merge it, otherwise it will be closed automatically.

@github-actions github-actions bot added the stale label Oct 22, 2025
# Conflicts:
#	apps/chatbot/docker/compose.yaml
@marcobottaro marcobottaro changed the title WIP: CAI-302 upgrade local langfuse to v3 [CAI-640] upgrade local langfuse to v3 Oct 28, 2025
amanfrinati and others added 4 commits October 28, 2025 11:35
# Conflicts:
#	apps/chatbot/.env.example
#	apps/chatbot/docker/compose.yaml
Deleted an obsolete file containing initialization logs for Terraform backend. This file was unnecessary and contributed no functional value to the codebase, improving clarity and reducing repository clutter.
…o-v3' into CAI-302-upgrade-local-langfuse-to-v3

# Conflicts:
#	apps/chatbot/.env.example
#	apps/chatbot/docker/compose.yaml
Moved Langfuse-related environment variables from multiple files into a dedicated `.env.langfuse` for improved organization and maintenance. Updated `.gitignore`, `.env.example`, and Docker compose configurations to reflect the change. This centralization simplifies environment management and enhances clarity across the project.
Co-authored-by: marcobottaro <39835990+marcobottaro@users.noreply.github.com>
@github-actions
Copy link
Contributor

github-actions bot commented Oct 29, 2025

Jira Pull Request Link

This Pull Request refers to the following Jira issue CAI-640

@github-actions
Copy link
Contributor

This PR exceeds the recommended size of 800 lines. Please make sure you are NOT addressing multiple issues with one PR. Note this PR might be rejected due to its size.

@marcobottaro marcobottaro merged commit 736a638 into main Oct 29, 2025
14 of 15 checks passed
@marcobottaro marcobottaro deleted the CAI-302-upgrade-local-langfuse-to-v3 branch October 29, 2025 10:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants