Skip to content

Commit 38f27e0

Browse files
authored
1 parent 470970c commit 38f27e0

File tree

2 files changed

+55
-2
lines changed

2 files changed

+55
-2
lines changed

src/langsmith/deploy-self-hosted-full-platform.mdx

Lines changed: 39 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -75,11 +75,49 @@ As of v0.12.0, the `langgraphPlatform` option is deprecated. Use `config.deploym
7575
enabled: true
7676
langgraphPlatformLicenseKey: "YOUR_LANGGRAPH_PLATFORM_LICENSE_KEY"
7777
```
78-
4. In your `values.yaml` file, configure the `hostBackendImage` and `operatorImage` options (if you need to mirror images)
78+
4. In your `values.yaml` file, configure the `hostBackendImage` and `operatorImage` options (if you need to mirror images). If you are using a private container registry that requires authentication, you must also configure `imagePullSecrets`, refer to [Configure authentication for private registries](#optional-configure-authentication-for-private-registries).
79+
7980
5. You can also configure base templates for your agents by overriding the base templates [here](https://github.com/langchain-ai/helm/blob/main/charts/langsmith/values.yaml#L898).
8081

8182
Your self-hosted infrastructure is now ready to create deployments.
8283

84+
## (Optional) Configure authentication for private registries
85+
86+
If your [Agent Server deployments](/langsmith/agent-server) will use images from private container registries (e.g., AWS ECR, Azure ACR, GCP Artifact Registry, private Docker registry), configure image pull secrets. This is a one-time infrastructure configuration that allows all deployments to automatically authenticate with your private registry.
87+
88+
**Step 1: Create a Kubernetes image pull secret**
89+
90+
```bash
91+
kubectl create secret docker-registry langsmith-registry-secret \
92+
--docker-server=myregistry.com \
93+
--docker-username=your-username \
94+
--docker-password=your-password \
95+
--docker-email=your-email@example.com \
96+
-n langsmith
97+
```
98+
99+
Replace the values with your registry credentials:
100+
- `myregistry.com`: Your registry URL
101+
- `your-username`: Your registry username
102+
- `your-password`: Your registry password or access token
103+
- `langsmith`: The Kubernetes namespace where LangSmith is installed
104+
105+
**Step 2: Configure the secret in your `values.yaml`**
106+
107+
```yaml
108+
images:
109+
imagePullSecrets:
110+
- name: langsmith-registry-secret
111+
```
112+
113+
**Step 3: Apply during Helm installation/upgrade**
114+
115+
When you deploy or upgrade your LangSmith instance using Helm, this configuration will be applied. All user deployments created through the LangSmith UI will automatically inherit these registry credentials.
116+
117+
For registry-specific authentication methods (AWS ECR, Azure ACR, GCP Artifact Registry, etc.), refer to the [Kubernetes documentation on pulling images from private registries](https://kubernetes.io/docs/tasks/configure-pod-container/pull-image-private-registry/).
118+
83119
## Next steps
84120
85121
Once your infrastructure is set up, you're ready to deploy applications. See the deployment guides in the [Deployment tab](/langsmith/deployments) for instructions on building and deploying your applications.
122+
123+

src/langsmith/deploy-with-control-plane.mdx

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ Before completing this guide, you'll need the following:
3333
- [Hybrid setup](/langsmith/deploy-hybrid): Installs data plane components (listener, operator, CRDs) in your Kubernetes cluster that connect to LangChain's managed control plane.
3434
- [Enable LangSmith Deployment](/langsmith/deploy-self-hosted-full-platform): Enables LangSmith Deployment on your self-hosted LangSmith instance.
3535
- Access to the [LangSmith UI](https://smith.langchain.com) with LangSmith Deployment enabled.
36-
- A container registry accessible by your Kubernetes cluster.
36+
- A container registry accessible by your Kubernetes cluster. If using a private registry that requires authentication, you must configure image pull secrets as part of your infrastructure setup. Refer to [Private registry authentication](#private-registry-authentication).
3737

3838
## Step 1. Test locally
3939

@@ -117,6 +117,21 @@ Starting from the LangSmith UI:
117117
- Adjust other settings as needed.
118118
1. Select **Submit**.
119119

120+
## Private registry authentication
121+
122+
If your container registry requires authentication (e.g., AWS ECR, Azure ACR, GCP Artifact Registry, private Docker registry), you must configure Kubernetes image pull secrets before deploying applications. This is a one-time infrastructure configuration.
123+
124+
<Note>
125+
**This configuration is done at the infrastructure level, not per-deployment.** Once configured, all deployments automatically inherit the registry credentials.
126+
</Note>
127+
128+
The configuration steps depend on your deployment type:
129+
130+
- **Self-hosted with control plane**: Configure `imagePullSecrets` in your LangSmith Helm chart's `values.yaml` file. See the detailed steps in the [Enable LangSmith Deployment guide](/langsmith/deploy-self-hosted-full-platform#setup).
131+
- **Hybrid**: Configure `imagePullSecrets` in your `langgraph-dataplane-values.yaml` file using the same format.
132+
133+
For detailed steps on creating image pull secrets for different registry providers, refer to the [Kubernetes documentation on pulling images from private registries](https://kubernetes.io/docs/tasks/configure-pod-container/pull-image-private-registry/).
134+
120135
## Next steps
121136

122137
- **[Control plane](/langsmith/control-plane)**: Learn more about control plane features.

0 commit comments

Comments
 (0)