deploy-component

MenadBt 的头像作者 MenadBt

使用SST部署组件(前端、后端或着陆页)。用于部署到AWS,推送至开发或生产环境。

📖 中文导读:使用SST部署组件(前端、后端或着陆页)。用于部署到AWS,推送至开发或生产环境。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: deploy-component description: Deploys a component (frontend, backend, or landing) using SST. Use when deploying to AWS, pushing to dev or prod environments. allowed-tools: Read, Bash(npx sst:), Bash(cd:)

Deploy Component

Deploys individual components (frontend, backend, landing) using SST to AWS.

Prerequisites

  1. AWS credentials configured
  2. SST secrets set for the stage
  3. For backend: ECR image must be built (CI/CD handles this)

Deployment Commands

Backend

cd back && npx sst deploy --stage dev
cd back && npx sst deploy --stage prod

Frontend

cd front && npx sst deploy --stage dev
cd front && npx sst deploy --stage prod

Landing

cd landing && npx sst deploy --stage dev
cd landing && npx sst deploy --stage prod

Stages

Stage Branch Domain Pattern
dev develop *-dev.{domain}
prod main *.{domain}

Domain Structure

Component Dev Prod
Landing dev.questloghq.com questloghq.com
Frontend app-dev.questloghq.com app.questloghq.com
Backend api-dev.questloghq.com api.questloghq.com

View Deployed Resources

npx sst console --stage dev

Common Issues

Missing Secrets

# Check if secrets are set
npx sst secret list --stage dev

# Set missing secret
npx sst secret set SecretName "value" --stage dev

Route 53 Record Exists

The SST configs use allowOverwrite: true / override: true for idempotent deploys.

Build Errors (Frontend)

Ensure all environment variables are set:

npx sst secret set ClerkPublishableKey "pk_..." --stage dev
npx sst secret set ClerkSecretKey "sk_..." --stage dev

CI/CD

Deployments are typically handled by GitHub Actions:

  • Backend: .github/workflows/deploy-backend.yml
  • Frontend: .github/workflows/deploy-frontend.yml
  • Landing: .github/workflows/deploy-landing.yml

Manual deployment should only be needed for debugging or emergency fixes.