fix: add Lightsail activation prerequisite to docs and error messages (#1850)

- Adds a Prerequisites section to sh/aws/README.md (updated path after
  shell scripts reorganization in #1843) with the Lightsail activation
  URL as the first step
- Surfaces the Lightsail activation URL in createInstance error hints
  for both CLI and REST paths so users get actionable guidance on failure
- Bumps CLI to 0.9.1

Fixes #1838

Agent: issue-fixer

Co-authored-by: B <6723574+louisgv@users.noreply.github.com>
Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
A 2026-02-23 21:53:28 -08:00 committed by GitHub
parent c487ea215f
commit a96a396e79
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
3 changed files with 10 additions and 2 deletions

View file

@ -1,6 +1,6 @@
{
"name": "@openrouter/spawn",
"version": "0.9.0",
"version": "0.9.1",
"type": "module",
"bin": {
"spawn": "cli.js"

View file

@ -733,6 +733,7 @@ export async function createInstance(name: string, tier?: CloudInitTier): Promis
} catch (err) {
logError("Failed to create Lightsail instance");
logWarn("Common issues:");
logWarn(" - Lightsail not enabled: visit https://lightsail.aws.amazon.com/ls/webapp/home to activate");
logWarn(" - Instance limit reached for your account");
logWarn(" - Bundle unavailable in region");
logWarn(" - AWS credentials lack Lightsail permissions");
@ -757,6 +758,7 @@ export async function createInstance(name: string, tier?: CloudInitTier): Promis
} catch (err) {
logError("Failed to create Lightsail instance");
logWarn("Common issues:");
logWarn(" - Lightsail not enabled: visit https://lightsail.aws.amazon.com/ls/webapp/home to activate");
logWarn(" - Instance limit reached for your account");
logWarn(" - Bundle unavailable in region");
logWarn(" - Credentials lack lightsail:CreateInstances permission");

View file

@ -2,7 +2,13 @@
AWS Lightsail instances via AWS CLI. [AWS Lightsail](https://aws.amazon.com/lightsail/)
> Uses 'ubuntu' user instead of 'root'. Requires AWS CLI installed and configured.
## Prerequisites
1. **Enable AWS Lightsail** — New AWS accounts must activate Lightsail before first use. Visit the [Lightsail console](https://lightsail.aws.amazon.com/ls/webapp/home) and follow the activation prompt. Without this step, all provisioning commands will fail.
2. **AWS CLI installed and configured** — Run `aws configure` with your Access Key ID and Secret Access Key.
> Uses `ubuntu` user instead of `root`.
## Agents