langchain-ai/langsmith-self-hosted-workshops
1
0
Fork 0
mirror of https://github.com/langchain-ai/langsmith-self-hosted-workshops.git synced 2026-06-30 20:48:02 -04:00
Code Issues Packages Projects Releases Wiki Activity

[PR #1] [MERGED] Refinements to the initial creation #1

New Issue
Closed
opened 2026-02-16 09:17:27 -05:00 by yindo · 0 comments
yindo commented 2026-02-16 09:17:27 -05:00
Owner
Copy Link
Copy Source

📋 Pull Request Information

Original PR: https://github.com/langchain-ai/langsmith-self-hosted-workshops/pull/1
Author: @cwaddingham
Created: 1/6/2026
Status: ✅ Merged
Merged: 1/6/2026
Merged by: @cwaddingham

Base: main ← Head: cwaddingham/refinements

📝 Commits (10+)

  • 4a4c11a docs: Provide suggestions on running Jupyter notebooks
  • ecd436b Enhance validation notebook: add license checks, external services, and cloud-agnostic support
  • 2681a53 Remove deprecated 01_aws_preflight.ipynb and update references
  • bc26fb1 feat: Add Module 2 - Identity & Authentication (SSO validation)
  • ea6131b feat: Add CI/CD testing infrastructure for notebooks
  • a6ee27a test: Add teardown notebook execution test
  • 163b810 docs: Add Module 1 documentation
  • af1e7a8 feat: Add Module 3 - Production Operations & Scaling
  • f9c22ad Add Module 4: Troubleshooting & Incident Response
  • b0b424e Add tests for Module 3 and Module 4 notebooks

📊 Changes

40 files changed (+14317 additions, -679 deletions)

View changed files

➕ .gitattributes (+3 -0)
➕ .github/workflows/README.md (+120 -0)
➕ .github/workflows/test-notebooks.yml (+256 -0)
📝 README.md (+3 -1)
➕ docs/modules/module-1.md (+606 -0)
➕ docs/modules/module-2.md (+541 -0)
➕ docs/modules/module-3.md (+679 -0)
➕ docs/modules/module-4.md (+426 -0)
➕ docs/shared/auth_troubleshooting.md (+366 -0)
➕ docs/shared/auth_validation_checklist.md (+110 -0)
➕ docs/shared/incident_first_10_minutes.md (+163 -0)
➕ docs/shared/ops_signals_and_thresholds.md (+312 -0)
➕ docs/shared/production_readiness_checklist.md (+238 -0)
➕ docs/shared/sidecars_and_service_mesh.md (+468 -0)
➕ docs/shared/support_escalation_template.md (+185 -0)
📝 env-samples/oidc.env.example (+37 -0)
📝 env-samples/workshop.env.example (+1 -1)
➖ notebooks/module-1/01_aws_preflight.ipynb (+0 -589)
📝 notebooks/module-1/01_preflight.ipynb (+90 -2)
📝 notebooks/module-1/02_terraform_apply.ipynb (+274 -4)

...and 20 more files

📄 Description

Pull Request

Summary

This PR adds comprehensive workshop materials for LangSmith self-hosted deployment,
including four complete modules covering deployment, authentication, operations, and
troubleshooting. All notebooks are cloud-agnostic (AWS/Azure) and include safety
checks and validation.

Commits

  • 62b8abe feat: Add email-based workshop identifier and configure nbstripout
    • Interactive email prompt generates deterministic resource identifiers
    • Configures nbstripout for automatic output cell stripping
  • 34fa0e6 Move setup notebook to shared and make it generic for modules 2, 3, and 4
    • Makes environment setup reusable across modules 2, 3, and 4
  • 951b61c Add safety checks to Module 4 failure labs
    • Adds environment verification and explicit confirmation requirements
  • b0b424e Add tests for Module 3 and Module 4 notebooks
    • Adds pytest tests for notebook syntax and execution
  • f9c22ad Add Module 4: Troubleshooting & Incident Response
    • Adds failure labs for PostgreSQL, Redis, ClickHouse, and Blob Storage
    • Includes diagnostics baseline and incident response documentation
  • af1e7a8 feat: Add Module 3 - Production Operations & Scaling
    • Adds production operations checks, scaling guidance, and observability
  • 163b810 docs: Add Module 1 documentation
  • a6ee27a test: Add teardown notebook execution test
  • ea6131b feat: Add CI/CD testing infrastructure for notebooks
    • Adds pytest-based notebook testing with GitHub Actions workflow
  • bc26fb1 feat: Add Module 2 - Identity & Authentication (SSO validation)
    • Adds OIDC and SAML SSO validation notebooks
  • 2681a53 Remove deprecated 01_aws_preflight.ipynb and update references
  • ecd436b Enhance validation notebook: add license checks, external services, and cloud-agnostic support
  • 4a4c11a docs: Provide suggestions on running Jupyter notebooks
  • dd93069 docs: Clarify minimal values file guidance in Helm install notebook
  • 354e129 feat: Add cloud abstraction layer for multi-cloud support
    • Enables AWS and Azure support via unified helper modules
  • e546d9d Added README.md file to give overview of the workshop and its contents.
  • 3a190f1 feat: Add Module 1 notebooks and shared infrastructure for LangSmith self-hosted workshops
    • Initial deployment notebooks: preflight, Terraform, Helm, validation, teardown

Testing

All workshop notebooks were tested locally and manually verified:

  • Module 1: Preflight, Terraform apply, Helm install, validation, teardown
  • Module 2: OIDC and SAML SSO validation
  • Module 3: Production operations sanity checks
  • Module 4: Failure labs and diagnostics baseline

Note: Agent-based automated testing has been postponed for a later date.

Key Features

  • Cloud-agnostic implementation (AWS and Azure support)
  • Interactive email-based resource identifier generation
  • Comprehensive safety checks to prevent accidental resource modification
  • Complete documentation for all four modules
  • CI/CD testing infrastructure (syntax validation)
  • Automatic output cell stripping via nbstripout

🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/langchain-ai/langsmith-self-hosted-workshops/pull/1 **Author:** [@cwaddingham](https://github.com/cwaddingham) **Created:** 1/6/2026 **Status:** ✅ Merged **Merged:** 1/6/2026 **Merged by:** [@cwaddingham](https://github.com/cwaddingham) **Base:** `main` ← **Head:** `cwaddingham/refinements` --- ### 📝 Commits (10+) - [`4a4c11a`](https://github.com/langchain-ai/langsmith-self-hosted-workshops/commit/4a4c11aaf9de2abe13dde61ddd7530856a81bf03) docs: Provide suggestions on running Jupyter notebooks - [`ecd436b`](https://github.com/langchain-ai/langsmith-self-hosted-workshops/commit/ecd436bcb26827bf26e1a4c0f893f3f33f2be919) Enhance validation notebook: add license checks, external services, and cloud-agnostic support - [`2681a53`](https://github.com/langchain-ai/langsmith-self-hosted-workshops/commit/2681a531a8d5feffd6bc3b8e4e7405ac8f263a31) Remove deprecated 01_aws_preflight.ipynb and update references - [`bc26fb1`](https://github.com/langchain-ai/langsmith-self-hosted-workshops/commit/bc26fb1f930c2c4e76c2927004cd3e61923e0045) feat: Add Module 2 - Identity & Authentication (SSO validation) - [`ea6131b`](https://github.com/langchain-ai/langsmith-self-hosted-workshops/commit/ea6131b3949314a024fc1477e4dca378414993a0) feat: Add CI/CD testing infrastructure for notebooks - [`a6ee27a`](https://github.com/langchain-ai/langsmith-self-hosted-workshops/commit/a6ee27a06049197690f183c13e01f28f69baabb0) test: Add teardown notebook execution test - [`163b810`](https://github.com/langchain-ai/langsmith-self-hosted-workshops/commit/163b810bb393b6c8ef5e3763bd15425bd017a65d) docs: Add Module 1 documentation - [`af1e7a8`](https://github.com/langchain-ai/langsmith-self-hosted-workshops/commit/af1e7a840caf00c2463b86c1500c6723356c1daf) feat: Add Module 3 - Production Operations & Scaling - [`f9c22ad`](https://github.com/langchain-ai/langsmith-self-hosted-workshops/commit/f9c22ad3ea42fa920a61d7c39e52ebaa37a9d287) Add Module 4: Troubleshooting & Incident Response - [`b0b424e`](https://github.com/langchain-ai/langsmith-self-hosted-workshops/commit/b0b424eabd308d3cf42718609bcd1044ecbd3fa1) Add tests for Module 3 and Module 4 notebooks ### 📊 Changes **40 files changed** (+14317 additions, -679 deletions) <details> <summary>View changed files</summary> ➕ `.gitattributes` (+3 -0) ➕ `.github/workflows/README.md` (+120 -0) ➕ `.github/workflows/test-notebooks.yml` (+256 -0) 📝 `README.md` (+3 -1) ➕ `docs/modules/module-1.md` (+606 -0) ➕ `docs/modules/module-2.md` (+541 -0) ➕ `docs/modules/module-3.md` (+679 -0) ➕ `docs/modules/module-4.md` (+426 -0) ➕ `docs/shared/auth_troubleshooting.md` (+366 -0) ➕ `docs/shared/auth_validation_checklist.md` (+110 -0) ➕ `docs/shared/incident_first_10_minutes.md` (+163 -0) ➕ `docs/shared/ops_signals_and_thresholds.md` (+312 -0) ➕ `docs/shared/production_readiness_checklist.md` (+238 -0) ➕ `docs/shared/sidecars_and_service_mesh.md` (+468 -0) ➕ `docs/shared/support_escalation_template.md` (+185 -0) 📝 `env-samples/oidc.env.example` (+37 -0) 📝 `env-samples/workshop.env.example` (+1 -1) ➖ `notebooks/module-1/01_aws_preflight.ipynb` (+0 -589) 📝 `notebooks/module-1/01_preflight.ipynb` (+90 -2) 📝 `notebooks/module-1/02_terraform_apply.ipynb` (+274 -4) _...and 20 more files_ </details> ### 📄 Description # Pull Request ## Summary This PR adds comprehensive workshop materials for LangSmith self-hosted deployment, including four complete modules covering deployment, authentication, operations, and troubleshooting. All notebooks are cloud-agnostic (AWS/Azure) and include safety checks and validation. ## Commits - [`62b8abe`](https://github.com/langchain-ai/langsmith-self-hosted-workshops/commit/62b8abef6c5aad9f0e10246bf3f20b8aad560f32) feat: Add email-based workshop identifier and configure nbstripout - Interactive email prompt generates deterministic resource identifiers - Configures nbstripout for automatic output cell stripping - [`34fa0e6`](https://github.com/langchain-ai/langsmith-self-hosted-workshops/commit/34fa0e687476d7c4882b1c3653fe7fa9fadd602e) Move setup notebook to shared and make it generic for modules 2, 3, and 4 - Makes environment setup reusable across modules 2, 3, and 4 - [`951b61c`](https://github.com/langchain-ai/langsmith-self-hosted-workshops/commit/951b61c37c3e956d2fcdbc2445dd040b977f64bc) Add safety checks to Module 4 failure labs - Adds environment verification and explicit confirmation requirements - [`b0b424e`](https://github.com/langchain-ai/langsmith-self-hosted-workshops/commit/b0b424eabd308d3cf42718609bcd1044ecbd3fa1) Add tests for Module 3 and Module 4 notebooks - Adds pytest tests for notebook syntax and execution - [`f9c22ad`](https://github.com/langchain-ai/langsmith-self-hosted-workshops/commit/f9c22ad3ea42fa920a61d7c39e52ebaa37a9d287) Add Module 4: Troubleshooting & Incident Response - Adds failure labs for PostgreSQL, Redis, ClickHouse, and Blob Storage - Includes diagnostics baseline and incident response documentation - [`af1e7a8`](https://github.com/langchain-ai/langsmith-self-hosted-workshops/commit/af1e7a840caf00c2463b86c1500c6723356c1daf) feat: Add Module 3 - Production Operations & Scaling - Adds production operations checks, scaling guidance, and observability - [`163b810`](https://github.com/langchain-ai/langsmith-self-hosted-workshops/commit/163b810bb393b6c8ef5e3763bd15425bd017a65d) docs: Add Module 1 documentation - [`a6ee27a`](https://github.com/langchain-ai/langsmith-self-hosted-workshops/commit/a6ee27a06049197690f183c13e01f28f69baabb0) test: Add teardown notebook execution test - [`ea6131b`](https://github.com/langchain-ai/langsmith-self-hosted-workshops/commit/ea6131b3949314a024fc1477e4dca378414993a0) feat: Add CI/CD testing infrastructure for notebooks - Adds pytest-based notebook testing with GitHub Actions workflow - [`bc26fb1`](https://github.com/langchain-ai/langsmith-self-hosted-workshops/commit/bc26fb1f930c2c4e76c2927004cd3e61923e0045) feat: Add Module 2 - Identity & Authentication (SSO validation) - Adds OIDC and SAML SSO validation notebooks - [`2681a53`](https://github.com/langchain-ai/langsmith-self-hosted-workshops/commit/2681a531a8d5feffd6bc3b8e4e7405ac8f263a31) Remove deprecated 01_aws_preflight.ipynb and update references - [`ecd436b`](https://github.com/langchain-ai/langsmith-self-hosted-workshops/commit/ecd436bcb26827bf26e1a4c0f893f3f33f2be919) Enhance validation notebook: add license checks, external services, and cloud-agnostic support - [`4a4c11a`](https://github.com/langchain-ai/langsmith-self-hosted-workshops/commit/4a4c11aaf9de2abe13dde61ddd7530856a81bf03) docs: Provide suggestions on running Jupyter notebooks - [`dd93069`](https://github.com/langchain-ai/langsmith-self-hosted-workshops/commit/dd93069314386690c2af0825f89649b56c6372a8) docs: Clarify minimal values file guidance in Helm install notebook - [`354e129`](https://github.com/langchain-ai/langsmith-self-hosted-workshops/commit/354e12953d50021aae2a75b2d7b38fcfb0d86ef2) feat: Add cloud abstraction layer for multi-cloud support - Enables AWS and Azure support via unified helper modules - [`e546d9d`](https://github.com/langchain-ai/langsmith-self-hosted-workshops/commit/e546d9da9227ca1ef1a20671d65cee1b27463f1a) Added README.md file to give overview of the workshop and its contents. - [`3a190f1`](https://github.com/langchain-ai/langsmith-self-hosted-workshops/commit/3a190f1c196265e44f1f1ca9a53e7ca16e4427bf) feat: Add Module 1 notebooks and shared infrastructure for LangSmith self-hosted workshops - Initial deployment notebooks: preflight, Terraform, Helm, validation, teardown ## Testing All workshop notebooks were tested locally and manually verified: - Module 1: Preflight, Terraform apply, Helm install, validation, teardown - Module 2: OIDC and SAML SSO validation - Module 3: Production operations sanity checks - Module 4: Failure labs and diagnostics baseline **Note:** Agent-based automated testing has been postponed for a later date. ## Key Features - Cloud-agnostic implementation (AWS and Azure support) - Interactive email-based resource identifier generation - Comprehensive safety checks to prevent accidental resource modification - Complete documentation for all four modules - CI/CD testing infrastructure (syntax validation) - Automatic output cell stripping via nbstripout --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
yindo added the pull-request label 2026-02-16 09:17:27 -05:00
yindo closed this issue 2026-02-16 09:17:27 -05:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
pull-request
Mirrored from GitHub Pull Request
No Label pull-request
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
yindo
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: langchain-ai/langsmith-self-hosted-workshops#1
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?