From f7882dbbabcabb392447e71ec52a2f6983e51f71 Mon Sep 17 00:00:00 2001 From: Danny Kopping Date: Thu, 27 Nov 2025 10:14:16 +0200 Subject: [PATCH] chore: document bedrock setup process for `aibridge` (#20956) Documents the steps needed to setup AWS Bedrock See also: https://github.com/coder/coder/pull/20507 --------- Signed-off-by: Danny Kopping --- .github/.linkspector.yml | 2 +- docs/ai-coder/ai-bridge/setup.md | 28 ++++++++++++++++++++++++++++ 2 files changed, 29 insertions(+), 1 deletion(-) diff --git a/.github/.linkspector.yml b/.github/.linkspector.yml index 18aeeae416fe2..50e9359f51523 100644 --- a/.github/.linkspector.yml +++ b/.github/.linkspector.yml @@ -27,7 +27,7 @@ ignorePatterns: - pattern: "splunk.com" - pattern: "stackoverflow.com/questions" - pattern: "developer.hashicorp.com/terraform/language" - - pattern: "platform.openai.com/docs/api-reference" + - pattern: "platform.openai.com" - pattern: "api.openai.com" aliveStatusCodes: - 200 diff --git a/docs/ai-coder/ai-bridge/setup.md b/docs/ai-coder/ai-bridge/setup.md index 3c0a4f7a839a1..b9ddbd56cdfb8 100644 --- a/docs/ai-coder/ai-bridge/setup.md +++ b/docs/ai-coder/ai-bridge/setup.md @@ -58,6 +58,34 @@ Set the following when routing [Amazon Bedrock](https://coder.com/docs/reference - `CODER_AIBRIDGE_BEDROCK_MODEL` or `--aibridge-bedrock-model` - `CODER_AIBRIDGE_BEDROCK_SMALL_FAST_MODEL` or `--aibridge-bedrock-small-fast-model` +#### Obtaining Bedrock credentials + +1. **Choose a region** where you want to use Bedrock. + +2. **Generate API keys** in the [AWS Bedrock console](https://us-east-1.console.aws.amazon.com/bedrock/home?region=us-east-1#/api-keys/long-term/create) (replace `us-east-1` in the URL with your chosen region): + - Choose an expiry period for the key. + - Click **Generate**. + - This creates an IAM user with strictly-scoped permissions for Bedrock access. + +3. **Create an access key** for the IAM user: + - After generating the API key, click **"You can directly modify permissions for the IAM user associated"**. + - In the IAM user page, navigate to the **Security credentials** tab. + - Under **Access keys**, click **Create access key**. + - Select **"Application running outside AWS"** as the use case. + - Click **Next**. + - Add a description like "Coder AI Bridge token". + - Click **Create access key**. + - Save both the access key ID and secret access key securely. + +4. **Configure your Coder deployment** with the credentials: + + ```sh + export CODER_AIBRIDGE_BEDROCK_REGION=us-east-1 + export CODER_AIBRIDGE_BEDROCK_ACCESS_KEY= + export CODER_AIBRIDGE_BEDROCK_ACCESS_KEY_SECRET= + coder server + ``` + ### Additional providers and Model Proxies AI Bridge can relay traffic to other OpenAI- or Anthropic-compatible services or model proxies like LiteLLM by pointing the base URL variables above at the provider you operate. Share feedback or follow along in the [`aibridge`](https://github.com/coder/aibridge) issue tracker as we expand support for additional providers.