langchain-ai/docs
1
0
Fork 0
mirror of https://github.com/langchain-ai/docs.git synced 2026-07-21 03:45:28 -04:00
Code Issues 490 Packages Projects Releases Wiki Activity

[PR #4187] docs(self-hosted): add Terraform guides for AWS, GCP, and Azure #4180

New Issue
Open
opened 2026-06-05 19:13:03 -04:00 by yindo · 0 comments
yindo commented 2026-06-05 19:13:03 -04:00
Owner
Copy Link
Copy Source

📋 Pull Request Information

Original PR: https://github.com/langchain-ai/docs/pull/4187
Author: @devfreddy-langchain
Created: 5/28/2026
Status: 🔄 Open

Base: main ← Head: feat/self-hosted-terraform-foundation

📝 Commits (10+)

  • 2e172f7 docs(self-hosted): add Terraform deployment overview and nav group
  • f07cf57 docs(self-hosted): add AWS Terraform deployment guides
  • 36ac01a docs(self-hosted): add GCP Terraform deployment guides
  • 7aedc57 docs(self-hosted): add Azure Terraform deployment guides
  • c496c09 docs(self-hosted): add OpenShift Terraform deployment guides (preview)
  • bf0b97f docs(self-hosted): tighten prose across Azure and OpenShift Terraform guides
  • 7c014df Merge branch 'main' into feat/self-hosted-terraform-foundation
  • 82c3127 docs(self-hosted): fix codespell failures in Terraform guides
  • 41374a8 docs(self-hosted): split AWS and GCP Terraform passes, add variables pages
  • 49581e7 docs(self-hosted): consolidate Terraform guides, drop OCP and Pass terminology

📊 Changes

31 files changed (+5332 additions, -18 deletions)

View changed files

📝 src/.codespellignore (+1 -0)
📝 src/docs.json (+36 -0)
➕ src/images/self-hosted-terraform/aws-architecture.png (+0 -0)
➕ src/images/self-hosted-terraform/aws-deployment-flow.png (+0 -0)
➕ src/images/self-hosted-terraform/azure-architecture-light.png (+0 -0)
➕ src/images/self-hosted-terraform/azure-architecture-pass2.png (+0 -0)
➕ src/images/self-hosted-terraform/azure-architecture-pass3.png (+0 -0)
➕ src/images/self-hosted-terraform/azure-architecture-pass4-5.png (+0 -0)
➕ src/images/self-hosted-terraform/azure-architecture.png (+0 -0)
➕ src/images/self-hosted-terraform/gcp-architecture.png (+0 -0)
➕ src/images/self-hosted-terraform/langsmith-components.png (+0 -0)
📝 src/langsmith/aws-self-hosted.mdx (+1 -3)
📝 src/langsmith/azure-self-hosted.mdx (+1 -3)
📝 src/langsmith/gcp-self-hosted.mdx (+1 -3)
📝 src/langsmith/kubernetes.mdx (+3 -9)
➕ src/langsmith/self-host-terraform-aws-architecture.mdx (+326 -0)
➕ src/langsmith/self-host-terraform-aws-deploy.mdx (+425 -0)
➕ src/langsmith/self-host-terraform-aws-quick-reference.mdx (+301 -0)
➕ src/langsmith/self-host-terraform-aws-troubleshooting.mdx (+435 -0)
➕ src/langsmith/self-host-terraform-aws-variables.mdx (+145 -0)

...and 11 more files

📄 Description

Summary

  • Adds Terraform deployment guides for LangSmith self-hosted across AWS, GCP, Azure, and OpenShift, mirroring the structure of the existing Helm setup guide.
  • Each provider gets an overview, quickstart, architecture reference, prerequisites/variables, teardown, troubleshooting, and (for Azure) per-pass walkthroughs for the optional add-ons (LangSmith Deployment, Agent Builder, Insights, Polly).
  • OpenShift ships in Preview while the OCP Terraform module matures; AWS, GCP, and Azure are GA.

Why

Self-hosted enterprise customers using the public Terraform modules at github.com/langchain-ai/terraform have so far been pointed at provider READMEs. This PR brings those walkthroughs into the official docs so the in-product Terraform path matches the experience the Helm path has had.

Areas needing careful review

  • Architecture diagrams and per-pass layer descriptions — accuracy of which services each pass provisions
  • Azure variables reference — deepest variable surface area of any provider
  • OpenShift "Planned production path" sections — preview content, calls out steps not yet GA

Test plan

  • make lint_prose passes (verified locally: 0 errors across all 30 terraform docs)
  • make broken-links passes
  • Mintlify preview renders all new pages and navigation entries resolve
  • /langsmith/self-host-terraform-{aws,gcp,azure,ocp}-quickstart URLs match src/docs.json

AI involvement

Drafted in collaboration with Claude Code (Opus 4.7). Author directed content and accuracy; Claude assisted with prose drafting, Vale lint cleanup passes, and consistency between provider sections.

🔄 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/docs/pull/4187 **Author:** [@devfreddy-langchain](https://github.com/devfreddy-langchain) **Created:** 5/28/2026 **Status:** 🔄 Open **Base:** `main` ← **Head:** `feat/self-hosted-terraform-foundation` --- ### 📝 Commits (10+) - [`2e172f7`](https://github.com/langchain-ai/docs/commit/2e172f74429abe4301068bccb3daf043af7ab99e) docs(self-hosted): add Terraform deployment overview and nav group - [`f07cf57`](https://github.com/langchain-ai/docs/commit/f07cf5752d9be7553e074ecdbeb5ec36147c7228) docs(self-hosted): add AWS Terraform deployment guides - [`36ac01a`](https://github.com/langchain-ai/docs/commit/36ac01ac9be0f7d8f525e01d49962e749182ebb0) docs(self-hosted): add GCP Terraform deployment guides - [`7aedc57`](https://github.com/langchain-ai/docs/commit/7aedc57a52daee13094c24feb08cadec15deb56c) docs(self-hosted): add Azure Terraform deployment guides - [`c496c09`](https://github.com/langchain-ai/docs/commit/c496c09ae0c08488a603197467fadca277228f95) docs(self-hosted): add OpenShift Terraform deployment guides (preview) - [`bf0b97f`](https://github.com/langchain-ai/docs/commit/bf0b97fa7218c127b93878b527605917899045d8) docs(self-hosted): tighten prose across Azure and OpenShift Terraform guides - [`7c014df`](https://github.com/langchain-ai/docs/commit/7c014df3e13e5ee792950719ed284332a0dcef5b) Merge branch 'main' into feat/self-hosted-terraform-foundation - [`82c3127`](https://github.com/langchain-ai/docs/commit/82c3127ad094fd13346a3df3c00170efd9ee36f9) docs(self-hosted): fix codespell failures in Terraform guides - [`41374a8`](https://github.com/langchain-ai/docs/commit/41374a8080f5b2289994642157d4c26fcde0fa1e) docs(self-hosted): split AWS and GCP Terraform passes, add variables pages - [`49581e7`](https://github.com/langchain-ai/docs/commit/49581e7d756e44f40ca2fdc6eb718a01798a6ba5) docs(self-hosted): consolidate Terraform guides, drop OCP and Pass terminology ### 📊 Changes **31 files changed** (+5332 additions, -18 deletions) <details> <summary>View changed files</summary> 📝 `src/.codespellignore` (+1 -0) 📝 `src/docs.json` (+36 -0) ➕ `src/images/self-hosted-terraform/aws-architecture.png` (+0 -0) ➕ `src/images/self-hosted-terraform/aws-deployment-flow.png` (+0 -0) ➕ `src/images/self-hosted-terraform/azure-architecture-light.png` (+0 -0) ➕ `src/images/self-hosted-terraform/azure-architecture-pass2.png` (+0 -0) ➕ `src/images/self-hosted-terraform/azure-architecture-pass3.png` (+0 -0) ➕ `src/images/self-hosted-terraform/azure-architecture-pass4-5.png` (+0 -0) ➕ `src/images/self-hosted-terraform/azure-architecture.png` (+0 -0) ➕ `src/images/self-hosted-terraform/gcp-architecture.png` (+0 -0) ➕ `src/images/self-hosted-terraform/langsmith-components.png` (+0 -0) 📝 `src/langsmith/aws-self-hosted.mdx` (+1 -3) 📝 `src/langsmith/azure-self-hosted.mdx` (+1 -3) 📝 `src/langsmith/gcp-self-hosted.mdx` (+1 -3) 📝 `src/langsmith/kubernetes.mdx` (+3 -9) ➕ `src/langsmith/self-host-terraform-aws-architecture.mdx` (+326 -0) ➕ `src/langsmith/self-host-terraform-aws-deploy.mdx` (+425 -0) ➕ `src/langsmith/self-host-terraform-aws-quick-reference.mdx` (+301 -0) ➕ `src/langsmith/self-host-terraform-aws-troubleshooting.mdx` (+435 -0) ➕ `src/langsmith/self-host-terraform-aws-variables.mdx` (+145 -0) _...and 11 more files_ </details> ### 📄 Description ## Summary - Adds Terraform deployment guides for LangSmith self-hosted across AWS, GCP, Azure, and OpenShift, mirroring the structure of the existing Helm setup guide. - Each provider gets an overview, quickstart, architecture reference, prerequisites/variables, teardown, troubleshooting, and (for Azure) per-pass walkthroughs for the optional add-ons (LangSmith Deployment, Agent Builder, Insights, Polly). - OpenShift ships in **Preview** while the OCP Terraform module matures; AWS, GCP, and Azure are GA. ## Why Self-hosted enterprise customers using the public Terraform modules at github.com/langchain-ai/terraform have so far been pointed at provider READMEs. This PR brings those walkthroughs into the official docs so the in-product Terraform path matches the experience the Helm path has had. ## Areas needing careful review - Architecture diagrams and per-pass layer descriptions — accuracy of which services each pass provisions - Azure variables reference — deepest variable surface area of any provider - OpenShift "Planned production path" sections — preview content, calls out steps not yet GA ## Test plan - [ ] `make lint_prose` passes (verified locally: 0 errors across all 30 terraform docs) - [ ] `make broken-links` passes - [ ] Mintlify preview renders all new pages and navigation entries resolve - [ ] `/langsmith/self-host-terraform-{aws,gcp,azure,ocp}-quickstart` URLs match `src/docs.json` ## AI involvement Drafted in collaboration with Claude Code (Opus 4.7). Author directed content and accuracy; Claude assisted with prose drafting, Vale lint cleanup passes, and consistency between provider sections. --- <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-06-05 19:13:03 -04:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
bug
deepagents
docs-infra
external
external
help wanted
integration
internal
internal
javascript
js/ts
langchain
langgraph
langsmith
needs-title
pull-request
Mirrored from GitHub Pull Request
 python
reference
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/docs#4180
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?